本章节为您介绍语义建模的所有操作。

前提条件

  1. 您已经新建工作组,详细请参见新建工作组并添加成员
  2. 您已经新建计算资源,详细请参见新建云计算资源
  3. 您已经在MaxCompute数据库插入表dws_ren_kh_di和dws_wp_xyk_di,表数据详细请参见MaxCompute数据库表语句

背景信息

语义建模主要为您介绍新建标签模型、加工衍生标签、标签同步和上线标签,为之后的标签资产做支撑。

新建标签模型

  1. 登录数据资源平台控制台
  2. 在顶部菜单栏单击菜单 > 研发工作台 > 资产加工 > 语义建模,进入语义建模页面。
  3. 单击左侧导航栏标签模型 > 进入,进入对象视图页面。
  4. 对象视图页面,单击页面右上角新建对象
  5. 新建实体1并绑表:
    1. 新建对象页面,选择实体,填写实体名称、实体code等信息,单击确定
      新建实体配置项:
      配置项 示例
      实体名称 银行客户
      实体code yhkh
    2. 跳转到详情页面,单击已绑定数据表,并单击新增绑表,弹出新增绑表页面。
    3. 创建数据表:选择数据源名称和表名。
      创建数据表配置项:
      配置项 示例
      表名 dws_ren_kh_di
    4. 配置映射:勾选所有字段,单击主标签开关开启主标签,若在右上角单击自定义设置,添加了其他属性,可单击修改自定义属性,批量填写所有标签自定义的属性,单击确定,并配置标签类型,所有操作完成后,单击确认
      配置映射配置项:
      配置项 示例
      主标签 zzhm
      dataq 原生
      标签类型 设置hyzk、xb、career和jysp为"枚举值"。
      普通标签 表上其他字段
    5. 出现提示页面,单击返回对象详情
  6. 新建实体2并绑表:
    1. 单击左侧导航栏标签模型 > 进入,进入对象视图页面。
    2. 对象视图页面,单击页面右上角新建对象
    3. 新建对象页面,选择实体,填写实体名称、实体code等信息,单击确定
      新建实体配置项:
      配置项 示例
      实体名称 信用卡
      实体code xyk
    4. 跳转到详情页面,单击已绑定数据表,并单击新增绑表,弹出新增绑表页面。
    5. 创建数据表:选择数据源名称和表名。
      创建数据表配置项:
      配置项 示例
      表名 dws_wp_xyk_di
    6. 配置映射:勾选所有字段,单击主标签开关开启主标签,若在右上角单击自定义设置,添加了其他属性,可单击修改自定义属性,批量填写所有标签自定义的属性,单击确定,所有操作完成后单击确认
      配置映射配置项:
      配置项 示例
      主标签 cid
      普通标签 表上其他字段
      说明

      实体绑定同一数据源上的多张表时,需要确保多张表的主标签的内容一致才可进行join查询。

      • 设置主表:按主表的left join查询。
      • 不设置主表:按inner join查询。
    7. 出现提示页面,单击返回对象详情
  7. 新建实体连接:
    1. 单击标签模型 > 详情,单击新建的实体1后的编辑 > 连接
    2. 弹出连接页面,单击新增连接,输入连接信息,单击确定
      新建实体1连接配置项:
      配置项 说明 示例
      请输入连接对象描述 用户自定义,用于描述连接的逻辑关系 银行客户证件号码ID和信用卡持卡人ID连接
      当前对象标签 实体要创建连接的标签 证件号码
      请选择关联对象 实体要关联的对象 信用卡
      关联对象标签 实体要关联的对象的标签 持卡人id
    3. 出现对象更新成功提示。
  8. 单击左侧导航栏标签模型 > 查看页面查看新建的实体。

加工衍生标签

