OpenAPI能够提供灵活多样的功能,是所有模块都要提供的标准能力,需购买对应功能模块的OpenAPI后方可使用。本文为您介绍OpenAPI支持的功能。
说明
- 从V4.5版本开始,为了提高OpenAPI的整体质量,Dataphin对存量OpenAPI进行治理,同时对新上线的OpenAPI提出新标准,将新接口的OpenAPI存放在 - com.aliyuncs.dataphin_public.model包中,即SDK2.0;同时V4.4版本及其之前的老接口OpenAPI仍存放在- com.aliyuncs.dataphin.model包中,即SDK1.0。
- 本篇OpenAPI即为SDK1.0,新OpenAPI(即SDK2.0)请参见OpenAPI门户。 
运维
通过该API模块,用户可以构建个性化的运维工具,通过API可以完成节点及实例的相关操作,同时可以获取Dataphin的告警事件及告警消息。
目前开放的API主要针对离线脚本任务和管道集成任务。规范建模相关的任务运维的API暂未开放。
| API(旧接口) | API(新接口) | API说明 | 
| 实例运维 | ||
| GetInstanceDownstream | - | 根据起始的实例查询该实例的下游。 | 
| GetPhysicalInstanceLog | - | 获取实例执行的日志,如果实例重跑了多次,则会有多条日志。 | 
| GetScriptInstance | - | 查询脚本的实例信息,包括实例状态,运行时间等信息。 | 
| InstanceFixData | - | 重跑下游(修复链路数据),支持强制重跑下游影响范围: 
 | 
| ListNormalInstance | - | 根据指定的查询条件获取实例的分页列表,实例类型包含周期实例手动实例。 | 
| OperateBatchInstance | - | 
 实例支持的运维操作有: 
 重跑下游操作请使用InstanceFixData。 | 
| OperateInstance | - | (推荐使用新接口OperateBatchInstanceRequest) 对实例进行运维操作,可操作的命令包含: 
 其中重跑及重跑下游会产生运行任务的额外费用。 | 
| 任务运维 | ||
| ListSupplementDagrun | - | 根据查询条件列出补数据工作流下的每一个业务日期对应的DagRun信息。 | 
| ListSupplementInstance | - | 列出补数据工作流下具体一个业务日期的所有节点的实例。 | 
| QueryInstanceUpDownStream | - | 查询实例的上下游,支持逻辑表和代码任务(从版本295-2开始支持)。 | 
| NodeSupplementCommand | - | 补数据请求参数。 | 
| CreateNodeSupplement | - | 通用补数据接口(从版本295-2开始支持)。 
 | 
| CreatePhysicalNodeSupplement | - | 创建物理节点补数据(物理节点),推荐使用CreateNodeSupplement。 
 | 
| GetPhysicalNode | - | 查询物理调度节点。 | 
| GetPhysicalNodeByOutput | - | 根据输出名查询物理节点。 | 
| GetPhysicalNodeContent | - | 查询调度节点代码内容。 | 
| GetPhysicalNodeOperationLog | - | 查询节点的操作日志。 | 
| ListDevDependency | - | 查询开发态任务配置的上游依赖。 | 
| ListNodes | - | 查询调度节点列表。 | 
| PausePhysicalNode | - | 暂停物理节点调度(危险操作),会暂停任务的调度,下游任务将无法调动,暂时仅支持离线代码任务及集成任务。 | 
| QueryDagFromPhysicalNode | - | 查询节点上下游(从物理节点出发)。 | 
| QueryNodeUpDownStream | - | 通用查询上下游接口(从版本295-2开始支持)。 | 
| QueryOperationSubmitStatus | - | 海量模式补数据之后,查询补数据提交的状态(从版本295-2开始支持)。 | 
| ResumePhysicalNode | - | 恢复物理节点调度。 | 
| RunManualNode | - | 运行手工节点(从版本295-2开始支持)。 
 | 
| RunTriggerNode | - | 运行触发式节点。 | 
| SearchSupplementDownStream | - | 查询补数据下游(从版本295-2开始支持)。 
 | 
