Freigeben über

Verbinden voreingestellt

  • Artikel

Preset bietet moderne Business Intelligence für Ihre gesamte Organisation. Preset bietet eine leistungsstarke, einfach zu verwendende Datensuche- und Visualisierungsplattform, die von Open Source Apache Superset unterstützt wird.

Sie können Ihre Databricks-SQL-Warehouses (ehemals Databricks-SQL-Endpunkte) und Azure Databricks-Cluster mit Preset integrieren.

Herstellen einer Verbindung mit Preset über Partner Connect

Informationen zum Verbinden Ihres Azure Databricks-Arbeitsbereichs mit Hex mittels Partner Connect finden Sie unter Herstellen einer Verbindung mit BI-Partnern mithilfe von Partner Connect.

Hinweis

Partner Connect unterstützt für Preset nur Databricks SQL-Warehouses. Stellen Sie manuell eine Verbindung mit Preset her, um einen Cluster in Ihrem Azure Databricks-Arbeitsbereich mit Preset zu verbinden.

Manuelles Verbinden mit Preset

In diesem Abschnitt wird ein vorhandenes SQL-Warehouse oder ein vorhandener Cluster in Ihrem Azure Databricks-Arbeitsbereich manuell mit Preset verbunden.

Hinweis

Für SQL-Warehouses können Sie Partner Connect verwenden, um den Verbindungsvorgang zu vereinfachen.

Anforderungen

Bevor Sie die Integration in Preset manuell ausführen, müssen Sie folgendes haben:

  • 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 die folgenden Themen:

    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

Gehen Sie wie folgt vor, um eine manuelle Verbindung mit Preset herzustellen:

  1. Erstellen Sie ein neues Voreingestelltes Konto, oder melden Sie sich bei Ihrem vorhandenen voreingestellten Konto an.

  2. Klicken Sie auf + Arbeitsbereich.

  3. Geben Sie im Dialogfeld Neuer Arbeitsbereich hinzufügeneinen Namen für den Arbeitsbereich ein, wählen Sie den Arbeitsbereichsbereich aus, der Ihnen am nächsten ist, und klicken Sie dann auf Speichern.

  4. Öffnen Sie den Arbeitsbereich, indem Sie auf die Arbeitsbereichskachel klicken.

  5. Klicken Sie auf der Symbolleiste auf Katalog>Datenbanken.

  6. Klicken Sie auf + Datenbank.

  7. Wählen Sie im Dialogfeld Verbinden einer Datenbank in der Liste Unterstützte Datenbanken eine der folgenden Optionen aus:

    • Wählen Sie für ein SQL-Warehouse die Option Databricks SQL-Warehouse aus.
    • Wählen Sie für einen Cluster Databricks Interactive Cluster aus.

  8. Geben Sie für SQLAlchemy-URI den folgenden Wert ein:

    Für ein SQL-Warehouse:

    databricks+pyodbc://token:{access token}@{server hostname}:{port}/{database name}

    Für einen Cluster:

    databricks+pyhive://token:{access token}@{server hostname}:{port}/{database name}

    Ersetzen Sie:

    • {access token}mit dem Wert des persönlichen Zugriffstokens< von Azure Databricks!– oder Azure Active Directory Tokenwert –> aus den Anforderungen.
    • {server hostname} mit dem Server hostnamen-Wert aus den Anforderungen.
    • {port} mit dem Portwert aus den Anforderungen.
    • {database name} durch den Namen der gewünschten Datenbank in Ihrem Azure Databricks-Arbeitsbereich.

    Beispiel für ein SQL-Warehouse:

    databricks+pyodbc://token:dapi...@adb-1234567890123456.7.azuredatabricks.net:443/default

    Zum Beispiel für einen Cluster:

    databricks+pyhive://token:dapi...@adb-1234567890123456.7.azuredatabricks.net:443/default

  9. Klicken Sie auf die Registerkarte Erweitert, und erweitern Sie Sonstige.

  10. Geben Sie für Modulparameter den folgenden Wert ein:

    Für ein SQL-Warehouse:

    {"connect_args": {"http_path": "sql/1.0/warehouses/****", "driver_path": "/opt/simba/spark/lib/64/libsparkodbc_sb64.so"}}

    Für einen Cluster:

    {"connect_args": {"http_path": "sql/protocolv1/o/****"}}

    Ersetzen Sie sql/protocolv1/o/**** mit dem HTTP-Pad-Wert aus den Anforderungen.

    Beispiel für ein SQL-Warehouse:

    {"connect_args": {"http_path": "sql/1.0/warehouses/ab12345cd678e901", "driver_path": "/opt/simba/spark/lib/64/libsparkodbc_sb64.so"}}

    Zum Beispiel für einen Cluster:

    {"connect_args": {"http_path": "sql/protocolv1/o/1234567890123456/1234-567890-buyer123"}}

  11. Klicken Sie auf die Registerkarte Standard, und klicken Sie dann aufVerbindung testen.

    Hinweis

    Informationen zur Problembehandlung bei der Verbindung finden Sie unterExemplarische Vorgehensweise für Datenbankverbindung für Databricks auf der voreingestellten Website.

  12. Nachdem die Verbindung erfolgreich hergestellt werden konnte, klicken Sie auf Verbinden.

Nächste Schritte

Erkunden Sie eine oder mehrere der folgenden Ressourcen auf der Preset-Website: