Sumário

Search

  1. Prefácio
  2. Programas e Utilitários de Linha de Comando
  3. Instalando e Configurando Utilitários de Linha de Comando
  4. Usando os programas de linha de comando
  5. Variáveis de Ambiente para Programas de Linha de Comando
  6. Usando infacmd
  7. Referência de Comando infacmd as
  8. Referência de Comandos infacmd aud
  9. Referência de Comandos infacmd autotune
  10. Referência de Comandos Infacmd bg
  11. Referência de Comandos infacmd ccps
  12. Referência de Comandos de infacmd cluster
  13. Referência de Comando infacmd cms
  14. Referência de Comando infacmd dis
  15. Consultas do Infacmd dis
  16. Referência de comandos infacmd dp
  17. Referência de comandos infacmd idp
  18. Referência de comandos infacmd edp
  19. Referência de Comandos Infacmd es
  20. Referência de Comando infacmd ics
  21. Referência de Comando infacmd ipc
  22. Referência de Comando infacmd isp
  23. Referência de comandos infacmd ldm
  24. Referência de Comandos infacmd mas
  25. Referência de Comandos infacmd mi
  26. Referência de Comando infacmd mrs
  27. Referência de Comando infacmd ms
  28. Referência de Comando infacmd oie
  29. Referência de Comando infacmd ps
  30. Referência de Comando infacmd pwx
  31. Referência de Comando infacmd roh
  32. Referência do Comando infacmd rms
  33. Referência aos comandos infacmd RTM
  34. Referência de Comandos infacmd sch
  35. Referência de Comandos infacmd search
  36. Referência de Comando infacmd sql
  37. Referência de Comando infacmd tdm
  38. Referência de Comando infacmd tools
  39. Referência do Comando infacmd wfs
  40. Referência de Comandos infacmd ws
  41. Referência de Comandos infacmd xrf
  42. Arquivos de controle infacmd
  43. Referência de Comando infasetup
  44. Referência de Comando pmcmd
  45. referência de comando pmrep
  46. Trabalhando com o filemanager
  47. Funcionamento com arquivos pmrep

Referência de Comandos

Referência de Comandos

runMapping

runMapping

