数据服务模块为您展示平台可提供的全量数据表和API等内容(指标和标签模块待上线)。您可根据需求申请所需数据表和API的权限,用于您应用的开发、展示或分析。
数据服务界面如下图所示,界面上方为搜索栏,您可进行数据表和接口的快速搜索定位,您可进行数据查询与筛选。具体包括以下三部分内容:
资产总览:展示交通云控平台提供的所有指标。
数据接口:展示交通云控平台提供的所有接口及信息。
行业模型:展示交通云控平台支持的所有主题域及其模型表,以及模型表的数据详情。
界面上方为搜索栏,您可进行指标、接口、模型表的快速搜索定位。
资产总览
资产总览界面如下图所示,展示平台提供的所有交通运行指标(下图仅为示例,具体显示指标请以产品实际显示为准)。
当您点击某个指标,即以该指标为关键字进行搜索,搜索完成后,跳转至“数据接口”界面,展示该指标的指标说明,以及该指标的相关接口;切换“行业模型”界面,展示指标介绍以及包含该指标的相关模型表。
以“当前时间片在途量”为例,您可在“资产总览”界面点击“区域”下“当前时间片在途量”指标,或通过界面上方搜索栏搜索该指标。
数据接口
展示平台可提供的全量API接口,您可查询接口明细。
数据接口模块方便您在不访问数据库的情况下,获取接口数据。其功能包括:
告知您接口的服务地址、所在模型、调用方式、请求参数、返回参数等信息。
在线调试,确定接口是否能正常获取数据。
数据接口界面如下图所示,展示交通云控平台提供的所有接口及信息,具体包括接口的中英文名称、返回指标以及描述等信息。接口右侧显示接口状态(未开通、已开通),已开通的接口数据可正常产出,未开通的接口数据暂时无产出。
您可以通过设定“实体”、“业务应用”和“接口状态”筛选所需接口,或通过关键字快速搜索定位到所需接口后,进行接口点击开通/取消开通操作。
如下图所示,支持您进行接口的批量开通。
点击接口的中英文名称,如下图所示,显示接口的详细信息,同时可进行接口调试操作。输入请求参数值,点击接口调试按钮,即可在响应参数处获取结果。若调试失败,响应参数中显示错误码,您可对照错误参照码查看失败原因。
行业模型
展示平台可提供的全量数据表,您可查询数据表明细,进一步加工您的数据粒度或业务算法。
您在数据表界面点击具体数据表,如下图所示,可跳转至该表的明细界面。显示内容包括该表的名称、描述、类型等基本信息,存储大小、创建/更新时间、所属云计算资源等扩展信息,以及表的字段信息、数据预览、血缘关联(上下游表和上下游接口)、数据质量等详情。
界面部分参数说明如下表所示:
参数名称 | 参数说明 |
表名 | 数据库中存储的物理表名称。 |
表描述 | 物理表的中文描述。 |
负责人 | 负责物理表开发的数据开发者。 |
应用领域 | 数据表的应用领域,具体应用领域与您的项目领域相关。 |
存储数据库 | 存储物理表的数据库,可查看同一个物理表存于不同数据库的当日状态、数据质量、指标详情和规则明细。 |
数据质量 | 平台会根据已配置的表级别规则,对物理表的数据质量进行评估。数据质量状态说明如下:
说明 |
您可以通过设定“模型类型(左侧模型目录)”、“应用领域”和“数据质量”筛选模型表,或通过表名称、表描述、字段等关键字快速搜索定位到所需模型表。
鼠标点击或移动至模型表运行失败报警处,如下图所示,可显示运行失败原因。
点击模型表右侧的表详情按钮,显示模型表详情界面。如下图所示,表详情显示内容包括表名、表描述以及数据表的存储数据库、开发责任人和模型负责人等基本信息;以及数据表的“字段信息”、“数据概览”、“血缘信息”、“数据质量”和“开发逻辑”等详细信息。如果数据表储存在多个数据库,可切换查看该表不同数据库的详细信息。
字段信息
字段信息显示数据表在所选存储数据库下的字段及信息,具体包括字段名、数据类型、字段描述、分区字段、数据质量以及告警信息。
鼠标点击或移动至告警信息处,可显示该字段的所有规则。如下图所示,其中告警规则会以红色高亮显示。
数据概览
点击切换“数据概览”,界面显示如下图所示,显示数据表内包含的详细数据。您可点击自定义查询按钮查询您关注的字段信息。
血缘信息
点击切换“血缘信息”,界面显示如下图所示,显示数据表在所选存储数据库下的上下游表,滑动鼠标可放大/缩小显示内容。上下游表最多分别显示10张,多于10张后您可点击上下按钮切换显示。具体显示内容如下:
显示表名称及其存储数据库、表的质量状态(请参考界面左上角的颜色说明),其中状态样式和行业模型的表状态一致。
鼠标移到至某表时,显示表的详细内容,具体包括:表名称、输出场景、存储形式、开发负责人以及计算任务状态等信息。
数据质量
点击切换“数据质量”,界面显示如下图所示,包括数据表的“命中历史”和“质量规则”。
命中历史
显示数据表规则的执行历史及结果,可自定义时间段。如果数据表未设置调度时间,则此处显示的是数据表的手动执行时间。如果存在告警,点击告警数可显示规则明细窗口查看具体报警。
质量规则
显示数据表配置的表级规则和字段级规则。