17.10 - move - 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)

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.

Pará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.
Ejemplo: 4
El valor por defecto lo calcula dinámicamente Data Mover.
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.
https://dm-server1:1443/datamover
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
Si no se especifica este valor, el daemon de Data Mover determinará qué utilidad de Teradata es la más adecuada para usar en el trabajo.
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.
Ejemplo: dsa
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.
Ejemplo: MEDIUM
log_level
[Opcional] El nivel de registro del resultado del archivo de registro.

Valores válidos

  • 0
  • 1
  • 2
  • 99
Ejemplo: 2
El valor por defecto es 0.
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.
Ejemplo: 4
El valor por defecto lo calcula dinámicamente Data Mover.
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
Ejemplo: true
overwrite_existing_objects
[Opcional] El trabajo sobrescribe objetos que ya existen en el destino.
Valores válidos
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
Si 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.
Ejemplo: true
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:
Ejemplo: Job=payroll;Userid=aa1000000;Jobsession=1122;
Este parámetro se debe agregar como el último parámetro en la definición de trabajo del XML. Consulte Acerca de la agrupación de consultas para ver las reglas de sintaxis detalladas para definir un grupo de consultas.
response_timeout
[Opcional] Cantidad de tiempo, en segundos, durante el que espera la respuesta desde el Daemon de Data Mover.
Ejemplo: 60
security_password
[Opcional] Contraseña del superusuario o del usuario autorizado de Viewpoint.
Ejemplo: 53cUr17y
Se necesita si la gestión de seguridad está habilitada en el Daemon de Data Mover. No es un parámetro válido si también se especifica -security_password_encrypted.
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.
Se necesita si la gestión de seguridad está habilitada en el Daemon de Data Mover.
source_account_id
[Opcional] ID de cuenta de inicio de sesión de la base de datos de origen.
La existencia de espacios en el nombre de cuenta del ID de cuenta hace que no se realice el trabajo correctamente.
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.

Ejemplo: KRB5
source_logon_mechanism_data
[Opcional] Parámetros adicionales necesarios para el mecanismo de inicio de sesión del sistema de origen.
Ejemplo: joe@domain1@@mypassword
source_password
[Opcional] Contraseña de inicio de sesión de Teradata de origen.
Ejemplo: 123456789
No es un parámetro válido si también se especifica -source_password_encrypted. Si no se especifica una contraseña para este parámetro, el comando solicitará que se introduzca una de manera interactiva. Las entradas se enmascaran con un número de asteriscos determinado, independientemente de la longitud de la contraseña.
source_password_encrypted
[Opcional] Contraseña de inicio de sesión cifrada de Teradata de origen.
Ejemplo: 17894cc84b5637a88e36fa37a010e3662d18f64b8ce204bef8d63868ad417810
No es un parámetro válido si también se especifica -source_password.
source_sessions
[Opcional] Número de sesiones por flujo de datos en la base de datos de origen.
Ejemplo: 4
El valor por defecto lo calcula dinámicamente Data Mover.
source_tdpid
Teradata Database de origen.
Ejemplo: Checks
source_user
[Opcional] ID de inicio de sesión de Teradata de origen.
Ejemplo: TD_API_user
Si no especifica un ID de inicio de sesión para este parámetro, el comando solicitará que se introduzca uno de manera interactiva.
La existencia de espacios en el nombre de usuario del ID de origen o de destino hace que no se realice el trabajo correctamente.
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.
Ejemplo: POOL-1
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.
Ejemplo: DB1.TABLE
target_account_id
[Opcional] ID de cuenta de inicio de sesión de la base de datos de destino.
La existencia de espacios en el nombre de cuenta del ID de cuenta hace que no se realice el trabajo correctamente.
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.

Ejemplo: KRB5
target_logon_mechanism_data
[Opcional] Parámetros adicionales que se necesitan para el mecanismo de inicio de sesión del sistema de destino.
Ejemplo: my@domain2@@mypassword
target_password
[Opcional] Contraseña de inicio de sesión de Teradata de destino.
Ejemplo: 212133344
No es un parámetro válido si también se especifica -target_password_encrypted. Si no se especifica una contraseña para este parámetro, el comando solicitará que se introduzca una de manera interactiva. Las entradas se enmascaran con un número de asteriscos determinado, independientemente de la longitud de la contraseña.
target_password_encrypted
[Opcional] Contraseña de inicio de sesión cifrada de Teradata de destino.
Ejemplo: 30e458fce484cefef07724653f5046095208f69fcfbf76bf7290b8576192c2fe
No es un parámetro válido si también se especifica -target_password.
target_sessions
[Opcional] Número de sesiones por flujo de datos en la base de datos de destino.
Ejemplo: 4
El valor por defecto lo calcula dinámicamente Data Mover.
target_tdpid
[Opcional] Teradata Database de destino.
Ejemplo: Leo
target_user
[Opcional] ID de inicio de sesión de Teradata de destino.
Ejemplo: TD_tar_User
Si no especifica un ID de inicio de sesión para este parámetro, el comando solicitará que se introduzca uno de manera interactiva.
La existencia de espacios en el nombre de usuario del ID de origen o de destino hace que no se realice el trabajo correctamente.
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.
Ejemplo: POOL-1
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-20110115155656EST.
Ejemplo: sales_tables_move

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>