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. Globalização do PowerExchange
  12. Usando os Drivers ODBC do PowerExchange
  13. Tipos de Dados e Matriz de Conversão do PowerExchange
  14. Apêndice A: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  15. Apêndice B: Glossário do PowerExchange

Manual de Referência

Manual de Referência

Instrução CAPI_CONNECTION - MSQL

Instrução CAPI_CONNECTION - MSQL

A instrução MSQL 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 para origens Microsoft SQL Server.
Windows
Microsoft SQL Server
Sim para Microsoft SQL Server CDC
CAPI_CONNECTION=([DLLTRACE=
trace_id
]   ,NAME=
capi_connection_name
  [,TRACE=
trace_name
]   ,TYPE=(MSQL    ,DISTDB=
distribution_database
   ,DISTSRV=
distribution_server
   [,BATCHSIZE=
number
]    [,DWFLAGS={
flag1flag2flag3flag4
|
NNNN
}] [,ENABLELWM={
N
|Y}]    [,EOF={
N
|Y}] [,GUIDBRACES={
Y
|N}] [,MEMCACHE={
cache_size
|
256
}]    [,MULTIPUB={N|
Y
}]     [,POLWAIT={
seconds
|
1
}] [,RECONNTRIES={
number
|
12
}] [,RECONNWAIT={
seconds
|
5
}]     [,RSTRADV=
seconds
] [,SQLNOLOCK={N|Y}] [,UIDFMT={DBNAME|
NONE
}]     ) )
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=(MSQL, ... )
Obrigatório. Tipo de instrução CAPI_CONNECTION. Para origens Microsoft SQL Server, esse valor deve ser MSQL.
DISTDB=
distribution_database_name
Obrigatório. O nome do banco de dados de distribuição.
DISTSRV=
distribution_database_server
Obrigatório. Nome da rede do servidor que hospeda o banco de dados de distribuição. Esse nome será diferente do nome da rede da instância de publicação do SQL Server se o banco de dados de distribuição residir em uma instância diferente.
Se o servidor de banco de dados usar um número de porta diferente do padrão de 1433, inclua o número de porta não padrão ao nome do servidor usando o seguinte formato:
\
server_name
,
port_number
\
. Caso contrário, o processamento de captura falha.
BATCHSIZE=
número
Opcional. O número de linhas do qual o PowerExchange captura dados alterados antes de fechar o cursor e em seguida reabri-lo. Esse parâmetro permite que os recursos sejam liberados periodicamente para reduzir a carga do processamento de captura na memória do sistema e para reduzir o temporariamente tabelas no banco de dados tempdb. Os valores válidos vão de 0 a 2147483647. Nenhum padrão é especificado.
Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica. Ele pode diminuir o desempenho do CDC porque o PowerExchange emite a consulta de leitura de dados mais frequentemente.
DWFLAGS={
flag1flag2flag3flag4
|
NNNN
}
Opcional. Uma série de quatro parâmetros posicionais que controlam se o processamento é interrompido ou continua quando ocorrem registros de log de perda de dados, truncamento, alterações de esquema ou transação não reconhecida.
Especifique essa instrução apenas sob a orientação do Suporte Global a Clientes da Informatica.
Digite os seguintes parâmetros posicionais:
  • flag1
    . Controla se o PowerExchange interrompe uma extração de dados alterados quando ele recupera dados de um tamanho inesperado no banco de dados de distribuição. Insira Y para continuar o processamento ou N para interrompê-lo.
  • flag2
    . Controla se o PowerExchange interrompe uma extração de dados alterados quando ele detecta uma alteração de esquema. Insira Y para continuar o processamento ou N para interrompê-lo.
  • flag3
    . Controla se o PowerExchange interrompe uma extração de dados alterados quando ele não encontra no log de transações a sequência inicial solicitada. Insira Y para continuar o processamento ou N para interrompê-lo.
  • flag4
    . Controla se o PowerExchange interrompe uma extração de dados alterados quando encontra um registro não reconhecido no log de transação. Insira Y para continuar o processamento após a mensagem de erro PWX-15742 ou N para interromper o processamento.