| GetJobInfo | - | 查询实时作业的信息。 | 
| SyncEngineJobGraph | - | 支持弹内dlab平台把影子链路任务参数,同步到Dataphin任务中。 说明  该API只有弹内dlab能发起调用。 | 
| 告警消息 | ||
| GetAlertEvent | - | 获取告警事件详情。 | 
| QueryAlertEvents | ListAlertEvent | 根据条件查询多个告警事件。 | 
| QueryAlertNotifications | ListAlertNotification | 根据条件查询多个推送记录。 | 
研发
通过该API模块,用户可将Dataphin研发平台的部分能力集成到其他系统中。该API模块主要提供了离线脚本任务和管道集成任务的查询、创建、修改和删除的能力,也提供了上传和管理资源、创建及管理UDF的能力。基于这些能力,用户可以定制化的开发数据集成的工具,以及轻度的自助取数和即席查询的能力。
OpenAPI不提供规范建模的能力。
| API(旧接口) | API(新接口) | API说明 | 
| 数据架构 | ||
| CreateBusinessEntity | CreateBizEntity | 创建业务实体,包括业务对象和业务活动。 | 
| DeleteBusinessEntity | DeleteBizEntity | 删除业务实体,支持批量删除统一类型的业务实体,删除时需指定业务实体类型,支持的业务实体类型:业务对象、业务活动。 | 
| DescribeBusinessEntity | GetBizEntityInfo | 查询业务实体的详情,包括业务对象和业务活动。 | 
| DescribeBusinessEntityByVersion | GetBizEntityInfoByVersion | 查询开发环境(Basic项目为生产环境)业务实体的版本详情,包括业务对象和业务活动。 | 
| ListBusinessEntities | ListBizEntities | 以平铺的方式分页查询业务实体列表。 可以根据数据板块ID及名称、主题域ID及名称、业务实体细分类型、负责人ID、实例化状态、业务实体状态以及业务实体名称进行模糊搜索;若不设置搜索条件,将在租户范围下查询业务实体列表。 | 
| OfflineBusinessEntity | OfflineBizEntity | 下线业务实体,支持批量下线同一类型的业务实体,下线时指定业务实体类型,支持的业务实体类型:业务对象、业务活动。 | 
| SubmitBusinessEntity | OnlineBizEntity | 上线业务实体,支持批量上线同一类型的业务实体,上线时指定业务实体类型,支持的业务实体类型:业务对象、业务活动。 | 
| UpdateBusinessEntity | UpdateBizEntity | 更新业务实体,包括业务对象和业务活动。 | 
| CreateBizUnit | - | 创建数据板块。 | 
| CreateDataDomain | - | 创建主题域。 | 
| DeleteBizUnit | - | 删除数据板块,如果数据板块下已关联项目、主题域、业务限定、原子指标、派生指标、事实逻辑表、维度逻辑表、汇总表等,则不可删除。 | 
| DeleteDataDomain | - | 删除主题域,如果主题域有下级主题域或业务实体等对象则不可删除。 | 
| DescribeBizUnit | GetBizUnitInfo | 根据数据板块ID获取板块信息。 | 
| DescribeDataDomain | GetDataDomainInfo | 查看主题域信息。 | 
| ListBizUnits | - | 不区分DEV和PROD列出所有的数据板块。 | 
| ListDataDomains | - | 获取主题域列表,可根据数据板块ID、上级主题域ID、主题域名称、编码、描述进行搜索。 | 
| UpdateBizUnit | - | 更新一个已有的数据板块。 | 
| UpdateDataDomain | - | 更新主题域。 | 
| 公共定义 | ||
| UpdateGlobalVariable | - | 编辑全局变量。目前支持普通变量、账号密码全局变量编辑。 | 
| 即席查询文件 | ||
| CreateAdHocFile | - | 创建即席查询文件。 | 
| CreateAdHocFileNew | CreateAdHocFile | 创建即席查询文件。 | 
| CreateFolder | - | 创建菜单树目录,支持计算任务、数据集成、同步任务等功能。 | 
| DeleteAdHocFile | - | 删除即席查询文件。 | 
| DeleteFolder | - | 删除菜单树目录。 | 
| GetAdHocFile | - | 查询即席查询文件。 | 
| ListFiles | - | 查询菜单树目录文件。 | 
| MoveFile | - | 移动菜单树文件位置。 | 
| RenameFile | - | 重命名菜单树文件。 | 
| UpdateAdHocFile | - | 更新即席查询文件。 | 
| UpdateAdHocFileNew | UpdateAdHocFileNew | 更新即席查询文件。 | 
| 建模研发公共 | ||
| QueryObjectVersionListById | - | 获取建模研发对象的版本信息列表,目前支持查原子指标、业务限定、派生指标的版本信息列表。 | 
| 业务限定 | ||
| ListBizCondition | - | 分页查询业务限定列表信息,若不设置搜索条件,将默认查询指定项目下的业务限定。 | 
| QueryBizConditionById | - | 获取业务限定数据信息。 | 
| QueryBizConditionVerDetailById | - | 获取业务限定版本的详情。 | 
| QueryHomoBizConditionById | - | 获取同源业务限定数据信息,同源指来源于同一个逻辑表的业务限定。一个业务限定可配置三个不同时效的计算逻辑,因此可能来源于三个不同时效的逻辑表。 | 
| 指标 | ||
| GetLogicalDefinitionSubTree | - | 获取建模研发规范定义对象的导航树结构,包含原子指标、业务限定、派生指标的导航树结构。 | 
| ListAtomicIndex | - | 分页查询原子指标列表信息,若不设置搜索条件,将默认查询指定项目下的所有原生原子指标、衍生原子指标。 | 
| ListDerivedIndex | - | 分页查询派生指标列表,若不设置搜索条件,将默认查询指定项目下所有的派生指标、衍生指标和注册上挂指标。 | 
| QueryAtomicIndexById | - | 获取原子指标数据信息。 | 
| QueryAtomicIndexVerDetailById | - | 获取原子指标版本详情。 | 
| QueryDerivedIndexById | - | 获取派生指标数据信息。 | 
| QueryDerivedIndexVerDetailById | - | 查询派生指标版本详情。 | 
| QueryHomoAtomicIndexById | - | 获取同源原子指标数据信息,同源指来源于同一个逻辑表的原子指标,一个原子指标可配置三个不同时效的计算逻辑,因此可来源于三个不同时效的逻辑表。 | 
| 逻辑表 | ||
| GetLogicalModelSubTree | - | 获取逻辑表对象的导航树结构。 | 
| QueryDimTableById | - | 查询维度逻辑表详情。 | 
| QueryFactTableById | - | 查询事实逻辑表详情。 | 
| QueryGranularityBySummaryId | - | 查询汇总逻辑表统计粒度相关的维度信息。 | 
| 离线代码任务 | ||
| CancelTask | - | 终止任务(从版本3.5.3开始支持),该接口幂等,如果该任务已被关闭,则正常返回。 | 
| CloseJdbcConnection | - | 关闭JDBC链接(从版本3.5.3开始支持)。 | 
| CreateBatchTaskFile | CreateBatchTask | 创建离线计算任务。 | 
| CreateJdbcConnection | - | 创建JDBC链接(从版本3.5.3开始支持)。 | 
| DeleteBatchTaskFile | DeleteBatchTask | 删除离线计算任务之前需先下线任务。 | 
| ExecSqlByJdbc | - | 通过JDBC方式执行SQL(从版本3.5.1开始支持)。 | 
| ExecTask | ExecuteAdHocTask | 执行即席查询任务。 | 
| FetchSqlResult | - | 获取SQL执行结果(从版本3.5.3开始支持)。待任务执行成功后,可通过该接口查询任务的执行结果。如果任务还未执行结束或者执行失败,该接口返回数据为空。 | 
| GetBatchTaskFile | GetBatchTaskInfo | 查询离线计算任务详情。 | 
| GetBatchTaskFileByVersion | GetBatchTaskInfoByVersion | 查询离线计算任务版本详情。 | 
| GetLineages | GetBatchTaskUdfLineages | 查询任务的自定义血缘信息。 | 
| KillTask | StopAdHocTask | 终止即席查询任务。 | 
| ListBatchTaskFileVersions | GetBatchTaskVersions | 查询离线计算任务的历史版本。 | 
| OfflineBatchTaskFile | OfflineBatchTask | 下线离线计算任务。 | 
| ParseDependency | ParseBatchTaskDependency | 解析离线计算任务的逻辑表依赖。注意解析结果上游依赖信息中可能包含自依赖节点(上游节点ID和解析代码的任务节点ID相同),需要用户自己进行处理。 | 
| QuerySqlTaskStatus | - | 获取SQL任务状态(从版本3.5.1开始支持)。 | 
| QueryTaskLog | GetAdHocTaskLog | 获取即席查询的任务运行日志。 | 
| QueryTaskResult | GetAdHocTaskResult | 获取即席查询的任务运行结果。 | 
| SaveLineages | UpdateBatchTaskUdfLineages | 任务保存自定义血缘。 | 
| SubmitBatchTaskFile | SubmitBatchTaskFileV2 | 提交离线计算任务。 | 
| SubmitBatchTaskFileV2 | SubmitBatchTask | 提交离线计算任务。可替代SubmitBatchTaskFile接口的使用。SubmitBatchTaskFileV2接口与SubmitBatchTaskFile接口的区别: SubmitBatchTaskFileV2接口在任务提交成功后,会同时返回待发布对象ID。 | 
| UpdateBatchTaskFile | UpdateBatchTask | 更新离线计算任务。 | 
| 实时研发任务 | ||
| GetDirectoryTree | - | 获取实时任务存储目录 。 | 
| GetClusterQueueInfoByEnv | - | 获取实时任务资源队列。 | 
| GetQueueEngineVersionByEnv | - | 获取实时任务引擎版本。 | 
| CreateStreamBatchJobMapping | - | 创建Flink SQL任务。 | 
| GetStreamJobs | - | 获取实时任务列表. | 
| 管道 | ||
| PipelineAsyncExeResult | - | 异步执行状态及结果。 | 
| FileInfo | - | 管道存放的文件信息。 | 
| HopCommand | - | 管道边的配置。 | 
| NodeRelationInternal | - | 调度依赖配置。 | 
| PipelineCommand | - | 管道配置。 | 
| PipelineObject | - | 管道对象。 | 
| PipelineSettings | - | 任务通道配置。 | 
| PipelineTreeNodeBriefDTO | - | 简要管道目录树信息。 | 
| QueryPipelineDirectoryTreeCommand | - | 查询管道目录树。 | 
| ScheduleCommand | - | 管道调度配置。 | 
| StepCommand | - | 管道的步骤配置。 | 
| AsyncCreatePipeline | - | 异步一键式创建管道。 | 
| CreatePipeline | - | 创建管道任务。 | 
| CreatePipelineNode | - | 创建实时集成任务(仅包含任务基本信息)。 | 
| GetAsyncExeResult | - | 查询异步执行状态及结果。 | 
| GetPipeline | - | 查询管道任务详情。 | 
| GetPipelineByVersion | - | 查看开发环境(Basic项目为生产环境)管道版本详情。 | 
| ListAsyncExeResult | - | 批量查询异步执行状态及结果。 | 
| ListPipeline | - | 批量查询管道任务。 | 
| ListPipelineDirectoryTree | - | 批量查询集成目录列表。 | 
| OfflineAndDeletePipeline | - | 下线管道,可删除管道,删除后无法找回。 | 
| OfflinePipeline | - | 下线管道任务。 | 
| SubmitPipeline | - | 提交管道任务。 | 
| UpdatePipeline | - | 更新管道任务。 | 
| 组件(接口) | ||
| ADB for MySQl 2.0 | - | 输出组件。 | 
| ADB for MySQl 3.0 | - | 输入与输出组件。 | 
| ADB for PostgreSQL | - | 输入与输出组件。 | 
| Column | - | 请使用内置的Builder进行构造。 | 
| ColumnCalculation | - | 字段计算组件。 | 
| ColumnFilter | - | 过滤组件。 | 
| ColumnMapping | - | 请使用内置的Builder进行构造。 | 
| ColumnSelection | - | 字段选择组件。 | 
| ConditedDistribution | - | 条件分发组件。 | 
| IBM DB2 | - | 输入与输出组件。 | 
| HBase | - | 输入与输出组件。 | 
| Hive | - | 输入与输出组件。 | 
| LogicTable | - | 逻辑表输入组件。 | 
| MaxCompute | - | 输入与输出组件。 | 
| MySQL | - | 输入与输出组件。 | 
| OSS | - | 输入与输出组件。 | 
| OceanBase | - | 输入与输出组件。 | 
| Oracle | - | 输入与输出组件。 | 
| PolarDB | - | 输入与输出组件。 | 
| PolarDB-X【原DRDS】 | - | 输入与输出组件。 | 
| PostgreSQL | - | 输入与输出组件。 | 
| SpeedLimit | - | 限速组件。 | 
| SQL Server | - | 输入与输出组件。 | 
| Tera Data | - | 输入与输出组件。 | 
| Vertica | - | 输入与输出组件。 | 
| 发布 | ||
| GetLatestSubmitDetail | GetLatestSubmitDetail | 获取最新的待发布记录详情,获取的是数据处理、管道对象、资产分离的某一任务的待发布记录详情。 说明  该API只适用于DEV-PROD模式项目。 | 
| ListObjectsToPublish | ListSubmitRecords | 待发布记录列表,数据处理、管道对象、资产分离的任务的待发布记录列表。 说明  该API只适用于DEV-PROD模式项目。 | 
| ListPublishingHistory | ListPublishRecords | 发布记录列表,数据处理、管道对象、资产分离的任务的发布记录列表。 说明  该API只适用于DEV-PROD模式项目。 | 
| PublishObject | PublishObjectList | 发布对象,数据处理、管道对象、资产分离的任务的发布接口,从待发布列表ListObjectsToPublish(待发布记录列表)中获取待发布ID。 说明  
 | 
