Índice

Search

  1. Prólogo
  2. Programas y utilidades de la línea de comandos
  3. Instalación y configuración de las utilidades de la línea de comandos
  4. Cómo utilizar los programas de la línea de comandos
  5. Variables de entorno para los programas de línea de comandos
  6. Cómo utilizar infacmd
  7. Referencia de comando infacmd as
  8. Referencia del comando infacmd aud
  9. Referencia de comando infacmd autotune
  10. Referencia de comandos de Infacmd bg
  11. Referencia de comando infacmd ccps
  12. Referencia de comandos infacmd cluster
  13. Referencia de comando infacmd cms
  14. Referencia de comando infacmd dis
  15. Referencia de comandos infacmd dp
  16. Referencia de comando infacmd idp
  17. Referencia de comando infacmd edp
  18. Referencia de comandos de infacmd es
  19. Referencia de comando infacmd ihs
  20. Referencia de comando infacmd ipc
  21. Referencia de comando infacmd isp
  22. Referencia de comando infacmd ldm
  23. Referencia de comando infacmd mas
  24. Referencia de comando infacmd mi
  25. Referencia de comando infacmd mrs
  26. Referencia de comando infacmd ms
  27. Referencia de comando infacmd oie
  28. Referencia de comando infacmd ps
  29. Referencia de comando infacmd pwx
  30. Referencia de comando infacmd roh
  31. Referencia de comando infacmd rms
  32. Referencia de comando infacmd rtm
  33. Referencia de comandos de infacmd sch
  34. Referencia de comando infacmd search
  35. Referencia de comando infacmd sql
  36. Referencia de comando infacmd tdm
  37. Referencia de comando infacmd tools
  38. Referencia de comando infacmd wfs
  39. Referencia de comando infacmd ws
  40. Referencia de comando infacmd xrf
  41. Archivos de control de infacmd
  42. Referencia de comando infasetup
  43. Referencia de comando pmcmd
  44. Referencia de comando pmrep
  45. Cómo trabajar con archivos de pmrep

Command Reference

Command Reference

runMapping

runMapping

