
# 配置DWS源端参数
表1DWS作为源端时的作业参数 
| 参数类型 | 参数名                                                       | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 取值样例                                  |
|:---|:---|:---|:---|
| 基本参数 | 使用SQL语句                                                   | 导出关系型数据库的数据时，您可以选择使用自定义SQL语句导出。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 否                                     |
| 基本参数 | SQL语句                                                     | "使用SQL语句"选择"是"时，您可以在这里输入自定义的SQL语句，CDM将根据该语句导出数据。 说明： - SQL语句只能查询数据，支持join和嵌套写法，但不能有多条查询语句，比如 select \* from table a; select \* from table b。  - 不支持with语句。  - 不支持注释 ，比如 "--" ，"/\*"。  - 不支持增删改操作，包括但不限于以下操作： - load data  - delete from  - alter table  - create table  - drop table  - into outfile    - 如果SQL语句过长，会导致请求过长下发失败，继续创建作业系统会报错"错误请求"，此时您需要简化或清空SQL语句，再次尝试继续创建作业。   | select id,name from sqoop.user;       |
| 基本参数 | 模式或表空间                                                    | "使用SQL语句"选择"否"时，显示该参数，表示待抽取数据的模式或表空间名称。单击输入框后面的按钮可进入模式选择界面，用户也可以直接输入模式或表空间名称。 如果选择界面没有待选择的模式或表空间，请确认对应连接里的账号是否有元数据查询的权限。 说明： 该参数支持配置通配符（\*），实现导出以某一前缀开头或者以某一后缀结尾的所有数据库。例如： - **SCHEMA\***表示导出所有以"SCHEMA"开头的数据库。  - **\*SCHEMA**表示导出所有以"SCHEMA"结尾的数据库。  - **\*SCHEMA** **\***表示数据库名称中只要有"SCHEMA"字符串，就全部导出。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | SCHEMA_E                              |
| 基本参数 | 表名                                                        | "使用SQL语句"选择"否"时，显示该参数，表示要抽取的表名。单击输入框后面的按钮可进入表的选择界面，用户也可以直接输入表名称。 如果选择界面没有待选择的表，请确认表是否已经创建，或者对应连接里的账号是否有元数据查询的权限。 该参数支持配置为时间宏变量，且一个路径名中可以有多个宏定义变量。使用时间宏变量和定时任务配合，可以实现定期同步新增数据，详细说明请参见[使用时间宏变量完成增量同步](https://support.huaweicloud.com/bestpractice-dataartsstudio/dataartsstudio_05_0006.html)。 该参数支持配置正则表达式，实现导出满足规则的所有数据库。例如：表名配置为*user_\[0-9\]{1,2}*，会匹配 user_0 到 user_9，user_00 到 user_99 的表。 说明： 表名支持配置通配符（\*），实现导出以某一前缀开头或者以某一后缀结尾的所有表（要求表中的字段个数和类型都一样）。例如**：** - **table\***表示导出所有以"table"开头的表。  - **\*table**表示导出所有以"table"结尾的表。  - **\*table** **\***表示表名中只要有"table"字符串，就全部导出。   说明： 如果配置了时间宏变量，通过DataArts Studio数据开发调度CDM迁移作业时，系统会将时间宏变量替换为"数据开发作业计划启动时间-偏移量"，而不是"CDM作业实际启动时间-偏移量"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | table                                 |
| 高级属性 | Where子句                                                   | "使用SQL语句"选择"否"时，显示该参数，表示配置抽取范围的Where子句，不配置时抽取整表。 指定抽取的是WHERE子句，不指定则抽取整表。如果要迁移的表中没有WHERE子句的字段，迁移失败。例如：age \> 18 and age \<= 60。 该参数支持配置为时间宏变量，实现抽取指定日期的数据，详细说明请参见[关系数据库增量迁移](https://support.huaweicloud.com/bestpractice-dataartsstudio/dataartsstudio_05_0005.html)。 说明： 如果配置了时间宏变量，通过DataArts Studio数据开发调度CDM迁移作业时，系统会将时间宏变量替换为"数据开发作业计划启动时间-偏移量"，而不是"CDM作业实际启动时间-偏移量"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | DS='${dateformat(yyyy-MM-dd,-1,DAY)}' |
| 高级属性 | 抽取分片字段                                                    | 抽取数据时使用该字段进行数据切分，CDM依据此字段将作业分割为多个任务并发执行。一般使用数据均匀分布的字段，例如以自然增长的序号字段作为分片字段。 单击输入框后面的按钮可进入字段选择界面，用户也可以直接输入抽取分片字段名。 说明： 抽取分区字段支持TINYINT、SMALLINT、INTEGER、BIGINT、REAL、FLOAT、DOUBLE、NUMERIC、DECIMAL、BIT、BOOLEAN、DATE、TIME、TIMESTAMP类型，建议该字段带有索引。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | id                                    |
| 高级属性 | 分片字段是否允许空值  | 是否允许分片字段包含空值。 多并发抽取时，若确定分片字段不含Null，将该值设为"否"可提升性能，若不确定，请设为"是"，否则可能会丢数据。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 是                                     |
   
