1. 概述

您在完成数据连接之后，即可进行数据模型的创建，支持直接使用原表创建数据模型、多表join/union生成数据模型；而对于一些复杂逻辑可以使用自定义 SQL 生成逻辑表，本文将介绍如何通过自定义SQL 创建数据模型。

2. 快速入门

（1）点击 数据源>数据模型>+>新建模型，从已有数据连接中选择目标数据源，或者直接从头新建数据连接；
自定义SQL - 图1

（2）在模型配置页面中，点击左侧 自定义表>+>新建自定义SQL，即可打开添加自定义SQL视图页面； 自定义SQL - 图2

（3）视图名称设置完成后，便可以在下方 SQL 编辑区自行输入 SQL 语句，也可以输入#号插入全局参数； 自定义SQL - 图3

  • SQL 语句的语法规则需要和连接的数据库适配；
  • 若输入的SQL语句校验通过，会展示当前语句中涉及到表名，默认勾选“是否参与依赖计算”
  • “参与依赖计算”：表示参与依赖抽取。当对表设置抽取并开启依赖执行，可调用接口触发依赖抽取；未参与依赖计算的表调用无效。详细接口调用可查看该文档：表数据更新通知接口

自定义SQL - 图4 自定义SQL - 图5 自定义SQL - 图6

（4）点击确定后，完成自定义SQL视图的创建，您可将其拖入右侧画布中，进行后续操作。 自定义SQL - 图7

3. 功能介绍

3.1 原始表与自定义表区别

表类型 数据源类型支持限制 数据库语法限制
原始表 所有数据源均支持 无限制
自定义表 仅数据库来源支持，详细清单见支持的数据源范围 根据数据库类别，对 SQL 语法有限制，比如数据连接是 MySQL，不支持 Oracle 的语法

3.2 自定义表管理

完成自定义SQL视图创建后，新建的表会出现在自定义表tab中，可通过右键唤出菜单执行查看数据、编辑、调整分类和删除操作。
自定义SQL - 图8