Compartir vía

Controlador JDBC de Databricks (OSS)

Nota:

El código fuente de Databricks JDBC Driver (OSS) está disponible públicamente en la licencia de Apache 2.0.

Esto refleja el compromiso de Databricks con la transparencia, la colaboración y el poder del desarrollo basado en la comunidad. Las contribuciones de desarrolladores, usuarios y la comunidad son bienvenidos. Para empezar, consulte las Directrices de contribución.

Databricks JDBC Driver (OSS), la versión más reciente del controlador JDBC de Databricks, le permite conectar herramientas como DataGrip, DBeaver y SQL Workbench/J a Azure Databricks a través de Java Database Connectivity (JDBC), una especificación estándar del sector para acceder a los sistemas de administración de bases de datos.

Este controlador ha implementado las API de JDBC y proporciona otras funciones básicas como OAuth, Cloud Fetch y características como la ingesta de volúmenes de Unity Catalog. Ejecuta en modo de consulta nativo y admite consultas parametrizadas nativas, y puede ejecutarse utilizando las APIs de Ejecución de Sentencias, que ofrecen la característica beneficiosa de retención de resultados de consulta, o con Thrift.

En este artículo se proporciona información sobre cómo instalar y usar Databricks JDBC Driver (OSS). Para obtener información sobre el controlador JDBC de Databricks que no es de OSS, consulte Controlador JDBC de Databricks.

Requisitos

Para usar Databricks JDBC Driver (OSS), se deben cumplir los siguientes requisitos:

  • Java Runtime Environment (JRE) 11.0 o superior. Las pruebas de CI se admiten en JRE 11, 17 y 21.

Nota:

Como resultado de un cambio en JDK 16 que provocó un problema de compatibilidad con la biblioteca de Apache Arrow usada por el controlador JDBC, pueden producirse errores en tiempo de ejecución al usar el controlador JDBC con JDK 16 o superior. Para evitar estos errores, reinicie la aplicación o el controlador mediante la siguiente opción de comando de JVM:

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

Instalar el controlador

El controlador JDBC de Databricks (OSS) se publica en el repositorio de Maven.

Para instalar el controlador, puede realizar cualquiera de las acciones siguientes:

  • Para los proyectos de Maven, agregue la siguiente dependencia al archivo del pom.xml proyecto para indicar a Maven que descargue automáticamente el controlador JDBC con la versión especificada:

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

  • En el caso de los proyectos de Gradle, agregue la siguiente dependencia al archivo de compilación del proyecto para indicar a Gradle que descargue automáticamente el controlador JDBC con la versión especificada:

    implementation 'com.databricks:databricks-jdbc:1.0.6-oss'

Para ver la sintaxis de dependencia de otros tipos de proyecto y obtener el número de versión más reciente del controlador JDBC (OSS) de Databricks, consulte el repositorio de Maven.

Pasos siguientes

Recursos adicionales