Sumário

Search

  1. Prefácio
  2. Introdução ao PowerExchange
  3. Arquivo de Configuração DBMOVER
  4. Trabalhos Netport
  5. Logs de Mensagens do PowerExchange e Substituições de Destinos
  6. Log de estatísticas do SMF e Relatórios
  7. Segurança do PowerExchange
  8. Suporte a Secure Sockets Layer
  9. Segurança de Rede Alternativa do PowerExchange
  10. SQL Não Relacional do PowerExchange
  11. Metadados DTLDESCRIBE
  12. Globalização do PowerExchange
  13. Usando os Drivers ODBC do PowerExchange
  14. Tipos de Dados e Matriz de Conversão do PowerExchange
  15. Apêndice A: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  16. Apêndice B: Glossário do PowerExchange

Manual de Referência

Manual de Referência

CAPI_CONNECTION - Instrução PG

CAPI_CONNECTION - Instrução PG

A instrução PG 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 de CDC para origens do PostgreSQL.
Windows
PostgreSQL
Sim para o CDC do PostgreSQL
CAPI_CONNECTION=(NAME=
capi_connection_name
[,DLLTRACE=
trace_id
]   ,TYPE=(PG ,SERVER={
database_server
|
localhost
}[,
port
] [,CAPTUREALL={Y|
N
}] [,DATABASE=
database_name
[,ENABLELWM={Y|
N
}] [,FETCHLIMIT=
maximum_rows_fetched
|
100
]    [,ONDATATRUNC={WARN|
FAIL
}]    [,ONTABLETRUNC={WARN|
FAIL
}] [,RECONNTRIES={
reconnection_attempts
|
12
}] [,RECONNWAIT={
seconds
|
5
}] [,REPLSTORETBL=
schema.table_name
|
public.pwx_repl
}      [,RSTRADV=
seconds
]      ) )
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.
CAPTUREALL={
N
|Y}
Esse parâmetro opcional controla se o PowerExchange captura e armazena dados alterados para todas as tabelas no banco de dados de origem ou apenas para as tabelas registradas para o CDC. Use esse parâmetro para limitar a quantidade de dados armazenados na tabela de armazenamento de replicação apenas aos dados das tabelas de origem registradas.
As opções são:
  • N
    . Capture as alterações de DML e armazene as alterações na tabela de armazenamento de replicação, apenas para tabelas de origem registradas. Essa opção limita a quantidade de dados coletados e armazenados na tabela de armazenamento.
  • Y
    . Capture as alterações de DML e armazene as alterações na tabela de armazenamento de replicação, para todas as tabelas no banco de dados de origem, incluindo tabelas não registradas. Essa configuração não é recomendada porque pode fazer com que mais dados do que o necessário para o processamento do CDC sejam armazenados na tabela de armazenamento de replicação.
O padrão é N.
DLLTRACE=
trace_ID
Opcional. O 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.
TYPE=(PG, ... )
Obrigatório. O tipo de instrução CAPI_CONNECTION. Para origens do PostgreSQL, esse valor deve ser PG.
SERVER={
host_name
|localhost}[,
port_number
]
Obrigatório. O nome do host ou endereço IP do servidor em que o banco de dados de origem do PostgreSQL é executado. Você poderá inserir "localhost" se o servidor de banco de dados e o Ouvinte do PowerExchange forem executados localmente na mesma máquina.
Se quiser que o servidor de origem atenda em um número de porta diferente da porta padrão, opcionalmente você pode anexar o número da porta ao nome do servidor.
DATABASE=
database_name
Obrigatório. O nome do banco de dados de origem do PostgreSQL no servidor especificado.
ENABLELWM={
N
|Y|
Opcional. Quando você usa o Agente de Log do PowerExchange para Linux, UNIX e Windows, controla se o processo de captura da API (CAPI) de consumo do PowerExchange exclui os dados lidos na tabela de armazenamento de replicação depois que os dados foram fixados em arquivos de log do Agente de Log do PowerExchange. Você pode usar esse parâmetro para melhorar o desempenho de captura e para impedir que a tabela de armazenamento de replicação cresça demais quando o Agente de Log do PowerExchange estiver em uso.
As opções são:
  • N
    . Não exclua os dados processados da tabela de armazenamento de replicação depois que os dados forem fixados nos arquivos de log do Agente de Log do PowerExchange. Com essa opção, a tabela de armazenamento de replicação pode ficar muito grande, causando degradação no desempenho do CDC.
  • Y
    . Exclua os dados processados da tabela de armazenamento de replicação depois que os dados forem fixados nos arquivos de log do Agente de Log do PowerExchange. Depois de uma alternância de arquivos de log, o Agente de Log do PowerExchange enviará uma marca d'água inferior (LWM) para o processo CAPI para identificar o último UOW final antes da alternância de arquivo. No final do próximo ciclo de captura, depois que o processo de conexão CAPI tiver lido os dados disponíveis no banco de dados de distribuição até o final, o CAPI excluirá todas as linhas da tabela de armazenamento de replicação até a LWM.
O padrão é N.
FETCHLIMIT
Opcional. O número máximo de linhas que podem ser buscadas na tabela de armazenamento de replicação em resposta a uma chamada SELECT do PowerExchange. Os valores válidos vão de 0 a 1000000. Um valor 0 significa que nenhum limite máximo está em vigor.
O padrão é 100.
ONDATATRUNC={WARN|
FAIL
}
Opcional. Indica se o PowerExchange emite uma mensagem de aviso e continua processando ou termina de forma anormal quando precisa truncar dados das colunas do PostgreSQL com mais de 98.304 bytes.
O padrão é FAIL.
ONTABLETRUNC={WARN|
FAIL
}
Opcional. Indica se o PowerExchange emite uma mensagem de aviso e continua o processamento ou termina de forma anormal quando encontra um registro TRUNCATE TABLE no fluxo de alteração.
O padrão é FAIL.
RECONNTRIES={
reconnection_attempts
|
12
}
Opcional. O número máximo de vezes que o PowerExchange tenta se reconectar ao servidor de banco de dados PostgreSQL após a queda de uma conexão enquanto o PowerExchange está recuperando dados do slot de replicação ou lendo dados da tabela de armazenamento de replicação. Se uma nova tentativa de conexão for mal-sucedida, o PowerExchange aguardará o número de segundos especificado no parâmetro RECONNWAIT antes de tentar se reconectar ao servidor de banco de dados novamente. Use esse parâmetro em conjunto com o parâmetro RECONNWAIT para melhorar a resiliência da conexão.
Os valores válidos vão de 0 a 2147483647. Um valor 0 resulta em nenhuma nova tentativa de conexão. O padrão é 12.
RECONNWAIT={
segundos
|
5
}
Opcional. O número de segundos que o PowerExchange aguarda entre as tentativas de se reconectar a um servidor de banco de dados do PostgreSQL. Use esse parâmetro em conjunto com o parâmetro RECONNTRIES para melhorar a resiliência da conexão.
Os valores válidos vão de 0 a 3600. Um valor 0 resulta em nenhuma espera entre as tentativas de conexão. O padrão é 5.
REPLSTORETBL={
schema.table_name
|
public.pwx_repl
}
Opcional. O nome da tabela de armazenamento de replicação do PowerExchange que contém os dados alterados do slot de replicação lógica do PostgreSQL. O PowerExchange lê os dados alterados dessa tabela.
Se esse valor não estiver especificado, será usado o nome padrão de public.pwx_repl.
RSTRADV=
seconds
Opcional. 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.
O PowerExchange zera o intervalo de espera quando um dos seguintes eventos ocorre:
  • O PowerExchange finaliza 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.
Valores válidos de 0 a 86400. Nenhum padrão é especificado. Um valor 0 desativa o processamento antecipado de reinicialização.
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. Nesse caso, 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.