Preparar Conexão do Banco de Dados

O Oracle GoldenGate for Yugabyte (variante PostgreSQL) se conecta aos bancos de dados Yugabyte usando um driver ODBC pré-empacotado. As conexões podem ser estabelecidas usando um Nome de Origem de Dados (DSN) ou usando uma conexão direta e fornecendo o host, a porta, o banco de dados e outras informações do servidor de banco de dados.

O uso de conexões DSN requer que os detalhes da conexão sejam listados em um arquivo odbc.ini, enquanto o uso de entradas diretas é inserido manualmente ao adicionar uma conexão de banco de dados da interface Web ou do Admin Client.

Observação: PgBouncer não é suportado para conexões do Oracle GoldenGate.

Observação: O Oracle GoldenGate não suporta conexões com o Yugabyte que usam Pgpool.

Depois de executar as etapas fornecidas a seguir para criar as entradas DSN ou você planeja usar conexões diretas, vá para o tópico Adicionar Conexões de Banco de Dados para saber como criar conexões de banco de dados.

Configurar uma Conexão baseada em DSN

Para criar uma conexão DSN para processos do Oracle GoldenGate, primeiro você precisará adicionar uma variável de ambiente para a implantação do Oracle GoldenGate for Yugabyte e, em seguida, criar um arquivo odbc.ini para armazenar os atributos de conexão.

1. Faça login na interface web do Service Manager.

2. No painel de navegação esquerdo, clique em Implantações e selecione o nome da implantação para Yugabyte. Isso expande as várias configurações para a implantação.

3. Clique em Configuração e, em seguida, clique no sinal de mais (+) ao lado de Variáveis de Ambiente.

4. Forneça as informações a seguir nos dois campos disponíveis. Para o campo Valor da Variável de Ambiente, verifique se ele é o caminho absoluto do arquivo odbc.ini:

   Nome da Variável de Ambiente = ODBCINI

   Valor da Variável de Ambiente = /ogg/deployment/yugabyte/odbc.ini

5. Clique em Submeter para criar a nova variável e, em seguida, reiniciar a implantação no painel Implantações, para que as alterações entrem em vigor.

6. Na pasta deployment da instalação do Oracle GoldenGate, crie manualmente um arquivo odbc.ini e adicione origens de dados nesse arquivo.

Use as seguintes configurações mínimas ao criar o arquivo DSN:

• Data Source Name – Um nome definido pelo usuário de uma conexão de banco de dados de origem ou de destino que será referenciada pelos processos do Oracle GoldenGate, como Extract ou Replicat. Os nomes DSN são permitidos com até 32 caracteres alfanuméricos e só podem incluir sublinhado (_) e traço (-) de caracteres especiais.

• IANAAppCodePage=4 – É a definição padrão, mas pode ser modificada de acordo com a orientação especificada na página https://docs.progress.com/bundle/datadirect-connect-odbc-71/page/IANAAppCodePage_9.html#IANAAppCodePage_9 quando o conjunto de caracteres do banco de dados não for Unicode.

• InstallDir – É o nome do caminho do driver do protocolo remoto PostgreSQL do Oracle GoldenGate e pode usar um caminho relativo, como: InstallDir =./datadirect

• Driver: É o nome do arquivo de driver do Oracle GoldenGate PostgreSQL Wire Protocol e pode usar um caminho relativo, como: Driver=./datadirect/lib/ggpsql25.so.

• Database: Este é o nome do banco de dados de origem ou de destino.

• Hostname: Este é o endereço IP ou o nome do host do host do banco de dados.

• PortNumber: Esta é a porta de listening do banco de dados.

• O Oracle GoldenGate for Yugabyte suporta vários hosts e portas para conexões Yugabyte. Esse recurso é útil na configuração do Oracle GoldenGate High Availability (HA). Em uma configuração de HA Yugabyte, há um servidor principal e vários servidores stand-by. Você pode configurar o formato de string de conexão para especificar vários hosts:

  String de Conexão	Descrição
  db-user@host1,host2,host3/db-name	As conexões seriam tentadas usando a porta de banco de dados Yugabyte padrão 5433 para todos os hosts (host1, host2, host3).
  db-user@host1:1234,host2:2345,host3:3456/db-name	Há uma tentativa de estabelecer conexões usando as portas associadas a cada host especificado na string de conexão.
  db-user@host1,host2,host3:1234/db-name	Todos os hosts que usam o mesmo número de porta (1234) em todos os hosts (host1, host2, host3). A tentativa de estabelecer conexões usando a porta 1234 para todos os hosts (host1, host2, host3).
  db-user@host1,host2,host3:1234/db-name	Todos os hosts que usam o mesmo número de porta (1234) em todos os hosts (host1, host2, host3). As conexões seriam tentadas usando a porta 1234 para todos os hosts.
  db-user@host1:3456,host2,host3:1234/db-name	Se a string de conexão for especificada em outros formatos em que o número da porta é especificado para alguns hosts enquanto os outros hosts são especificados sem portas, a especificação da última porta ou da extremidade direita será usada como o número da porta para todos os hosts que não têm um número de porta especificado na string de conexão. Como mostrado na string de conexão: db-user@host1:3456,host2,host3:1234/db-name O número da porta para host2 seria 1234, que é o número da porta mais à direita especificado na string de conexão.

• Você também pode fornecer uma LogonID e uma Password para o usuário Extract ou Replicat, mas elas serão armazenadas em texto não criptografado. É recomendável deixar esses campos fora do DSN e, em vez disso, armazená-los na wallet do Oracle GoldenGate como um alias de credencial e referenciá-los com o parâmetro USERIDALIAS em Extract e Replicat.

Veja a seguir um arquivo de exemplo odbc.ini com duas entradas DSN. Os nomes da Origem de Dados usados no exemplo abaixo são PG_src e PG_tgt.

#[ODBC Data Sources] [ODBC] IANAAppCodePage=4 InstallDir=/datadirect

[PG_src] Driver= ./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=sourcedb HostName=remotehost PortNumber=5432

| — |

[PG_tgt] Driver=./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=targetdb HostName=remotehost PortNumber=5432

1. Salve e feche o arquivo odbc.ini.

2. Para configurar a conexão de banco de dados do Oracle GoldenGate para uma implantação de Yugabyte, consulte Adicionar Conexões de Banco de Dados.