Data Mover 命令中包含必要参数和可选参数。要指定这些参数,可以直接在命令行中键入参数,也可以将参数输入命令所使用的 XML 文件。通常情况下,使用 XML 文件更为便捷,因为这些文件可重复使用且易于修改,并无需在每次运行命令时都键入参数值。
在本手册中,用于指定命令参数的 XML 文件称为 parameters.xml。
如果在 parameters.xml 中定义了某个参数,同时又直接在命令行中定义了同一个参数,则会显示一条消息,并将优先采用命令行中的值。
XML 文件中的大小写
创建或修改 XML 文件时,您要为与命令参数对应的各个元素指定值。元素的名称以 XML 开始和结束标记括起,这些名称区分大小写,必须以示例 XML 文件中所示的形式显示。例如,job_name 元素必须使用小写字母,不得改为 JOB_NAME。
您指定或更改的值中,有些值不区分大小写。例如,元素 export_without_spool 的值既可以输入为 true,也可以输入为 TRUE。这两个值均有效。对于 create 命令,以下两个示例 XML 文件等同。
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <!-- lowercase values --> <dmCreate xmlns="http://schemas.teradata.com/dataMover/v2009" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schemas.teradata.com/unity/datamover.xsd"> <job_name>floyd_dmdev_create</job_name> <source_tdpid>floyd</source_tdpid> <source_user>dmguest</source_user> <source_password>please</source_password> <target_tdpid>dmdev</target_tdpid> <target_user>dmguest</target_user> <target_password>please</target_password> <data_streams>4</data_streams> <max_agents_per_task>4</max_agents_per_task> <source_sessions>4</source_sessions> <target_sessions>4</target_sessions> <force_utility>tptapi</force_utility> <log_level>0</log_level> <database selection="unselected"> <name>dmguest</name> <table selection="included"> <name>orders_2010</name> <export_without_spool>true</export_without_spool> <validate_row_count>partial</validate_row_count> <sql_where_clause> <![CDATA[WHERE colA > 100]]> </sql_where_clause> <key_columns> <key_column>colA</key_column> </key_columns> <staging_to_target>insert_only</staging_to_target> </table> </database> </dmCreate>
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <!-- UPPERCASE VALUES --> <dmCreate xmlns="http://schemas.teradata.com/dataMover/v2009" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schemas.teradata.com/unity/datamover.xsd"> <job_name>floyd_dmdev_create</job_name> <source_tdpid>floyd</source_tdpid> <source_user>dmguest</source_user> <source_password>please</source_password> <target_tdpid>dmdev</target_tdpid> <target_user>dmguest</target_user> <target_password>please</target_password> <data_streams>4</data_streams> <max_agents_per_task>4</max_agents_per_task> <source_sessions>4</source_sessions> <target_sessions>4</target_sessions> <force_utility>TPTAPI</force_utility> <log_level>0</log_level> <database selection="unselected"> <name>dmguest</name> <table selection="included"> <name>orders_2010</name> <export_without_spool>TRUE</export_without_spool> <validate_row_count>PARTIAL</validate_row_count> <sql_where_clause> <![CDATA[WHERE colA > 100]]> </sql_where_clause> <key_columns> <key_column>colA</key_column> </key_columns> <staging_to_target>INSERT_ONLY</staging_to_target> </table> </database> </dmCreate>
下表列出了不区分大小写的值:
元素 | 值 |
---|---|
force_utility | DSA |
TPTAPI | |
TPTAPI_LOAD | |
TPTAPI_UPDATE | |
TPTAPI_STREAM | |
JDBC | |
T2T | |
export_without_spool overwrite_existing_objects online_archive |
TRUE |
FALSE | |
FALSE | |
UNSPECIFIED | |
force_target_staging_table | TRUE |
FALSE | |
validate_row_count | NONE |
PARTIAL | |
ALL | |
staging_to_target | NOT_SPECIFIED |
DELETE_INSERT | |
MERGE | |
INSERT_ONLY | |
status_mode | A |
N | |
I | |
R | |
C | |
F | |
RS | |
Q | |
UC | |
B | |
action_time | BEFORE |
AFTER | |
enabled(action_time 元素的一个属性) | YES |
NO | |
index_type | HASH_INDEX |
JOIN_INDEX |
值 TRUE 和 FALSE 对于某些元素和属性也不区分大小写,这些元素和属性包括:
- compare_ddl
- override_lock_access
- use_userid_pool
- sync(dmCreate 和 dmEdit 元素的一个子元素)
- all 和 skip_prompt(delete_job 元素的子元素)
- copyStats(表或索引元素的一个属性)