典型应用 互联网应用 GeminiDB Cassandra的超强读写、弹性扩展，以及高强度的故障容忍，能够支持大并发低延时的访问需求，具备高可用和弹性扩容能力，使其适用于具有产品目录、推荐、个性化引擎、交易流水等功能的大数据量的互联网网站。 优势： 大规模集群部署 单套集群最大支持100个节点部署，适用于写入规模和数据量大的互联网场景。 高可用易扩展 单节点宕机不会影响整个集群的可用性，计算节点和存储空间可独立快速扩容，扩容期间业务无感知。 实时高并发写入 实时高并发写入，适合电商领域高并发海量订单，写入性能高。 工业数据采集 GeminiDB Cassandra兼容Cassandra生态，帮助客户整合多种终端采集来源，实时存储采集的指标，提供聚合分析，实时统计等功能。 优势： 大规模集群部署 适用于工业制造海量指标采集存储的场景。 高可用高性能 支持7*24小时在线持续高并发写入。 极速备份恢复 通过存储快照技术实现极速备份恢复能力。 分钟级扩容 轻松应对作业/项目高峰。

兼容接口和版本 介绍GeminiDB Influx目前支持的兼容接口和版本。 表1 兼容接口和版本 兼容接口 实例类型 版本 InfluxDB 集群 集群是基于多个节点（至少是三节点）组成。集群的主要特点是横向扩展能力强，能满足不断增长的数据量需求，因此当您对可用性要求较高、数据量较大、未来扩展性要求较高的情况下，推荐您使用集群架构。 单节点 单节点实例只有一个节点，无法保证SLA，建议仅用于测试和功能验证。 1.7，1.8 父主题： 产品介绍

系统管理 系统管理功能概览如表6所示。 表6 系统管理功能概览 功能名称 功能描述 发布区域 应用配置 定义系统的功能构架，支持的类型包括产品、应用、模块、微服务、前端Web及移动App。 支持查询系统中所有API信息。 按模块维护系统功能菜单栏目及菜单中的子页面及按钮对象，包括菜单、按钮需要的API权限。 维护数据字典。 定义参数配置。 华南-广州、华北-北京四 用户权限 管理用户信息，支持添加用户、重置密码等操作。 维护角色拥有的功能权限，管理角色权限对应的用户。 支持给用户授予角色，使其获得角色拥有的功能权限。 管理工厂所属员工信息。 华南-广州、华北-北京四 运维监控 支持记录登录日志、操作日志及文件日志。 华南-广州、华北-北京四 租户管理 支持管理业务租户（二级租户）。 华南-广州、华北-北京四

质量管理 质量管理功能概览如表4所示。 表4 质量管理功能概览 功能名称 功能描述 发布区域 质量计划 维护工单质检方案。 支持查询工单质检单信息以及质检项内容。 华南-广州、华北-北京四 质量检验 支持按质检单完成对产品的质检，记录质检信息，也支持对完成缺陷/故障维修的产品再次进行检验。 提供产品缺陷登记的能力。 提供产品故障现象登记的能力。 支持录入产品维修结果，以及查看产品缺陷故障记录、产品维修记录。 提供对维修失败的产品登记报废的能力。 华南-广州、华北-北京四

制造数据模型管理 制造数据模型管理功能概览如表1所示。 表1 制造数据模型管理功能概览 功能名称 功能描述 发布区域 从这里开始 可参考向导制定一个通用的生产方案。 可参考向导制定一个高阶的生产方案。 华南-广州、华北-北京四 工厂模型 定义公司及公司下的工厂。 建立和维护工厂的虚拟模型，该虚拟模型可以反映出工厂、流水线、工厂地址等信息。 定义公司内部的一个或一组业务独立经营的部门。 管理供应商信息。 管理制造商信息。 管理客户信息。 定义部门信息以及管理部门人员。 华南-广州、华北-北京四 产品模型 对产品、物料等规格信息建立规范的规格编码体系。 维护产品制造BOM信息，包括维护BOM行数据、维护BOM行物料的装配位置以及维护BOM行对应的生产工序及工位。 支持根据Part编码查询BOM多层级树结构。 华南-广州、华北-北京四 工艺模型 定义生产的工序，包括工序组及工序组下的工序。 支持通过图形化的方式定义产品的工艺路线。 维护加工产品的线体的生产能力信息，为生产排产提供参考信息。 管理生产工序的作业指导书。 审核作业指导书的发布请求。 华南-广州、华北-北京四 资源模型 维护指定产品的工艺路线中需要的资源信息，通过配置工序中的资源来定义使用的工治具。 维护资源实物信息。 维护产品在其生产过程中需要操作人员具备的技能。 维护公司级、工厂级、车间级、线体级的班次、通用事件，以及资源的日历信息。 维护资源规格（工治具）信息。 华南-广州、华北-北京四 配方模型 维护在生产工序中设备的参数信息。 维护在生产工序中需要从设备采集的数据。 华南-广州、华北-北京四 质检模型 维护各种故障现象、故障对象、测量方法、故障原因、缺陷及措施。 维护物料的追溯标准。 维护不同产品的质检方案、检验方案和抽样规则。 维护产品质检方案中检验项目的检验结果项。 维护产品质检方案中检验分组的累计规则。 华南-广州、华北-北京四 设备模型 维护设备规格信息。 维护设备实物BOM信息。 华南-广州、华北-北京四 仓储模型 以工厂为维度按仓库-库区-货位的层级维护工厂下的仓库结构及相应的属性。 以工厂为维度维护仓库类型的LookUP值。 华南-广州、华北-北京四 建模工具 以图形化界面的方式灵活定义系统中的编码信息。 管理各类数据描述集合。 记录配置项相关信息。 以图形化界面的方式定义系统所需打印的标签信息。 配置动态属性扩展。 配置全局扩展属性。 华南-广州、华北-北京四

