Se connecter à SQL Workbench/J

Cet article explique comment utiliser SQL Workbench/J avec Azure Databricks.

Spécifications

• SQL Workbench/J.

• Le pilote JDBC Databricks. Téléchargez le pilote JDBC Databricks sur votre machine de développement locale, en extrayant le fichier DatabricksJDBC42.jar du fichier DatabricksJDBC42-<version>.zip téléchargé.

  Remarque

  Cet article a été testé avec macOS, SQL Workbench/J Build 130, Zulu OpenJDK 21.0.1 et le pilote JDBC Databricks 2.6.36.

  Pour l’authentification Azure Databricks, si vous n’utilisez pas l’authentification par jeton d’accès personnel Azure Databricks, vous pouvez ignorer la génération d’un jeton d’accès personnel plus loin dans ces exigences. Pour plus d’informations sur les types d’authentification Azure Databricks disponibles, consultez Paramètres d’authentification pour le pilote JDBC Databricks.

• Un cluster ou un entrepôt SQL dans votre espace de travail Azure Databricks.

  • Informations de référence sur la configuration de calcul.
  • Créer un entrepôt SQL.

• Les détails de connexion pour votre cluster ou votre entrepôt SQL, en particulier les valeurs Nom d’hôte du serveur, Port et Chemin HTTP.

  • Obtenir les détails de connexion pour une ressource de calcul Azure Databricks.

• Un jeton d’accès personnel Azure Databricks ou un jeton Microsoft Entra ID (anciennement Azure Active Directory). Pour créer un jeton d’accès personnel, suivez les étapes décrites dans Les jetons d’accès personnels Azure Databricks pour les utilisateurs de l’espace de travail.

  Remarque

  En guise de bonne pratique de sécurité, quand vous vous authentifiez avec des outils, systèmes, scripts et applications automatisés, Databricks recommande d’utiliser des jetons d’accès personnels appartenant à des principaux de service et non des utilisateurs de l’espace de travail. Pour créer des jetons d’accès pour des principaux de service, consultez la section Gérer les jetons pour un principal de service.

Étapes de connexion à Workbench/J

Pour vous connecter à Workbench/J, procédez comme suit :

1. Lancez SQL Workbench/J.
2. Sélectionnez File > Connect (Fichier > Se connecter).
3. Dans la boîte de dialogue Select Connection Profile (Sélectionner un profil de connexion), cliquez sur Manage Drivers (Gérer les pilotes).
   1. Dans le champ Nom, saisissez Databricks.
   2. Dans le champ Library (Bibliothèque), cliquez sur l’icône Select the JAR file(s) (Sélectionner le ou les fichiers JAR). Accédez au répertoire dans lequel vous avez extrait le fichier DatabricksJDBC42.jar à partir du fichier DatabricksJDBC42-<version>.zip téléchargé, puis sélectionnez le fichier JAR. Cliquez ensuite sur Choose (Choisir).
   3. Vérifiez que le champ Classname est renseigné avec com.databricks.client.jdbc.Driver.
   4. Cliquez sur OK.
4. Cliquez sur l’icône de création d’un profil de connexion.
   1. Tapez un nom pour le profil.
   2. Dans le champ Driver, sélectionnez Databricks (com.databricks.client.jdbc.Driver).
   3. Dans le champ URL, entrez l’URL JDBC de votre ressource Azure Databricks. Pour connaître la syntaxe du champ URL pour les URL JDBC, consultez Paramètres d’authentification pour le pilote JDBC Databricks.
   4. Cliquez sur Tester.
   5. Cliquez deux fois sur OK .

Ressources supplémentaires

• SQL Workbench/J
• Support