| 资源 | ||
| CreateResource | - | 创建资源。 说明  资源文件上传依赖GetResourceStorageCredential接口,如果使用环境不满足文件上传要求,需要通过Dataphin平台上传并创建资源。 | 
| DeleteResource | - | 删除资源。 | 
| GetGlobalResourceStorageCredential | GetFileStorageCredential | 获取上传资源文件的存储配置。 说明  
 | 
| GetResource | - | 获取资源详情。 | 
| GetResourceByVersion | - | 查询开发环境(Basic项目为生产环境)资源版本详情。 | 
| GetResourceStorageCredential | GetFileStorageCredential | 获取上传资源文件的存储配置,用于调用OSS SDK上传文件。 说明  
 | 
| UpdateResource | - | 更新资源。 | 
| 函数 | ||
| CreateUdf | - | 创建自定义函数。 | 
| DeleteUdf | - | 删除自定义函数。 | 
| GetUdf | - | 查询自定义函数详情。 | 
| GetUdfByVersion | - | 查询自定义函数版本详情。 | 
| UpdateUdf | - | 更新自定义函数。 | 
标签工厂
通过该API模块,用户可以查询Dataphin的标签群组信息。
| API(旧接口) | API(新接口) | API说明 | 
| BindGroupToApp | - | 绑定群组到应用。 | 
| CreateGroupByImport | - | 导入群组。 | 
| CreateGroupPageQuery | - | 创建群组分页查询。 说明  该API只有超级管理员(SuperAdmin)和系统管理员能调用。 | 
| DeleteGroup | - | 删除群组。 | 
| DeleteGroupPage | - | 删除群组分页服务。 | 
| DeleteGroupVersion | - | 删除群组版本。 | 
| EditGroupPageQuery | - | 群组分页查询编辑。 | 
| GetComputeSourceFileStorageCredentials | - | 获取计算源文件配置文件上传凭证,可用于上传配置文件。 | 
| GetGroupPageApiCode | - | 获取群组分页查询调用服务调用代码。 | 
| GetOnlineClusterById | - | 根据群组ID获取群组详情。 | 
| GetOnlineFeatureById | - | 根据标签ID获取标签详情。 | 
| ListOnlineFeatures | - | 获取已上架标签列表。 | 
| ListApplyFeaturesInProject | - | 获取当前项目内已申请的标签列表。 | 
| ListApps | - | 获取应用列表。(3.14.1新增) | 
| ListFeaturesInProject | - | 获取当前项目内开发的标签列表。 | 
| ListGroupPageSubscription | - | 获取已发布的群组分页查询服务列表。 | 
| ListGroupsInApp | - | 应用中查询已申请群组列表。(3.14.1新增) | 
| ListOnlineClusters | - | 获取已上架群组列表。 | 
| - | 应用中查询已申请标签列表。(3.14.1新增) | |
| ListingGroup | - | 上架群组市场。 | 
| OfflineGroup | - | 下线群组。 | 
| OfflineGroupPage | - | 下线群组分页服务。 | 
| OnlineGroupPageQuery | - | 发布的群组分页查询。 说明  该API只有超级管理员(SuperAdmin)和系统管理员能够调用。 | 
| PublishAndOnlineGroup | - | 发布并上架群组版本。 | 
| PublishGroup | - | 发布群组版本。 | 
| QueryGroupStatus | - | 获取群组状态。 | 
| QueryGroupVersionStatus | - | 获取群组版本状态。 | 
| QuerySubscriptionStatus | - | 获取群组离线服务状态。 | 
| RevokeGroup | - | 撤回群组。 | 
| SaveGroup | - | 第一次创建群组。 | 
| SaveGroupVersion | - | 新建群组版本。 | 
| SubmitGroupVersion | - | 提交群组版本。 | 
| SupplementGroupData | - | 对群组补数据。 | 
| SupplementGroupPageData | - | 群组分页查询服务补数据。 | 
| UnlistingGroup | - | 下架群组(免审批)。 | 
资产
通过该API模块,用户可以查询Dataphin的资产元数据信息。包括查询物理表与逻辑表的字段及分区,以及查询表的血缘。
| API(旧接口) | API(新接口) | API说明 | 
| 元数据 | ||
| GetTableColumnLineage | - | 查询字段血缘信息。 | 
| GetTableLineage | - | 查询表血缘信息。 | 
| GetTableLineagebyNodeId | - | 根据任务ID查询相关的表血缘。 | 
| GetColumnLineagebyNodeId | - | 根据任务ID查询相关的字段血缘。 | 
| ListCatalogTableColumns | - | 查询资产表的列。 | 
| ListLogicTableColumns | - | 查询逻辑表的列。 | 
| ListRealtimeTableColumns | - | 查询实时元表的列。 | 
| ListTableColumns | - | 查询物理表的列。 | 
| ListTablePartitions | - | 查询物理分区数据。 | 
| ListTables | - | 查询表元数据。 | 
| QueryLogicTable | - | 查询逻辑表详情。 | 
| QueryRealtimeTable | - | 查询实时元表详情。 | 
| QueryTable | - | 查询物理表接口。 | 
| QueryTableLineage | - | [已过时]-查询字段血缘关系(暂不支持实时表)。 建议使用新的接口:GetTableColumnLineage。 | 
| RegisterAssetMetaData | - | 注册新的资产类型的元数据。 | 
| ReportAsset | - | 上报资产到Dataphin。 | 
| SearchCatalogTable | - | 已废弃。查询资产表元数据。 | 
| 数据标准 | ||
| CancelInvalidMappingRelation | - | 取消无效映射关系。 说明  当前方法是后台异步执行的,执行结果需要通过查询无效映射的接口进行确认, 或者在页面上查看操作历史和结果详情。 | 
| CancelValidMappingRelation | - | 解除有效映射关系。 说明  当前方法是后台异步执行的,执行结果需要通过查询无效映射的接口进行确认,或者在页面上查看操作历史和结果详情。 | 
| ChangeValidMappingRelationToInvalid | - | 将有效映射关系置为无效映射关系。 说明  当前方法是后台异步执行的,执行结果需要通过查询无效映射的接口进行确认,或者在页面上查看操作历史和结果详情。 | 
| CreateLookupTable | - | 创建码表。 | 
| CreateMappingRelations | - | 创建映射关系(包括有效映射和无效映射)。 | 
| CreateStandard | - | 创建标准。 | 
| CreateStandardRelations | - | 创建标准关联关系。 | 
| CreateStandardSet | - | 创建标准集。 | 
| CreateStandardTemplate | - | 创建标准模板。 | 
| CreateWordRoot | - | 创建词根。 | 
| DeleteLookupTable | - | 删除码表。 | 
| DeleteStandardRelations | - | 删除标准关联关系。 | 
| DeleteStandardSet | - | 删除标准集。 | 
| DeleteWordRoot | - | 删除词根。 | 
| FuzzySearchStandard | - | 根据符合查询条件分页查询满足条件的标准。 | 
| DeleteStandard | - | 删除标准。 | 
| GetStandardStatisticsOfType | - | 查询目录下按照标准类型统计的标准数目。 | 
| QueryLookupTable | - | 查询码表。 | 
| QueryMappingRelationByAsset | - | 根据资产对象查询映射关系。 | 
| QueryMappingRelationByBelongAsset | - | 根据归属资产查询映射关系。 | 
| QueryStandard | - | 根据标准ID查询指定版本、指定状态的数据标准。 | 
| QueryStandardSet | - | 根据标准集ID查询标准集。 | 
| QueryStandardTemplate | - | 根据标准模板ID查询标准模板。 | 
| QueryWordRoot | - | 查询词根。 | 
| SubmitStandard | - | 发布标准。 | 
| UnpublishStandard | - | 将发布的标准下线。 | 
| UpdateLookupTable | - | 更新码表。 | 
| UpdateStandard | - | 更新标准。 | 
| UpdateStandardSet | - | 更新标准集。 | 
| UpdateStandardTemplate | - | 更新标准模板。 | 
| UpdateWordRoot | - | 更新词根。 | 
| 数据质量 | ||
| AssignQualityRuleSchedules | - | 将规则和调度设置进行绑定。 | 
| GetQualityAlert | - | 通过监控对象ID获取告警设置。 | 
| GetQualityRule | - | 通过ID获取质量规则对象。 | 
| GetQualityRuleTask | - | 通过ID获取质量任务对象。 | 
| GetQualityRuleTaskLog | - | 通过ID获取质量任务对象的日志内容。 | 
| GetQualitySchedule | - | 通过ID获取质量调度对象。 | 
| GetQualityTemplate | - | 通过ID获取质量模板对象。 | 
| GetQualityWatch | - | 通过ID获取质量监控对象。 | 
| GetQualityWatchByObjectId | - | 通过监控对象原始ID获取监控对象记录,例如:数据源、表、指标等的ID。 | 
| GetQualityWatchTask | - | 通过ID获取监控任务对象。 | 
| GetQualityWatchTaskLog | - | 通过ID获取监控任务对象的日志内容。 | 
| ListQualitySchedules | - | 通过监控对象ID获取调度设置列表。 | 
| OpenCloseQualityRules | - | 批量开启/关闭质量规则。 | 
| OpenCloseQualityWatches | - | 批量开启关闭质量监控对象。 | 
| PagedQueryQualityRuleTasks | - | 分页查询质量规则任务。 | 
| PagedQueryQualityRules | - | 分页查询质量规则。 | 
| PagedQueryQualityTemplates | - | 分页查询质量模板。 | 
| PagedQueryQualityWatchTasks | - | 分页查询质量监控对象任务。 | 
| PagedQueryQualityWatches | - | 分页查询质量监控对象。 | 
| RemoveQualityRuleSchedules | - | 批量删除质量规则和调度的绑定关系。 | 
| RemoveQualityRules | - | 批量删除质量规则对象。 | 
| RemoveQualitySchedules | - | 批量删除质量调度对象。 | 
| RemoveQualityTemplates | - | 批量删除质量模板对象。 | 
| RemoveQualityWatches | - | 批量删除质量监控对象。 | 
| SaveQualityAlert | - | 新建或修改监控对象告警设置。 | 
| SaveQualityRule | - | 新建或修改质量规则。 | 
| SaveQualitySchedule | - | 新建或修改调度设置。 | 
| SaveQualityTemplate | - | 新建或修改质量模板。 | 
| SaveQualityWatch | - | 添加质量监控对象支持添加多种类型的质量监控对象,包括:Dataphin表、全域表、数据源、指标、实时元表。 说明  添加Dataphin表和实时元表时,需要table和datasource两个参数必传,datasource的 | 
| SubmitQualityRuleTasks | - | 批量提交规则任务,支持试跑。 | 
| SubmitQualityWatchTasks | - | 批量提交监控对象校验任务。 | 
| 数据安全 | ||
| AddSecurityLabel | - | 新建安全识别结果,能够选择覆盖模式,也能修改线上的安全识别结果。 说明  该API仅支持安全管理员或该表所在项目的管理员能够发起调用。 | 
| CreateClassifyCatalog | - | 新建数据分类目录。拥有数据分类-管理权限的角色可以新建任意目录;一级目录的管理员仅可在该一级目录下新建目录。 | 
| CreateSecurityClassify | - | 新建安全分类。 | 
| CreateSecurityLevel | - | 新建安全分级。 | 
| GetSecretKeyByName | - | 根据密钥名称查询密钥详情。 | 
| GetSecurityClassifyDetail | - | 根据分类ID查询数据分类详情 。 | 
| GetSecurityLabelById | - | 通过识别结果ID获取识别结果对象。 | 
| GetSecurityLevelDetail | - | 根据分级ID查询数据分级详情。 | 
| PagedQuerySecurityIdentifyRecordsOfField | - | 分页查询安全识别结果的识别详情。 | 
| PagedQuerySecurityLabels | - | 分页查询安全识别结果。 | 
| RemoveClassifyCatalog | - | 删除数据分类目录。拥有数据分类-管理权限的自定义角色可以删除任意目录;一级目录的管理员仅可删除该一级目录及其子目录。 | 
| RemoveSecurityClassify | - | 删除安全分类。 | 
| RemoveSecurityLabels | - | 批量删除安全识别结果。 说明  该API仅支持安全管理员或该表所在的项目管理员能够发起调用。 | 
| RemoveSecurityLevel | - | 删除安全分级。 | 
| UpdateClassifyCatalog | - | 更新数据分类目录。拥有数据分类-管理权限的自定义角色可修改任意目录;一级目录的管理员仅可修改该一级目录及其子目录;涉及移动操作时,操作人需同时具备来源一级目录和目标一级目录的管理员权限。 | 
| UpdateSecurityClassify | - | 更新安全分类。 | 
| UpdateSecurityLabelsEnableStatus | - | 批量更新安全识别结果的生效状态。 说明  该API仅支持安全管理员或该表所在的项目管理员能够发起调用。 | 
| UpdateSecurityLabelsIdentifyRule | - | 批量更新安全识别结果绑定的识别规则。 说明  该API仅支持安全管理员或该表所在的项目管理员能够发起调用。 | 
| UpdateSecurityLevel | - | 更新安全分级。 | 
| 数据服务 | ||
| CreateDataServiceApi | - | 创建新的数据服务API并提交。 | 
| PublishDataServiceApi | - | 发布指定的API的版本到线上环境。 | 
| ListApiByApp | - | 查询应用下已授权的API详情列表。 | 
| QueryApiDocumentRequest | GetDataServiceApiDocument | 获取API文档。 | 
| QueryApiLogPage | ListDataServiceApiCalls | 运维-服务调用日志查询-API调用日志查询。 | 
| QueryApiServiceGroup | GetDataServiceApiGroups | 查询API服务分组列表。 | 
| QueryApiServicePage | ListDataServicePublishedApis | 分页查询发布的API。 | 
| QueryErrorImpact | GetDataServiceApiErrorImpactSummary | API常影响分析。 | 
| QueryIndicators | GetDataServiceApiCallSummary | 运维监控调用汇总统计。 | 
| QueryVisitTrend | GetDataServiceApiCallTrend | 运维监控访问趋势分析。 | 
| ApplyApi | ApplyDataServiceApiPermission | API权限申请。 | 
| QueryApiAuthPage | ListDataServiceAuthorizedApis(可以用已有API:ListAuthorizedDataServiceApiDetails取代) | 查询当前用户有权限的API列表。 | 
| QueryApiGroup | GetDataServiceAuthorizedApiGroups | 查询当前项目的API分组列表。 | 
| QueryGroupApi | - | 查询分组下的API列表。 | 
| QueryPrivateApp | GetDataServiceAuthorizedAppsByGroupId | 查询账号有权限的应用列表。 | 
| ApplyApp | ApplyDataServiceAppPermission | 申请应用权限。 | 
| QueryAppAuthPage | ListDataServiceAuthorizedApps | 查询当前用户有权限的应用列表。 | 
| QueryAppGroup | GetDataServiceAuthorizedAppGroups | 查询当前项目的应用分组列表。 | 
| QueryGroupApp | GetDataServiceAppsByGroupId | 查询分组下应用列表。 | 
| ApplyDataSource | - | Dataphin数据源权限申请。 | 
| QueryDataSourceAppGroup | - | 查询Dataphin数据源分组列表。 | 
| QueryDataSourceAuthPage | - | 根据项目查询已申请权限的Dataphin数据源分页列表。 | 
| QueryDataSourceGroup | - | 查询当前租户项目的分组。 | 
| QueryGroupDataSource | - | 列出Dataphin数据源分组下的Dataphin数据源列表。 | 
| QueryLogicalTable | - | 查询指定Dataphin数据源下的逻辑表。 | 
| QueryPhysicalTable | - | 查询指定Dataphin数据源下的物理表。 | 
| QueryTableColumn | - | 查询表Dataphin数据源的表字段。 | 
| AuthorizeApi | GrantDataServiceApiPermission | API授权。 | 
| QueryMyApiPage | ListDataServiceMyApiPermissions | API权限列表。 | 
| RecycleApi | RevokeDataServiceApiPermission | API权限回收。 | 
| AuthorizeApp | GrantDataServiceAppPermission | 应用授权。 | 
| GrantAppToUser | GetDataServiceAppAdmins | 查询应用负责人。 | 
| ListAppAuthUser | GetDataServiceAppAuthorizedUsers | 应用有权限的用户列表。 | 
| QueryMyAppPage | ListDataServiceMyAppPermissions | 查询自己有权限的应用。 | 
| RecycleApp | RevokeDataServiceAppPermission | 应用权限回收。 | 
| AuthorizeDataSource | - | 申请Dataphin数据源应用授权。 | 
| QueryMyDataSourcePage | - | 查询我有权限的数据源列表。 | 
| RecycleDataSource | - | Dataphin数据源权限回收。 | 
| ListAuthorizedDataServiceApiDetails | - | 授权数据服务API列表信息。 | 
| ListManagerProject | GetDataServiceMyProjects | 当前登录用户作为负责人的项目下拉列表。 | 
| ListDataphinDsPermissions | - | 判断当前账号的租户是否有数据服务(Dataphin)权限。 | 
| QueryDataSourceDocument | - | 根据数据源ID查询数据源详情(Dataphin数据源文档)。 | 
| QueryDataSourceServicePage | - | 查询Dataphin数据源的分页列表。 | 
| QueryApiImpactDetail | ListDataServiceApiImpacts | API影响分析列表。 | 
| QueryApiMonitor | ListDataServiceApiMaintanceStatistics | 查询API运维统计信息。 | 
| CreateProjectUser | AddDataServiceProjectMember | 添加项目用户并设置角色。 | 
| ListDataphinUser | GetDataServiceProjectMembers | 查询当前租户项目的用户列表。 | 
| ListPrivilegedProject | GetDataServiceAuthorizedProjects | 查询有权限的项目列表。 | 
| QueryProjectPage | ListDataServiceProjects | 分页查询项目。 | 
| pageInfo | - | 无。 | 
| ParseSql | ParseDataServiceSql | 翻译SQL。 | 
| SqlLegalityVerify | CheckDataServiceSqlLegality | SQL校验与鉴权。 | 
平台管理
通过平台管理相关的API,用户可以查询当前购买的产品的功能特性,创建及管理数据源、查询项目信息、管理项目成员,管理Dataphin的成员,以及给用户授权和回收数据源权限。
| API(旧接口) | API(新接口) | API说明 | 
| 购买特性 | ||
| ListFeatures | - | 获取当前租户可用的特性列表。 | 
| 项目管理 | ||
| AddProjectMembers | AddProjectMember | 添加项目成员,支持添加项目Basic和DEV_PROD项目的项目成员。 | 
| DeleteProjectMembers | DeleteProjectMember | 删除项目成员,支持删除项目Basic和DEV_PROD项目的项目成员。 说明  
 | 
