Partager via

Pilote JDBC Databricks

Remarque

Le code source du pilote JDBC Databricks est disponible publiquement sous la licence Apache 2.0.

Cela reflète l’engagement de Databricks en matière de transparence, de collaboration et de puissance du développement communautaire. Les contributions des développeurs, des utilisateurs et de la communauté sont bienvenues. Pour commencer, consultez les instructions de contribution.

Le pilote JDBC Databricks vous permet de connecter des outils tels que DataGrip, DBeaver et SQL Workbench/J à Azure Databricks via Java Database Connectivity (JDBC), une spécification standard pour accéder aux systèmes de gestion de base de données.

Ce pilote a implémenté les API JDBC, et fournit des fonctionnalités de base, notamment OAuth, Cloud Fetch et des fonctionnalités telles que l’ingestion de volume Unity Catalog. Il exécute le mode de requête natif et prend en charge la requête paramétrisée native, et peut s’exécuter à l’aide des API d’exécution d’instructions, qui fournissent la fonctionnalité de rétention des résultats de requête bénéfique, ou Thrift.

Remarque

Sur les systèmes d’exploitation IBM AIX, le format de résultat Apache Arrow n’est pas pris en charge. Étant donné que Cloud Fetch s’appuie sur Flèche, Cloud Fetch n’est pas non plus pris en charge sur AIX. Pour éviter les erreurs lors de l’exécution de SQL, désactivez La flèche en définissant la propriété de connexion JDBC : EnableArrow=0

Cet article fournit des informations sur l’installation et l’utilisation du pilote JDBC Databricks, version 3 et ultérieures. Pour plus d’informations sur le Databricks JDBC Driver (Simba), antérieure à la version 3, consultez Databricks JDBC Driver (Simba).

Spécifications

Pour utiliser le pilote JDBC Databricks, les conditions suivantes doivent être remplies :

  • Nécessite Java Runtime Environment (JRE) 11.0 ou version ultérieure. Les tests CI sont pris en charge sur JRE 11, 17 et 21.

Une branche JDK 8 dédiée est disponible pour les utilisateurs qui nécessitent une compatibilité avec Java 8. Les utilisateurs peuvent générer un fichier JAR à partir de cette branche en fonction des besoins. Cette branche est synchronisée régulièrement avec la branche principale, mais les contributions de la communauté sont bienvenues pour la maintenir à jour. Consultez la branche JDK 8 du pilote JDBC Databricks.

Remarque

En raison d’une modification de JDK 16 qui a provoqué un problème de compatibilité avec la bibliothèque Apache Arrow utilisée par le pilote JDBC, les erreurs d’exécution peuvent se produire lors de l’utilisation du pilote JDBC avec JDK 16 ou version ultérieure. Pour éviter ces erreurs, redémarrez votre application ou pilote à l’aide de l’option de commande JVM suivante :

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

Installer le pilote

Le pilote JDBC Databricks est publié dans le référentiel Maven.

Pour installer le pilote, vous pouvez effectuer l’une des opérations suivantes :

  • Pour les projets Maven, ajoutez la dépendance suivante au fichier du pom.xml projet pour indiquer à Maven de télécharger automatiquement le pilote JDBC avec la version spécifiée :

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

  • Pour les projets Gradle, ajoutez la dépendance suivante au fichier de build du projet pour indiquer à Gradle de télécharger automatiquement le pilote JDBC avec la version spécifiée :

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

Pour afficher la syntaxe de dépendance pour d’autres types de projets et obtenir le numéro de version le plus récent du pilote JDBC Databricks, consultez le référentiel Maven.

Étapes suivantes

Ressources supplémentaires

  • Last updated on