Sumário

Search

  1. Prefácio
  2. Introdução ao Navegador do PowerExchange
  3. Mapas de Dados
  4. Mapas de Dados para Fontes de Dados Específicas
  5. Copybooks
  6. Grupos de Registro e Registros de Captura
  7. Grupos de Extração e Mapas de Extração
  8. Metadados Pessoais
  9. Teste de Linha de Banco de Dados
  10. Exemplos do Navegador do PowerExchange
  11. Apêndice A: Funções do PowerExchange para Campos Definidos pelo Usuário
  12. Apêndice B: Programas de Método de Acesso do Usuário
  13. Apêndice C: Grupos de Aplicativos e Aplicativos
  14. Apêndice D: Propriedades do Mapa de Dados
  15. Apêndice E: Propriedades do Registro, Campo e Tabela
  16. Apêndice F: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  17. Apêndice G: Rastreamento para criar um mapa de memória ao importar um copybook COBOL

Colunas Geradas pelo PowerExchange em Mapas de Extração

Colunas Geradas pelo PowerExchange em Mapas de Extração

Além das colunas de tabela definidas nos registros de captura, os mapas de extração incluem colunas geradas pelo PowerExchange.
Estas colunas geradas pelo PowerExchange contêm informações relacionadas ao CDC, como o tipo de alteração de SQL e o registro de data/hora.
Quando você importa um mapa de extração no Designer, o PWXPC inclui as colunas geradas pelo PowerExchange na definição de origem.
Quando você executa um teste de linha do banco de dados em um mapa de extração, o Navegador do PowerExchange exibe as colunas geradas pelo PowerExchange nos resultados. Por padrão, o Navegador do PowerExchange oculta a exibição dessas colunas quando você abre o mapa de extração. Para exibir essas colunas, abra o mapa de extração, clique com o botão direito do mouse em qualquer lugar na janela
Definição de Extração
e selecione
Exibir Colunas Geradas Automaticamente
.
Por padrão, todas as colunas são selecionadas em mapas de extração, exceto as colunas DTL__
columnname
_CNT, DTL__
columnname
_IND e DTL__CI_
columnname
. Para adicionar essas colunas, você deve editar o mapa de extração.
A tabela a seguir descreve as colunas que o PowerExchange gera para cada registro de alteração:
Coluna
Descrição
Tipo de dados
Comprimento
DTL__CAPXRESTART1
Fornece um valor binário que representa a posição do fim do UOW desse registro de alteração seguido pela posição do próprio registro de alteração.
O tamanho de um token de sequência varia de acordo com o tipo de fonte de dados, exceto no z/OS, no qual os tokens de sequência de todos os tipos de fonte de dados têm o mesmo tamanho.
O valor de DTL__CAPXRESTART1 é conhecido também como
token de sequência
, que, quando combinado com o
token de reinicialização
, forma o par de tokens de reinicialização.
Um token de sequência de um registro de alteração é um valor estritamente crescente e que pode ser repetido.
VARBIN
255
DTL__CAPXRESTART2
Fornece um valor binário que representa uma posição no fluxo de alteração que pode ser usado para reconstruir o estado do UOW para o registro de alteração, com as seguintes exceções:
  • CDC do Microsoft SQL Server. Um valor binário que contém o DBID do banco de dados de distribuição e o nome do servidor de distribuição.
  • Dados alterados extraídos de arquivos condensados completos no z/OS ou i5/OS. Um valor binário que contém o nome da instância do grupo de registro do registro de captura.