| GetProject | - | 根据项目ID和环境信息获取项目信息。 | 
| GetProjectByName | - | 根据项目名称获取项目信息,查询开发环境项目时需要在项目名称后添加 | 
| ListProjectByProjectType | - | 根据项目类别筛选项目。 | 
| ListProjectMembers | - | 根据项目ID和环境信息,获取项目成员列表。 | 
| ListProjects | - | 根据项目类别筛选项目。 | 
| QueryProjectWhiteList | GetProjectWhiteLists | 根据项目ID查询项目白名单。 | 
| UpdateProjectMembers | UpdateProjectMember | 更新项目成员,支持更新项目Basic和DEV_PROD项目的项目成员。 | 
| 数据源 | ||
| CheckDataSourceConnectivity | - | 检查数据源连通性。 | 
| CheckExistDataSourceConnectivity | - | 检查已创建的数据源连通性。 | 
| CreateDataSource | - | 创建数据源,支持单独创建生产环境数据源,同时创建开发、生产数据源,以及为生产环境数据源创建开发环境数据源三种模式。 | 
| DeleteDevProdModeDataSource | - | 删除数据源,支持只删除开发环境中的数据源,或者同时删除开发、生产数据源,Dataphin系统目前不允许开发环境数据源单独存在。 | 
| ListDataSourceDependency | GetDataSourceDependencies | 搜索数据源依赖,接口返回结果为list。 | 
| SearchDataSourceConfig | - | 搜索数据源,结果分页返回,返回数据源结构为开发、生产成对组合。 | 
| UpdateDataSourceBasicInfo | - | 更新数据源的基本信息,如名称、描述。 | 
| UpdateDataSourceConfiguration | - | 更新数据源配置信息,如链接URL、用户名、密码等。 | 
| 行级权限 | ||
| ListRowPermission | - | V5.1新接口,获取行级权限列表。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| GetAccountByRowPermissionId | - | V5.1新接口,根据行级权限ID获取某一行级权限下的所有授权账号。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| ListAccountByRowPermissionId | - | 根据行级权限ID获取账户列表。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| CreateRowPermission | - | V5.1新接口,新建行级权限。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| DeleteRowPermission | - | V5.1新接口,根据行级权限ID删除行级权限。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| UpdateRowPermissionBasicInfo | - | 更新行级权限的基本信息。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| AddControlRule | - | 添加行级权限的管控规则。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| UpdateControlRule | - | 更新行级权限的管控规则。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| DeleteControlRule | - | 删除行级权限的管控规则。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| AddAssociatedTable | - | 添加相关表的行级权限信息。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| DeleteAssociatedTable | - | 删除相关表的行级权限信息。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| ListRowPermissionByUserId | - | V5.1新接口,获取用户的行级权限列表。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| UpdateRowPermission | - | V5.1新接口,更新行级权限。 说明  在DataphinV5.1及之后版本,因行级权限能力升级,该API将不支持,请查看Dataphin-OpenAPI SDK2.0接口文档。 | 
| 计算源 | ||
| CheckComputeSourceConnectivity | - | 检查计算源配置的连通性。 | 
| CheckComputeSourceConnectivityById | - | 根据项目ID检查项目连通性。 | 
| CreateComputeSource | - | 创建计算源。 | 
| DeleteComputeSource | - | 删除计算源。 | 
| GetComputeSource | GetComputeSourceInfo | 根据计算源ID获取计算源信息。 | 
| GetComputeSourceFileCredentials | GetFileStorageCredential | 获取计算源文件配置文件上传凭证,可用于上传配置文件。 | 
| QueryComputeSource | ListComputeSources | 计算源批量查询。 | 
| SetTenantComputeEngine | UpdateTenantComputeEngine | 设置租户计算引擎。 | 
| UpdateComputeSource | - | 更新计算源。 | 
| 用户与授权 | ||
| AddUser | - | 给租户添加用户。 说明  该API仅支持超级管理员(SuperAdmin)发起调用。 | 
| BatchAddTenantMember | - | 批量添加用户至租户。 说明  该API仅支持超级管理员(SuperAdmin)和系统管理员调用。 | 
| BatchGetUsers | - | 根据 | 
| BatchSyncUsers | - | 同步租户成员信息。 说明  该API只有超级管理员(SuperAdmin)和系统管理员调用。 | 
| CheckResourcePermission | - | 判断个人账号、生产账号是否有操作某一资源的权限。 说明  该API只有超级管理员(SuperAdmin)和系统管理员调用。 | 
| CreateUserGroup | - | 新建用户组。 | 
| DeleteUserGroup | - | 删除用户组。 | 
| GetDataSourceUserList | - | 根据数据源ID查询拥有权限的用户。 | 
| GetOpsTenant | - | 获取运维租户信息。 说明  该API仅支持超级管理员(SuperAdmin)发起调用。 | 
| GetPermissionChangeObjects | - | 获取权限变化对象详情。 | 
| GetProjectProduceUser | - | 获得项目生产账号。 说明  该API仅支持超级管理员(SuperAdmin)发起调用。 | 
| GetRoleListByUserId | - | 获取某个用户所拥有的角色列表。 | 
| GetUserGroup | - | 获取用户组详情。 | 
| GetUserInfoBySourceId | - | 根据外部账号ID查询对应的Dataphin的用户信息。 | 
| GrantByResource | - | 根据资源授权用户。 说明  该API仅支持超级管理员(SuperAdmin)和资源所有者(项目管理员、数据源管理员)发起调用,目前支持表、数据源。 | 
| GrantPermissionToDataSource | - | 授予数据源多个用户多个行为权限(建议使用新API,GrantByResource)。 | 
| GrantRole | - | 授予用户某个角色,该接口已作废,设置租户级别角色使用UpdateTenantMembers接口。 说明  该API仅支持超管(SuperAdmin)和项目管理员发起调用。 | 
| IsProductAdmin | - | 判断当前用户是否是某个产品的超级管理员。 | 
| ListAddableRoles | - | 成员可配置用户角色(管理中心 > 成员管理)。 | 
| ListAssetPermissionAudit | - | 分页获取权限操作审计列表信息。 | 
| ListPermissionChangeLog | - | 游标获取权限变化记录。 | 
| ListPermissionOperationAudit | - | 分页获取权限操作审计列表信息。 | 
| ListDepts | - | 租户部门列表 。 | 
| ListUserGroup | - | 分页获取用户组信息。 | 
| ListUserGroupMember | - | 分页获取用户组成员信息。 | 
| ListUsers | - | 分页获取用户信息。 | 
| MineTenants | - | 我的租户列表信息。 | 
| QueryPagedAddableUsers | - | 查询租户可添加用户。 说明  该API仅支持超级管理员(SuperAdmin)和系统管理员调用。 | 
| QueryPagedDept | - | 分页查询一级部门信息。 | 
| QueryPagedMembers | - | 成员列表分页查询。 | 
| RemoveUser | - | 给租户删除用户。 说明  该API仅支持超级管理员和系统管理员发起调用。 | 
| RevokeByResource | - | 根据资源回收用户权限。 说明  该API仅支持超级管理员(SuperAdmin)和资源所有者(项目管理员、数据源管理员)发起调用,目前支持表、数据源。 | 
| RevokePermissionFromDataSource | - | 用户数据源权限移除(建议使用新API,RevokeByResource)。 说明  该API仅支持超级管理员(SuperAdmin)发起调用。 | 
| UpdateTenantMemberStatus | - | 更新租户成员启停状态。 | 
| UpdateTenantMembers | - | 更新租户成员信息。 说明  该API仅支持超级管理员(SuperAdmin)和系统管理员调用。 | 
| UpdateUserGroup | - | 更新用户组成员列表信息。 | 
| UpdateUserGroupSwitch | - | 修改用户组的启用状态。 | 
| AddUserToUserGroup | - | 添加用户到用户组。 | 
| RemoveUserFromUserGroup | - | 从用户组中删除用户。 | 
| UpdateTenantMembersStatus | - | 启停用某一用户。 | 
| ListTenantRolesByUserId | - | 根据userid获取租户级别角色。 | 
| ListTenantRoles | - | 获取租户级别角色。 | 
| Python三方包 | ||
| ListPythonModule | - | Python三方包分页查询。 |