支持用户编写TQL,将计算结果作为标签值,为实体生成新的标签。

  1. 登录数据资源平台控制台
  2. 在顶部菜单栏单击菜单 > 研发工作台 > 资产加工 > 语义建模,进入语义建模页面。
  3. 在左侧导航栏单击标签工厂 > 标签方案,单击新建标签方案
  4. 弹出新建标签方案页面,填写方案名称和描述,选择方案类型为TQL模式,单击完成
    新建方案配置项:
    配置项 示例
    方案名称 银行客户信用卡张数
    方案描述 银行客户信用卡张数
    1. 标签配置页面,选择源和目标云计算资源,在查询编辑器里面输入TQL语句,单击TQL测试
      TQL语句:
      select count(xyk.cid) as 数量,xyk.rid as 证件号 from xyk group by xyk.rid;
      说明 select 后面需带绑定对象的主标签才可开启输出表关联标签。
      测试通过,可查看数据结果table格式。
      • 单击返回JSON,查看数据结果JSON格式。查看数据结果
      • 单击执行的SQL,查看执行的SQL语句。
      • 单击步骤详情,查看执行的每一步耗时。
      对返回结果设置输出表关联标签:在页面右侧标签配置下,打开输出表关联开关,选择绑定对象,在绑定标签名的”证件号“选择绑定对象主标签。
      配置项 说明 示例
      绑定对象 设置加工的衍生标签的绑定对象 银行客户
      返回标签 选择绑定对象的主标签 证件号码
      标签配置
      对返回标签新建标签:单击绑定标签名下的新建标签,填写标签名称、标签code和dataq,单击完成新建标签新建标签配置项:
      配置项 说明 示例
      标签名称 衍生标签名称 持卡数量
      标签code 衍生标签code cksl
      dataq 标签业务口径 衍生
      绑定标签名下可查看新建标签。查看标签单击页面右上角下一步
    2. 进入离线任务配置,选择调度类型为:立即运行,单击页面右上角下一步
    3. 进入预览保存页面,可以查看标签方案配置信息,单击页面右上角保存预览方案
  5. 页面跳转至标签方案列表,可查看新建的标签方案。查看方案
  6. 单击新建的标签方案后的提交,等待标签方案状态变为完成
  7. 单击新建的标签方案后的执行,弹出运行参数配置,选择立即运行,单击确定
  8. 单击新建的标签方案后的任务,页面跳转到任务列表,等待任务状态变为成功任务查看
  9. 单击左侧导航栏标签模型 > 进入,进入对象视图页面,单击衍生标签绑定的对象后的详情页面,查看新建的衍生标签。查看衍生

创建标签同步

实现源云计算资源MaxCompute的标签数据同步到目标云计算资源RDS中。

  1. 登录数据资源平台控制台
  2. 在顶部菜单栏单击菜单 > 研发工作台 > 资产加工 > 语义建模,进入语义建模页面。
  3. 在左侧导航栏单击标签同步页面,单击计划列表 > 新建
  4. 出现新建同步计划页面,配置同步目标、配置同步标签、配置同步参数和保存预览。
    1. 配置同步目标页面,填写同步计划名称、选择目标云计算资源和同步对象后,单击下一步
      配置同步目标配置项:
      配置项 说明 示例
      同步计划名称 客户自定义 银行客户从ODPS到RDS
      目标云计算资源 标签同步的目标云计算资源 RDS
      同步对象 要同步的对象 银行客户
    2. 配置同步标签页面,勾选所有标签,单击下一步
    3. 配置同步参数页面,同步目标参数设置后,单击下一步
      同步目标参数设置:
      配置项 说明 示例
      目标表名 客户自定义 tb_yhkh
      表描述 客户自定义 银行客户
    4. 保存预览页面:预览同步计划信息,单击保存
  5. 计划列表页面,可查看新建的同步计划,选择新建的同步计划,单击启动
  6. 弹出启动任务页面,调度类型选择立即运行,单击确认
  7. 选择新建的同步计划,单击任务,跳转到任务列表页面等待同步任务运行变为成功状态。查看任务

上线标签

上线后的标签可以进行标签资产编目并对外提供申请使用。

  1. 登录数据资源平台控制台
  2. 在顶部菜单栏单击菜单 > 研发工作台 > 资产加工 > 语义建模,进入语义建模页面。
  3. 单击左侧导航栏标签模型 > 进入,进入对象视图页面,单击新建实体1后的详情页面,查看所有标签。
  4. 单击待上线,勾选实体上的所有标签,单击上线,出现更改标签上线状态成功提示。
  5. 在顶部菜单栏单击菜单 > 运营工作台 > 资产管理 > 资产对象管理 > 标签资产管理列表查看所有上线标签。

创建标签API

将标签生成API,可供其他应用通过调用API来获取数据,从而节省数据传播的成本。

  1. 登录数据资源平台控制台
  2. 在顶部菜单栏单击菜单 > 研发工作台 > 资产加工 > 语义建模,进入语义建模页面。
  3. 在左侧导航栏单击分析引擎 > 查询调试,进入查询调试页面。
  4. 选择云计算资源,输入TQL语句。
    TQL语句:
    select yhkh.zzhm as 证件号码,yhkh.gz as 工资 from yhkh where yhkh.gz > ${gz1,string,'10000'};
  5. 在页面左上角单击测试,查看数据结果、执行的sql以及执行步骤详情。查看数据结果
    • 单击返回JSON,查看JSON格式。
    • 单击执行的SQL,查看执行的SQL语句。
    • 单击步骤详情,查看执行的每一步耗时。
  6. 单击生成API按钮,弹出发布API页面,填写API名称、path、分组和描述,单击确定
    发布API配置项:
    配置项 示例
    API名称 月入过万客户
    API Path yrgw
    版本 1.0.0
  7. 单击左侧导航栏分析引擎 > API列表,可查看新建的API。查看API
  8. 单击新建API后的发布,弹出版本管理页面,选择操作,单击确认,出现发布版本成功提示。