Centro de suporte da Workiva

Com o conector JDBC, você pode usar os comandos em uma cadeia para executar operações de linguagem de consulta estruturada (SQL) em soluções locais compatíveis com a conectividade de banco de dados Java® (JDBC). Por exemplo, com esse conector, você pode:

• Executar comandos SQL, incluindo uma instrução CREATE ou UPDATE ou uma consulta SELECT
• Recuperar detalhes sobre uma tabela de banco de dados
• Inserir registros em um banco de dados via JDBC

Observação: Para conectar-se ao Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) ou Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, ou Snowflake®, use seu respectivo conector.

Pré-requisitos

Para proteger a conexão JDBC, o conector usa autenticação básica de nome de usuário e senha. Para configurar o conector, você precisará de:

• Um usuário de integração designado, configurado na solução à qual você está se conectando.
• As credenciais de autenticação do usuário de integração
• A URL da conexão JDBC, como jdbc:solution://host:port/database
• A GroundRunner dedicado ao conector, pois não há suporte para CloudRunners.
• O driver JDBC para a conexão, incluindo o nome da classe e o caminho no sistema de arquivos do GroundRunner.
• Para que você possa personalizar as opções de Java ao usar esse conector, defina a variável de ambiente JDK_JAVA_OPTIONS para o GroundRunner. Por exemplo, se estiver usando o Databricks, você usaria o seguinte:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". Você deve reiniciar o computador em que o GroundRunner está operando após definir essa variável. Isso é semelhante às variáveis de configuração definidas em Instalar e gerenciar GroundRunners. 
  Importado: Você deve reiniciar o computador em que o GroundRunner está operando depois de definir essa variável.

Nota: O driver deve estar localizado no GroundRunner, pois os arquivos .jar não podem ser carregados como recursos.

Configurar o conector JDBC

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de Cadeias, clique em Conexões compare_arrows e, em seguida, em Criar no canto superior direito.
2. Em Connector Connection, selecione JDBC e o GroundRunner a ser usado com a conexão.
   
3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.

4. Em Propriedades, digite os detalhes da conexão:
   

   Propriedade	Detalhes
   Nome de usuário	Digite o nome de usuário para o usuário de integração do conector.
   Senha	Digite a senha da propriedade Nome de usuário.
   URL de conexão	Digite o URL da conexão JDBC, como jdbc:solution://host:port/database.
   Classe de unidade JDBC	Digite o nome da classe do arquivo .jar do driver JDBC. Por exemplo, para Sybase®, digite com.sybase.jdbc.sybdriver.
   Caminho para o driver JDBC	Digite o caminho para a instalação do driver JDBC no sistema de arquivos do GroundRunner.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.

5. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
6. Desligue e reinicie o computador em que o GroundRunner está sendo executado para reinicializar o JVM.
7. Para testar a conexão, crie e execute uma cadeia com o comando Get Table Definition do conector e verifique se ele retorna uma saída válida.

Solução de problemas

Se a conexão JDBC falhar:

• Verifique as credenciais de autenticação do usuário de integração.
• Verifique o URL da conexão JDBC, incluindo o servidor, a porta e o banco de dados.
• Verifique o nome da classe do driver JDBC ou o caminho inserido para o conector.

Se a conexão não conseguir executar um comando, verifique se suas entradas (como a sintaxe ou a tabela SQL) são válidas.