生产管理 生产管理功能概览如表3所示。 表3 生产管理功能概览 功能名称 功能描述 发布区域 生产准备 支持按照线体、工单号显示已派工到线体的工单清单，提供工单开工、打印工单派工信息功能。 支持按工单号、产品条码和标签模板定义打印标签，并记录打印信息。 支持对线体加工工单的批次物料、资源上载或卸载。 支持对生产工单按批量需求进行拆分生成产品条码。 支持对已拆分生成的产品条码进行再次拆分出新的小批料单。 支持导入和查询系统中用于生产消耗的物料信息。 华南-广州、华北-北京四 生产执行 支持执行产品在线体工位上的过站，完成批次物料扣减与序列物料采集绑定。 提供产品返工的能力，支持让产品重新回到已完成的工序步骤上重新过站。 支持对原产品条码所绑定的序列物料条码信息进行替换或者打散。 华南-广州、华北-北京四 生产入库 提供对已完成生产的产品包装的能力，并提供对小包装进行组合包装的能力。 支持对已完成生产的产品进行入库状态的更新。 华南-广州、华北-北京四 生产看板 支持查看工单在各工序上的生产进度（如工序完成数量、在制数量、缺陷数量）。 支持查看产品过站记录和其他交易记录（如维修、故障、缺陷、报废）。 支持按工单或产品追溯所使用的批次物料与序列物料记录。 支持按物料条码反向追溯该物料的使用记录。 华南-广州、华北-北京四

计划管理 计划管理功能概览如表2所示。 表2 计划管理功能概览 功能名称 功能描述 发布区域 工单导入 提供手工导入（录入）、拆分工单、编辑以及查询ERP工单功能。 华南-广州、华北-北京四 工单方案 提供手工录入工单、批量录入工单、工单方案生成、工单方案实例化、工单取消、修改加工区域、查询工单、维护工单工程方案（工艺路线、料、机、人、法）功能。 华南-广州、华北-北京四 计划排产 提供排产保存、一键排产、导出待排产信息、排产调整、取消排产、导出排产结果信息、查询工单排产信息功能。 支持生成物料需求、查询工单物料需求信息。 支持生成生产工具需求、查询工单生产物料信息。 支持冻结工单、解除冻结工单、查询工单冻结信息。 华南-广州、华北-北京四

企业产品数字化转型 企业面对市场需求多样化，生产过程复杂化，产业协作多维化，产品服务数字化，通过数字化技术应对未来世界的不确定性已成为大势所趋。IPD支撑华为持续研发创新和稳定高速发展， CraftArts IPDCenter 作为IPD研发支撑平台核心，是华为产品数字化转型的核心成果，基于元数据理念，围绕产品业务对象进行梳理重构，实现产品全生命周期的数据模型统一，能够满足企业数字化转型的要求。 图1 企业产品数字化转型

安装AI原生应用引擎SDK 执行如下命令，快速安装。 pip install huawei_wiseagent_dev_sdk_python-{version}-py3-none-any.whl 若已经安装过最新版本SDK，可以忽略此步骤。 将${version}替换成实际所使用的SDK版本。 如果采用本地依赖的方式引入SDK，即手动将本地下载的SDK包引入到工程，还需要添加间接依赖：httpx、pydantic、jinja2。

