Tópicos Relacionados:
ROWID={N|Y|ALLOW}
Controla se os valores de rowid físicos do Oracle são incluídos nos registros de alterações capturadas para tabelas que não têm a movimentação de linha do Oracle ativada. O PowerExchange grava os valores de rowid na coluna gerada pelo PowerExchange
DTL__CAPXROWID. Por exemplo, use esse parâmetro se tiver tabelas de origem sem chave na quais você precisa realizar um processamento que exige um ID de linha exclusivo quando as sessões de extração são executadas.
Insira uma das seguintes opções:
• N. Não captura valores de rowid. A coluna DTL__CAPXROWID contém valores nulos.
• Y. Capture valores rowid para as tabelas que não têm a movimentação de linha ativada e grave os valores na coluna DTL__CAPXROWID dos registros de alteração. Se uma tabela tiver a movimentação de linha habilitada, o processamento de captura será encerrado de forma anormal.
• ALLOW. Capture valores rowid para as tabelas que não têm a movimentação de linha ativada e grave os valores na coluna DTL__CAPXROWID dos registros de alteração. Se uma tabela tiver a movimentação de linha habilitada, ela retornará valores nulos para a coluna DTL__CAPXROWID e continuará o processamento de captura. Talvez você deseje capturar o processamento para continuar se não precisar de valores de rowid para as tabelas que têm a movimentação de linha ativada.
Nota: Esse parâmetro se aplica ao CDC Oracle do PowerExchange com LogMiner. Se você usar o PowerExchange Express CDC para Oracle, defina o parâmetro ROWID semelhante na instrução OPTIONS do arquivo de configuração do Express CDC.
O padrão é N.
Instruções DBMOVER 83
SELRETRY={retry_number|1000}
Opcional. O número de vezes que o PowerExchange efetua loop inverso imediatamente para a chamada do Oracle LogMiner antes de implementar um loop de espera em escala graduada.
Depois que o PowerExchange tenta novamente a chamada para o LogMiner o número especificado de vezes, ele define um intervalo de espera entre cada nova tentativa subsequente. O intervalo de espera começa com um milissegundo e aumenta gradualmente para um segundo. Quando o LogMiner retorna dados, o PowerExchange zera o intervalo de espera, e o processo começa novamente para a próxima chamada para o LogMiner.
Para a variável retry_number, digite um número de 0 a 2147483647. O padrão é 1000.
Se você especificar um valor diferente de zero, o PowerExchange usará SQL diferente de bloqueio para assegurar-se de poder processar uma solicitação do usuário para encerrar uma sessão de extração de maneira oportuna.
Se você especificar 0, o PowerExchange não usará SQL diferente de bloqueio. Essa definição melhora o consumo de CPU, mas pode prolongar o encerramento de uma sessão de extração. Em instâncias inativas do Oracle, o PowerExchange não atende a uma solicitação de encerramento enquanto o Oracle não retorna os dados de log. Em instâncias do Oracle nas quais está ocorrendo atividade de atualização, o comportamento de encerramento não muda de forma perceptível.
Importante: Se você capturar dados de alteração de uma origem Oracle 12.1 ou posterior, defina o parâmetro SELRETRY como 0. Caso contrário, as sessões do Oracle LogMiner para o CDC do PowerExchange falharão ao tentar buscar dados alterados.
SNGLINST={N|Y}
Opcional. Controla se o PowerExchange usa apenas os logs de redo em arquivo morto de uma instância específica do Oracle e o destino de log de arquivo morto.
Digite uma das seguintes opções:
• N. O PowerExchange usa a instância do Oracle especificada para pesquisar logs de redo em arquivo morto que contenham cópias do catálogo Oracle. Depois que o PowerExchange transmite esses logs para uma sessão do Oracle LogMiner, o LogMiner determina os demais logs de redo em arquivo morto a serem lidos.
• Y. O PowerExchange só usa o destino de log de arquivo morto e a instância do Oracle que você especifica nos parâmetros LOGDEST e LGTHREAD para ler logs de redo em arquivo morto. O LogMiner não lê nenhum outro log de redo em arquivo morto. Depois que o PowerExchange processa os logs da localização especificada, a operação de extração de dados alterados é finalizada.
Se você especificar Y, será preciso também especificar os parâmetros LOGDEST e LGTHREAD para identificar o destino de log de arquivo morto e a instância Oracle a serem utilizados. Em um ambiente RAC, você deve executar processos separados de extração de dados alterados para todas as instâncias Oracle restantes no RAC e determinar como mesclar corretamente os dados alterados de forma que eles possam ser aplicados aos destinos.
O padrão é N.
Instrução CAPI_CONNECTION - UDB
A instrução UDB CAPI_CONNECTION especifica um conjunto denominado de parâmetros que a API (CAPI) de Consumo usa para conectar-se com o fluxo de mudança e controlar o processamento do CDC nas origens DB2 para Linux, UNIX e Windows.
Adicione essa instrução ao arquivo dbmover.cfg no sistema onde estão os registros de captura do DB2. Essa localização corresponde ao nó Localização que você especifica quando define um grupo de registro.
Normalmente, é onde reside o banco de dados de origem.
Sistemas Operacionais: Linux, UNIX e Windows Fontes de Dados: DB2 para Linux, UNIX e Windows Instruções Relacionadas: N/A
Obrigatório: Sim para o CDC Sintaxe:
CAPI_CONNECTION=([DLLTRACE=trace_id]
,NAME=capi_connection_name [,TRACE=trace_name]
,TYPE=(UDB
[,CCATALOG={capture_catalog|creator.DTLCCATALOG}]
[,DBCONN=database_name]
[,EPWD=encryted_password]
[,LARGEOPS=number_of_operations]
[,MEMCACHE={cache_size|1024}]
[,MONITORINT={minutes|5}]
[,PASSWORD=password]
[,RSTRADV=seconds]
[,SPACEPRI={AUTO|MAX|NONE|nn}]
[,THREADING={AUTO|MAX|NONE|nn}]
[,UDBSCHEMA=schema]
[,UPDINT={seconds|600}]
[,UPDREC={records|1000}]
[,USERID=user_id]
) )
Parâmetros:
DLLTRACE=trace_id
Opcional. Um nome definido pelo usuário para a 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. Um 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. Um nome definido pelo usuário para a 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=(UDB, ... )
Obrigatório. O tipo de instrução CAPI_CONNECTION. Nas fontes DB2 para Linux, UNIX e Windows, esse valor deve ser UDB.
Instruções DBMOVER 85
CCATALOG={capture_catalog|creator.DTLCCATALOG}
Opcional. O nome da tabela do catálogo de captura do PowerExchange no formato autor.nome_da_tabela.
O padrão é creator.DTLCCATALOG, onde creator é a identificação do usuário utilizada para conexão com o banco de dados.
DBCONN=database_name
Opcional. O nome do banco de dados substituto ao qual você deseja conectar para extração de dados em vez de o banco de dados que está especificado para o grupo de registro. O banco de dados substituto deve conter tabelas e colunas idênticas às do banco de dados original. Os nomes de marca de registro e mapa de extração incluem o nome do banco de dados original.
EPWD=encryted_password
Opcional. Uma senha criptografada que é usada com a ID de usuário no parâmetro USERID para acesso ao banco de dados.
Se você especificar esse parâmetro, especifique também o parâmetro USERID. No entanto, não especifique também o parâmetro PASSWORD.
Sugestão: Você pode criar senhas criptografadas no Navegador do PowerExchange.
LARGEOPS=número de operações
Opcional. Substitui o valor padrão que o PowerExchange usa para identificar as transações como transações grandes para fins de relatório. Digite o número de operações de DML (inserções, atualizações e exclusões), em milhares, que uma transação deve conter para ser considerada uma transação grande.
O PowerExchange emite mensagens de status para transações grandes que cumpram esses critérios. Se o PowerExchange emitir mensagens em excesso, pode-se aumentar esse valor para limitar o número de mensagens.
Os valores válidos são de 1 a 2147483 (1.000 a 2.147.483.000 de operações). O valor padrão é metade do valor arredondado do parâmetro MEMCACHE para o milhar mais próximo. Com base no valor padrão 1024 KB de MEMCACHE, o valor padrão de LARGEOPS é de 1000 (1.000.000 de operações).
Nota: Se uma transação comprometida abrange várias partições em um banco de dados DB2, o PowerExchange reporta o número de operações SQL e tamanho de transação em todas as partições.
MEMCACHE={cache_size|1024}
Opcional. O tamanho máximo do cache de memória, em quilobytes, que o PowerExchange pode alocar para reconstruir UOWs concluídos.
Digite um número de 0 a 2147483647. O padrão é 1024 KB. Se você inserir 0, o tamanho do cache de memória será limitado somente pela memória disponível no sistema. A Informatica recomenda que você insira 0.
Para cada sessão de extração, o PowerExchange mantém todas as alterações de cada UOW pendente no cache de memória até que ele processe o registro end-UOW. O PowerExchange aloca o cache de memória incrementalmente até o limite que esse parâmetro especifica. Se o cache de memória for muito pequeno para manter todas as alterações de UOWs pendentes, o
PowerExchange eliminará as alterações em um UOW para arquivos sequenciais, chamados arquivos spill UOW, no disco.
Cada arquivo spill UOW contém dados de alteração de um UOW. Um UOW poderá exigir vários arquivos spill UOW para manter todas as alterações desse UOW. Se o fluxo de mudança contiver vários UOWs grandes e o cache de memória for insuficiente, o PowerExchange poderá criar inúmeros arquivos spill UOW.
O PowerExchange processará o fluxo de mudança de modo mais eficiente se ele não precisar usar arquivos spill UOW. Um grande número de arquivos spill UOW pode diminuir o desempenho de extração e causar falta de espaço em disco.
Importante: Se o fluxo de mudança contiver UOWs pequenos, o valor padrão poderá ser suficiente.
Entretanto, o valor padrão geralmente é muito pequeno para eliminar arquivos spill UOW.
A localização em que o PowerExchange aloca os arquivos spill UOW varia conforme o sistema operacional da seguinte forma:
• No Linux e UNIX, o PowerExchange usa o diretório atual por padrão. Para usar um diretório diferente, você deve especificar a variável de ambiente TMPDIR.
O PowerExchange nomeia os arquivos spill UOW usando o prefixo "dtlq" e a função tempnam do sistema operacional.
Nota: Os arquivos spill UOW são arquivos temporários que são excluídos quando fechados pelo PowerExchange. Esses arquivos não são visíveis no diretório enquanto estão abertos.
• No Windows, o PowerExchange usa o diretório atual por padrão para arquivos spill UOW. Para usar um diretório diferente, especifique a variável de ambiente TMP.
O PowerExchange nomeia os arquivos spill UOW usando o prefixo "dtlq" e a função _tempnam do Windows.
Aviso: O PowerExchange aloca o tamanho do cache para cada operação de extração. Se você usar uma grande valor de MEMCACHE e executar muitas sessões de extração simultâneas, poderão ocorrer restrições de memória.
MONITORINT=minutos
Opcional. Período em minutos no qual o PowerExchange verifica a atividade de transação para transações pendentes e transações grandes. Transação pendente longa é a que permanece ativa por dois intervalos de monitoramento e transação grande é a que atende aos critérios de LARGEOPS. Quando o período termina, o PowerExchange emite mensagens que identificam as transações grandes e pendentes longas e informa sua atividade de processamento. O
PowerExchange também emite mensagens que identificam a posição atual no fluxo de mudança.
Os valores válidos vão de 0 a 720. O valor 0 desativa o monitoramento. O padrão é 5.
PASSWORD=password
Opcional. Uma senha de texto não criptografado usada com a ID de usuário no parâmetro USERID para acesso ao banco de dados.
Se você especificar esse parâmetro, especifique também o parâmetro USERID. No entanto, não especifique também o parâmetro EPWD.
RSTRADV=seconds
O intervalo de tempo, em segundos, que o PowerExchange aguarda antes de antecipar os tokens de reinicialização e sequência para uma fonte de dados registrada, durante os períodos em que os UOWs não incluem alterações de interesse da fonte de dados. Quando o intervalo de espera termina, o PowerExchange retorna o próximo "UOW vazio" confirmado, que inclui apenas informações atualizadas de reinicialização.
Digite um número de 0 a 86400. Nenhum padrão é especificado.
Instruções DBMOVER 87
O PowerExchange zera o intervalo de espera quando um dos seguintes eventos ocorre:
• O PowerExchange conclui o processamento de um UOW que inclui alterações de interesse.
• O PowerExchange retorna um UOW vazio porque o intervalo de espera terminou sem que o PowerExchange recebesse nenhuma alteração de interesse.
Por exemplo, se você especificar 5, o PowerExchange aguardará cinco segundos depois de concluir o processamento do último UOW ou após o término do intervalo de espera anterior. Em seguida, o PowerExchange retorna o próximo UOW vazio confirmado que inclui informações atualizadas de reinicialização e zera o intervalo de espera.
Se você não especificar RSTRADV, o PowerExchange não antecipará os tokens de reinicialização e sequência para uma fonte registrada, durante os períodos em que ele não receber alterações de interesse. Quando o PowerExchange for inicializado a quente, ele lerá todas as alterações, incluindo aquelas que não são de interesse do CDC, do ponto de reinicialização.
Atenção: Um valor 0 pode diminuir o desempenho. Além dos UOWs que contêm alterações das origens registradas de interesse, o PowerExchange retorna um UOW vazio para cada UOW que não contém alterações das origens registradas de interesse.
SPACEPRI={primary_space|2147483647}
Opcional. A quantidade de espaço em disco, em bytes, que o PowerExchange usa para alocar arquivos spill UOW como arquivos temporários.
Digite um número de 1 a 2147483647. O padrão é 2147483647 bytes.
THREADING={AUTO|MAX|NONE|nn}
Opcional. Controla o número de segmentos que o CAPI UDB usa para capturar dados de alteração de um banco de dados DB2. Use este parâmetro para melhorar o desempenho do processamento de captura. Se você tiver um banco de dados particionado, poderá usar um máximo de um segmento para cada nó de partição de banco de dados mais dois segmentos adicionais para processamento de CAPI e de mesclagem.
Os valores válidos são:
• AUTO. Use até nove segmentos.
• MAX. Use um segmento para cada partição de banco de dados, mais dois segmentos adicionais para processamento de mesclagem e CAPI. O número máximo de segmentos é 99.
• NONE. Não use vários segmentos para o processamento de captura.
• nn. Um número especificado pelo usuário de segmentos. Os valores válidos vão de 1 a 99. Para um banco de dados particionado, se você inserir um valor que excede a soma do
(número_de_partições_de_banco_dados + 2), o CAPI não usará os segmentos em excesso.
O padrão é AUTO.
UDBSCHEMA=schema
Opcional. Um nome de esquema que, em registros de captura, substitui o nome do esquema.
UPDINT={seconds|600}
Opcional. O tempo mínimo em segundos que o PowerExchange aguarda depois de encontrar um virtual time stamp (VTS) nos registros de log do DB2 para uma partição, antes de gravar uma entrada de posicionamento na tabela de catálogo de captura do PowerExchange. A entrada de posicionamento, que contém um log sequence number (LSN) e VTS, indica a localização nos logs do DB2.
Digite um número de 1 a 2147483647. O padrão é 600 segundos.
Nota: O número mínimo de registros especificado no parâmetro UPDREC também deverá ser atingido antes que o PowerExchange possa gravar entradas de posicionamento na tabela de catálogo de captura.
UPDREC={records|1000}
Opcional. O número mínimo de registros de log do DB2 que o PowerExchange deve ler em uma partição a fim de poder gravar uma entrada de posicionamento na tabela de catálogo de captura do PowerExchange. A entrada de posicionamento contém um LSN e VTS e indica uma localização nos logs do DB2.
Digite um número de 1 a 2147483647. O padrão é 1000 registros.
Nota: O período mínimo de espera especificado no parâmetro UPDINT também deverá ser atingido antes que o PowerExchange possa gravar entradas de posicionamento na tabela de catálogo de captura.
USERID=user_id
Opcional. Uma ID de usuário do banco de dados que tem a autoridade SYSADM ou DBADM.
Se você especificar esse parâmetro, especifique também o parâmetro PASSWORD ou EPWD.
Instrução CAPI_CONNECTION - UOWC
A instrução UOWC CAPI_CONNECTION especifica um conjunto denominado de parâmetros que a API (CAPI) de Consumo usa no UOW Cleanser.
No fluxo de mudança de algumas fontes de dados, as alterações de vários UOWs são mescladas entre si. O UOW Cleanser reconstrói as alterações entremescladas lidas no fluxo de mudança nos UOWs concluídos, em ordem cronológica baseada na hora de término.
Sistemas Operacionais: i5/OS, Linux, UNIX, Windows e z/OS
Fontes de dados: DB2 para origens i5/OS CDC, Oracle CDC com origens LogMiner e origens z/OS CDC Instruções Relacionadas: CAPI_CONNECTION - AS4J, CAPI_CONNECTION - LRAP e CAPI_CONNECTION - ORCL
Obrigatório: Sim, no CDC das fontes especificadas Sintaxe:
CAPI_CONNECTION=([DLLTRACE=trace_id]
,NAME=capi_connection_name [,TRACE=trace_name]
,TYPE=(UOWC
,CAPINAME=source_capi_name [,BLKSIZE=block_size]
[,DATACLASS=data_class]
[,LARGEOPS=number_of_operations]
[,MEMCACHE={cache_size|1024}]
[,MONITORINT={minutes|5}]
[,RSTRADV=seconds]
[,SPACEPRI={primary_space|50}]
[,SPACETYP={BLK|TRK|CYL}]
[,SPILLKEEP=number_of_spill_files]
[,STORCLASS=storage_class]
[,TIMESTAMP={LOG|COMMIT}]
[,UNIT=unit]
) )
Instruções DBMOVER 89
Parâmetros:
DLLTRACE=trace_id
Opcional. Um nome definido pelo usuário para a 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. Um 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. Um nome definido pelo usuário para a 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=(UOWC, ... )
Obrigatório. O tipo de instrução CAPI_CONNECTION. Para o UOW Cleanser, esse valor deve ser UOWC.
CAPINAME=capi_name
Obrigatório. O valor de parâmetro NAME na instrução CAPI_CONNECTION específica da fonte relacionada, que pode ser um dos seguintes tipos de instrução:
• Instrução AS4J CAPI_CONNECTION para origens DB2 para i5/OS
• Instrução ORCL CAPI_CONNECTION para Oracle CDC com origens LogMiner
• Instrução LRAP CAPI_CONNECTION para fontes de dados z/OS BLKSIZE=block_size
Opcional. O tamanho do bloco, em bytes, para os arquivos spill UOW sequenciais que o UOW Cleanser cria quando o cache de memória não pode manter todas as alterações de um UOW.
A tabela a seguir mostra os valores válidos por tipo de origem do CDC:
Tipo de Fonte de Dados Valores Válidos Valor Padrão
DB2 para i5/OS Um número de 8 a 32760 32760
Oracle Um número de 8 a 65535 32768
Fontes de dados z/OS Um número de 8 a 32760 18452
DATACLASS=data_class
Opcional. No z/OS, a classe de dados SMS que o UOW Cleanser usa quando aloca os arquivos spill UOW sequenciais. Se você não especificar esse parâmetro, as rotinas SMS ACS poderão atribuir a classe de dados.
LARGEOPS=número de operações
Opcional. Substitui o valor padrão que o PowerExchange usa para identificar as transações como transações grandes para fins de relatório. Digite o número de operações de DML (inserções, atualizações e exclusões), em milhares, que uma transação deve conter para ser considerada uma
O PowerExchange emite mensagens de status para transações grandes que cumpram esses critérios. Se o PowerExchange emitir mensagens em excesso, pode-se aumentar esse valor para limitar o número de mensagens.
Os valores válidos são de 1 a 2147483 (1.000 a 2.147.483.000 de operações). O valor padrão é metade do valor arredondado do parâmetro MEMCACHE para o milhar mais próximo. Com base no valor padrão 1024 KB de MEMCACHE, o valor padrão de LARGEOPS é de 1000 (1.000.000 de operações).
MEMCACHE={cache_size|1024}
Opcional. O tamanho máximo do cache de memória, em quilobytes, que o PowerExchange aloca para reconstruir UOWs concluídos.
Digite um número de 0 a 2147483647. O padrão é 1024 KB. Se você inserir 0, o tamanho do cache de memória será limitado somente pela memória disponível no sistema.
Para cada sessão de extração, o PowerExchange mantém todas as alterações de cada UOW no cache de memória até que ele processe o registro end-UOW. O PowerExchange aloca o cache de memória incrementalmente até o limite que esse parâmetro especifica. Se o cache de memória for muito pequeno para manter todas as alterações em um UOW, o PowerExchange eliminará as alterações nos arquivos sequenciais em disco, chamados arquivos spill UOW.
Cada arquivo spill UOW contém um UOW. Um UOW poderá exigir vários arquivos spill UOW para manter todas as alterações desse UOW. Se o fluxo de mudança contiver vários UOWs grandes e o cache de memória for insuficiente, o PowerExchange poderá criar inúmeros arquivos spill UOW.
O PowerExchange processará o fluxo de mudança de modo mais eficiente se ele não precisar usar arquivos spill UOW. Um grande número de arquivos spill UOW pode diminuir o desempenho de extração e causar falta de espaço em disco.
Importante: Se o fluxo de mudança contiver UOWs pequenos, o valor padrão poderá ser suficiente.
Importante: Se o fluxo de mudança contiver UOWs pequenos, o valor padrão poderá ser suficiente.