O tamanho de um token de reinicialização varia de acordo com o tipo de fonte de dados. No z/OS, os tokens de reinicialização de todos os tipos de fonte de dados têm o mesmo tamanho, exceto os dados de alteração extraídos de arquivos condensados completos.
O valor de DTL__CAPXRESTART2 é conhecido também como
token de reinicialização
, que, quando combinado com o
token de sequência
, forma o par de tokens de reinicialização.
VARBIN
255
DTL__CAPXROWID
Para o PowerExchange Express CDC for Oracle, fornece o valor físico de rowid. O PowerExchange poderá incluir valores de rowid em registros de alteração para tabelas Oracle somente se as tabelas não tiverem a movimentação de linhas ativada.
Para ativar a captura de valores de rowid, você deve configurar a instrução OPTIONS ROWID=Y no arquivo de configuração do Express CDC.
O rowid é útil para processar linhas em tabelas sem chave durante sessões de extração do CDC.
CHAR
18
DTL__CAPXRRN
Somente para origens DB2 for i, fornece o número de registro relativo até 2.147.483.647.
DTL__CAPXRNN está obsoleto, mas ainda tem suporte em mapas de extração existentes criados antes do PowerExchange 10.5.
NUM32
4
DTL__CAPXEXRRN
Somente para origens DB2 for i, fornece o número de registro relativo, incluindo valores estendidos até o valor máximo do sistema de 4.294.967.288.
DTLNUM64U
8
DTL__CAPXUOW
Fornece um valor binário que representa a posição no fluxo de alteração do início do UOW para o registro de alteração.
VARBIN
255
DTL__CAPXUSER
Fornece a ID do usuário que fez a alteração na fonte de dados, com as seguintes exceções:
  • Origens do CDC do Adabas 8.3, esse valor será o ID do Usuário de Segurança (SECUID) do usuário se a Definição de Arquivo do Adabas incluir o campo de sistema SY=SECUID.
  • Para origens de CDC baseado em tabela Datacom, esse valor é o nome do MUF.
  • Para origens CDC do DB2 for i (i5/OS), esse valor depende do parâmetro LIBASUSER na instrução AS4J CAPI_CONNECTION. Se LIBASUSER=Y, este valor será o nome da biblioteca e o nome do arquivo em que a alteração foi feita. Se LIBASUSER=M, este valor será o nome da biblioteca, o nome do arquivo e o nome do membro de dados do arquivo em que a alteração foi feita. Se LIBASUSER=N, esse valor será o ID do usuário que fez a alteração. Se LIBASUSER=P, esse valor será o nome do programa que fez a alteração.
  • Para origens CDC do DB2 for z/OS, esse valor depende do parâmetro UIDFMT em LRAP CAPI_CONNECTION. Dependendo da definição do parâmetro, esse valor pode ser um identificador de conexão do DB2, um identificador de correlação, um tipo de conexão, um nome do plano, um ID de usuário ou todos esses valores no formato
    UID:PLAN:CORR:CONN:CTYPE
    . Se você não especificar o parâmetro UIDFMT, esse valor será a ID de usuário que fez a alteração.
  • Para origens CDC do IDMS, esse valor é o valor que o programa do usuário coloca no campo do nome do programa do bloco de controle do subesquema do aplicativo. Geralmente, esse valor é o nome do programa do usuário.
  • Para origens CDC síncronas do IMS, esse valor depende do parâmetro UIDFMTIMS na instrução LRAP CAPI_CONNECTION. Dependendo da configuração do parâmetro, esse valor poderá ser um ID de usuário, um nome PSB ou os dois valores no formato
    userid
    :
    psbname
    . Se você não especificar o parâmetro UIDFMTIMS, por padrão, o ID do usuário será usado.
  • Para origens CDC do Microsoft SQL Server, esse valor depende do parâmetro UIDFMT na instrução MSQL CAPI_CONNECTION. Se UIDFMT=DBNAME, esse valor será o nome do banco de dados de publicação do SQL Server. Se UIDFMT=NONE, esse valor será nulo.
  • Para origens CDC do Oracle, esse valor é um ID de usuário que o PowerExchange obtém do Oracle, se disponível. Caso contrário, este valor será nulo.
VARCHAR
255
DTL__CAPXTIMESTAMP
Fornece o registro de data/hora que o DBMS de origem grava para o registro de alteração de banco de dados.
Esse valor pode ser o registro de data/hora que o DBMS de origem grava no registro de alteração nos logs do banco de dados ou o registro de data/hora de confirmação da transação no banco de dados de origem.
O tipo de registro de data/hora depende do tipo de origem e de determinados parâmetros:
  • Para origens DB2 no Linux, UNIX ou Windows, o carimbo de data/hora de confirmação da transação.
  • Para origens do Microsoft SQL Server, a hora em que a alteração foi gravada no banco de dados de distribuição.
  • Para origens do MySQL, a hora em que o MySQL registrou o evento de alteração no log binário.
  • Para origens Oracle, o tipo de registro de data/hora é controlado pelo parâmetro TIME_STAMP_MODE na instrução OPTIONS do arquivo de configuração do Express CDC.
  • Para todas as origens que exigem uma instrução UOWC CAPI_CONNECTION, o tipo de registro de data/hora é controlado pelo parâmetro TIMESTAMP na instrução UOWC CAPI_CONNECTION do arquivo DBMOVER.
Para obter mais informações detalhadas sobre os registros de data/hora de cada tipo de origem, consulte DTL__CAPXTIMESTAMP Time Stamps.
O formato do registro de data/hora é:
YYYYMMDDhhmmssnnnnnn
Onde:
  • YYYY é o ano de quatro dígitos.
  • MM é o mês.
  • DD é o dia.
  • hhmmssnnnnnn é horas, minutos, segundos e microssegundos.
O DB2 no Linux, UNIX ou Windows e Oracle não oferece suporte a microssegundos no carimbo de data/hora.
CHAR
20
DTL__CAPXACTION
Indica o tipo de registro de alteração que o PowerExchange transmitiu ao destino durante o processamento de extração. Esse indicador corresponde ao tipo de operação de alteração SQL no banco de dados de origem.
Valores válidos:
  • I
    . Inserir.
  • D
    . Excluir.
  • U
    . Pós-imagem de UPDATE.
  • T
    . Pré-imagem de UPDATE. Somente as conexões (ODBC)
