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 DataGripDBeaver e SQL Workbench/J para Azure Databricks por meio Java JDBC (Conectividade de Banco de Dados), 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.

Esta página fornece informações sobre como instalar e usar o Driver JDBC do Databricks, versão 3 e superior. Para obter informações sobre o Driver JDBC do Simba (Herdado), abaixo da versão 3, consulte Simba JDBC Driver (Legacy).

Requisitos

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

  • Java JRE (Ambiente de Runtime) 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 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.

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.3.1</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.3.1'
    

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