认识Widget包目录结构 解压下载到本地的组件Widget包，认识组件结构。如解压EchartsWidgetTemplate组件包，其目录结构如图2所示。 图2 Widget包目录结构 为了便于描述，对于名称不固定的手册，统一采用“{widget}”来命名。 i18n.json：组件的国际化资源文件，用于配置多语言。例如，messages-zh.json为中文，messages-en.json为英文。 packageinfo.json：组件的元数据描述文件。 {widget}.css：组件的样式文件，在该文件中编写组件的 CSS 样式。 {widget}.editor.js：组件核心渲染文件。组件属性定义文件，负责组件编辑状态时需要渲染的界面和逻辑。 {widget}.flt：组件DOM结构文件，需要在服务端提前渲染的部分可以写在此文件中，相当于HTML文件，负责样式展示。 {widget}.js：组件逻辑文件，整个Widget的渲染核心JS，在组件编辑状态和页面最终的发布运行态都会被加载执行。

配置 在配置中，为图观端场景编辑器设置容器名称和场景地址。 图2 图观端场景编辑器配置 容器名称：设置容器的名称，命名必须唯一。名称是组件的唯一标识，设置后其他3D组件会通过这个标识，识别到这个容器，并在容器上进行渲染。 场景地址：设置渲染的3D场景地址。 选择场景：单击“选择场景”，可以在“场景”中新建场景或选择已有场景，也可以从“案例库”中选择场景。 输入场景URL：直接输入图观的二次开发场景地址。

汇总 汇总组件用于对关联本表单的其他表单中，某些字段数据或记录总数进行数量汇总，即求和。 使用汇总组件，需要存在关联本表单的其他表单。例如，表单A要使用汇总组件，需要先创建一个新表单B，表单B通过关联记录组件关联表单A，才能对表单B的记录做汇总。 在表单开发页面，从“数据组件”中，拖拽“汇总”组件至表单设计区域，如图1。 图1 汇总 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 汇总目标：选择关联本表单的其他要汇总的表单视图。 被汇总字段：被汇总的字段，支持汇总记录总数。 汇总方式：选择字段的汇总方式。 单位：汇总数额的单位，可以设置为中文，也可以设置为英文。 保留小数位数：支持设置精确保留的小数位数。 属性：设置字段属性，勾选“隐藏”后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

全文检索概述 全文检索（或者说文本搜索）提供了查询可读性文档的能力，并且通过查询相关度将结果进行排序。搜索最常见的方式是：找到包含指定查询词的所有记录，并且按照查询顺序返回这些记录。 文本搜索操作符在数据库中已存在多年。 GaussDB (DWS)为文本数据类型提供~、~*、LIKE和ILIKE操作符，但这些操作符缺乏现代信息系统所要求的许多必要属性，不过这一问题可以通过使用索引及词典进行解决。 实时数仓（单机部署）暂不支持全文检索功能。 文本检索缺乏信息系统所要求的必要属性： 没有语义支持，即使是英语也是如此。 要识别派生词并不是那么容易，即使正则表达式也不能满足要求。例如satisfies和satisfy，当使用正则表达式寻找satisfy时，并不会查询到包含satisfies的文档。用户可以使用OR搜索多种派生形式，但过程非常繁琐。并且有些词会有上千的派生词，容易出错。 没有对搜索结果的分类（排序）。当搜索出成千的文档时，查找效率很低。 由于没有索引的支持，每一次的搜索需要遍历所有的文档，整体搜索比较缓慢。 使用全文索引可以对文档进行预处理，并且可以使后续的搜索更快速。预处理过程包括： 将文档解析成token。 为每个文档标记不同类别的token是非常有必要的，例如：数字、文字、复合词、电子邮件地址，这样就可以针对不同类别做不同的处理。原则上token的类别依赖于具体的应用，但对于大多数的应用来说，可以使用一组预定义的token类。 将token转换为词素。 词素像token一样是一个字符串，但它已经标准化处理，这样同一个词的不同形式是一样的。例如，标准化通常包括：将大写字母折成小写字母、删除后缀（如英语中的s或者es）。这将允许通过搜索找到同一个词的不同形式，不需要繁琐地输入所有可能的变形样式。同时，这一步通常会删除停用词。这些停用词通常因为太常见而对搜索无用。（总之，token是文档文本的原片段，而词素被认为是有用的索引和搜索词。）GaussDB(DWS)使用词典执行这一步，且提供了各种标准的词典。 保存搜索优化后的预处理文档。 比如，每个文档可以呈现为标准化词素的有序组合。伴随词素，通常还需要存储词素位置信息以用于邻近排序。因此文档包含的查询词越密集其排序越高。 词典能够对token如何标准化做到细粒度控制。使用合适的词典，可以定义不被索引的停用词。 数据类型tsvector用于存储预处理文档，tsquery用于存储查询条件，详细内容可参见文本搜索类型。为数据类型tsvector提供的函数和操作符可参见文本检索函数和操作符，其中最重要的是匹配运算符@@，请参见基本文本匹配。 父主题： 介绍