Se você especificar um
Tipo de Imagem
de
BA
na conexão para uma sessão do CDC, o PowerExchange gerará um registro de exclusão, seguido por um registro de inserção para uma atualização de origem. No registro de exclusão, a coluna DTL___CAPXACTION contém o valor D. No registro de inserção, a coluna DTL__CAPXACTION contém o valor I.
Se você especificar um
Tipo de Imagem
de
AI
na conexão para uma sessão do CDC, o PowerExchange gerará um registro para uma atualização. Nesse registro, a coluna DTL___CAPXACTION contém o U valor.
Se você usar uma conexão ODBC para gravar dados de alteração para uma tabela de preparação e definir o parâmetro CAPXIMAGETYPE do driver ODBC como TU ou inserir a sequência de escape SQL DTLIMTYPE=TU no PowerCenter, essa coluna poderá conter um valor de T ou U. Para cada atualização de origem, o PowerExchange entrega dois registros para a tabela de preparação: um para a pré-imagem e outro para a pós-imagem. No registro de pré-imagem, a coluna DTL__CAPXACTION contém o valor T. No registro da pós-imagem, a coluna DTL__CAPXACTION contém o valor U.
CHAR
1
DTL__CAPXCASDELIND
Somente para origens do DB2 for z/OS, indica se o DB2 excluiu a linha porque a tabela especifica a cláusula ON DELETE CASCADE. Valores válidos:
  • Y.
    Indica que o DB2 excluiu a linha por causa de uma regra de exclusão em cascata.
  • N
    . Indica que o DB2 não excluiu a linha por causa de uma regra de exclusão em cascata.
CHAR
1
DTL__BI_
columnname
Fornece a pré-imagem de uma coluna que foi alterada por uma operação UPDATE.
Tipo de dados da coluna de origem
Tamanho da coluna de origem
DTL__CI_
columnname
Indica se uma operação UPDATE alterou ou não o valor da coluna. Valores válidos:
  • Y
    . O valor da coluna foi alterado por uma operação UPDATE.
  • N
    . A coluna foi alterada por uma operação UPDATE.
  • null
    . A coluna foi alterada por uma operação INSERT ou DELETE. Ela não foi alterada por uma operação UPDATE.
Por padrão, a coluna de indicador de alteração não é incluída em mapas de extração. Para adicioná-la, você deve editar um mapa de extração e selecionar essa coluna automaticamente gerada.
CHAR
1
DTL__ST_
lob_columnname
Para uma coluna LOB do DB2 for z/OS, indica se ela contém ou não todos os dados LOB. O ECCR fornecerá dados LOB incompletos se os dados não forem armazenados totalmente embutidos no espaço da tabela base ou se excederem 32 KB de tamanho. Valores válidos:
  • C
    . A coluna de origem contém todos os dados LOB. O ECCR foi capaz de capturar todos os dados LOB, pois os dados estão armazenados totalmente embutidos no espaço da tabela base e não excedem 32 KB.
  • I
    . A coluna contém dados LOB incompletos. O ECCR não pôde capturar todos os dados LOB, pois os dados estão armazenados em um espaço de tabela auxiliar ou estão armazenados totalmente embutidos, mas excedem 32 KB de tamanho.
  • null
    . A coluna contém apenas valores nulos.
Se os dados LOB não forem armazenados totalmente embutidos na tabela base, inclua a coluna DTL__ST_lob_columnname. Quando essa coluna especifica I para indicar dados LOB incompletos, você pode usar as transformações do PowerCenter para recuperar todos os dados LOB atuais para a coluna de origem associada.
Para uma coluna LOB do Oracle, DTL__ST_job_columname indica se a coluna de origem associada contém ou não os dados LOB. O PowerExchange Express CDC for Oracle fornece dados LOB completos se os dados estiverem totalmente armazenados na linha. Valores válidos:
  • C
    . A coluna de origem contém todos os dados LOB. O PowerExchange Express CDC capturou todos os dados LOB porque os dados são armazenados totalmente embutidos na linha.
  • I
    . A coluna de origem foi alterada, mas não contém dados LOB. O PowerExchange Express CDC não conseguiu capturar os dados LOB porque os dados não estão armazenados embutidos na linha.
  • null
    . A coluna de origem contém apenas valores nulos.
Se os dados LOB não forem armazenados em linha na tabela base, inclua a coluna DTL__ST_lob_columname. Quando essa coluna especifica I para indicar dados LOB incompletos, você pode usar as transformações do PowerCenter para recuperar todos os dados LOB atuais para a coluna de origem associada.
Essa coluna é incluída nos mapas de extração por padrão. Para removê-lo, abra o mapa de extração no Navegador do PowerExchange e limpe essa coluna gerada automaticamente.
CHAR
1
DTL__
columnname
_CNT
Uma contagem de binários gerada pelo PowerExchange para uma coluna de comprimento variável do tipo VARCHAR e VARBIN. A contagem é usada para determinar o comprimento da coluna durante o processamento de extrações de dados de alterações.
Por padrão, a coluna de contagem de binários não é incluída em mapas de extração. Para adicioná-la, você deve editar um mapa de extração e selecionar essa coluna automaticamente gerada.
NUM32U
0
DTL__
columnname
_IND
Indica se uma coluna anulável contém ou não um valor nulo. O PowerExchange gera essa coluna somente para colunas anuláveis.
Por padrão, a coluna de indicador de nulo não é incluída em mapas de extração. Para adicioná-la, você deve editar um mapa de extração e selecionar essa coluna automaticamente gerada.
BIN
1