Ejecuta una asignación que está implementada en un servicio de integración de datos. Puede ejecutar la asignación con un conjunto de parámetros o un archivo de parámetros.
Para crear un archivo de parámetros de una asignación, ejecute el comando infacmd ms listMappingParams.
Antes de ejecutar el comando infacmd ms listMappingParams, ejecute el comando infacmd dis startApplication en la aplicación.
Para ver los parámetros y valores de un conjunto de parámetros, ejecute el comando infacmd dis listParameterSetEntries.
El comando infacmd ms runMapping emplea la siguiente sintaxis:
runMapping <-DomainName|-dn> domain_name <-ServiceName|-sn> service_name <-UserName|-un> user_name <-Password|-pd> password [<-SecurityDomain|-sdn> security_domain] [<-ResilienceTimeout|-re> timeout_period_in_seconds] <-Application|-a> application_name <-Mapping|-m> mapping_name [<-Wait|-w> true|false] [<-ParameterFile|-pf> parameter_file_path] [<-ParameterSet|-ps> parameter_set_name] [<-OperatingSystemProfile|-osp> operating_system_profile_name] [<-NodeName|-nn> node_name] [<-OptimizationLevel|-ol> optimization_level] [<-PushdownType|-pt> pushdown_type] [<-CustomProperties|-cp> custom_properties] [<-RuntimeInstanceName|-rin> runtime_instance_name]
El comando devuelve el ID de trabajo de la asignación.
Debe habilitar la supervisión para almacenar el nombre de la instancia en tiempo de ejecución. Si purga las estadísticas de supervisión, se eliminarán los nombres de instancias en tiempo de ejecución e infacmd ms getMappingStatus no los devolverá. Puede que el registro de asignaciones siga conteniendo el nombre de la instancia en tiempo de ejecución, y se pueden seguir usando las salidas de asignación persistentes asociadas con el nombre de la instancia en tiempo de ejecución.
En la siguiente tabla se describen las opciones y los argumentos del comando infacmd ms runMapping:
Opción
Argumento
Descripción
-DomainName
-dn
domain_name
Obligatorio. Nombre del dominio de Informatica. El nombre de dominio se puede establecer con la opción -dn o con la variable de entorno INFA_DEFAULT_DOMAIN. Si se establece un nombre de dominio con ambos métodos, la opción -dn tendrá preferencia.
-ServiceName
-sn
service_name
Obligatorio. Nombre del servicio de integración de datos que va a ejecutar la asignación. La aplicación que contiene la asignación debe estar implementada en un servicio de integración de datos.
-UserName
-un
user_name
Es obligatorio si el dominio utiliza autenticación nativa o de LDAP. Nombre de usuario para conectar con el dominio. El nombre de usuario se puede establecer con la opción -un o con la variable de entorno INFA_DEFAULT_DOMAIN_USER. Si se establece un nombre de usuario con ambos métodos, la opción -un tendrá preferencia.
Es opcional si el dominio usa autenticación Kerberos. Para ejecutar el comando con inicio de sesión único, no establezca el nombre de usuario. Si establece el nombre de usuario, el comando se ejecutará sin inicio de sesión único.
-Password
-pd
password
Es obligatorio si especifica el nombre de usuario. Contraseña del nombre de usuario. La contraseña distingue entre mayúsculas y minúsculas. Las contraseñas se pueden establecer con la opción -pd o con la variable de entorno INFA_DEFAULT_DOMAIN_PASSWORD. Si se establece una contraseña con ambos métodos, la contraseña establecida con la opción -pd tendrá preferencia.
-SecurityDomain
-sdn
security_domain
Obligatorio si el dominio requiere autenticación de LDAP. Opcional si el dominio usa autenticación nativa o autenticación Kerberos. Nombre del dominio de seguridad al que pertenece el usuario del dominio. Los dominios de seguridad se pueden establecer con la opción -sdn o con la variable de entorno INFA_DEFAULT_SECURITY_DOMAIN. Si establece un nombre de dominio de seguridad con ambos métodos, la opción -sdn tendrá preferencia. El dominio de seguridad distingue mayúsculas de minúsculas.
Si el dominio utiliza autenticación nativa o de LDAP, el valor predeterminado es Nativo. Si el dominio utiliza autenticación Kerberos, el valor predeterminado es el dominio de seguridad de LDAP creado durante la instalación. El nombre del dominio de seguridad es el mismo que el ámbito del usuario especificado durante la instalación.
-ResilienceTimeout
-re
timeout_period_in_seconds
Opcional. Tiempo, en segundos, durante el que infacmd intenta establecer o restablecer una conexión con el dominio. El tiempo de espera de fiabilidad se puede configurar con la opción -re o con la variable de entorno INFA_CLIENT_RESILIENCE_TIMEOUT. Si se establece un período de tiempo de espera de fiabilidad con ambos métodos, la opción -re tendrá preferencia.
-Application
-a
application_name
Obligatorio. Nombre de la aplicación que contiene la asignación.
-Mapping
-m
mapping_name
Obligatorio. Nombre de la asignación que se va a ejecutar.
-Wait
-w
true|false
Opcional. Indica si infacmd debe esperar a que finalice la asignación antes de volver al shell o a la línea de comandos. Si es true, infacmd volverá al shell o a la línea de comandos una vez que finalice la asignación. No se puede ejecutar ningún otro comando hasta que finalice la asignación. Si es false, infacmd vuelve al shell o a la línea de comandos inmediatamente. No tendrá que esperar a que finalice la asignación para ejecutar el comando siguiente. El valor predeterminado es false.
-ParameterFile
-pf
parameter_file_path
Opcional. Nombre y ruta de acceso del archivo de parámetros. No introduzca a la vez un archivo de parámetros y un conjunto de parámetros.
-ParameterSet
-ps
parameter_set_name
Opcional. Nombre de un conjunto de parámetros para utilizar en tiempo de ejecución. La opción de conjunto de parámetros reemplaza cualquier conjunto de parámetros implementado con la aplicación. No introduzca a la vez un conjunto de parámetros y un archivo de parámetros.
-OperatingSystemProfile
-osp
operating_system_profile_name
Opcional. Nombre del perfil del sistema operativo para ejecutar la asignación.
Si no utiliza esta opción cuando el servicio de integración de datos está habilitado para utilizar perfiles del sistema operativo, el servicio de integración de datos ejecuta la asignación con el perfil predeterminado.
-NodeName
-nn
node_name
Opcional. Nombre del nodo en una malla de servicio de integración de datos al que se enviará el trabajo de asignación. El nodo debe tener en ejecución un proceso de servicio de integración de datos.
Si no utiliza esta opción, el trabajo de asignación se enviará al nodo donde se ejecuta el proceso principal del servicio de integración de datos.
-OptimizationLevel
-ol
optimization_level
Opcional. Controla los métodos de optimización que el servicio de integración de datos aplica a una asignación. Introduzca el valor numérico correspondiente al nivel de optimización que desee configurar. Especifique uno de los siguientes valores:
-1 (Auto)
El servicio de integración de datos aplica optimizaciones en función del modo de ejecución y el contenido de la asignación.
0 (Ninguno)
El servicio de integración de datos no aplica ninguna optimización.
1 (Mínimo)
El servicio de integración de datos aplica el método de optimización de primera proyección.
2 (Normal)
El servicio de integración de datos aplica los métodos de optimización de primera proyección, de primera selección, de eliminación de ramificaciones, de inserción, de predicado global y de predicado.
3 (Completo)
El servicio de integración de datos aplica los métodos de optimización basada en el coste, de primera proyección, de primera selección, de eliminación de ramificaciones, de predicado, de inserción, semi-join y dataship-join.
El valor predeterminado es -1 (Auto).
-PushdownType
-pt
pushdown_type
Opcional. Controla el tipo de pushdown que el servicio de integración de datos aplica a una asignación. Especifique uno de los siguientes valores:
  • Ninguno. No seleccione ningún tipo de inserción para la asignación.
  • Origen. El servicio de integración de datos intenta insertar toda la lógica de transformación posible en la base de datos de origen.
  • Completo. El servicio de integración de datos inserta la lógica de transformación completa en la base de datos de origen.
