Tópicos Relacionados:
UIDFMT={DBNAME |NONE}
Opcional. Controla o tipo de valor usado pelo PowerExchange para preencher a coluna DTL__CAPXUSER gerada de cada registro de alteração. As opções são:
• DBNAME. Retorna o nome do banco de dados de publicação do Microsoft SQL Server.
• NONE Retorna um valor nulo porque uma ID de usuário não está disponível.
O padrão é NONE.
Instrução CAPI_CONNECTION - ORAD
A instrução ORAD CAPI_CONNECTION especifica um conjunto denominado de parâmetros que o API (CAPI) de Consumo usa para se conectar ao fluxo de mudança e controlar o PowerExchange Express CDC para o processamento do Oracle para fontes de dados do Oracle.
Sistemas Operacionais: Linux, UNIX e Windows Fontes de Dados: do Oracle
Instruções Relacionadas : ORACLEID, ORACLE_CAPTURE_TYPE Obrigatório: Sim, para o PowerExchange Express CDC para Oracle Sintaxe:
CAPI_CONNECTION=([DLLTRACE=trace_id]
,NAME=capi_connection_name
,ORACOLL=collection_id
[,PARMFILE=express_cdc_configuration_file]
[,PASSWORD=database_password]
[,USERID=database_user_id]
) )
Parâmetros:
DLLTRACE=trace_id
Opcional. Nome definido pelo usuário da instrução TRACE que ativa o rastreamento de DLL interno para essa CAPI.
Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
NAME=capi_connection_name
Obrigatório. Nome exclusivo definido pelo usuário para essa instrução CAPI_CONNECTION.
O tamanho máximo é de oito caracteres alfanuméricos.
TYPE=(ORAD, ... )
Obrigatório. Tipo de instrução CAPI_CONNECTION. Para o PowerExchange Express CDC para origens do Oracle, esse valor deve ser ORAD.
EPWD=database_encrypted_password
Opcional. Uma senha criptografada que o PowerExchange usa para se conectar ao banco de dados de origem do Oracle para o PowerExchange Express CDC para Oracle. Se especificar o parâmetro USERID dessa instrução, você também deve especificar o parâmetro EPWD ou PASSWORD.
Essa senha criptografada substitui o valor do parâmetro EPWD na instrução de banco de dados do PowerExchange Express CDC para arquivo de configuração do Oracle e valor de Senha nos atributos de conexão da sessão do CDC. Para usar uma dessas outras senhas criptografadas, não inclua o parâmetro EPWD na instrução ORAD CAPI_CONNECTION.
ORACOLL=collection_id
Obrigatório. O identificador de coleta para a instância do Oracle. Esse valor deve corresponder ao ID de coleta no primeiro parâmetro posicional de uma instrução ORACLEID no mesmo arquivo
dbmover.cfg.
Normalmente, esse valor também corresponde ao ID de coleta especificado no grupo de registro para a instância do Oracle. Se você especificar um ID de coleta diferente no grupo de registro, o ID de coleta de registro substitui esse valor ORACOLL.
PARMFILE=path_and_filename
Opcional. O caminho e nome de arquivo para o PowerExchange Express CDC para o arquivo de configuração do Oracle, relativo ao diretório de trabalho atual. Você pode usar esse parâmetro para substituir o nome de arquivo e caminho padrão ou lembrar aos usuários do PowerExchange do caminho e o nome do arquivo padrão.
Se esse parâmetro não for especificado, o PowerExchange usa pwx_home_directory\pwxorad.cfg por padrão. O caminho padrão é o caminho na variável de ambiente PWX_HOME, ou se essa variável de ambiente não estiver definida, o caminho padrão é o caminho para o diretório bin do PowerExchange. Se o arquivo pwxorad.cfg não existe na localização padrão e uma substituição de PARMFILE não está definida, o PowerExchange emite mensagens de erro PWX-09951 e PWX-00268 e a captura de alteração falha.
Instruções DBMOVER 77
PASSWORD=database_password
Opcional. Uma senha de texto simples que o PowerExchange usa para se conectar ao banco de dados de origem do Oracle para o PowerExchange Express CDC para Oracle. Se especificar o parâmetro USERID nessa instrução, você deve especificar o parâmetro EPWD ou PASSWORD.
Essa senha de texto simples substitui o parâmetro PASSWORD na instrução DATABASE do PowerExchange Express CDC do arquivo de configuração do Oracle e do valor de Senha nos atributos de conexão da sessão do CDC. Para usar uma dessas outras senhas, não inclua o parâmetro PASSWORD na instrução ORAD CAPI_CONNECTION.
USERID=database_user_id
Opcional. Uma identificação de usuário que o PowerExchange usa para se conectar ao banco de dados de origem do Oracle para o PowerExchange Express CDC para Oracle. Se especificar o parâmetro USERID dessa instrução, você também deve especificar o parâmetro EPWD ou PASSWORD.
Essa Identificação de usuário substitui o parâmetro USERID na instrução DATABASE do PowerExchange Express CDC para o arquivo de configuração do Oracle e do valor de Nome de Usuário nos atributos de conexão da sessão do CDC. Para usar uma dessas outras identificações de usuário, não inclua o parâmetro USERID na instrução ORAD CAPI_CONNECTION.
Notas de Uso:
• Você pode especificar várias instruções ORAD CAPI_CONNECTION no arquivo dbmover.cfg para capturar dados alterados de mais de uma instância do Oracle ou para usar diferentes configurações de parâmetro para a mesma instância do Oracle.
• Defina o ORAD CAPI_CONNECTION e instruções ORACLEID no sistema do PowerExchange que deve conectar-se ao banco de dados de origem do Oracle para captura de dados alterados. Normalmente, o Agente de Log do PowerExchange para Linux, UNIX e Windows é executado no sistema.
• Você não pode definir ambas as instruções ORAD CAPI_CONNECTION e ORCL CAPI_CONNECTION no mesmo arquivo dbmover.cfg. Se você usar o PowerExchange Express CDC para Oracle, defina instruções ORAD CAPI_CONNECTION. Se você usar o PowerExchange Oracle CDC com o LogMiner, defina as instruções ORCL CAPI_CONNECTION. Se você precisar executar o PowerExchange Express CDC para Oracle e o PowerExchange Oracle CDC com sessões do LogMiner com a mesma instância do Oracle, use arquivos dbmover.cfg, os Ouvintes do PowerExchange e Agentes de Log do PowerExchange separados.
• A identificação do usuário e senha do banco de dados ou uma senha criptografada podem ser especificadas em vários locais. Se você fizer isso, o PowerExchange usa a seguinte ordem de precedência:
1. O valor USERID e o valor EPWD ou PASSWORD especificados na instrução ORAD CAPI_CONNECTION no arquivo de configuração dbmover
2. O valor USERID e o valor EPWD ou PASSWORD especificados na instrução DATABASE no PowerExchange Express CDC para arquivo de configuração do Oracle, pwxorad.cfg.
3. Os valores de Nome de Usuário e Senha que são especificados nos atributos de conexão de aplicativo do Oracle para a sessão do CDC do PowerCenter
Instrução CAPI_CONNECTION - ORCL
A instrução ORCL CAPI_CONNECTION especifica um conjunto denominado de parâmetros que o API (CAPI) de Consumo usa para conectar-se ao fluxo de mudança e controlar o processamento do PowerExchange Oracle CDC para fontes do Oracle.
Fontes de Dados: Oracle
Instruções Relacionadas: CAPI_CONNECTION - UOWC e ORACLEID Obrigatório: Sim para PowerExchange Oracle CDC com LogMiner Sintaxe:
CAPI_CONNECTION=([DLLTRACE=trace_id]
,NAME=capi_connection_name [,TRACE=trace_name]
,TYPE=(ORCL
[,ARRAYSIZE=array_size|100]
[,BYPASSUF={N|Y}]
[,CATBEGIN=hh:mm|00:00]
[,CATEND=hh:mm|24:00]
[,CATINT=minutes|1400]
[,COMMITINT=minutes|5]
[,GENRLOCK={N|Y}]
[,IGNUFMSG={N|Y}]
[,LOGDEST=logdest_id]
[,LGTHREAD=instance_number]
[,ONLINECAT={N|Y}]
,ORACOLL=collection_id [,ROWID={N|Y|ALLOW}]
[,SELRETRY=retry_number|1000]
[,SNGLINST={N|Y}]
) )
Parâmetros:
DLLTRACE=trace_id
Opcional. Nome definido pelo usuário da instrução TRACE que ativa o rastreamento de DLL interno para essa CAPI.
Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
NAME=capi_connection_name
Obrigatório. Nome exclusivo definido pelo usuário para essa instrução CAPI_CONNECTION.
O tamanho máximo é de oito caracteres alfanuméricos.
TRACE=trace_name
Opcional. Nome definido pelo usuário da instrução TRACE que ativa o rastreamento de CAPI comum.
Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
TYPE=(ORCL, ... )
Obrigatório. Tipo de instrução CAPI_CONNECTION. Para o PowerExchange Oracle CDC com o origens do LogMiner, esse valor deve ser ORCL.
ARRAYSIZE={array_size|100}
Opcional. O número de linhas do array de pré-busca que o PowerExchange usa para ler os logs de redo do Oracle.
Digite um número de 0 a 2147483647. O padrão é 100.
Nota: Um valor menor que 100 pode diminuir o desempenho do CDC do Oracle com LogMiner. Um valor 0 desabilita a pré-busca. Digite 0 apenas sob a orientação do Suporte Global a Clientes da Informatica.
Instruções DBMOVER 79
BYPASSUF={N|Y}
Opcional. Controla se o PowerExchange é finalizado de forma anormal ou emite uma mensagem de aviso quando o Oracle LogMiner retorna um registro de log não formatado.
O LogMiner retorna registros de log não formatados quando Tabelas Temporárias Globais são atualizadas, ou quando ONLINECAT=Y e os dados de log que estão sendo lidos estão
inconsistentes com o catálogo.
Insira uma das seguintes opções:
• N. O PowerExchange é finalizado com um erro sempre que ele recebe um registro de log não formatado do Oracle LogMiner.
• Y. O PowerExchange grava uma mensagem de aviso no log de mensagens indicando que dados de log não formatados foram encontrados e, em seguida, continua o processamento.
Dependendo da quantidade de dados de log não formatados, o PowerExchange poderá gravar várias mensagens de aviso. Para suprimir essas mensagens de aviso, especifique Y para o parâmetro IGNUFMSG.
O padrão é N.
Sugestão: Digite Y se a instância do Oracle contiver Tabelas Temporárias Globais. Caso contrário, não inclua o parâmetro BYPASSUF.
CATBEGIN={hh:mm|00:00}
Opcional. Primeira hora do dia, em um formato de 24 horas, em que o PowerExchange solicita ao Oracle que grave uma cópia do catálogo Oracle nos logs de redo.
Se você especificar um valor para o parâmetro CATBEGIN, especifique também um valor para o parâmetro CATEND.
O padrão é 00:00.
CATEND={hh:mm|24:00}
Opcional. Última hora do dia, em um formato de 24 horas, em que o PowerExchange solicita ao Oracle que grave uma cópia do catálogo Oracle nos logs de redo.
Se você especificar um valor para o parâmetro CATEND, especifique também um valor para o parâmetro CATBEGIN.
O padrão é 24:00.
CATINT={minutes|1440}
Opcional. Intervalo de tempo, em minutos, entre as solicitações de cópia do catálogo Oracle nos logs de redo.
Digite um número de 1 a 1440. O padrão é 1440.
Se esse intervalo decorrer, mas a hora estiver fora do período especificado pelos parâmetros CATBEGIN e CATEND, o PowerExchange não solicitará ao Oracle que faça uma cópia do catálogo Oracle. Em vez disso, o PowerExchange aguarda o tempo especificado no parâmetro CATBEGIN para solicitar uma cópia do catálogo.
COMMITINT={minutes|5}
Opcional. Intervalo de tempo, em minutos, entre as operações SQL COMMIT que o PowerExchange emite para confirmar as transações geradas pela sessão do Oracle LogMiner.
Embora o PowerExchange não atualize os dados nas tabelas do usuário ao ler dados alterados dos logs de redo, a interface do Oracle LogMiner gera transações automaticamente para as sessões do LogMiner iniciadas pelo PowerExchange. O Oracle deixa essas transações abertas, ou em cascata, até que a sessão do LogMiner seja finalizada.
Para poder reiniciar eficientemente as operações de extração de dados alterados, o PowerExchange deve emitir ocasionalmente operações SQL COMMIT para finalizar essas transações em cascata.
Caso contrário, a reinicialização de todas as futuras operações de extração em tempo real poderá ser impactada, já que o PowerExchange sempre começa a ler os dados alterados no início do UOW em cascata mais antigo.
GENRLOCK={N|Y}
Opcional. Controla se o PowerExchange gera um ponto de reinicialização seguro para solicitações de pontos de reinicialização que correspondem ao fim do log (EOL) atual.
Insira uma das seguintes opções:
• N. O PowerExchange gera pontos de reinicialização que correspondem ao EOL atual, ignorando qualquer transação em cascata nas tabelas de origem.
• Y. O PowerExchange gera pontos de reinicialização seguros para as tabelas de origem.
O padrão é N.
Um ponto de reinicialização seguro para uma tabela de origem representa um ponto no fluxo de mudança que não ignora nenhum UOW em cascata nessa tabela. Para gerar um ponto de
reinicialização seguro para uma tabela de origem, o PowerExchange obtém um bloqueio exclusivo na tabela para interromper alterações adicionais. Em seguida, o PowerExchange pesquisa o catálogo Oracle em busca do ponto no fluxo de mudança que corresponde à transação ativa mais antiga na tabela e usa esse ponto como ponto de reinicialização. Se não houver UOWs em cascata para uma tabela, o PowerExchange usará o EOL atual. O PowerExchange libera o bloqueio na tabela de origem depois que a geração do ponto de reinicialização é concluída. As alterações então podem ser gravadas na tabela novamente.
O PowerExchange gera tokens de reinicialização que correspondem ao EOL atual nas seguintes situações:
• Você inicializa a frio o Agente de Log do PowerExchange para Linux, UNIX e Windows e o arquivo de configuração pwxccl não especifica os parâmetros SEQUENCE_TOKEN e RESTART_TOKEN.
O PowerExchange obtém bloqueios para todas as tabelas associadas aos registros de captura ativos a serem usados para processamento do Agente de Log do PowerExchange.
• O arquivo de token de reinicialização para uma sessão do CDC especifica a opção CURRENT_RESTART nas instruções substitutas especiais RESTART1 e RESTART2.
O PowerExchange obtém bloqueios somente para as tabelas na sessão do CDC à qual aplicam-se instruções substitutas especiais.
• Um teste de linha do banco de dados no Navegador do PowerExchange que usa a instrução SQL SELECT CURRENT_RESTART.
O PowerExchange obtém um bloqueio para a tabela representada pelo registro de captura associado ao mapa de extração usado no teste de linha do banco de dados.
• Uma operação do utilitário DTLUAPPL que usa a opção RSTTKN GENERATE.
O PowerExchange obtém um bloqueio para a tabela representada pelo registro de captura especificado nas instruções de controle do utilitário.
Instruções DBMOVER 81
IGNUFMSG={N|Y}
Opcional. Controla se o PowerExchange grava mensagens de aviso no arquivo de log de mensagens para registros de dados não formatados.
Digite uma das seguintes opções:
• N. O PowerExchange não grava mensagens de aviso.
• Y. O PowerExchange grava mensagens de aviso.
O padrão é N.
LOGDEST=logdest_id
Opcional. O identificador numérico para o destino de log de arquivo morto que você deseja fazer com que o PowerExchange use. Esse destino de log de arquivo morto deve ser local para a instância do Oracle que o PowerExchange está usando.
Digite um número de 1 a 10.
Por exemplo, para usar os logs em arquivo morto do destino definido pelo parâmetro LOG_ARCHIVE_DEST_3 no arquivo init.ora, especifique LOGDEST=3.
O parâmetro SNGINST afeta como o PowerExchange usa o destino de log de arquivo morto e a instância do Oracle que você especifica em LOGDEST e LGTHREAD.
Se você especificar Y para o parâmetro ONLINECAT, o PowerExchange validará e depois ignorará os parâmetros LOGDEST e LGTHREAD.
LGTHREAD=instance_number
Opcional. O número da instância para a instância Oracle. O PowerExchange usa o número dessa instância para identificar os logs redo do arquivo morto a serem processados.
Digite um número de 1 a 2147483647.
Para ambientes que não sejam RAC, se você especificar esse parâmetro, defina-o como 1.
O parâmetro SNGINST afeta como o PowerExchange usa o destino de log de arquivo morto e a instância do Oracle que você especifica em LOGDEST e LGTHREAD.
Se você especificar Y para o parâmetro ONLINECAT, o PowerExchange validará e depois ignorará os parâmetros LOGDEST e LGTHREAD.
ONLINECAT={N|Y}
Opcional. Controla se o PowerExchange orienta o Oracle LogMiner a usar o catálogo Oracle online ou a cópia do catálogo nos logs de redo para formatar os dados de log do CDC.
Digite uma das seguintes opções:
• N. O Oracle LogMiner usa a cópia do catálogo dos logs de redo em arquivo morto e o PowerExchange controla as alterações de esquema para assegurar que não ocorra perda de dados.
• Y. O Oracle LogMiner usa o catálogo online e o PowerExchange não pode controlar as alterações de esquema.
O padrão é N.
Quando você configura o PowerExchange para usar o catálogo online na formatação de dados de log, o PowerExchange costuma ainda catalogar as cópias para determinar o ponto de
reinicialização das operações de extração de dados alterados. Portanto, copie regularmente o
As operações de extração de dados alterados geralmente são inicializadas de forma mais rápida quando você configura o PowerExchange para criar sessões do LogMiner com o catálogo online, em vez de uma cópia do catálogo. Entretanto, quando o LogMiner usa o catálogo online, ele não controla alterações de DDL e não pode formatar registros de log para tabelas que tenham alterações de esquema.
Se o LogMiner usar o catálogo online e você fizer alterações de esquema enquanto ele estiver lendo dados de log, ele transmitirá ao PowerExchange os registros de log não formatados para alterações subsequentes. Se você especificar N para o parâmetro BYPASSUF ou aceitar o valor padrão N, o PowerExchange fará com que a solicitação de extração falhe depois que o Oracle transmitir o primeiro registro não formatado. Caso contrário, o PowerExchange irá ignorar o registro não formatado e continuará o processamento, o que resulta na perda de dados alterados. Portanto, especifique N para o parâmetro ONLINECAT, ou permita que ele assuma o padrão, se você tiver os seguintes requisitos:
• Você especifica Y para o parâmetro BYPASSUF e precisa alterar o esquema de tabelas registradas para captura enquanto operações de extração de dados alterados estão ocorrendo.
• Você precisa iniciar uma extração de um ponto nos logs de redo do Oracle que contém dados de tabela capturados pelo PowerExchange em um esquema anterior.
ORACOLL=collection_id
Obrigatório. O identificador de coleta do Oracle, que deve corresponder ao valor especificado na instrução ORACLEID.