EA元模型说明 表1 实体列表 实体中文名 架构分类 说明 组织 业务架构 一个具有共同目标的独立自主的资源单位，可以是公司内的功能单元（如HR、财经等）、业务单元（汽车、火车等）、区域单元（XX代表处等）、法人单位（XX子公司等）等，也可以是公司外的合作伙伴。 角色 业务架构 是一个参与者通常的或预期的行为，或者是特定过程或事件中的某人某物。一个参与者可以扮演多个角色。 参与者 业务架构 是发起活动或参与活动的人、组织或系统。参与者可以是组织内部，也可以是组织外部的。 参与者与角色主要有如下差异： 范围：参与者可以是组织外部的，但角色一般是组织内部的。 关注：参与者更关注利益影响，角色更关注承担的职责或完成特定的任务。 变化：参与者在不同阶段可能发生变化，角色相对更加固定。 价值流 业务架构 价值流是一组端到端的活动集合，能够为用户创造一个有价值的结果，这些活动在建模时用价值流阶段来描述。 业务能力 业务架构 企业为达到特定目的而拥有或交换的一种独特的能力，例如硬件开发、订单管理等。 流程 业务架构 流程是在特定企业环境及资源保障下，为了实现客户价值和企业商业目标而形成的一套规范业务运作规则和机制：即通过一系列可重复、有逻辑顺序的活动，按照相关的政策和业务规则，将一个或多个输入转换成明确的、可度量的、有价值的输出。 主题域 信息架构 联系较为紧密的业务对象的集合。 业务对象 信息架构 指企业重要的人、事、物，承载了业务运作和管理涉及的重要信息。 逻辑数据实体 信息架构 描述业务对象某种业务特征的属性集合。 属性 信息架构 描述业务对象的数据特征，是数据最基本的单元。 数据容器 信息架构 包括一组数据集的逻辑集合或物理集合，可以是集群、数据库、Schema等。 数据集 信息架构 代表了数据的集合，通常指数据库中的表/视图、流处理系统中的流、 数据湖 系统中以文件或文件夹形式存在的数据集合等。 数据集字段 信息架构 数据集中的每一列的特定变量对应一个数据集字段。 数据标准 信息架构 定义组织层面需共同遵守的属性层数据含义和业务规则，是组织层面对某个数据的共同理解，这些理解一旦确定下来，就应作为组织层面的标准在组织内被共同遵守。 业务平台 应用架构 能独立满足业务某种需要，提供给用户使用的可运营的功能和服务的组合，有清晰的业务定位、服务对象和业务范围，有完整的产品团队并对本产品的全生命周期管理负责。 应用 应用架构 应用是支撑特定业务需求而提供的一组紧耦合的功能，可独立开发、构建、部署、发布、升级、运行。 技术组件 技术架构 构成软件系统、应用程序或技术解决方案的单个元素或模块。 父主题： EA元模型介绍

