# 关系型数据库数据集
基于关系型数据库，如MS SQL Server、MySQL、Oracle、GaussDB或PostgreSQL创建的数据集。
#### 前提条件
连接的数据源已创建，如何创建请参见[关系型数据库数据源](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6159.html)。
#### 约束与限制
"数据配置"选择"SQL模式"时，输入的SQL语句中如果含有和数据库中字段名称相同的关键字，关键字格式需遵循如下规则：
- MySQL数据库加反引号"\`\`" MySQL数据库中，常用的关键字有value、data、desc、day、all和add，更多关键字请参见[MySQL5.7官方保留字与关键字](https://dev.mysql.com/doc/refman/5.7/en/keywords.html)、[MySQL8.0官方保留字与关键字](https://dev.mysql.com/doc/refman/8.0/en/keywords.html)。
  

- PostgreSQL或GaussDB数据库加双引号 """" PostgreSQL和GaussDB数据库中，常用的关键字有value、user、 date、desc、day、all，更多关键字介绍请参见[PostgreSQL或GaussDB官方保留字与关键字](https://www.postgresql.org/docs/current/sql-keywords-appendix.html)。
  

- SQL Server数据库加"\[\]" SQL Server数据库中常用的关键字有value、user、 date、desc、day和all，更多关键字介绍请参见[SQL Server官方保留字与关键字](https://learn.microsoft.com/zh-cn/sql/t-sql/language-elements/reserved-keywords-transact-sql?view=sql-server-ver16)。
  
- Oracle数据库加双引号""""。 Oracle数据库中常用的关键字有value、user、 date、desc、day和all，更多关键字介绍请参见[Oracle官方保留字与关键字](https://docs.oracle.com/database/121/SQLRF/ap_keywd001.htm#SQLRF55621)。
  
 
 #### 创建关系型数据库数据集
1. 参考[登录华为云Astro大屏应用界面](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6008.html)中操作，登录华为云Astro大屏应用界面。
2. 在主菜单中，选择"数据中心"。
3. 在左侧导航栏中，选择"数据集 \> 全部"。
4. 在数据集管理页面，单击"新建数据集"。
5. 在新增数据集页面，设置数据集名称、选择数据类型、数据源和目录，单击"保存"。 
   图1新建数据集   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158424061.png)
   - 数据集名称：新建数据集的名称，用于标识该数据集。长度为1\~60个字符，可包括中文、字母、数字及下划线。
   
   - 数据类型：选择"关系型数据库"。
   
   - 数据源：选择[关系型数据库数据源](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6159.html)中，创建的数据源。
   
   - 目录：设置数据集的存放目录，配置为[（可选）新建目录](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6152.html)中新建的目录，也可以直接单击"新增目录"，新建一个目录。
   
   - 责任人：数据集的创建人。
   
   - 描述：新建数据集的描述信息，通常设置为数据集的功能。
   
   
   
   
6. 设置数据集参数。 
   图2设置关系型数据库数据集参数   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158305733.png "点击放大")
   - 界面模式 该模式为界面化操作，需要选择具体的数据表、返回字段。单击"+"可新增分组字段、设置展示数据的过滤条件、将展示结果根据某个字段可进行升序或者降序排序、限定返回的总记录数。本示例选择界面模式，如选择city表，设置返回如下字段。
     - 返回字段：设置返回的字段，可设置字段别名。
       图3选择返回字段   
       ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123025936.png "点击放大") 
     
     - 字段分组：按该字段分组，单击"+"可添加该参数。
     
     - 过滤：设置展示数据的过滤条件，单击"+"可添加该参数。
     
     - 排序：将展示结果根据某个字段可进行升序或者降序排序，单击"+"可添加该参数。
     
     - 限制数据行数：设置返回数据的行数，单击"+"可添加该参数。
      
   
   - SQL模式
     该模式需要输入SQL语句，支持选择数据表、设置变量，变量定义格式为"${*变量名* }"，如[图4]。自定义的SQL语句（仅支持以select或with开头），返回数据字段如果为变量则需指定别名，同时样例数据需使用别名。
     ```
     select * from student  where 身高> ${height};
     ```
     图4定义变量   
     ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002136187570.png "点击放大")
     创建关系型数据库数据源时，如果数据库类型选择"GaussDB"或"PostgreSQL"，还支持从指定的schema中，选择数据表。如果不指定schema，默认从public类型的数据库表中获取数据。其中，"pg_catalog"为指定的schema，"pg_index"为数据库中的表。
     ```
     select * from pg_catalog."pg_index"
     ```
     自定义SQL语句时，通过输入"$"，可进入表达式设置页面。在表达式设置页面，可从下方左侧面板选择字段名、函数或者直接输入函数，如[图5]。
     图5表达式设置   
     ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002171626689.png "点击放大") 
    
   
   
7. 单击"保存"，完成数据集的创建。
 
#### 在组件中使用数据集
1. 返回华为云Astro大屏应用项目列表页面。
2. 进入开发页面，拖拽所需组件（如基本柱图）到画布中。 
   图6从图表中拖拽基本柱图到画布中   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158305693.png "点击放大")
   
   
3. 选中该组件，单击组件上方的![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002112534904.png)，进入组件数据页面。
4. 在"数据类型"下拉框中，选择"数据集"，选择[创建关系型数据库数据集]中创建的数据集。
5. 配置全局变量。 
   全局变量可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的，例如图表联动、自定义字段等功能。如何使用全局变量，可参考[如何基于页面级的全局变量实现组件交互](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6173.html)\~[如何通过全局变量，实现组件数据的动态变化](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_7037.html)。本示例不做配置。
   
   
6. 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击"保存"。 
   图7拖拽字段到对应坐标轴   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158424073.png "点击放大")
   - 表格字段：展示[创建关系型数据库数据集]中，接入的关系型数据库中的数据。
   
   - 配置：从表格字段中，拖拽所需的字段到X轴数据、Y轴数据或系列中。
   
   - 刷新周期：每隔多少秒从关系型数据库中读取一次数据，默认配置为"0"，表示只获取一次。
   
   - 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的关系型数据库请求，不会各自只调用，而是共享结果数据。
   
   
   
   
7. 选中基本柱图组件，单击组件上方的![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002148293797.png)，设置标题内容为"N省各市人口数量（千万）"。
   
   图8设置图表标题   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123184064.png "点击放大")
   
   
8. 单击页面上方的![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123286424.png)，保存设置页面。
9. 单击![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158647057.png)，进入预览页面，预览效果。