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

CAPI_CONNECTION - Instrução MYSQL

CAPI_CONNECTION - Instrução MYSQL

A instrução MYSQL 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 fontes do MySQL.
Linux e Windows
MySQL
Sim para o CDC do MySQL
CAPI_CONNECTION=(NAME=
capi_connection_name
[,DLLTRACE=
trace_id
]   ,TYPE=(MYSQL     ,SERVER={
database_server
|
localhost
} ,CATSCHEMA=
catalog_schema_name
[,CATSERVER=
catalog_server
] [,CATUSERNAME=
catalog_user_name
] [,CATEPASSWORD=
encrypted_catalog_user_password
] [,CATPASSWORD=
catalog_user_password
] [,MYSQLBINLOG=
path/binlog_file
[
option1 option2 ...
]]    [,ONDATATRUNC={WARN|
FAIL
}]    [,ONTABLEDDL={WARN|
WARN-UNTIL-EOL
|FAIL}]    [,ONTABLETRUNC={WARN|
FAIL
}] [,RECONNTRIES={
reconnection_attempts
|
12
}] [,RECONNWAIT={
seconds
|
5
}]    [,ROWMEMMAX=
bytes
]      [,RSTRADV=
seconds
]    [,UOWREADAHEAD={
minimum_transactions
|
5
},{
maximum_transactions
|
10
}]      ) )
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.
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=(MYSQL, ... )
Obrigatório. O tipo de instrução CAPI_CONNECTION. Para origens do MySQL, esse valor deve ser MYSQL.
SERVER={
server_name
|localhost}[,
port_number
]
Obrigatório. O nome do host ou endereço IP do servidor MySQL em que o banco de dados de origem do MySQL é executado. Você pode inserir "localhost" se o servidor MySQL e o Ouvinte do PowerExchange forem executados localmente na mesma máquina.
Se você quiser que o servidor de origem atenda em um número de porta diferente da porta padrão, anexe o número da porta ao nome do servidor.
CATSERVER
Opcional. O nome do servidor contendo as tabelas de catálogos atualizadas por DDL que armazenam as definições da tabela de origem do MySQL.
O padrão é o nome do servidor de origem do MySQL. Você pode usar o padrão se criou as tabelas de catálogo e instalou os drivers ODBC do MySQL no servidor de origem.
CATSCHEMA
Obrigatório. O nome do esquema para as tabelas de catálogos DDL.
CATUSERNAME
Opcional. Um nome de usuário usado para se conectar ao servidor de catálogos.
O padrão será o nome de usuário de origem do MySQL, se as tabelas de catálogos existirem no servidor de origem.
CATEPASSWORD
Opcional. A senha criptografada do usuário do catálogo especificado. Especifique CATEPASSWORD ou CATPASSWORD, mas não especifique os dois parâmetros.
O padrão será a senha do usuário de origem do MySQL, se as tabelas de catálogos existirem no servidor de origem.
CATPASSWORD
Opcional. A senha com texto não criptografado do usuário do catálogo especificado. Especifique CATPASSWORD ou CATEPASSWORD, mas não especifique os dois parâmetros.
O padrão será a senha do usuário de origem do MySQL, se as tabelas de catálogos existirem no servidor de origem.
MYSQLBINLOG=
path/binlog_file_name
[
option1 option2...
]
Opcional. Se o servidor MySQL não estiver instalado no host local, especifique o caminho para o utilitário mysqlbinlog neste parâmetro ou na variável de ambiente PATH. O PowerExchange usa o utilitário mysqlbinlog para ler os eventos de alteração do log binário do MySQL. Opcionalmente, você pode incluir qualquer uma das opções compatíveis com o utilitário mysqlbinlog, como as opções --ssl-. O PowerExchange passa as opções para o utilitário quando a sessão do CDC é executada. Para obter informações sobre as opções de utilitário, consulte o
Manual de Referência do MySQL
.
Se qualquer parte do valor de MYSQLBINLOG incluir espaços, você deverá colocar todo o valor MYSQLBINLOG entre aspas duplas ("). Além disso, se qualquer parte do valor de
path\binlog_file_name
ou uma opção incluir um espaço, escape o valor com o caractere de barra invertida (\) e coloque-o entre aspas duplas, por exemplo:
MYSQLBINLOG="\"c:\bin\test dir\mysqlbinlog.exe\" --ssl-mode required "
Se o valor de
path\binlog_file_name
começar com o caractere hífen (-), todo o valor será tratado como uma opção de utilitário, como se nenhum valor de
path/file_name
fosse especificado.
ONDATATRUNC={WARN|
FAIL
}
Opcional. Indica se o PowerExchange emite uma mensagem de aviso e continua o processamento ou termina de forma anormal quando precisa truncar dados de colunas do MySQL que têm um tipo de dados mediumblob, longblob, mediumtext, longtext, enum, json, set, varbinary ou varchar e têm mais de 98.304 bytes.
O padrão é FAIL.
ONTABLEDDL={WARN|
WARN-UNTIL-EOL
|FAIL}
Opcional. Indica se o PowerExchange emite uma mensagem de aviso e continua o processamento ou termina de forma anormal quando encontra um registro DDL para uma fonte que não é consistente com o registro de origem. As opções são:
  • WARN. Emita uma mensagem de aviso e continue o processamento da captura.
  • WARN-UNTIL-EOL. Emita uma mensagem de aviso e continue o processamento de captura até o fim do log (EOL). Em seguida, emita uma mensagem de erro e encerre o processamento de captura.
  • FAIL. Emita uma mensagem de erro e encerre o processamento de captura.
O padrão é WARN-UNTIL-EOL.
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 do Servidor MySQL após detectar que o servidor de banco de dados foi desligado ou a conexão de rede com o servidor foi interrompida. Quando o PowerExchange e o servidor de banco de dados são executados na mesma máquina, o PowerExchange processa registros de alteração no final do log e, em seguida, verifica se o servidor ainda está em execução. Se o PowerExchange se conectar a um servidor de banco de dados remoto e o servidor for desligado ou a conexão de rede ao servidor for interrompida, a conexão do leitor de log binário poderá ser interrompida. Nesse caso, você pode usar esse parâmetro em conjunto com o parâmetro RECONNWAIT para melhorar a resiliência da conexão.
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
}
Opcional. O número de segundos que o PowerExchange aguarda antes de qualquer tentativa de se reconectar a um servidor de banco de dados do Servidor MySQL após detectar que o servidor foi desligado ou a conexão de rede com o servidor foi interrompida. 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.
ROWMEMMAX=
maximum_bytes
Opcional. A quantidade máxima de memória, em bytes, que o PowerExchange pode usar para armazenar uma alteração de linha de uma tabela de origem do MySQL. Nenhum valor padrão está disponível. Se nenhum valor máximo for fornecido, o PowerExchange não limitará a memória para uma alteração de linha capturada.
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 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. 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.
UOWREADAHEAD=
minimum_transactions_in_queue
,
maximum_transactions_in_queue
Opcional. O número mínimo de transações e o número máximo de transações que controlam a E/S na fila de leitura antecipada do UOW que o PowerExchange usa para pré-buscar dados alterados. A fila de leitura antecipada do UOW é uma fila dinâmica de transações em buffer que estão aguardando para serem lidas pelo processo de captura do PowerExchange. Quando a fila atinge o número máximo de transações, o thread do leitor de fila para e dorme até que transações suficientes tenham sido lidas na fila para retorná-la ao valor máximo. O número de transações na fila pode ficar menor que o número mínimo nos seguintes casos:
  • O PowerExchange leu até o final do log binário e nenhuma alteração adicional está disponível.
  • As transações na fila são consumidas mais rapidamente do que as alterações são lidas no log binário.
Para o campo
minimum_transactions
, o valor padrão é 5 e o intervalo válido de valores é de 0 a 100. Para o campo
maximum_transactions
, o valor padrão é 10 e o máximo é 100.
O número máximo de transações que a fila pode conter é 100.