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
Parámetros
Consulte Orden de parámetros.
- additional_arc_parameters
- [Opcional] Especifica los parámetros de ARC adicionales que se anexarán al ejecutar cada tarea de ARC. Hay un límite de 2048 caracteres.
- broker.port
- [Opcional] Se puede especificar un puerto de agente para sobrescribir el valor por defecto especificado en el archivo commandline.properties para conectarse a un servidor diferente de ActiveMQ (y, por lo tanto, a un daemon diferente) en tiempo de ejecución.
- broker.url
- [Opcional] Se puede especificar una URL de agente para sobrescribir el valor por defecto especificado en el archivo commandline.properties para conectarse a un servidor diferente de ActiveMQ (y, por lo tanto, a un daemon diferente) en tiempo de ejecución.
- 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 ARC, 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.
- 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
- arc
- dsa
- jdbc
- tptapi
- tptapi_load
- tptapi_stream
- tptapi_update
- T2T
No se permite copiar datos en una versión anterior de Teradata Database mediante Teradata ARC o Teradata DSA. No se puede utilizar Teradata ARC ni Teradata DSA si los TDPID de origen y de destino son iguales. - 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.
- job_name
- [Opcional] Nombre para este trabajo. El nombre debe ser único y tener 32 caracteres como máximo.
- 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.
- 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
- 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, las bases de datos o los diarios.
- 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 ARC o 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 Sin especificar 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 Sin especificar Valor predeterminado: el valor se establece como el valor en el archivo de configuración del daemon de Data Mover - owner_name
- [Opcional] Usuario que creó el trabajo.
- 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.
- 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 ARC o Teradata DSA. Los mecanismos de inicio de sesión solo se usan para 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 ARC o Teradata DSA especificado para -force_utility produce un error.
- source_logon_mechanism_data
- [Opcional] Parámetros adicionales que se necesitan 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.
- 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 ARC y Teradata DSA no admiten 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 -force_utility no se utiliza, Teradata PT API se utiliza de forma predeterminada. La especificación de -target_logon_mechanism con Teradata ARC o Teradata DSA especificado para -force_utility produce 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.
- 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>arc</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>