O padrão é NNNN, que indica que nenhum dos parâmetros está definido.
ENABLELWM={
N
|Y}
Opcional. Quando você usa o Agente de Log do PowerExchange para Linux, UNIX e Windows, controla se o processo de conexão da API (CAPI) de consumo do PowerExchange exclui os dados lidos no banco de dados de distribuição do SQL Server depois que os dados foram fixados em arquivos de log do Agente de Log do PowerExchange ou após o tempo de expiração de publicação do PowerExchange. Você pode usar esse parâmetro para melhorar o desempenho do banco de dados de distribuição e para impedir que ele cresça demais quando o Agente de Log do PowerExchange estiver em uso.
Insira uma das seguintes opções:
  • N
    . O trabalho de limpeza do banco de dados de distribuição excluirá os dados do banco de dados de distribuição após o tempo de expiração das publicações do PowerExchange. Essa opção pode diminuir o desempenho do trabalho de limpeza do banco de dados de distribuição e causar crescimento excessivo do banco de dados de distribuição.
  • Y
    . O processo de conexão CAPI excluirá os dados processados do banco de dados de distribuição depois que os dados forem fixados em 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 para o processo de conexão 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á todos os dados processados de publicações do PowerExchange, incluindo os dados de marca d'água inferior, da tabela distribution.dbo.MSrepl_commands no banco de dados de distribuição.
    O ID de usuário na qual o Agente de Log do PowerExchange é executado deve ter autoridade de exclusão na tabela MSrepl_commands.
    Essa opção pode ajudar a melhorar o desempenho e o controle do tamanho do banco de dados de distribuição. No entanto, se o Log Reader Agent do SQL Server Agent estiver gravando UOWs muito grandes no banco de dados de distribuição quando a conexão CAPI processar os dados da marca d'água inferior, o desempenho do banco de dados de distribuição poderá ser temporariamente reduzido porque o processo de conexão CAPI deve aguardar um bloqueio na tabela MSrepl_commands.
    Se você executar várias extrações em um único banco de dados de distribuição para diferentes bancos de dados de publicação e usar ENABLELWM=Y para uma conexão CAPI e ENABLELWM=N com um valor RSTRADV para outra conexão CAPI, o PowerExchange poderá emitir a mensagem de erro PWX-15756 para a conexão com ENABLELWM=N. A mensagem relata incorretamente que os dados de alteração foram perdidos. Para suprimir esse erro, adicione o parâmetro DWFLAGS=NNYN à instrução MSQL CAPI_CONNECTION.
O padrão é N.
EOF={
N
|Y}
Opcional. Controla se o PowerExchange interrompe as extrações de dados alterados quando o fim do arquivo (EOL) é atingido.
Insira uma das seguintes opções:
  • N
    . O PowerExchange não interrompe extrações de dados alterados quando o EOL é atingido.
  • Y
    . O PowerExchange interrompe extrações de dados alterados quando o EOL é atingido.
O padrão é N.
Como esse parâmetro afeta todos os usuários da instrução MSQL CAPI_CONNECTION, a Informatica recomenda que você use um dos seguintes métodos alternativos para interromper extrações de dados alterados no EOL:
  • Nas sessões do CDC que usam o modo de extração em tempo real, digite 0 para o atributo
    Tempo Inativo
    da conexão do aplicativo PWX MSSQL CDC em Tempo Real.
  • No Agente de Log do PowerExchange para Linux, UNIX e Windows, digite 1 para a instrução COLL_END_LOG no arquivo de configuração pwxccl.cfg.
  • Nas sessões do CDC que usam conexões ODBC, digite 0 para o parâmetro WAITTIME na fonte de dados ODBC.
GUIDBRACES={
Y
|N}
Opcional. Controla se o PowerExchange retém ou remove chaves {} em torno dos valores GUID nos dados capturados nas colunas registradas do SQL Server que têm o tipo de dados uniqueidentifier. Se a sessão do PowerCenter gravar os dados nas colunas uniqueidentifier de destino do SQL Server, defina esse parâmetro como N para remover as chaves. Caso contrário, a sessão encontrará erros de gravador.
  • N
    . Remover chaves.
  • Y
    . Manter chaves.
O padrão é Y.
MEMCACHE={
cache_size
|
256
}
O tamanho máximo, em kilobytes, do cache de memória que armazena os dados alterados de uma única operação SQL que são capturados do banco de dados de distribuição do SQL Server. O cache de memória armazena a imagem de linha completa, que pode incluir a pré-imagem e a pós-imagem e quaisquer dados LOB.
Os valores válidos vão de 0 a 2147483647. O padrão é 256. Se você inserir 0, o valor padrão será usado.
MULTIPUB={N|
Y
}
Opcional. Indica se você captura dados alterados do banco de dados de distribuição para artigos em um único banco de dados de publicação ou em vários bancos de dados de publicação. Essa opção pode afetar o desempenho do processamento do CDC no modo de extração e no modo de extração contínua em Tempo Real com o Agente de Log do PowerExchange para Linux, UNIX e Windows.
Insira uma das seguintes opções:
  • N
    . Especifique essa opção se você capturar dados alterados para artigos em um único banco de dados de publicação. A Informatica recomenda essa opção nesse cenário porque ele faz com que o PowerExchange extraia alterações com muito mais eficiência. Ela também pode ajudar a reduzir o uso de recursos.
  • Y
    . Use esta opção para extrair dados alterados para artigos em vários bancos de dados de publicação em uma única sessão do CDC ou em uma única passagem do Agente de Log do PowerExchange para Linux, UNIX e Windows. Se você não usar essa opção nesse cenário, o processamento de extração falhará com a mensagem PWX-15757.
    Essa opção poderá fazer com que registros de alteração sejam gravados no banco de dados de distribuição mais lentamente. Para melhorar o desempenho, adicione o seguinte índice para o banco de dados de distribuição:
    USE [distribution] GO /****** Object: Index [IX_MSrepl_transactions] Script Date: 03/31/2012 11:56:07 ******/ CREATE NONCLUSTERED INDEX [IX_MSrepl_transactions] ON [dbo].[MSrepl_transactions] ( [entry_time] ASC, [publisher_database_id] ASC, [xact_seqno] ASC, [xact_id] ASC )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = ON, SORT_IN_TEMPDB = OFF, IGNORE_DUP_KEY = OFF, DROP_EXISTING = OFF, ONLINE = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY] GO
