Preparar Conexão do Banco de Dados

Saiba mais sobre como configurar definições de conexão de banco de dados, sistema e parâmetro para o Oracle GoldenGate for SQL Server.

O Oracle GoldenGate for SQL Server se conecta aos bancos de dados do SQL Server 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 à interface Web do Serviço de Administração ou por meio do Admin Client.

Configurar uma Conexão DSN no Linux

As etapas a seguir demonstram como criar uma conexão DSN no Linux usando um arquivo odbc.ini.

Para versões anteriores à versão 23.6 do Oracle GoldenGate, primeiro você precisa adicionar uma nova variável de ambiente ODBCINI para a implantação do SQL Server usando as etapas abaixo. As versões que começam com a versão 23.6 definem automaticamente essa variável durante a criação da implantação.
1. Faça login na interface web do Service Manager.
2. No painel de navegação esquerdo, clique em Implantações e selecione a implantação do Oracle GoldenGate SQL Server. 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_HOME)/msodbc/odbc.ini
5. Clique em Submeter para criar a nova variável e, em seguida, reinicie a implantação no painel Implantações para que as alterações tenham efeito.
Na pasta msodbc da instalação do Oracle GoldenGate, crie manualmente um arquivo odbc.ini e adicione origens de dados nesse arquivo usando as informações e o exemplo a seguir.

Exemplo de versões do Oracle GoldenGate anteriores à 23.6, em que Driver deve ser definido como 'ODBC Driver 18 for SQL Server'
```
[mssql_source]
Driver = ODBC Driver 18 for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```
Exemplo de Oracle GoldenGate versões 23.6 ou posteriores, em que Driver deve ser definido como 'Microsoft ODBC Driver for SQL Server'
```
[mssql_source]
Driver = Microsoft ODBC Driver for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```

Observação: Para obter uma lista completa das opções de conexão disponíveis, consulte a documentação da Microsoft no seguinte link: https://learn.microsoft.com/en-us/sql/connect/odbc/dsn-connection-string-attribute?view=sql-server-ver16

Salve e feche o arquivo odbc.ini.
Para criar a conexão de banco de dados para a implantação, consulte Adicionar Conexões de Banco de Dados.

Configurar uma Conexão DSN no Windows

Antes de criar uma conexão de banco de dados para processos do Oracle GoldenGate em execução no Windows, instale a versão mais recente do Driver Microsoft ODBC 17 para SQL Server ou do Driver Microsoft ODBC 18 para SQL Server.

Siga estas etapas para criar um DSN do sistema no servidor Windows em que o Oracle GoldenGate está instalado.

Para criar um DSN do SQL Server:

Abra o aplicativo Origens de dados ODBC (64 bits).
Na caixa de diálogo Administrador da Origem de Dados ODBC, selecione a guia DSN do Sistema e clique em Adicionar.
Em Criar Nova Origem de Dados, selecione o Driver ODBC {version} para SQL Server e clique em Finalizar. O assistente Criar uma Nova Origem de Dados para SQL Server é exibido.
Informe os seguintes detalhes e clique em Avançar:
- Nome: Pode ser de sua escolha. Em um cluster do Windows, use um nome em todos os nós do cluster.
- Descrição: (Opcional) Digite uma descrição desta origem de dados.
- Servidor: Digite a string de conexão do SQL Server ou o nome da instância\do servidor. Para conexões Always On, use o nome da instância do listener\do Grupo de Disponibilidade Always On.
Para autenticação de log-in, selecione autenticação do SQL Server, especifique as informações de ID de Log-in e Senha e clique em Próximo.
Se estiver configurando uma conexão usando o Driver Microsoft ODBC 18 para SQL Server, clique em Próximo novamente para ir para a última página de configuração. Selecione a opção para Certificado do servidor de confiança e clique em Voltar para prosseguir, pois você precisa primeiro ativar o certificado do servidor de Confiança antes de selecionar o banco de dados padrão na próxima etapa.
Selecione Alterar o banco de dados padrão para e, em seguida, selecione o banco de dados de origem ou de destino na lista. Ative as definições de Usar ANSI e clique em Próximo.
Deixe a próxima página do assistente no estado em que se encontra e clique em Concluir.
Clique em Testar Origem de Dados para testar a conexão.
Se o teste for bem-sucedido, feche a caixa de confirmação e a caixa Criar uma nova origem de dados.
Repita este procedimento para cada banco de dados de origem e destino do SQL Server, em que o processo do Oracle GoldenGate se conectará.

Estabelecendo Conexão com o Listener de um SQL Server Always On Configuration

O Extract e o Replicat podem se conectar ao listener de uma configuração Always On ou diretamente à réplica principal atual do grupo.

A vantagem de criar a conexão com o listener é que o Extract ou o Replicat pode se reconectar à nova réplica principal após o failover sem precisar reconfigurar a string de conexão com o novo principal.

Um Extract também pode ser configurado para rotear suas consultas somente leitura para uma réplica secundária de modo síncrono legível disponível. Por padrão, se o Extract se conectar a um listener, todo o processamento será feito na réplica principal, mas se um Extract for configurado com o parâmetro TRANLOGOPTIONS ALWAYSONREADONLYROUTING, suas consultas somente leitura serão roteadas pelo listener para uma réplica secundária legível disponível.

Consulte TRANLOGOPTIONS e Resumo de Requisitos para Captura e Entrega de Bancos de Dados em um Grupo de Disponibilidade Sempre Ativo para obter mais informações.

Se estiver criando o DSN para estabelecer conexão com um Listener de uma configuração Always On, ative a opção de failover Multissub-rede ao criar um DSN. Para conexões DSN do Linux, use a opção MultiSubnetFailover=Yes na entrada DSN.