Partilhar via

Databricks JDBC Driver

Observação

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

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

O Databricks JDBC Driver permite conectar ferramentas como DataGrip, DBeaver e SQL Workbench/J ao Azure Databricks por meio do Java Database Connectivity (JDBC), uma especificação padrão do setor para acessar sistemas de gerenciamento de banco de dados.

Esse driver implementou as APIs JDBC e fornece funcionalidades principais, incluindo OAuth, Cloud Fetch e recursos como a ingestão de volume do Unity Catalog. Ele executa o modo de consulta nativa e suporta consultas com parâmetros nativos, podendo ser executado através das APIs de execução de instruções, que oferecem a útil funcionalidade de retenção de resultados de consulta, ou através do Thrift.

Observação

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

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

Requerimentos

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

  • Java Runtime Environment (JRE) 11.0 ou superior. O teste CI é suportado pelo 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 a partir dessa ramificação, conforme necessário. Esta ramificação é sincronizada com a ramificação principal periodicamente, mas as contribuições da comunidade são bem-vindas para mantê-la atualizada. Consulte a ramificação 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 de seta Apache 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 o aplicativo ou driver usando a seguinte opção de comando JVM:

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

Instale o driver

O Databricks JDBC Driver é publicado no repositório Maven.

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

  • Para projetos 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 Gradle, adicione a seguinte dependência ao arquivo de compilação 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 da versão mais recente do Databricks JDBC Driver, consulte o Repositório Maven.

Próximos passos

Recursos adicionais

  • Last updated on