[]
本节详细介绍直连模型的创建与使用流程，帮助用户快速掌握模型搭建方法，提升数据使用效率。
数据准备： 确保系统已成功创建可用的数据源或数据集。
步骤一：进入直连模型数据准备界面
在文档门户中可通过以下两种方式创建直连模型（具体操作界面详见下方对比表格）：
快捷创建：文档门户单击工作空间进入文档列表，找到数据模型后鼠标悬停单击“+”按钮，即可进入数据模型选择界面。
完整创建：文档门户单击工作空间进入文档列表，选中数据模型进入数据模型列表界面，在该界面单击 +创建数据模型 按钮，即可进入数据模型选择界面。
快捷创建：鼠标悬停创建数据模型 | 完整创建：数据模型列表界面创建数据模型 |
|---|---|
|
|
在数据模型选择界面，选择直连模型并单击创建按钮，即可进入直连模型的配置界面。
步骤二：配置模型数据源并添加数据
在直连模型数据准备界面，首先选择数据源类型，支持共享数据源和内嵌数据源，支持通过搜索关键字或排序筛选快速定位数据源，配置完成后单击下一步，即可进入表选择与编辑界面。
数据源类型说明：
数据源类型 | 说明 | 示例图 |
|---|---|---|
共享数据源 | 点击数据源下拉列表，在展开的列表中选择所需的数据源。 1. 数据源下拉列表中展示的内容 1）权限范围：当前用户创建的、其他用户分享给当前用户的数据源。 2）类型限制：仅展示直连模型适配的数据源类型。 详细支持类型可参考：数据源支持矩阵：建模方式。 |
|
内嵌数据源 | 选择内嵌数据源需配置全新的数据源，完成配置单击测试数据连接并提示连接成功后，单击下一步即可使用。 |
|
注意：
Mysql数据库要求： 如果要使用MySql数据库，必须使用8.0及以上版本。ostgres（支持限定Schema，具体做法请查看Postgres数据连接）、TimeScale、AnalyticDB(MySQL)、MariaDB、DB2和MonetDB。
直连模型支持数据库类型： 支持Oracle、SQLServer、Mysql、Postgres（支持限定Schema，具体做法请查看Postgres数据连接）、TimeScale、AnalyticDB(MySQL)、MariaDB、DB2和MonetDB。
共享数据源扩展支持： 如使用共享数据源，在以上数据库的基础上还支持WebJSON、Snowflake、ClickHouse和GaussDB（DWS）的使用。
完成数据连接之后，点击“下一步”进入到选择和编辑表的页面。在这个页面中，选择要加入到模型的表或视图。
界面功能说明：
快速检索： 通过搜索框查找目标表/视图
表/视图切换： 勾选仅显示表或视图
别名设置： 列表中展示的为数据库中的表名，可以通过设置别名将表名修改为易于用户理解的表名。
关系和相关表设置：
设置项 | 设计器示意图（圆圈表示表，箭头表示表之间的关系 ） | 说明 |
|---|---|---|
|
| “包含当前关系”和“包含相关表”两个选项都勾选，会将与所选择的表及其表关系所关联的表都一并添加。 |
|
| 仅勾选“包含当前关系”，所选择的表和其他表之间有表关系，仅所选择的表和他们的表关系会被添加至数据模型。 例如： 表A和表B之间有表关系，表B和表C有关联关系。 1. 仅表A被选中，仅表A会被添加至数据模型。 2. 表A和表B被选中，表A和表B及其表关系会添加至数据集。 |
|
| “包含当前关系”和“包含相关表”两个选项都未被勾选，则仅会将所选择的表或视图添加至数据模型，其表关系不会被添加。 我们所看到就是独立的数据表，不包含任何表关系。 |
选择数据库的表或视图后，点击下一步进入列选择与编辑页面。该页面将列出所选数据表的所有字段，勾选列名前的复选框即可将该列添加至模型表。您还可以为各列设置别名以便识别，既支持手动输入，也可单击自动生成别名按钮快速生成。
注意：
“自动生成别名”，若连接数据源的数据库内已配置字段说明，点击后会自动将字段说明填充为字段别名，快速完成别名配置；若数据库未录入字段描述，点击该按钮无效果。
步骤三：配置表关系
完成数据的配置之后，点击完成，进入到模型设计器中。
在数据准备界面中，已建立关系的表可跳过此步骤，未关联的表需设置表间关系以确保数据模型完整性。数据模型使用圆圈和方向箭头抽象表示表关系，箭头方向代表数据过滤方向 (起点表可过滤终点表)， 详情请参考表关系管理。
在左侧的模型表列表区域中展示所添加的模型表。
在中间的画布区域用ER图的形式展示模型表及其关系。
提示： 建议将模型图调整为层级树状布局——自下而上逐层展示表间过滤关系，使数据流向一目了然。
步骤四：设置过滤器
完成表关系配置后，即可为对应表设置数据过滤条件。具体步骤详见：行数据过滤。
步骤五：验证并保存模型
模型设置完成后，单击顶部菜单栏的验证按钮，系统将自动检查模型逻辑的准确性。验证通过后，单击保存按钮，输入模型名称即可保存模型。保存成功的模型可在「文档门户>工作空间>数据模型」进行查看，支持对模型进行管理及分享，被分享用户可在仪表板中选择并使用该模型进行数据展示。
新建模型保存： 需输入模型名称，可选择性填写描述信息
编辑现有模型保存： 可选择性填写描述信息
步骤六：模型的查看与使用
模型保存完成之后，点击设计器左上角的关闭按钮即可退出设计器。回到门户网站，在工作空间的数据模型分类中找到刚刚添加的直连模型，
点击模型名称即可进行预览。预览区域左侧面板显示模型表列表，点击模型表名，即可在右侧预览数据。
注意： 预览时出于性能的考虑，仅预览前100条数据。
本章介绍直连模型的标准创建流程，实际业务场景中，可结合自身需求查阅对应功能章节作为补充。
保存后的模型支持管理及分享，被分享用户可在仪表板中选择并使用该模型进行数据展示。