O padrão é Y.
Você pode alterar a configuração MULTIPUB após a captura de alterações. Para manter a integridade de dados, siga o procedimento para alterar a definição do parâmetro MULTIPUB no
Guia do CDC do PowerExchange para Linux, UNIX e Windows
. Se usar o Agente de Log do PowerExchange para Linux, UNIX e Windows e alterar a configuração de Y para N, você deve inicializar a frio o Agente de Log do PowerExchange.
POLWAIT={
seconds
|
1
}
Opcional. O número máximo de segundos que o PowerExchange aguarda depois de atingir o fim do log antes de verificar se o banco de dados de origem em busca de mais dados de alteração.
Para origens Microsoft SQL Server, a frequência da verificação também depende do parâmetro NO_DATA_WAIT2 do Agente de Log do PowerExchange, ou se você não usar o Agente de Log do PowerExchange, a frequência da verificação dependerá do atributo Latência do PWX na conexão do aplicativo PWX CDC. Se o NO_DATA_WAIT2 ou o valor de Latência do PWX for menor do que o valor POLWAIT, o menor valor terá prioridade. Nesse caso, o PowerExchange realizará uma pesquisa na origem com mais frequência do que o esperado com base apenas no parâmetro POLWAIT.
Os valores válidos vão de 1 a 2147483647. O padrão é 1.
RECONNTRIES={
número
|
12
}
O número máximo de vezes que o PowerExchange tenta reconectar-se ao banco de dados MicrosoftSQL Server após a conexão ser descartada. Use este parâmetro em conjunto com o parâmetro RECONNWAIT se você receber o seguinte erro de conexão ODBC e quiser melhorar a resiliência de conexão:
PWX-15790 ODBC driver for Microsoft SQL Server returned error [08S01][Informatica][ODBC SQL Server Wire Protocol driver]Unexpected Network Error. ErrNum = 10054.
Os valores válidos são 0 ou qualquer número positivo. Um valor 0 resulta em nenhuma nova tentativa de conexão. O padrão é 12.
RECONNWAIT={
segundos
|
5
}
O número de segundos que o PowerExchange aguarda antes de qualquer tentativa de se reconectar a um banco de dados MicrosoftSQL Server após a conexão ter sido descartada. Use este parâmetro em conjunto com o parâmetro RECONNTRIES se você receber a mensagem PWX-15790 para um erro no driver ODBC e quiser melhorar a resiliência de 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.
RSTRADV=
seconds
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 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.
Valores válidos de 0 a 86400. Nenhum padrão é especificado.
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.
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.
SQLNOLOCK={N|Y}
Opcional. Controla se instruções SELECT do PowerExchange usam a dica NOLOCK ao consultar o banco de dados de distribuição do SQL Server para a captura de dados de alterações. A dica NOLOCK pode evitar a contenção de bloqueio com os utilitários do SQL Server, mas pode fazer com que o PowerExchange perca alguns registros de alteração.
Insira uma das seguintes opções:
  • N
    . As consultas SELECT do PowerExchange que recuperam dados do banco de dados de distribuição
    não
    usam a dica NOLOCK. Se os bloqueios forem mantidos em alguns registros de alteração, as consultas do PowerExchange não poderão recuperar os dados até que esses bloqueios sejam liberados. Com essa configuração, as consultas do PowerExchange podem demorar mais para serem concluídas. No entanto, nenhuma alteração é ignorada, e a integridade dos dados é preservada. Use essa opção somente quando o parâmetro MULTIPUB estiver definido como Y.
  • Y
    . As consultas SELECT do PowerExchange que recuperam dados do banco de dados de distribuição usam a dica NOLOCK. Use essa opção somente quando o parâmetro MULTIPUB estiver definido como N. Se o parâmetro MULTIPUB estiver definido como Y, o SQL Server poderá usar verificações de ordem de alocação para recuperar dados para consultas do PowerExchange, o que pode resultar em perda de dados de alterações e corrupção de dados.
    Em vez de usar SQLNOLOCK=Y, a Informatica recomenda que você defina o nível de isolamento para o banco de dados de distribuição como READ_COMMITTED_SNAPSHOT ON para evitar problemas de integridade de dados.
O padrão é
N
quando MULTIPUB está definido como Y, ou
Y
quando MULTIPUB está definido como N.
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.