17.10 - crear - 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 create crea un trabajo en el daemon a partir de los parámetros de sintaxis y de la lista de objetos. Una definición de trabajo consiste en los parámetros y la lista de objetos.

Sintaxis

Consulte Esquemas XML de Data Mover.

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
execute_permission
[Opcional] Define el nombre de usuario y el rol con permiso de ejecución para el trabajo creado.
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
freeze_job_steps
(Opcional) Bloquea los pasos del trabajo para que no se vuelvan a crear cada que vez que se inicia el trabajo. Solo se debe establecer como true si los entornos de origen y de destino no cambian tras la creación del trabajo.
Valores válidos
  • true: los pasos del trabajo no se vuelven a crear cada que vez que se inicie el trabajo.
  • false: los pasos del trabajo se vuelven a crear cada vez que se inicie el trabajo.
  • unspecified (valor predeterminado): el valor se establece como false.
Ejemplo: true
job_name
[Opcional] Nombre para este trabajo. El nombre debe ser único y tener 32 caracteres como máximo.
Si no se especifica un nombre, se generará automáticamente con el formato: <source tdpid >_<target tdpid >_<date time year>.
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
job_security
[Opcional] Define los parámetros de acceso para el trabajo creado.
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.
log_to_event_table
[Opcional] Especifica la tabla de eventos que se usará para este trabajo. Para obtener más información, consulte Uso de tablas de eventos.
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
owner_name
[Opcional] Usuario que creó el trabajo.
Ejemplo: owner
Se debe establecer si la seguridad del daemon está desactivada o si el usuario es el superusuario (dmcl_admin). De lo contrario, el usuario que está conectado actualmente sobrescribirá el valor.
read_permission
[Opcional] Define el nombre de usuario (o usuarios) y el rol (o roles) con permiso de lectura para el trabajo creado.
response_timeout
[Opcional] Cantidad de tiempo, en segundos, durante el que espera la respuesta desde el Daemon de Data Mover.
Ejemplo: 60
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
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.
write_permission
[Opcional] Define el nombre de usuario y el rol con permiso de escritura para el trabajo creado.

Notas sobre el uso

Escriba datamove create -f parameters.xml para crear un trabajo. El nombre del trabajo se muestra en pantalla una vez que se completa el comando create. Recuerde el nombre del trabajo para utilizarlo con otros comandos, tales como stop y start.

El comando create no inicia el trabajo. Utilice el comando start para iniciar el trabajo o el comando edit para revisar los scripts del trabajo.

Ejemplo de archivo XML

Para el comando create, escriba datamove create -f parameters.xml.

El siguiente ejemplo muestra un archivo de parámetros del comando create.
<?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>
    <db_client_encryption>false</db_client_encryption>
    <database selection="unselected">
        <name>dmguest</name>
        <table selection="included">
            <name>test1</name>
            <db_client_encryption>true</db_client_encryption>
        </table>
        <table selection="included">
            <name>test2</name> 
        </table> 
        <table selection="included">
            <name>test3</name>
        </table>
    </database>
    <query_band>Job=payroll;Userid=aa1000000;Jobsession=1122;</query_band> 
    <job_security>
         <owner_name>owner</owner_name>
    <read_permission>
        <username>read_user1</username>
        <username>read_user2</username>
        <role>read_role1</role>
        <role>read_role2</role>
    </read_permission> 
    <write_permission>
        <username>write_user1</username>
        <username>write_user2</username>
        <role>write_role1</role>
        <role>write_role2</role>
    </write_permission>
    <execute_permission>
        <username>execute_user1</username>
        <username>execute_user2</username>
        <role>execute_role1</role>
        <role>execute_role2</role>
    </execute_permission> 
    </job_security>
</dmCreate>