Sumário

Search

  1. Prefácio
  2. Apresentação do Change Data Capture
  3. Ouvinte do PowerExchange
  4. Condensador do PowerExchange
  5. Change Data Capture do DB2 para i5/OS
  6. Logs Remotos de Dados
  7. Apresentação da Extração de Dados Alterados
  8. Extraindo Dados Alterados
  9. Monitorando Sessões do CDC
  10. Gerenciando Extrações de Dados Alterados
  11. Ajustando Sessões do CDC
  12. Apêndice A: Carimbos de Data/Hora DTL__CAPXTIMESTAMP

Guia do CDC para i5/OS

Guia do CDC para i5/OS

Instruções de Substituição Explícitas

Instruções de Substituição Explícitas

Use instruções de substituição explícitas para especificar um ponto de reinicialização de extração para uma origem específica em uma sessão de CDC. Você pode especificar várias instruções explícitas de substituição, cada uma para uma fonte diferente.
Quando você inicia uma sessão de CDC a quente, a instrução de substituição explícita para um objeto de origem substitui os tokens de reinicialização na tabela ou no arquivo de estado dessa origem. Você pode usar as instruções de substituição explícitas em conjunto com instruções de substituição especiais para especificar tokens de reinicialização de substituição para todas as origens em uma sessão de CDC.
Uma instrução de substituição explícita para uma origem pode especificar um par para tokens de reinicialização que definem um ponto específico no stream de alterações ou a opção CURRENT_RESTART para o final atual do stream de alterações. Como alternativa, se você usar o Agente de Log do PowerExchange para Linux, UNIX e Windows com uma conexão de aplicativo de CDC, poderá definir opcionalmente uma instrução de substituição explícita que especifica um ponto de reinicialização baseado em tempo para o processamento de extração nos arquivos de log do Agente de Log.
Para especificar tokens de reinicialização para uma origem, insira um par de instruções, cada uma contendo o nome do mapa de extração e um valor de token de sequência (restart1) ou token de reinicialização (restart2). Utilize a seguinte sintaxe:
extractionMapName
=
restart1_token
extractionMapName
=
restart2_token
Como uma origem pode ter vários mapas de extração com nomes distintos, pode ser necessário definir vários pares de instruções de substituição explícitas para uma origem.
Para origens do z/OS, se você usar o valor padrão de Y para o parâmetro FUZZYRSTART na instrução LRAP CAPI_CONNECTION, será possível inserir uma posição restart2 diferente de uma posição begin-uow na qual iniciar o processamento de extração nos logs do Agente de Log do PowerExchange para z/OS. No exemplo a seguir, o valor de
restart2_token
aponta para uma posição de RBA que não coincide com um registro begin-uow, enquanto o valor de
restart1_token
aponta para uma posição anterior à posição de
restart2_token
:
  • Para o valor
    restart1_token
    , especifique
    000000000001000000000000000000000000000000000000
    . Esse valor consiste em 48 zeros com um "1" na décima segunda posição. Com esse valor, o valor de
    restart2_token
    determinará os registros a serem retornados pela extração.
  • Para o valor de
    restart2_token
    , especifique um valor que consista em um ID do Agente de Log de 6 bytes no formato EBCDIC (preenchido com espaços) + uma posição de RBA de 6 bytes + 8 zeros. A posição de RBA pode ser qualquer RBA nos logs perto de onde você deseja reiniciar o processamento de extração. Por exemplo:
    E2C2F2D340400000000AEF4000000000
Com essas configurações de token de reinicialização, o PowerExchange inicia o processamento de extração no primeiro registro que está na posição de
restart1_token
ou posterior e na primeira UOW retornada com base na posição de
restart2_token
.
Para especificar o final atual do stream de alterações como o ponto de reinicialização, use a seguinte sintaxe:
extractionMapName
=CURRENT_RESTART
Para especificar um ponto de reinicialização baseado em tempo nos dados registrados do Agente de Log do PowerExchange, insira um par de instruções, uma contendo a opção RESTART_TIME e a outra contendo um valor de data e hora. Utilize a seguinte sintaxe:
extractionMapName
=RESTART_TIME
extractionMapName
=
datetime
Descrições de parâmetros:
extractionMapName
O nome de um mapa de extração para a fonte de dados. Para determinar o nome do mapa de extração, use um destes métodos:
  • Para fontes do mapa de dados do CDC, consulte os atributos
    Substituição do Nome do Esquema
    e
    Substituição do Nome do Mapa
    nas propriedades da sessão. Esses atributos substituem o nome do esquema e o nome do mapa no mapa de extração de origem. Ou, no Designer, consulte os valores
    Nome do Esquema
    e
    Nome do Mapa
    nas Extensões de Metadados de origem.
  • Para fontes relacionais, consulte o atributo
    Nome do Mapa de Extração
    nas propriedades da sessão.
Depois que o mapa de extração tiver sido usado para extrair dados de alterações, o nome da tabela será anexado a esse valor no formato
extractionMapName
_
tableName
. Use o nome completo ao definir uma instrução de substituição explícita.
restart1_token
A parte do token de sequência de um par de tokens de reinicialização. Esse valor varia com base no tipo de fonte de dados.
restart2_token
A parte do token de reinicialização de um par de tokens de reinicialização. Esse valor depende do tipo de fonte de dados.
CURRENT_RESTART
A opção que gera um par de tokens de reinicialização que marcam o final atual do stream de alterações. O leitor de CDC do PWXPC abre uma conexão distinta com o PowerExchange, solicita a geração de tokens de reinicialização atuais e, em seguida, fornece os valores de tokens à origem aplicável.
Opcionalmente, você pode gerar tokens de reinicialização atuais na caixa de diálogo
Teste da Linha do Banco de Dados
do Navegador do PowerExchange.
Use a opção CURRENT_RESTART somente para sessões de CDC que usam o modo de extração em tempo real ou o modo de extração contínua.
RESTART_TIME
Se você usar os arquivos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows, essa opção permitirá especificar um valor de data e hora como o ponto de reinicialização para o processamento de extração nos arquivos de log do Agente de Log.
datetime
A data e hora a serem usadas como ponto de reinicialização nos arquivos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows. Esse valor deve estar no formato YYYYMMDDhhmmssuuuuuu, em que YYYY é um ano com quatro dígitos, MM é o mês, DD é o dia do mês, hh é horas, mm é minutos, ss é segundos e uuuuuu é microssegundo.