Hive WebHCat接口介绍 以下示例的IP为WebHCat的业务IP，端口为安装时设置的WebHCat HTTP端口。 除“:version”、“status”、“version”、“version/hive”、“version/hadoop”以外，其他API都需要添加user.name参数。 :version(GET) 描述 查询WebHCat支持的返回类型列表。 URL http://www.myserver.com/templeton/:version 参数 表1 :version接口请求参数说明 参数 描述 :version WebHCat版本号（当前必须是v1）。 返回结果 表2 :version接口返回参数说明 参数 描述 responseTypes WebHCat支持的返回类型列表。 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1' status (GET) 描述 获取当前服务器的状态 URL http://www.myserver.com/templeton/v1/status 参数 无 返回结果 表3 status接口返回结果参数说明 参数 描述 status WebHCat连接正常，返回OK。 version 字符串，包含版本号，比如v1。 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/status' version (GET) 描述 获取服务器WebHCat的版本 URL http://www.myserver.com/templeton/v1/version 参数 无 返回结果 表4 version接口返回结果参数说明 参数 描述 supportedVersions 所有支持的版本。 version 当前服务器WebHCat的版本。 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/version' version/hive (GET) 描述 获取服务器Hive的版本 URL http://www.myserver.com/templeton/v1/version/hive 参数 无 返回结果 表5 version/hive接口返回结果说明 参数 描述 module hive version Hive的版本 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/version/hive' version/hadoop (GET) 描述 获取服务器Hadoop的版本 URL http://www.myserver.com/templeton/v1/version/hadoop 参数 无 返回结果 表6 version/hadoop接口返回结果说明 参数 描述 module hadoop version Hadoop的版本 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/version/hadoop' ddl (POST) 描述 执行DDL语句 URL http://www.myserver.com/templeton/v1/ddl 参数 表7 ddl接口请求参数说明 参数 描述 exec 需要执行的HCatalog DDL语句。 group 当DDL是创建表时，创建表使用的用户组。 permissions 当DDL是创建表时，创建表使用的权限，格式为rwxr-xr-x。 返回结果 表8 ddl接口返回结果说明 参数 描述 stdout HCatalog执行时的标准输出值，可能为空。 stderr HCatalog执行时的错误输出，可能为空。 exitcode HCatalog的返回值。 例子 curl -i -u : --negotiate -d exec="show tables" 'http://10.64.35.144:9111/templeton/v1/ddl?user.name=user1' ddl/database (GET) 描述 列出所有的数据库 URL http://www.myserver.com/templeton/v1/ddl/database 参数 表9 ddl/database接口请求参数说明 参数 描述 like 用来匹配数据库名的正则表达式。 返回结果 表10 ddl/database接口返回结果说明 参数 描述 databases 数据库名 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/ddl/database?user.name=user1' ddl/database/:db (GET) 描述 获取指定数据库的详细信息 URL http://www.myserver.com/templeton/v1/ddl/database/:db 参数 参数 描述 :db 数据库名 返回结果 参数 描述 location 数据库位置 comment 数据库的备注，如果没有备注则不存在 database 数据库名 owner 数据库的所有者 owertype 数据库所有者的类型 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/ddl/database/default?user.name=user1' ddl/database/:db (PUT) 描述 创建数据库 URL http://www.myserver.com/templeton/v1/ddl/database/:db 参数 参数 描述 :db 数据库名 group 创建数据库时使用的用户组 permission 创建数据库时使用的权限 location 数据库的位置 comment 数据库的备注，比如描述 properties 数据库属性 返回结果 参数 描述 database 新创建的数据库的名字 例子 curl -i -u : --negotiate -X PUT -HContent-type:application/json -d '{"location": "/tmp/a", "comment": "my db", "properties": {"a": "b"}}' 'http://10.64.35.144:9111/templeton/v1/ddl/database/db2?user.name=user1' ddl/database/:db (DELETE) 描述 删除数据库 URL http://www.myserver.com/templeton/v1/ddl/database/:db 参数 参数 描述 :db 数据库名 ifExists 如果指定数据库不存在，Hive会返回错误，除非设置了ifExists为true。 option 将参数设置成cascade或者restrict。如果选择cascade，将清除一切，包括数据和定义。如果选择restrict，表格内容为空，模式也将不存在。 返回结果 参数 描述 database 删除的数据库名字 例子 curl -i -u : --negotiate -X DELETE 'http://10.64.35.144:9111/templeton/v1/ddl/database/db3?ifExists=true&user.name=user1' ddl/database/:db/table (GET) 描述 列出数据库下的所有表 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table 参数 参数 描述 :db 数据库名 like 用来匹配表名的正则表达式 返回结果 参数 描述 database 数据库名字 tables 数据库下表名列表 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/ddl/database/default/table?user.name=user1' ddl/database/:db/table/:table (GET) 描述 获取表的详细信息 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table 参数 参数 描述 :db 数据库名 :table 表名 format 格式：format=extended，参考额外信息（“table extended like”）。 返回结果 参数 描述 columns 列名和类型 database 数据库名 table 表名 partitioned 是否分区表，只有extended下才会显示。 location 表的位置，只有extended下才会显示。 outputformat 输出形式，只有extended下才会显示。 inputformat 输入形式，只有extended下才会显示。 owner 表的属主，只有extended下才会显示。 partitionColumns 分区的列，只有extended下才会显示。 例子 curl -i -u : --negotiate 'http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1?format=extended&user.name=user1' ddl/database/:db/table/:table (PUT) 描述 创建表 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table 参数 参数 描述 :db 数据库名 :table 新建表名 group 创建表时使用的用户组 permissions 创建表时使用的权限 external 指定位置，hive不使用表的默认位置。 ifNotExists 设置为true，当表存在时不会报错。 comment 备注 columns 列描述，包括列名，类型和可选备注。 partitionedBy 分区列描述，用于划分表格。参数columns列出了列名，类型和可选备注。 clusteredBy 分桶列描述，参数包括columnNames、sortedBy、和numberOfBuckets。参数columnNames包括columnName和排列顺序（ASC为升序，DESC为降序）。 format 存储格式，参数包括rowFormat，storedAs，和storedBy。 location HDFS路径 tableProperties 表属性和属性值（name-value对） 返回结果 参数 描述 database 数据库名 table 表名 例子 curl -i -u : --negotiate -X PUT -HContent-type:application/json -d '{"columns": [{"name": "id", "type": "int"}, {"name": "name","type": "string"}], "comment": "hello","format": {"storedAs": "orc"} }' 'http://10.64.35.144:9111/templeton/v1/ddl/database/db3/table/tbl1?user.name=user1' ddl/database/:db/table/:table (POST) 描述 重命名表 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table 参数 参数 描述 :db 数据库名 :table 已有表名 rename 新表表名 返回结果 参数 描述 database 数据库名 table 新表表名 例子 curl -i -u : --negotiate -d rename=table1 'http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/tbl1?user.name=user1' ddl/database/:db/table/:table (DELETE) 描述 删除表 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table 参数 参数 描述 :db 数据库名 :table 表名 ifExists 当设置为true时，不报错。 返回结果 参数 描述 database 数据库名 table 表名 例子 curl -i -u : --negotiate -X DELETE 'http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/table2?ifExists=true&user.name=user1' ddl/database/:db/table/:existingtable/like/:newtable (PUT) 描述 创建一张和已经存在的表一样的表 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:existingtable/like/:newtable 参数 参数 描述 :db 数据库名 :existingtable 已有表名 :newtable 新表名 group 创建表时使用的用户组。 permissions 创建表时使用的权限。 external 指定位置，hive不使用表的默认位置。 ifNotExists 当设置为true时，如果表已经存在，Hive不报错。 location HDFS路径 返回结果 参数 描述 database 数据库名 table 表名 例子 curl -i -u : --negotiate -X PUT -HContent-type:application/json -d '{"ifNotExists": "true"}' 'http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1/like/tt1?user.name=user1' ddl/database/:db/table/:table/partition(GET) 描述 列出表的分区信息 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/partition 参数 参数 描述 :db 数据库名 :table 表名 返回结果 参数 描述 database 数据库名 table 表名 partitions 分区属性值和分区名 例子 curl -i -u : --negotiate http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/x1/partition?user.name=user1 ddl/database/:db/table/:table/partition/:partition(GET) 描述 列出表的某个具体分区的信息 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/partition/:partition 参数 参数 描述 :db 数据库名 :table 表名 :partition 分区名，解码http引用时，需当心。比如country=%27algeria%27。 返回结果 参数 描述 database 数据库名 table 表名 partition 分区名 partitioned 如果设置为true，为分区表 location 表的存储路径 outputFormat 输出格式 columns 列名，类型，备注 owner 所有者 partitionColumns 分区的列 inputFormat 输入格式 totalNumberFiles 分区下文件个数 totalFileSize 分区下文件总大小 maxFileSize 最大文件大小 minFileSize 最小文件大小 lastAccessTime 最后访问时间 lastUpdateTime 最后更新时间 例子 curl -i -u : --negotiate http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/x1/partition/dt=1?user.name=user1 ddl/database/:db/table/:table/partition/:partition(PUT) 描述 增加一个表分区 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/partition/:partition 参数 参数 描述 :db 数据库名。 :table 表名。 group 创建新分区时使用的用户组。 permissions 创建新分区时用户的权限。 location 新分区的存放位置。 ifNotExists 如果设置为true， 当分区已经存在，系统报错。 返回结果 参数 描述 database 数据库名 table 表名 partitions 分区名 例子 curl -i -u : --negotiate -X PUT -HContent-type:application/json -d '{}' http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/x1/partition/dt=10?user.name=user1 ddl/database/:db/table/:table/partition/:partition(DELETE) 描述 删除一个表分区 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/partition/:partition 参数 参数 描述 :db 数据库名。 :table 表名。 group 删除新分区时使用的用户组。 permissions 删除新分区时用户的权限， 格式为rwxrw-r-x。 ifExists 如果指定分区不存在，Hive报错。参数值设置为true除外。 返回结果 参数 描述 database 数据库名 table 表名 partitions 分区名 例子 curl -i -u : --negotiate -X DELETE -HContent-type:application/json -d '{}' http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/x1/partition/dt=10?user.name=user1 ddl/database/:db/table/:table/column(GET) 描述 获取表的column列表 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/column 参数 参数 描述 :db 数据库名 :table 表名 返回结果 参数 描述 database 数据库名 table 表名 columns 列名字和类型 例子 curl -i -u : --negotiate http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1/column?user.name=user1 ddl/database/:db/table/:table/column/:column(GET) 描述 获取表的某个具体的column的信息 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/column/:column 参数 参数 描述 :db 数据库名 :table 表名 :column 列名 返回结果 参数 描述 database 数据库名 table 表名 column 列名字和类型 例子 curl -i -u : --negotiate http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1/column/id?user.name=user1 ddl/database/:db/table/:table/column/:column(PUT) 描述 增加表的一列 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/column/:column 参数 参数 描述 :db 数据库名 :table 表名 :column 列名 type 列类型，比如string和int comment 列备注，比如描述 返回结果 参数 描述 database 数据库名 table 表名 column 列名 例子 curl -i -u : --negotiate -X PUT -HContent-type:application/json -d '{"type": "string", "comment": "new column"}' http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1/column/name?user.name=user1 ddl/database/:db/table/:table/property(GET) 描述 获取表的property URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/property 参数 参数 描述 :db 数据库名 :table 表名 返回结果 参数 描述 database 数据库名 table 表名 properties 属性列表 例子 curl -i -u : --negotiate http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1/property?user.name=user1 ddl/database/:db/table/:table/property/:property(GET) 描述 获取表的某个具体的property的值 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/property/:property 参数 参数 描述 :db 数据库名 :table 表名 :property 属性名 返回结果 参数 描述 database 数据库名 table 表名 property 属性列表 例子 curl -i -u : --negotiate http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1/property/last_modified_by?user.name=user1 ddl/database/:db/table/:table/property/:property(PUT) 描述 增加表的property的值 URL http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table/property/:property 参数 参数 描述 :db 数据库名 :table 表名 :property 属性名 value 属性值 返回结果 参数 描述 database 数据库名 table 表名 property 属性名 例子 curl -i -u : --negotiate -X PUT -HContent-type:application/json -d '{"value": "my value"}' http://10.64.35.144:9111/templeton/v1/ddl/database/default/table/t1/property/mykey?user.name=user1 mapreduce/jar(POST) 描述 执行MR任务，在执行之前，需要将MR的jar包上传到HDFS中 URL http://www.myserver.com/templeton/v1/mapreduce/jar 参数 参数 描述 jar 需要执行的MR的jar包。 class 需要执行的MR的分类。 libjars 需要加入的classpath的jar包名，以逗号分隔。 files 需要复制到集群的文件名，以逗号分隔。 arg Main类接受的输入参数。 define 设置hadoop的配置，格式为：define=NAME=VALUE。 statusdir WebHCat会将执行的MR任务的状态写入到statusdir中。如果设置了这个值，那么需要用户手动进行删除。 enablelog 如果statusdir设置，enablelog设置为true，收集Hadoop任务配置和日志到$statusdir/logs。此后，成功和失败的尝试，都将记录进日志。$statusdir/logs下，子目录布局为： logs/$job_id (directory for $job_id) logs/$job_id/job.xml.html logs/$job_id/$attempt_id (directory for $attempt_id) logs/$job_id/$attempt_id/stderr logs/$job_id/$attempt_id/stdout logs/$job_id/$attempt_id/syslog 仅支持Hadoop 1.X。 callback 在MR任务执行完的回调地址，使用$jobId，将任务ID嵌入回调地址。在回调地址中，任务ID替换该$jobId。 返回结果 参数 描述 id 任务ID，类似“job_201110132141_0001” 例子 curl -i -u : --negotiate -d jar="/tmp/word.count-0.0.1-SNAPSHOT.jar" -d class=com.huawei.word.count.WD -d statusdir="/output" "http://10.64.35.144:9111/templeton/v1/mapreduce/jar?user.name=user1" mapreduce/streaming(POST) 描述 以Streaming方式提交MR任务 URL http://www.myserver.com/templeton/v1/mapreduce/streaming 参数 参数 描述 input Hadoop中input的路径。 output 存储output的路径。如没有规定，WebHCat将output储存在使用队列资源可以发现到的路径。 mapper mapper程序位置。 reducer reducer程序位置。 files HDFS文件添加到分布式缓存中。 arg 设置argument。 define 设置hadoop的配置变量，格式：define=NAME=VALUE cmdenv 设置环境变量，格式：cmdenv=NAME=VALUE statusdir WebHCat会将执行的MR任务的状态写入到statusdir中。如果设置了这个值，那么需要用户手动进行删除。 enablelog 如果statusdir设置，enablelog设置为true，收集Hadoop任务配置和日志到$statusdir/logs。此后，成功和失败的尝试，都将记录进日志。$statusdir/logs下，子目录布局为： logs/$job_id (directory for $job_id) logs/$job_id/job.xml.html logs/$job_id/$attempt_id (directory for $attempt_id) logs/$job_id/$attempt_id/stderr logs/$job_id/$attempt_id/stdout logs/$job_id/$attempt_id/syslog 仅支持Hadoop 1.X。 callback 在MR任务执行完的回调地址，使用$jobId，将任务ID嵌入回调地址。在回调地址中，任务ID将替换该$jobId。 返回结果 参数 描述 id 任务ID，类似job_201110132141_0001 例子 curl -i -u : --negotiate -d input=/input -d output=/oooo -d mapper=/bin/cat -d reducer="/usr/bin/wc -w" -d statusdir="/output" 'http://10.64.35.144:9111/templeton/v1/mapreduce/streaming?user.name=user1' 本接口的使用需要前置条件，请参阅“开发规范”中的Hive规则。 /hive(POST) 描述 执行Hive命令 URL http://www.myserver.com/templeton/v1/hive 参数 参数 描述 execute hive命令，包含整个和短的Hive命令。 file 包含hive命令的HDFS文件。 files 需要复制到集群的文件名，以逗号分隔。 arg 设置argument。 define 设置Hive的配置，格式：define=key=value，如果使用多实例，需要配置实例的scratch dir，如WebHCat实例使用define=hive.exec.scratchdir=/tmp/hive-scratch，WebHCat1实例使用define=hive.exec.scratchdir=/tmp/hive1-scratch，以此类推。 statusdir WebHCat会将执行的MR任务的状态写入到statusdir中。如果设置了这个值，那么需要用户手动进行删除。 enablelog 如果statusdir设置，enablelog设置为true，收集Hadoop任务配置和日志到$statusdir/logs。此后，成功和失败的尝试，都将记录进日志。$statusdir/logs下，子目录布局为： logs/$job_id (directory for $job_id) logs/$job_id/job.xml.html logs/$job_id/$attempt_id (directory for $attempt_id) logs/$job_id/$attempt_id/stderr logs/$job_id/$attempt_id/stdout logs/$job_id/$attempt_id/syslog callback 在MR任务执行完的回调地址，使用$jobId，将任务ID嵌入回调地址。在回调地址中，任务ID将替换该$jobId。 返回结果 参数 描述 id 任务ID，类似job_201110132141_0001 例子 curl -i -u : --negotiate -d execute="select count(*) from t1" -d statusdir="/output" -d define=hive.exec.scratchdir=/tmp/hive-scratch "http://10.64.35.144:9111/templeton/v1/hive?user.name=user1" jobs(GET) 描述 获取所有的job id URL http://www.myserver.com/templeton/v1/jobs 参数 参数 描述 fields 如果设置成*，那么会返回每个job的详细信息。如果没设置，只返回任务ID。现在只能设置成*，如设置成其他值，将出现异常。 jobid 如果设置了jobid，那么只有字典顺序比jobid大的job才会返回。比如，如果jobid为"job_201312091733_0001"，只有大于该值的job才能返回。返回的job的个数，取决于numrecords。 numrecords 如果设置了numrecords和jobid，jobid列表按字典顺序排列，待jobid返回后，可以得到numrecords的最大值。如果jobid没有设置， 而numrecords设置了参数值，jobid按字典顺序排列后，可以得到numrecords的最大值。相反，如果numrecords没有设置，而jobid设置了参数值，所有大于jobid的job都将返回。 showall 如果设置为true，用户可以获取所有job，如果设置为false，则只获取当前用户提交的job。默认为false。 返回结果 参数 描述 id Job id detail 如果showall为true，那么显示detail信息，否则为null。 例子 curl -i -u : --negotiate "http://10.64.35.144:9111/templeton/v1/jobs?user.name=user1" jobs/:jobid(GET) 描述 获取指定job的信息 URL http://www.myserver.com/templeton/v1/jobs/:jobid 参数 参数 描述 jobid Job创建后的Jobid 返回结果 参数 描述 status 包含job状态信息的json对象。 profile 包含job状态的json对象。WebHCat解析JobProfile对象中的信息，该对象因Hadoop版本不同而不同。 id Job的id。 percentComplete 完成百分比，比如75% complete，如果完成后则为null。 user 创建job的用户。 callback 回调URL（如果有）。 userargs 用户提交job时的argument参数和参数值。 exitValue job退出值。 例子 curl -i -u : --negotiate "http://10.64.35.144:9111/templeton/v1/jobs/job_1440386556001_0255?user.name=user1" jobs/:jobid(DELETE) 描述 kill任务 URL http://www.myserver.com/templeton/v1/jobs/:jobid 参数 参数 描述 :jobid 删除的Job的ID 返回结果 参数 描述 user 提交Job的用户。 status 包含Job状态信息的JSON对象。 profile 包含Job信息的JSON对象。WebHCat解析JobProfile对象中的信息，该对象因Hadoop版本不同而不同。 id Job的ID。 callback 回调的URL（如果有）。 例子 curl -i -u : --negotiate -X DELETE "http://10.64.35.143:9111/templeton/v1/jobs/job_1440386556001_0265?user.name=user1" 父主题： Hive对外接口介绍