17.10 - Archivos XML de Data Mover - Teradata Data Mover

Teradata® Data Mover Guía del usuario

Product
Teradata Data Mover
Release Number
17.10
Release Date
Junio de 2021
Content Type
Guía del usuario
Publication ID
B035-4101-061K-ESN
Language
Español (España)

Los comandos de Data Mover tienen parámetros obligatorios y opcionales que se pueden especificar al escribirlos directamente en la línea de comandos o en un archivo XML que utiliza el comando. A menudo, es más conveniente utilizar archivos XML porque se pueden reutilizar y modificar con facilidad sin tener que escribir los valores de parámetro cada vez que se ejecuta un comando.

Los archivos XML que especifican parámetros de comandos se denominan parameters.xml en este manual.

Si el mismo parámetro se define en parameters.xml y también en la línea de comandos, aparecerá un mensaje y el valor de la línea de comandos tendrá prioridad.

Distinción entre mayúsculas y minúsculas en archivos XML

Al crear o modificar un archivo XML, se especifican valores de elementos que corresponden a parámetros de comando. Los nombres de los elementos, que se adjuntan al abrir y cerrar etiquetas XML, distinguen mayúsculas y minúsculas, y deben aparecer como se muestra en los archivos XML de ejemplo. Por ejemplo, el elemento job_name se debe escribir en minúsculas y no se debe cambiar por JOB_NAME.

Algunos valores que se especifican o se cambian no distinguen mayúsculas y minúsculas. Por ejemplo, se puede introducir el valor del elemento export_without_spool como true o TRUE, ambos son válidos. Para el comando create, los dos archivos XML de ejemplo siguientes son equivalentes.

<?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>

En la siguiente tabla se muestran los valores que no distinguen entre mayúsculas y minúsculas:

Elemento Valor
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
habilitado (un atributo del elemento action_time) YES
NO
index_type HASH_INDEX
JOIN_INDEX
Además, los valores TRUE y FALSE no distinguen mayúsculas y minúsculas para varios elementos y atributos, incluidos los siguientes:
  • compare_ddl
  • override_lock_access
  • use_userid_pool
  • sync (un elemento secundario de los elementos dmCreate y dmEdit)
  • all y skip_prompt (elementos secundarios del elemento delete_job)
  • copyStats (un atributo de los elementos de tabla o de índice)