Executa um mapeamento que é implantado em um Serviço de Integração de Dados. Você pode executar o mapeamento com um conjunto de parâmetros ou um arquivo de parâmetro.
Para criar um arquivo de parâmetro para um mapeamento, execute infacmd ms listMappingParams.
Antes de executar infacmd ms listMappingParams, execute o comando infacmd dis startApplication para o aplicativo.
Para visualizar os parâmetros e os valores de um conjunto de parâmetros, execute o comando infacmd dis listParameterSetEntries.
O comando infacmd ms runMapping usa a seguinte sintaxe:
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] [<-RuntimeInstanceName|-rin> runtime_instance_name] [<-EnableAudit|-ea> true|false] [<-CustomProperties|-cp> custom_properties]
O comando retorna o ID de trabalho da execução de mapeamento.
Você deve ativar o monitoramento para armazenar o nome da instância de tempo de execução. Se você limpar estatísticas de monitoramento, os nomes de instâncias de tempo de execução serão excluídos e não serão retornados por infacmd ms getMappingStatus. O log de mapeamento ainda pode conter o nome da instância de tempo de execução, e as saídas de mapeamento persistentes associadas ao nome da instância de tempo de execução ainda podem ser usadas.
A tabela a seguir descreve opções e argumentos do infacmd ms runMapping:
Opção
Argumento
Descrição
-DomainName
-dn
domain_name
Obrigatório. Nome do domínio Informatica. Você pode definir o nome do domínio com a opção -dn ou a variável de ambiente INFA_DEFAULT_DOMAIN. Se você definir um nome de domínio com ambos os métodos, a opção -dn terá precedência.
-ServiceName
-sn
service_name
Obrigatório. Nome do Serviço de Integração de Dados para execução do mapeamento. O aplicativo que contém o mapeamento deve ser implantado em um Serviço de Integração de Dados.
-UserName
-un
user_name
Obrigatório se o domínio usar a autenticação Nativa ou LDAP. Nome de usuário a ser conectado ao domínio. Você pode definir o nome de usuário com a opção -un ou a variável de ambiente INFA_DEFAULT_DOMAIN_USER. Se você definir um nome de usuário com ambos os métodos, a opção -un terá precedência.
Opcional se o domínio usar a autenticação Kerberos. Para executar o comando com o logon único, não defina o nome de usuário. Se você definir o nome de usuário, o comando será executado sem o logon único.
-Password
-pd
senha
Obrigatório se você especificar o nome de usuário. A senha para o nome de usuário. A senha faz distinção entre maiúsculas e minúsculas. Você pode definir uma senha com a opção -pd ou a variável de ambiente INFA_DEFAULT_DOMAIN_PASSWORD. Se você definir uma senha com ambos os métodos, a senha definida com a opção -pd terá precedência.
-SecurityDomain
-sdn
security_domain
Obrigatório se o domínio usar a autenticação LDAP. Opcional se o domínio usar a autenticação nativa ou a autenticação Kerberos. O nome do domínio de segurança ao qual o usuário do domínio pertence. É possível definir um domínio de segurança com a opção -sdn ou a variável de ambiente INFA_DEFAULT_SECURITY_DOMAIN. Se você definir um nome de domínio de segurança com ambos os métodos, a opção -sdn terá precedência. O nome de domínio de segurança diferencia maiúsculas de minúsculas.
Se o domínio usar a autenticação nativa ou LDAP, o padrão será Nativo. Se o domínio usar a autenticação Kerberos, o padrão será o domínio de segurança LDAP criado durante a instalação. O nome do domínio de segurança é o mesmo que o realm do usuário especificou durante a instalação.
-ResilienceTimeout
-re
timeout_period_in_seconds
Opcional. O tempo em segundos durante o qual infacmd tenta estabelecer ou restabelecer uma conexão com o domínio. Você pode definir o período de tempo de espera de resiliência com a opção -re ou a variável de ambiente INFA_CLIENT_RESILIENCE_TIMEOUT. Se você definir um período de tempo de espera de resiliência com ambos os métodos, a opção -re terá precedência.
-Application
-a
application_name
Obrigatório. Nome do aplicativo que contém o mapeamento.
-Mapping
-m
mapping_name
Obrigatório. Nome do mapeamento a ser executado.
-Wait
-w
true|false
Opcional. Indica se o infacmd aguarda o mapeamento ser concluído antes de retornar para o shell ou prompt de comando. Se for "true", o infacmd retornará para o shell ou prompt de comando depois que o mapeamento for concluído. Não será possível executar comandos subsequentes até que o mapeamento seja concluído. Se "false", o infacmd retornará para o shell ou prompt de comando imediatamente. Não é necessário aguardar a conclusão do mapeamento antes de executar o próximo comando. O padrão é false.
-ParameterFile
-pf
parameter_file_path
Opcional. Nome e caminho do arquivo de parâmetro. Não insira um arquivo de parâmetro e um conjunto de parâmetros.
-ParameterSet
-ps
parameter_set_name
Opcional. Nome de um conjunto de parâmetros a ser usado em tempo de execução. A opção de conjunto de parâmetros substitui qualquer conjunto de parâmetros implantado com o aplicativo. Não insira um conjunto de parâmetros e um arquivo de parâmetro.
-OperatingSystemProfile
-osp
operating_system_profile_name
Opcional. O nome do perfil do sistema operacional para executar o mapeamento.
Se você não usar esta opção quando o Serviço de Integração de Dados estiver ativado para usar perfis do sistema operacional, o Serviço de Integração de Dados executa o mapeamento com o perfil padrão.
-NodeName
-nn
node_name
Opcional. Nome do nó em uma grade do Serviço de Integração de Dados para o qual despachar o trabalho de mapeamento. Um processo do Serviço de Integração de Dados deve estar em execução no nó.
Se você não usar essa opção, o trabalho de mapeamento será despachado para o nó em que o processo do Serviço de Integração de Dados é executado.
-OptimizationLevel
-ol
optimization_level
Opcional. Controla os métodos de otimização que o Serviço de Integração de Dados aplica ao mapeamento. Insira o valor numérico associado ao nível de otimização que você deseja configurar. Insira um dos seguintes valores:
-1 (Auto)
O Serviço de Integração de Dados aplica otimizações com base no modo de execução e no conteúdo de mapeamento.
0 (Nenhum)
O Serviço de Integração de Dados não aplica nenhuma otimização.
1 (Mínimo)
O Serviço de Integração de Dados aplica o método de otimização de projeção antecipada.
2 (Normal)
O Serviço de Integração de Dados aplica os métodos de otimização de projeção antecipada, seleção antecipada, remoção de ramificação, envio, predicado global e predicado.
3 (Completo)
O Serviço de Integração de Dados aplica os métodos de otimização baseada em custos, de projeção antecipada, de seleção antecipada, remoção de ramificação, predicado, envio, semiassociação e dataship-join.
O padrão é -1 (Automático).
-PushdownType
-pt
pushdown_type
Opcional. Controla o tipo de empilhamento que o Serviço de Integração de Dados aplica a um mapeamento. Insira um dos seguintes valores:
  • Nenhum. Não selecione nenhum tipo de empilhamento para o mapeamento.
  • Origem. O Serviço de Integração de Dados tenta enviar o máximo possível da lógica de transformação para o banco de dados de origem.
  • Completo. O Serviço de Integração de Dados envia a lógica de transformação completa para o banco de dados de origem.
