16.20 - Data Mover XML 文件 - Teradata Data Mover

Teradata® Data Mover 用户指南

Product
Teradata Data Mover
Release Number
16.20
Published
2021 年 11 月
Content Type
用户指南
Publication ID
B035-4101-107K-CHS
Language
中文 (简体)

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 ARC
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
TRUEFALSE 对于某些元素和属性也不区分大小写,这些元素和属性包括:
  • compare_ddl
  • override_lock_access
  • use_userid_pool
  • sync(dmCreate 和 dmEdit 元素的一个子元素)
  • all 和 skip_prompt(delete_job 元素的子元素)
  • copyStats(表或索引元素的一个属性)