Se connecter à SQL Workbench/J

  • Article

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

Notes

Cet article couvre SQL Workbench/J, qui n’est ni fourni ni pris en charge par Databricks. Pour contacter le fournisseur, consultez le forum de support SQL Workbench/J dans Google Groups.

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.

  • 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.

  • 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, effectuez les actions suivantes :

    1. Dans votre espace de travail Azure Databricks, cliquez sur votre nom d’utilisateur Azure Databricks dans la barre supérieure, puis sélectionnez Paramètres dans la liste déroulante.
    2. Cliquez sur Développeur.
    3. À côté de Jetons d’accès, cliquez sur Gérer.
    4. Cliquez sur Générer un nouveau jeton.
    5. (Facultatif) Entrez un commentaire qui vous aide à identifier ce jeton à l’avenir et modifiez sa durée de vie par défaut (90 jours). Pour créer un jeton sans durée de vie (non recommandé), laissez vide la zone Durée de vie (en jours).
    6. Cliquez sur Générer.
    7. Copiez le jeton affiché dans un emplacement sécurisé, puis cliquez sur Terminé.

    Remarque

    Veillez à enregistrer le jeton copié dans un emplacement sécurisé. Ne partagez pas votre jeton copié avec d'autres. Si vous le perdez, vous ne pouvez pas régénérer exactement le même. Vous devez donc répéter cette procédure pour créer un jeton. Si vous perdez le jeton copié ou si vous pensez que le jeton a été compromis, Databricks vous recommande vivement de supprimer immédiatement ce jeton de votre espace de travail en cliquant sur l’icône de la corbeille (Révoquer) à côté du jeton de la page Jetons d’accès.

    Si vous n'êtes pas en mesure de créer ou d'utiliser des jetons dans votre espace de travail, cela peut être dû au fait que votre administrateur d'espace de travail a désactivé les jetons ou ne vous a pas donné l'autorisation de créer ou d'utiliser des jetons. Consultez votre administrateur d'espace de travail ou les rubriques suivantes :

    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