Essa opção substitui o tipo de empilhamento definido nas propriedades de tempo de execução do mapeamento ou em um arquivo de parâmetros ou conjunto de parâmetros.
Se você não a utilizar, o Serviço de Integração de Dados aplicará o tipo de empilhamento definido nas propriedades de tempo de execução do mapeamento ou em um arquivo de parâmetros ou conjunto de parâmetros.
-RuntimeInstanceName
-rin
runtime_instance_name
Opcional. Nome da instância de tempo de execução do mapeamento. O nome deve ser exclusivo.
O nome da instância de tempo de execução não pode conter caracteres de barra.
Você deve especificar um nome de instância de tempo de execução em runMapping para persistir saídas de mapeamento e executar os comandos listMappingPersistedOutputs e deleteMappingPersistedOutputs.
Você pode definir o valor da seguinte maneira para padronizar nomes de instância de tempo de execução:

    Se todos os mapeamentos em um aplicativo usarem as mesmas saídas de mapeamento persistentes, use o nome do aplicativo.

    Se os mapeamentos usarem saídas de mapeamento persistentes diferentes, use uma combinação de nome do aplicativo, nome do mapeamento e conjunto de parâmetros ou nome do arquivo.

-EnableAudit
-ea
true|false
Opcional. Indica se as regras e as condições de auditoria são executadas com o mapeamento.
O padrão é Falso.
Esta opção substitui a configuração
Habilitar Auditoria
na Developer tool. Por exemplo, se você selecionar
Habilitar Auditoria
na Developer tool e usar o valor padrão para esta opção, as regras e as condições de auditoria não serão executadas.
-CustomProperties
-cp
custom_properties
Opcional. Defina propriedades personalizadas para um mapeamento por solicitação do Suporte Global a Clientes da Informatica.
Insira propriedades personalizadas como pares de nome/valor separados por ponto-e-vírgula. Por exemplo:
... -cp custom_property_name=value
Para digitar um valor que contenha um espaço ou outro caractere não alfanumérico, coloque-o entre aspas.