Paramètres de compute pour le Driver JDBC Databricks (Simba)

remarque

Cette page s'applique au Driver JDBC Simba (hérité), versions inférieures à la version 3. Databricks recommande vivement de migrer vers le Driver JDBC Databricks pour la connectivité JDBC. Il inclut des améliorations telles que la prise en charge des vues des indicateurs Unity Catalog, des transactions couvrant plusieurs instructions SQL, des procédures stockées, une récupération plus rapide des grands résultats et la télémétrie client intégrée.

Cette page décrit comment configurer les paramètres des Ressources de compute Databricks pour le Driver JDBC Databricks.

remarque

Le driver JDBC ne prend pas en charge la connexion aux clusters de jobs.

Paramètres requis

Configurez les paramètres suivants pour vous connecter à une ressource de compute Databricks :

Paramètre	Description
Host	La valeur Hostname du serveur de votre ressource de compute Databricks.
Port	443
HTTPPath	La valeur du **chemin HTTP** de votre ressource de compute Databricks.
SSL	1
Schema (facultatif)	Le nom du schéma par default.
Catalog (facultatif)	Le nom du catalogue default.

Paramètre	Description
Host	La valeur Hostname du serveur de votre ressource de compute Databricks.
Port	443
HTTPPath	La valeur du **chemin HTTP** de votre ressource de compute Databricks.
SSL	1
Schema (facultatif)	Le nom du schéma par default.
Catalog (facultatif)	Le nom du catalogue default.

Format de l'URL de connexion

Utilisez le format suivant pour l’URL de connexion JDBC :

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]

Exemple Java

L'exemple suivant montre comment établir une connexion à l'aide de Java :

Java

// ...
String url = "jdbc:databricks://<server-hostname>:443";
Properties p = new java.util.Properties();
p.put("httpPath", "<http-path>");
p.put("<setting1>", "<value1>");
p.put("<setting2>", "<value2>");
p.put("<settingN>", "<valueN>");
// ...
Connection conn = DriverManager.getConnection(url, p);
// ...

Pour un exemple complet, consultez les paramètres d'authentification du Driver JDBC Databricks (Simba).

Remplacez les espaces réservés <setting> et <value> par vos paramètres d’authentification et tout paramètre de capacité du Driver.

Pour obtenir les valeurs de <server-hostname> et <http-path>, consultez les sections suivantes.

Pour obtenir les détails de connexion d'un cluster Databricks :

1. Connectez-vous à votre workspace Databricks.
2. Dans la barre latérale, cliquez sur compute.
3. Dans la liste des clusters disponibles, cliquez sur le nom du cluster cible.
4. Dans l'onglet **Configuration**, développez les **Options avancées**.
5. Cliquez sur la tab JDBC/ODBC .
6. Copiez les détails de connexion dont vous avez besoin, tels que le Hostname du serveur , le Port et le Chemin HTTP .

Pour obtenir les détails de connexion pour un SQL Warehouse Databricks, procédez comme suit :

1. Connectez-vous à votre workspace Databricks.
2. Dans la barre latérale, sous SQL , cliquez sur SQL Warehouses .
3. Dans la liste des warehouses disponibles, cliquez sur le nom du warehouse cible.
4. Dans l'onglet Détails de la connexion , copiez les détails de connexion dont vous avez besoin, tels que Hostname du serveur , Port et Chemin HTTP .

Pour utiliser le Driver avec un cluster Databricks, l’utilisateur appelant ou le Service Principal doit disposer de deux autorisations lors de la connexion au cluster ou de son redémarrage :

• Autorisation CAN ATTACH TO pour se connecter au cluster en cours d'exécution.
• Autorisation CAN RESTART pour Trigger automatiquement le start du cluster si son état est terminé lors de la connexion.

Pour utiliser le Driver avec un SQL Warehouse Databricks SQL, l'utilisateur appelant ou le Service Principal a besoin de l'autorisation CAN USE permission. Le SQL Warehouse Databricks SQL démarre automatiquement s'il a été arrêté.

remarque

Les Databricks SQL warehouses sont recommandés lors de l'utilisation de Microsoft Power BI en mode DirectQuery .