数据服务

数据服务模块为您展示平台可提供的全量数据表和API等内容(指标和标签模块待上线)。您可根据需求申请所需数据表和API的权限,用于您应用的开发、展示或分析。

数据服务界面如下图所示,界面上方为搜索栏,您可进行数据表和接口的快速搜索定位,您可进行数据查询与筛选。具体包括以下三部分内容:

  • 资产总览:展示交通云控平台提供的所有指标。

  • 数据接口:展示交通云控平台提供的所有接口及信息。

  • 行业模型:展示交通云控平台支持的所有主题域及其模型表,以及模型表的数据详情。

  • 界面上方为搜索栏,您可进行指标、接口、模型表的快速搜索定位。

image..png

资产总览

资产总览界面如下图所示,展示平台提供的所有交通运行指标(下图仅为示例,具体显示指标请以产品实际显示为准)。

image..png

当您点击某个指标,即以该指标为关键字进行搜索,搜索完成后,跳转至“数据接口”界面,展示该指标的指标说明,以及该指标的相关接口;切换“行业模型”界面,展示指标介绍以及包含该指标的相关模型表。

以“当前时间片在途量”为例,您可在“资产总览”界面点击“区域”下“当前时间片在途量”指标,或通过界面上方搜索栏搜索该指标。image..png

数据接口

展示平台可提供的全量API接口,您可查询接口明细。

数据接口模块方便您在不访问数据库的情况下,获取接口数据。其功能包括:

  • 告知您接口的服务地址、所在模型、调用方式、请求参数、返回参数等信息。

  • 在线调试,确定接口是否能正常获取数据。

数据接口界面如下图所示,展示交通云控平台提供的所有接口及信息,具体包括接口的中英文名称、返回指标以及描述等信息。接口右侧显示接口状态(未开通、已开通),已开通的接口数据可正常产出,未开通的接口数据暂时无产出。

您可以通过设定“实体”、“业务应用”和“接口状态”筛选所需接口,或通过关键字快速搜索定位到所需接口后,进行接口点击开通/取消开通操作。

image..png

如下图所示,支持您进行接口的批量开通。

image.png

点击接口的中英文名称,如下图所示,显示接口的详细信息,同时可进行接口调试操作。输入请求参数值,点击接口调试按钮,即可在响应参数处获取结果。若调试失败,响应参数中显示错误码,您可对照错误参照码查看失败原因。

image..png

行业模型

展示平台可提供的全量数据表,您可查询数据表明细,进一步加工您的数据粒度或业务算法。

您在数据表界面点击具体数据表,如下图所示,可跳转至该表的明细界面。显示内容包括该表的名称、描述、类型等基本信息,存储大小、创建/更新时间、所属云计算资源等扩展信息,以及表的字段信息、数据预览、血缘关联(上下游表和上下游接口)、数据质量等详情。

image..png

界面部分参数说明如下表所示:

参数名称

参数说明

表名

数据库中存储的物理表名称。

表描述

物理表的中文描述。

负责人

负责物理表开发的数据开发者。

应用领域

数据表的应用领域,具体应用领域与您的项目领域相关。

存储数据库

存储物理表的数据库,可查看同一个物理表存于不同数据库的当日状态、数据质量、指标详情和规则明细。

数据质量

平台会根据已配置的表级别规则,对物理表的数据质量进行评估。数据质量状态说明如下:

  • 优秀(绿灯):没有命中规则。

  • 一般(黄灯):命中数据表的弱规则,建议您根据实际情况使用。

  • 较差(红灯):命中数据表的强规则,请联系数据开发者修改。

说明

您可以通过设定“模型类型(左侧模型目录)”、“应用领域”和“数据质量”筛选模型表,或通过表名称、表描述、字段等关键字快速搜索定位到所需模型表。

鼠标点击或移动至模型表运行失败报警处,如下图所示,可显示运行失败原因。

image..png

点击模型表右侧的表详情按钮,显示模型表详情界面。如下图所示,表详情显示内容包括表名、表描述以及数据表的存储数据库、开发责任人和模型负责人等基本信息;以及数据表的“字段信息”、“数据概览”、“血缘信息”、“数据质量”和“开发逻辑”等详细信息。如果数据表储存在多个数据库,可切换查看该表不同数据库的详细信息。

image..png

字段信息

字段信息显示数据表在所选存储数据库下的字段及信息,具体包括字段名、数据类型、字段描述、分区字段、数据质量以及告警信息。

鼠标点击或移动至告警信息处,可显示该字段的所有规则。如下图所示,其中告警规则会以红色高亮显示。

image..png

数据概览

点击切换“数据概览”,界面显示如下图所示,显示数据表内包含的详细数据。您可点击自定义查询按钮查询您关注的字段信息。行业模型-4

血缘信息

点击切换“血缘信息”,界面显示如下图所示,显示数据表在所选存储数据库下的上下游表,滑动鼠标可放大/缩小显示内容。上下游表最多分别显示10张,多于10张后您可点击上下按钮切换显示。具体显示内容如下:

  • 显示表名称及其存储数据库、表的质量状态(请参考界面左上角的颜色说明),其中状态样式和行业模型的表状态一致。

  • 鼠标移到至某表时,显示表的详细内容,具体包括:表名称、输出场景、存储形式、开发负责人以及计算任务状态等信息。

行业模型-5

数据质量

点击切换“数据质量”,界面显示如下图所示,包括数据表的“命中历史”和“质量规则”。

  • 命中历史

    显示数据表规则的执行历史及结果,可自定义时间段。如果数据表未设置调度时间,则此处显示的是数据表的手动执行时间。如果存在告警,点击告警数可显示规则明细窗口查看具体报警。

    行业模型-6
  • 质量规则

    显示数据表配置的表级规则和字段级规则。

    行业模型-7