Propósito
El comando move crea un trabajo para copiar los objetos de base de datos especificados de una base de datos a otra y, a continuación, inicia el trabajo inmediatamente. Utilice el comando para crear e iniciar un trabajo rápidamente sin la lista de objetos XML especificando las tablas en la línea de comandos.
Para trabajos que utilizan Teradata DSA, el usuario de la base de datos del sistema de destino en el que se copian las tablas debe tener privilegios RESTORE y no debe estar conectado mientras se ejecuta el trabajo, o se producirá un error en el trabajo.
Sintaxis
Esquemas XML de Data MoverParámetros
Consulte Orden de parámetros.
- data_streams
- [Opcional] Número de flujos de datos que se utilizarán entre las bases de datos de origen y de destino. Se aplica a los trabajos que utilizan Teradata DSA y TPT API (desde y hacia Teradata). Todos los demás protocolos utilizan un único flujo de datos.
- db_client_encryption
- [Opcional] Establecer en true si se debe cifrar el trabajo durante la transferencia de datos.
- dm.rest.endpoint
- [Opcional] Introduzca una URL del servidor REST de Data Mover para sobrescribir el valor predeterminado especificado en el archivo commandline.properties para conectarse a un servidor REST diferente (y, por lo tanto, a un daemon diferente) en tiempo de ejecución.
- force_utility
- [Opcional] Obliga al daemon de Data Mover a usar una utilidad específica para todas las operaciones de copia.
Valores válidos
- dsa
- jdbc
- tptapi
- tptapi_load
- tptapi_stream
- tptapi_update
- T2T
Copiar datos en una versión anterior de Teradata Database mediante Teradata DSA no es válido. No se puede utilizar Teradata DSA si los TDPID de origen y de destino son iguales. - job_name
- [Opcional] Nombre del trabajo. El nombre debe ser exclusivo y debe tener menos de 32 caracteres. Si no se especifica, se genera un nombre de manera automática con el siguiente formato: <source_tdpid>_<target_tdpid>_M<sequential number>.
- job_priority
- [Opcional] Especifica la prioridad de ejecución del trabajo. Los valores admitidos son: ALTA, MEDIA, BAJA y SIN ESPECIFICAR. Si no se especifica ningún valor, el valor por defecto MEDIA se utilizará en tiempo de ejecución.
- log_level
- [Opcional] El nivel de registro del resultado del archivo de registro.
Valores válidos
- 0
- 1
- 2
- 99
- max_agents_per_task
- [Opcional] Número máximo de agentes de Data Mover que se utilizan en paralelo al mover las tablas o las bases de datos.
- netrace
- [Opcional] Parámetro netrace de CLI. Cualquier valor mayor o igual a 0 genera un registro de seguimiento de CLI. Se debe proporcionar un valor de CLI válido.
- netrace_buf_len
- [Opcional] Parámetro de CLI netrace_buf_len. Cualquier valor mayor o igual a 0 genera un registro de seguimiento de CLI. Se debe proporcionar un valor de CLI válido.
- online_archive
- [Opcional] Concede acceso de lectura y escritura a las tablas de origen mientras las tablas se copian con Teradata DSA. Las actualizaciones se producen en la tabla de origen durante la copia, pero no se transfieren a la tabla de destino. Cuando se completa la copia correctamente, los datos que contiene la tabla de destino coinciden con los datos que estaban en la tabla de origen al principio de la copia.Valores válidos
Valor Descripción True Habilita el archivo en línea False Deshabilita el archivo en línea Unspecified Valor predeterminado: el valor se establece como el valor en el archivo de configuración del daemon de Data Mover - overwrite_existing_objects
- [Opcional] El trabajo sobrescribe objetos que ya existen en el destino.Valores válidosSi el parámetro no se especifica, el valor se establecerá como el valor del parámetro overwrite_existing_objects en el archivo de configuración del Daemon de Data Mover. Si el parámetro se especifica como verdadero o falso, ese valor tendrá prioridad sobre el valor del parámetro en el archivo de configuración del Daemon de Data Mover.
Valor Descripción True Habilita la sobrescritura False Deshabilita la sobrescritura Unspecified Valor predeterminado: el valor se establece como el valor en el archivo de configuración del daemon de Data Mover - query_band
- [Opcional] Un conjunto de pares nombre-valor separados por puntos y coma que identifica sesiones o transacciones de Teradata para el origen y el destino de forma exclusiva. Para utilizar un grupo de consultas para identificar el trabajo payroll, el ID de usuario aa100000 y el número de sesiones de trabajo 1122, defina el grupo de consultas de la siguiente manera:
- response_timeout
- [Opcional] Cantidad de tiempo, en segundos, durante el que espera la respuesta desde el Daemon de Data Mover.
- security_password
- [Opcional] Contraseña del superusuario o del usuario autorizado de Viewpoint.
- security_username
- [Opcional] El ID de usuario de superusuario o el usuario autorizado de Viewpoint. El ID de usuario de superusuario es dmcl_admin y no se puede cambiar.
- source_account_id
- [Opcional] ID de cuenta de inicio de sesión de la base de datos de origen.
- source_logon_mechanism
- [Opcional] El mecanismo de inicio de sesión del sistema de origen. Para iniciar sesión en un sistema de Teradata Database de origen, el usuario debe proporcionar al menos uno de los siguientes datos:
- source_user y source_password
- source_logon_mechanism
Los mecanismos de inicio de sesión no son compatibles con trabajos de Teradata DSA. Los mecanismos de inicio de sesión solo se usan con trabajos de Teradata PT API y Teradata JDBC. Si se especifica -source_logon_mechanism y no se utiliza -force_utility, Teradata PT API se utiliza de forma predeterminada. La especificación de -source_logon_mechanism con Teradata DSA especificado para -force_utility da como resultado un error.
- source_logon_mechanism_data
- [Opcional] Parámetros adicionales necesarios para el mecanismo de inicio de sesión del sistema de origen.
- source_password
- [Opcional] Contraseña de inicio de sesión de Teradata de origen.
- source_password_encrypted
- [Opcional] Contraseña de inicio de sesión cifrada de Teradata de origen.
- source_sessions
- [Opcional] Número de sesiones por flujo de datos en la base de datos de origen.
- source_tdpid
- Teradata Database de origen.
- source_user
- [Opcional] ID de inicio de sesión de Teradata de origen.
- source_userid_pool
- [Opcional] El trabajo obtiene el usuario del grupo de credenciales especificado. Está disponible para cualquier tipo de trabajo. Debe utilizar el mismo grupo de credenciales que target_userid_pool si se especifican ambos parámetros en la misma definición de trabajo.
- sync
- [Opcional] Espera a que el trabajo finalice y, entonces, devuelve un código de salida que indica si el trabajo se ha completado correctamente. El código de salida 0 indica que el trabajo finalizó correctamente. Un código de salida distinto de 0 indica un error del trabajo o del comando.
- table
- [Opcional] Tabla que desea copiar.
- target_account_id
- [Opcional] ID de cuenta de inicio de sesión de la base de datos de destino.
- target_logon_mechanism
- [Opcional] El mecanismo de inicio de sesión del sistema de destino. Para iniciar sesión en un sistema de Teradata Database de destino, el usuario debe proporcionar al menos uno de los siguientes datos:
- target_user y target_password
- target_logon_mechanism
Teradata DSA no admite los mecanismos de inicio de sesión. Los mecanismos de inicio de sesión solo se usan con trabajos de Teradata PT API y Teradata JDBC. Si se especifica -target_logon_mechanism y no se utiliza -force_utility, Teradata PT API se utiliza de forma predeterminada. La especificación de -target_logon_mechanism con Teradata DSA especificado para -force_utility da como resultado un error.
- target_logon_mechanism_data
- [Opcional] Parámetros adicionales que se necesitan para el mecanismo de inicio de sesión del sistema de destino.
- target_password
- [Opcional] Contraseña de inicio de sesión de Teradata de destino.
- target_password_encrypted
- [Opcional] Contraseña de inicio de sesión cifrada de Teradata de destino.
- target_sessions
- [Opcional] Número de sesiones por flujo de datos en la base de datos de destino.
- target_tdpid
- [Opcional] Teradata Database de destino.
- target_user
- [Opcional] ID de inicio de sesión de Teradata de destino.
- target_userid_pool
- [Opcional] El trabajo obtiene el usuario del grupo de credenciales especificado. Está disponible para cualquier tipo de trabajo. Debe utilizar el mismo grupo de credenciales que source_userid_pool si se especifican ambos parámetros en la misma definición de trabajo.
- tpt_debug
- [Opcional] Parámetro de registro de depuración de seguimiento de API TPT. Cualquier valor mayor o igual que 0 genera un registro de seguimiento de la API TPT. Se debe proporcionar un valor válido de la API TPT.
- uowid
- [Opcional] El ID alternativo o el nombre del grupo de tareas asociado al trabajo. Si se proporciona un valor para este parámetro, Data Mover registrará este valor como el ID de la unidad de trabajo cuando envíe eventos a Teradata Ecosystem Manager o a su tabla interna TMSMEVENT. Si no se especifica este parámetro, Data Mover utilizará un valor por defecto como ID de la unidad de trabajo al enviar eventos a Teradata Ecosystem Manager o a su tabla interna TMSMEVENT. El valor por defecto del ID de la unidad de trabajo se compone del nombre de ejecución del trabajo y de la marca de hora actual. Por ejemplo, si desea definir los orígenes de un origen de consulta cuyo nombre de ejecución de trabajo es sales_table, el valor por defecto del ID de la unidad de trabajo será sales_table-20211110122330.
Ejemplo de archivo XML
Para el comando move, escriba datamove move -f parameters.xml.
En el ejemplo siguiente, se utiliza el elemento <dmCreate> en el archivo XML, en lugar del elemento <dmMove>.
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<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>5</data_streams>
<source_sessions>1</source_sessions>
<target_sessions>1</target_sessions>
<force_utility>dsa</force_utility>
<log_level>0</log_level>
<database selection="unselected">
<name>dmguest</name>
<table selection="included">
<name>test1</name>
</table>
<table selection="included">
<name>test2</name>
</table>
<table selection="included">
<name>test3</name>
</table>
</database>
<uowid>sales_tables_move</uowid>
<query_band>Job=payroll;Userid=aa1000000;Jobsession=1122;</query_band>
</dmCreate>