Esta opción reemplaza el tipo de pushdown definido en las propiedades de tiempo de ejecución de la asignación, en un archivo de parámetros o en un conjunto de parámetros.
Si no utiliza esta opción, el servicio de integración de datos aplicará el tipo de pushdown definido en las propiedades de tiempo de ejecución de la asignación, en un archivo de parámetros o en un conjunto de parámetros.
-CustomProperties
-cp
custom_properties
Opcional. Define propiedades personalizadas para una asignación a pedido del servicio de atención al cliente de Informatica.
Introduzca las propiedades personalizadas como pares de nombre y valor separados por punto y coma. Por ejemplo:
... -cp custom_property_name=value
Para especificar un valor que contenga un espacio u otro carácter no alfanumérico, escriba el valor entre comillas.
-RuntimeInstanceName
-rin
runtime_instance_name
Opcional. Nombre de la instancia en tiempo de ejecución de la asignación. El nombre debe ser único.
El nombre de la instancia en tiempo de ejecución no puede contener caracteres de barra invertida.
Debe especificar un nombre de instancia en tiempo de ejecución en runMapping para conservar las salidas de asignación y ejecutar los comandos listMappingPersistedOutputs y deleteMappingPersistedOutputs.
El valor se puede establecer del siguiente modo para estandarizar los nombres de instancias en tiempo de ejecución:

    Si todas las asignaciones de una aplicación utilizan las mismas salidas de asignación persistentes, utilice el nombre de la aplicación.

    Si las asignaciones utilizan salidas de asignación persistentes distintas, utilice una combinación del nombre de la aplicación, el nombre de la asignación y el conjunto de parámetros o el nombre de archivo.