Databricks Driver JDBC (OSS)
O Databricks JDBC Driver (OSS), a versão mais recente do driver JDBC Databricks, permite conectar ferramentas como DataGrip, DBeavere 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 nativo e suporta consulta parametrizada nativa, e pode ser executado usando APIs de execução de instruções, que fornece o útil recurso de retenção de resultados de consulta, ou Thrift.
Este artigo fornece informações sobre como instalar e usar o Databricks JDBC Driver (OSS). Para obter informações sobre o driver JDBC Databricks não-OSS, consulte Databricks JDBC Driver.
Requisitos
Para usar o Databricks JDBC Driver (OSS), os seguintes requisitos devem ser atendidos:
- Java Runtime Environment (JRE) 11.0 ou superior. O teste de CI é suportado no JRE 11, 17 e 21.
Nota
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 (OSS) é 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>1.0.1-oss</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:1.0.1-oss'
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 (OSS), consulte o Maven Repository.
Próximos passos
- Configurar uma URL de conexão
- Propriedades de autenticação e configuração de proxy
- propriedades de configuração do SQL
- Ativar registo
- Exemplo: Executar uma consulta usando o driver JDBC (OSS)