Freigeben über

Verbinden Sie sich mit SQL Workbench/J

  • Artikel

In diesem Artikel wird die Verwendung von SQL Workbench/J mit Azure Databricks beschrieben.

Hinweis

Dieser Artikel behandelt SQL Workbench/J, das von Databricks weder bereitgestellt noch unterstützt wird. Informationen zum Kontaktieren des Anbieters finden Sie unter Verwenden des SQL Workbench/J-Supportforums in Google Groups.

Anforderungen

  • SQL Workbench/J.

  • Der Databricks-JDBC-Treiber. Laden Sie den Databricks JDBC-Treiber auf Ihren lokalen Entwicklungscomputer herunter, und extrahieren Sie die DatabricksJDBC42.jar-Datei aus der heruntergeladenen DatabricksJDBC42-<version>.zip-Datei.

    Hinweis

    Dieser Artikel wurde mit macOS, SQL Workbench/J Build 130, Zulu OpenJDK 21.0.1 und Databricks WORKBENCH 2.6.36 getestet.

    Wenn Sie für die Azure Databricks-Authentifizierung keine persönliche Zugangstoken-Authentifizierung verwenden, können Sie die Erstellung eines persönlichen Zugangstokens später in diesen Anforderungen überspringen. Weitere Informationen zu verfügbaren Azure Databricks-Authentifizierungstypen finden Sie unter Authentifizierungseinstellungen für den Databricks JDBC-Treiber.

  • Ein Cluster oder SQL-Warehouse in Ihrem Azure Databricks-Arbeitsbereich

  • Die Verbindungsdetails für Ihren Cluster oder Ihr SQL-Warehouse, insbesondere die Werte Serverhostname, Hafen und HTTP-Pfad

  • Ein persönliches Azure Databricks-Zugriffstoken oder ein Microsoft Entra ID-Token (früher Azure Active Directory). Gehen Sie wie folgt vor, um ein persönliches Zugriffstoken zu erstellen:

    1. Wählen Sie in Ihrem Azure Databricks-Arbeitsbereich in der oberen Leiste Ihren Azure Databricks-Benutzernamen und dann im Dropdownmenü die Option Einstellungen aus.
    2. Klicken Sie auf Entwickler.
    3. Klicken Sie neben Zugriffstoken auf Verwalten.
    4. Klicken Sie auf Neues Token generieren.
    5. (Optional) Geben Sie einen Kommentar ein, durch den Sie dieses Token in Zukunft identifizieren können, und ändern Sie die standardmäßige Lebensdauer des Tokens von 90 Tagen. Wenn Sie ein Token ohne Gültigkeitsdauer erstellen möchten (nicht empfohlen), lassen Sie das Feld Lebensdauer (Tage) leer.
    6. Klicken Sie auf Generate (Generieren) .
    7. Kopieren Sie das angezeigte Token an einen sicheren Speicherort, und klicken Sie auf Fertig.

    Hinweis

    Achten Sie darauf, den kopierten Token an einem sicheren Ort zu speichern. Geben Sie das kopierte Token nicht an andere Personen weiter. Wenn Sie das kopierte Token verlieren, können Sie das gleiche Token nicht erneut generieren. Stattdessen müssen Sie erneut das Verfahren zum Erstellen eines neuen Tokens durchlaufen. Wenn Sie das kopierte Token verlieren oder glauben, dass das Token kompromittiert wurde, empfiehlt Databricks dringend, dass Sie das Token sofort aus Ihrem Arbeitsbereich löschen. Klicken Sie hierzu auf der Seite Zugriffstoken auf das Papierkorbsymbol (Widerrufen) neben dem Token.

    Wenn Sie in Ihrem Arbeitsbereich keine Token erstellen oder verwenden können, liegt dies möglicherweise daran, dass Ihr Arbeitsbereichsadministrator Token deaktiviert hat oder Ihnen keine Berechtigung zum Erstellen oder Verwenden von Token erteilt hat. Wenden Sie sich an Ihren Arbeitsbereichsadministrator oder lesen Sie:

    Hinweis

    Als bewährte Methode für die Sicherheit empfiehlt Databricks, dass Sie bei der Authentifizierung mit automatisierten Tools, Systemen, Skripten und Anwendungen persönliche Zugriffstoken verwenden, die zu Dienstprinzipalen und nicht zu Benutzern des Arbeitsbereichs gehören. Informationen zum Erstellen von Token für Dienstprinzipale finden Sie unter Verwalten von Token für einen Dienstprinzipal.

Schritte zum Herstellen einer Verbindung mit Workbench/J

Gehen Sie wie folgt vor, um eine Verbindung zu Workbench/J herzustellen:

  1. Starten Sie „SQL Workbench/J“.
  2. Wählen Sie die Datei > Verbinden aus.
  3. Klicken Sie im Dialogfeld Verbindungsprofil auswählen auf Treiber verwalten.
    1. Geben Sie im Feld NameDatabricks ein.
    2. Klicken Sie im Feld Bibliothek auf das Symbol JAR-Datei(en) auswählen. Navigieren Sie zu dem Verzeichnis, in dem Sie die DatabricksJDBC42.jar-Datei aus der heruntergeladenen DatabricksJDBC42-<version>.zip-Datei extrahiert haben, und wählen Sie die JAR-Datei aus. Klicken Sie dann auf Auswählen.
    3. Stellen Sie sicher, dass das Feld Klassenname mit com.databricks.client.jdbc.Driver gefüllt ist.
    4. Klicken Sie auf OK.
  4. Klicken Sie auf das Symbol Neues Verbindungsprofil erstellen.
    1. Geben Sie einen Namen für das Profil ein.
    2. Wählen Sie im Treiberfeld Databricks (com.databricks.client.aspx.Driver) aus.
    3. Geben Sie in das Feld URL die URL FÜR Ihre Azure Databricks-Ressource ein. Informationen zur URL-Feldsyntax für JDBC-URLs finden Sie unter Authentifizierungseinstellungen für den Databricks JDBC-Treiber.
    4. Klicken Sie auf Test.
    5. Klicken Sie zweimal auf OK .

Zusätzliche Ressourcen