Criar uma conexão JDBC com o Cache

Quando precisamos integrar o Caché/IRIS com outros bancos de dados relacionais, uma pergunta comum surge: “Como configuro a conexão JDBC?”. A documentação oficial nem sempre fornece um guia passo a passo direto, o que pode ser frustrante, especialmente para iniciantes.

Neste artigo, vou guiá-lo por todo o processo de configuração de uma conexão JDBC com MySQL, desde o download do conector até o espelhamento de tabelas no Caché/IRIS.

Nota: Conexões JDBC no Caché/IRIS têm algumas limitações, especialmente em relação ao caching e ao uso de ResultSet. Em muitos casos, você pode precisar adaptar consultas manualmente e usar o objeto Gateway para lidar com cenários avançados.

1. Baixar o Conector JDBC do MySQL

O primeiro passo é baixar o driver JDBC oficial do MySQL.
Vá para: https://dev.mysql.com/downloads/connector/j/

2. Tornar o Conector Acessível

Após o download:

1. Extraia o pacote
2. Localize o arquivo.jar  (ex., mysql-connector-j-9.4.xx.jar).
3. Copie o arquivo para uma pasta acessível ao Caché/IRIS, por exemplo:

3. Configurar a Conexão no Portal de Administração

Agora, vamos configurar a conexão dentro do Portal de Administração:

1. Abra o Portal de Administração Caché/IRIS em seu navegador.
2. Navegue até Gateway Sql Connections (Conexões SQL do Gateway).
3. Clique em “Create New Connection” (Criar Nova Conexão).

Crie uma nova conexão e configure-a usando o exemplo fornecido:

,

4. Espelhar Tabelas Externas

• Vá para a tela SQL no Menu
• Clique em Assistant > Link Table (Assistente > Espelhar Tabela).
• Selecione sua conexão (MySQL_Conn).
• Escolha as tabelas que você deseja espelhar.
• Confirme.

Configure as definições necessárias; esta parte é fácil e muito sugestiva. Uma vez feito isso, sua conexão JDBC estará pronta. Você poderá ver o banco de dados e as tabelas na própria tela SQL e poderá trazer os dados. Lembre-se que o MySQL usa crases (`) para formar o SELECT, e o Caché/IRIS usa aspas duplas ("), o que pode ser um problema ao realizar algumas consultas.
Após mapear as tabelas, você poderá visualizá-las na aba Tables (Tabelas) da tela SQL.

5. Considerações sobre a Sintaxe SQL

Uma questão comum:

• O MySQL usa crases (`) para nomes de tabelas e colunas.
• O Caché/IRIS usa aspas duplas (") para identificadores.
• Ao selecionar as opções apropriadas na tela de configuração do Gateway (conforme mostrado na captura de tela), você pode resolver esse problema. No entanto, você também pode optar por deixar inalterado por qualquer motivo.

Isso pode causar problemas em consultas. Se necessário, ajuste manualmente a sintaxe ao escrever comandos SQL.

Conclusão

E é isso! Agora você tem uma conexão JDBC funcional entre Caché/IRIS e MySQL.

Com esta configuração, você pode:

• Consultar dados do MySQL diretamente do Caché/IRIS.
• Espelhar tabelas para o seu namespace para fácil integração.
• Automatizar a troca de dados entre sistemas.

Embora o JDBC no Caché/IRIS tenha algumas limitações, esta configuração abrange a maioria das necessidades de integração de forma prática.