云服务器内容精选

  • 数据库有数据,但是接口返回0是什么原因? 可能原因如下: “rdmextentiontype”参数值有误。请检查“rdmextentiontype”是否有值。如果有,该值是否正确。“rdmextentiontype”参数值为模型项英文名称。 “rdmdeleteflag”参数值为0或空。“rdmdeleteflag”表示软删除标识,工业数字模型驱动引擎-数据建模引擎(xDM Foundation,简称xDM-F)提供的所有原子接口均不查询和返回软删除的数据。 查询条件不对。 父主题: 全量数据服务API相关问题
  • API返回数据规格 数据服务适用于小批量数据的快速响应交互场景,不适用于将大量数据通过API的方式返回。当前通过数据服务API返回数据的规格如下表所示。 表5 API的返回数据条数限制 API分类 使用场景 数据源 默认规格(条) 配置类API 调试API DLI /MySQL/RDS/DWS 10 调用API DLI/MySQL/RDS/DWS 100 脚本类API 测试SQL - 10 调试API DLI 默认分页:100 自定义分页:1000 MySQL/RDS/DWS 默认分页:10 自定义分页:2000 调用API DLI 默认分页:100 自定义分页:1000 MySQL/RDS/DWS 默认分页:10 自定义分页:2000
  • 共享版规格 数据服务共享版无具体的规格指标,在表3中给出了用户创建和使用API的相关配额说明。 如果您需要修改默认限制值,请参考如何申请扩大配额。 表3 数据服务使用限制明细 限制项 默认限制 能否修改 API分组数量 每个用户最多创建50个API分组。 √ API数量 每个用户最多创建200个API。 √ 后端策略数量 每个用户最多创建5个后端策略。 √ 应用数量 每个用户最多创建50个应用。应用配额包括用户自行创建的应用和API市场购买API生成的应用。 √ 流控策略数量 每个用户最多创建30个流控策略。 用户流量限制不超过API流量限制。 应用流量限制不超过用户流量限制。 源IP流量限制不超过API流量限制。 √ 访问控制策略数量 每个用户最多可以创建100个访问控制策略。 √ VPC通道数量 每个用户最多创建30个VPC通道。 √ 变量数量 每个分组在任意一个环境中,最多创建50个变量。 √ 弹性云服务器数量 每个VPC通道最多添加200个弹性云服务器。 √ 参数数量 每个API最多创建50个参数。 √ 发布历史数量 同一个API在每个环境中最多记录10条最新的发布历史。 √ 每个API的访问频率 不超过200次/秒。 √ 特殊应用 阈值不超过API流量限制值。 x 子 域名 访问次数 每个子域名每天最多可以访问1000次。 x 调用请求包的大小 API每次最大可以调用12M的请求包 x TLS协议 支持TLS1.1和TLS1.2,推荐使用TLS1.2。 x 实名认证 未实名认证的用户,无法进行任何的创建操作。 x
  • 共享版与专享版对比 数据服务当前提供共享版与专享版两种服务方式。其中共享版数据服务即开即用但仅限于存量用户调测使用,专享版数据服务需要购买专享版集群增量包并在集群中管理API。 数据服务共享版当前仅限于华东-上海一、华北-北京四、华南-广州的存量用户调测使用,受限于服务稳定性和生命周期策略,不建议用于生产环境。 专享版数据服务常用于企业内部系统解耦,各服务部署在云上的VPC内,服务之间以RESTful API方式通信,通信链路在VPC内部进行,网络安全得到进一步保障。同时专享版实例支持前端或后端服务部署在公有网络,通过绑定弹性公网IP实现网络交互。 表1 共享版与专享版数据服务差异 差异项 共享版 专享版 计费 - 根据集群规格按包年包月计费。 按照API使用额度计费:每个工作空间具有10个API免费试用额度,超过试用配额每天每个API按1元收费。 网络访问 公网访问。 实例运行在虚拟私有云(VPC)中,在VPC内,使用实例子网地址调用API。 可通过开启公网入口与出口访问,允许外部服务调用API,及后端部署在外部网络环境中。 云市场售卖 API可在云市场公开售卖。 不支持将API上架到云市场公开售卖。 使用对象 小型用户。 物理隔离要求较低,能够开箱即用,快速实现API能力开放。 中大型用户。 专享版数据服务拥有物理隔离的独立集群, 更丰富的特性。 满足内部API调用跟API开放,独立的出、入网带宽选择。 数据服务的共享版与专享版在功能上的异同点如下表所示。 表2 共享版与专享版数据服务功能差异 规格分类 规格描述 共享版 专享版 基本功能 精细化流控策略 30个 500个 IP&用户访问控制 √ √ 安全认证 √ √ API生命周期管理 √ √ 自定义域名 √ √ Excel导入导出 √ √ 支持VPC通道 √ √ API参数编排-配置方式 √ √ API参数编排-脚本方式 √ √ API参数编排-MyBatis方式 × √ API编排 × √ 注册现有API √ × 返回总条数 × √ API分组变量管理 √ √ 高级功能 自定义认证 √ √ 创建应用 50个 1000个 支持对接API云市场 √ × 支持协议 HTTP或HTTPS HTTPS 支持API策略路由 √ √ 运维分析展示 √ √ 支持后端负载均衡 × √ 支持内部API管理 × √ 后端支持对接私有云 × √ 支持对接专线服务 × √ 性能指标 独立物理多租集群 × √ 出、入网带宽独立 × √ 推荐每秒请求次数 200TPS 8000-30000TPS
  • 操作场景 当您发布数据模型和发布应用后,系统会在全量数据服务中预生成与其相应的API,您可以在应用设计态预览各类API的详细信息。 支持通过如下方式进行查看: 离线方式:将应用设计态的全量数据服务API导出至本地计算机进行查看(推荐),具体操作请参见导出API。 在线方式:在应用设计态上在线查看。 如需查看应用完整的全量数据服务API,需将应用部署至数据建模引擎后,前往应用运行态查看,具体操作请参见部署应用和全量数据服务。
  • 使用流程 进入“生成器配置”页签,创建ID标识器,即建立一个满足业务需求的编码发生器。 创建ID标识器前,需要添加生成器分类和生成器标签,生成器名称及代码系统自动生成。 生成器分类:支持创建一种业务分类,例如生成的编码是文档编码、零件编号或生产批次等。 生成器标签:为生成器建立编码标签,例如上文中的文档,是属于工程文档、测试说明,还是财经报告、法律条文等,添加一个可辨识、搜索的标签。 ID标识器任务创建完成后,通过拖拉拽在画布中添加“构件”,并设置构件的运行属性,设置完成后发布生效。 编码生成器由4个部分构件组成,固定字符+对象编码+日期代码+流水序列。其中流水序列是必选部分,没有该部分,无法对外生成编码。 添加构件时,若添加“对象编码”构件,则需要设置业务对象属性。例如部件编码组成包含对内型号、小类代码等属性,此时就需要在“业务对象属性”中单独添加属性,并设置“业务对象类属性代码”(属性值、唯一值)。编码生成时就会包含自定义添加的属性值。 通过接口调用使用,应用于系统或程序中,生成业务编码。
  • 创建ID标识器 创建任务 进入“生成器配置”页签,单击。 在弹出的界面中设置如下信息: 生成器代码:由系统自动生成,系统唯一值。 生成器名称:生成器的名称,系统默认填充“生成器代码”的取值。 生成器分类:数据来源于生成器分类。 生成器标签:数据来源于生成器标签。 填写完成后,单击“确定”。 添加构件 将需要的“构件”从顶部的构件列表中拖入中间的画布区域。 图1 添加构件 “流水序列”构件为必选,没有流水序列,无法对外生成编码。 单击构件,设置构件属性。 表3 构件属性 构件 说明 ID生成器 生成器代码:系统自动生成,系统唯一值 生成器名称:生成器的名称,系统默认填充“生成器代码”的取值 生成器分类:自定义分类,数据来源于生成器分类 总目标长度:生成器条码总长度 流水分组规则:系统自动生成 格式预览:生成器条码内容 备注:填写自定义备注信息 固定字符 构件代码:由系统自动生成,系统唯一值 构件名称:默认为固定字符串,支持修改 固定值:编码中自定义的固定值,如ABC、001等 目标长度:固定值的长度 是否属于流水分组标识:是否开启编码生成的预览效果,默认开启 是否作为组装元素输出:是否使用该规则,默认开启 对象编码 业务属性取值 业务属性:数据来源于业务对象属性 属性初始值:数据来源于“业务对象属性”中的“默认值” 目标长度:根据预览值计算的长度 预览值:“属性初始值”经过数据处理后的最终数值 数据处理逻辑 数据处理方法:支持大小写转换、长度填补、顺序反转、字符串截取、增加前缀、增加后缀。(例如大小写转换,支持设置为“全转大写”,即编码中的小写字母全部转换成大写) 构件显示属性 构件名称:默认为对象编码,支持修改 构件代码:由系统自动生成,系统唯一值 是否属于流水分组标识:是否开启编码生成的预览效果,默认开启 是否作为组装元素输出:是否使用该规则,默认开启 日期代码 时间代码属性:设置日期样式,选项如下 时间年月日时分秒yyyMddHHmmss 时间年月日yyyyMdd 时间年月yyyyMM 时间时分秒HHmmss 自选定组合 日期格式:设置年份显示样式,显示为2位数字或4位数字,例如24或2024 预览值:选定日期后,自动生成预览值 目标长度:预览值长度 初始值:根据“时间代码属性”生成的值,例如202406 构件代码:由系统自动生成,系统唯一值 构件名称:默认为日期代码,支持修改 是否属于流水分组标识:是否开启编码生成的预览效果,默认开启 是否作为组装元素输出:是否使用该规则,默认开启 流水序列 流水码类别:当前仅支持数字流水 目标长度:数字流水值的长度,取值范围1-10 最小值:根据目标长度和进制规则确认最小值 最大值:根据目标长度和进制规则确认最大值 增减方式:目前仅支持增量 间隔量(十进制):默认为1 进制规则:十进制、可配置字符进制,其中34进制字符集不勾选O和I 周期重置模式:可选值从不、每日、每周、每月、每年 预览值:最小值经过进制转换后的最终数值 构件代码:由系统自动生成,系统唯一值 构件名称:默认为流水序号,支持修改 是否作为组装元素输出:是否使用该规则,默认开启 说明: 流水序列递增规则: 如果纯数字,会从最小值递增到最大值,例如:最小值是1最大值是9999,则初始的第一个流水序列码是0001,然后往上递增加1,变为0002,0003。 如果是数字加字母形式,会从最小值递增到最大值,例如,最小值是1,最大值是ZZZZ,在同一个位数上,先是数字递增,然后再到字母递增。则初始的第一个流水序列码是0001,然后往上递增加1,变为0002,0003,到了0009的时候再递增是000A,000B,000C,到了000Z后再递增是0010。 设置完成后单击“操作”列表中的“发布”。 操作过程中您也可以进行重置、还原、复制等操作。
  • 业务对象属性 添加编码构件后,需要创建业务对象,并设置业务对象属性。业务对象添加后可应用于编码当中,作为编码的组成部分。 添加业务对象 进入“业务对象属性”页签。 单击“添加”。 在弹出的“添加业务对象”窗口中,设置如下信息: 应用名称:业务对象的应用名称。 应用类名称:业务对象的应用类名称。 应用类代码:业务对象的应用类代码,默认为“应用类名称”取值。 应用类描述:业务对象的应用类描述。 参考对象表:业务对象参考对象表。 参考的数据源名称:业务对象参考的数据源名称。 设置完成后,单击“保存”。 添加业务对象属性 选择已添加的业务对象,单击“操作”列中的“添加”。 在弹出的“添加业务对象属性”窗口中,设置如下信息: 业务对象:数据来源于业务对象。 业务对象类属性代码:业务对象属性的代码,系统唯一值。 业务对象类属性名称:业务对象属性的名称。 数据类型:业务对象属性的数据类型。 取值范围:varchar(字符);number(数字);date(日期)。 默认值:业务对象属性的默认值。 业务对象类属性描述:业务对象属性的描述。 备注:业务对象属性的备注。 设置完成后,单击“保存”。
  • 功能简介 编码发生器是一种用于生成一定长度的随机编码的工具。这些编码通常由数字、字母或符号组成,具有一定的随机性和唯一性,可以用于各种需要标识唯一性的场合,如订单号、会员号、优惠券码等。 编码发生器可以根据不同的需求和规则生成不同类型的编码,如固定长度、可变长度、指定字符集、不重复等。同时,编码发生器还可以支持批量生成和自定义前缀、后缀等功能,方便快捷地生成大量的编码。 在实际应用中,编码发生器通常与数据库或缓存系统结合使用,用于生成唯一的标识符,以便于管理和查询。
  • 请求示例 示例背景 已在设计态构建一个名称为“employee”的数据实体,该实体自定义了“age”和“gender”两个属性,并完成了实体发布、应用发布和应用部署。 已在运行态通过控制台或API的方式创建多个 数据实例 。 需要查询“gender”为“男性”的数据实例,且结果需要先按名称倒序排序,再按年龄倒序排序。 示例代码 { "params": { "sorts": [ { "sort": "DESC", "orderBy": "name" }, { "sort": "DESC", "orderBy": "age" } ], "filter": { "joiner": "and", "conditions": [ { "conditionName": "gender", "operator": "=", "conditionValues": [ "男" ] } ] }, "isNeedTotal": true } }
  • 响应示例 { "result": "SUC CES S", "data": [ { "id": "455304645330341888", "creator": "test1 3c03e719256a427eb9277b64fcXXXXXX", "createTime": "2023-01-13T01:38:07.000+00:00", "modifier": "test1 3c03e719256a427eb9277b64fcXXXXXX", "lastUpdateTime": "2023-01-13T01:38:07.000+00:00", "rdmVersion": 1, "rdmExtensionType": "People", "rdmDeleteFlag": 0, "tenant": { "id": "-1", "clazz": "Tenant" }, "className": "People", "name": "李四", "description": null, "kiaguid": null, "securityLevel": "internal", "gender": "男", "age": 20 }, { "id": "455304534248394752", "creator": "test1 3c03e719256a427eb9277b64fcXXXXXX", "createTime": "2023-01-13T01:37:40.000+00:00", "modifier": "test1 3c03e719256a427eb9277b64fcXXXXXX", "lastUpdateTime": "2023-01-13T01:37:40.000+00:00", "rdmVersion": 1, "rdmExtensionType": "People", "rdmDeleteFlag": 0, "tenant": { "id": "-1", "clazz": "Tenant" }, "className": "People", "name": "张三", "description": null, "kiaguid": null, "securityLevel": "internal", "gender": "男", "age": 18 } ], "errors": [], "pageInfo": { "curPage": 1, "pageSize": 20, "totalRows": 2, "totalPages": 1 } }
  • 请求参数 根据实体类型、功能的不同,请求body参数不同,您可以在全量数据服务查看API具体参数。为篇幅起见,这里只展示部分内容。 表2 请求body参数 参数 是否必填 参数类型 描述 sorts 否 List 排序。 sort 否 String 排序方式(asc/desc)。 orderBy 否 String 排序字段,可填写模型自身属性、参考对象的属性、扩展属性及分类属性。 filter 否 Object 查询条件。 isNeedTotal 否 Boolean 是否需要查询总记录数(false/true)。
  • URI URI格式: POST http://{Endpoint}/rdm_{appID}_app/services/dynamic/api/{entityName}/find/{pageSize}/{curPage} 参数说明: 表1 URI参数说明 参数 是否必填 参数类型 描述 Endpoint 是 String 承载REST服务端点的服务器域名或IP地址。 appID 是 String 应用ID。 entityName 是 String 实体的英文名称。 pageSize 否 String 分页查询时,每页最多展示的记录数。 curPage 否 String 分页查询的页数。
  • 约束与限制 对于数据服务共享版 IAM 认证方式的API,系统已默认记录了当前账号的白名单,不支持删除,因此共享版IAM认证方式的API无需进行授权即可进行调用。而专享版中使用IAM认证方式的API则必须先通过应用或白名单授权才能调用。 申请API授权时,仅支持通过应用授权的方式,暂不支持白名单授权方式。 APP认证方式的API只能授权给APP类型的应用。 IAM认证方式的API只能授权给IAM类型的应用。
  • 操作场景 DataArts Studio 数据服务的API流量控制基于指定规则对API的访问流量进行调节控制的限流策略,能够提供多种维度的后端服务保护功能。当前API流控支持通过用户、应用和时间段等不同维度限制API的调用次数。 为了提供持续稳定的服务,您需要通过创建并选择流控策略,针对部分API进行流量控制。流控策略和API本身是相互独立的,只有将流控策略绑定API后,流控策略才对绑定的API生效。 同一个环境中一个API只能被一个流控策略绑定,一个流控策略可以绑定多个API。