Compartilhar via

Databricks JDBC Driver

Observação

O código-fonte do Driver JDBC do Databricks está disponível publicamente na licença do Apache 2.0.

Isso reflete o compromisso do Databricks com a transparência, a colaboração e o poder do desenvolvimento orientado pela comunidade. Contribuições de desenvolvedores, usuários e comunidade são bem-vindas. Para começar, consulte as Diretrizes de Contribuição.

O Driver JDBC do Databricks permite que você conecte ferramentas como DataGrip, DBeaver e SQL Workbench/J ao Azure Databricks por meio da JDBC (Conectividade de Banco de Dados Java), uma especificação padrão do setor para acessar sistemas de gerenciamento de banco de dados.

Esse driver implementou as APIs do JDBC e fornece funcionalidades básicas, incluindo o OAuth, a Busca na Nuvem e recursos como ingestão de volume do Catálogo do Unity. Ele executa o modo de consulta nativa, dá suporte à consulta parametrizada nativa e pode ser executado usando APIs de Execução de Instrução, o que fornece o recurso vantajoso de retenção de resultados de consulta, ou Thrift.

Observação

Nos sistemas operacionais IBM AIX, não há suporte para o formato de resultado do Apache Arrow. Como o Cloud Fetch depende de Seta, o Cloud Fetch também não tem suporte no AIX. Para evitar erros durante a execução do SQL, desabilite a seta definindo a propriedade de conexão JDBC: EnableArrow=0

Este artigo fornece informações sobre como instalar e usar o Driver JDBC do Databricks, versão 3 e superior. Para obter informações sobre o Simba (Driver JDBC) do Databricks, abaixo da versão 3, consulte Databricks JDBC Driver (Simba).

Requisitos

Para usar o Driver JDBC do Databricks, os seguintes requisitos devem ser atendidos:

  • JRE (Java Runtime Environment) 11.0 ou superior. Há suporte para o teste de CI no JRE 11, 17 e 21.

Uma ramificação dedicada do JDK 8 está disponível para usuários que exigem compatibilidade com o Java 8. Os usuários podem criar um JAR com base nesse branch, conforme necessário. Este ramo é sincronizado periodicamente com o ramo principal, mas as contribuições da comunidade são bem-vindas para mantê-lo atualizado. Consulte o branch JDK 8 do driver JDBC do Databricks.

Observação

Como resultado de uma alteração no JDK 16 que causou um problema de compatibilidade com a biblioteca Apache Arrow usada pelo driver JDBC, erros de tempo de execução podem ocorrer ao usar o driver JDBC com JDK 16 ou superior. Para evitar esses erros, reinicie seu aplicativo ou driver usando a seguinte opção de comando JVM:

--add-opens=java.base/java.nio=org.apache.arrow.memory.core ALL-UNNAMED

Instalar o driver

O Driver JDBC do Databricks é publicado no Repositório Maven.

Para instalar o driver, você pode fazer o seguinte:

  • Para projetos do Maven, adicione a seguinte dependência ao arquivo do pom.xml projeto para instruir o Maven a baixar automaticamente o driver JDBC com a versão especificada:

    <dependency>
  <groupId>com.databricks</groupId>
  <artifactId>databricks-jdbc</artifactId>
  <version>3.0.5</version>
  <scope>runtime</scope>
</dependency>

  • Para projetos do Gradle, adicione a seguinte dependência ao arquivo de build do projeto para instruir o Gradle a baixar automaticamente o driver JDBC com a versão especificada:

    implementation 'com.databricks:databricks-jdbc:3.0.5'

Para exibir a sintaxe de dependência para outros tipos de projeto e obter o número de versão mais recente do Driver JDBC do Databricks, consulte o Repositório Maven.

Próximas etapas

Recursos adicionais

  • Last updated on