UiPath Documentation
integration-service
latest
false
Integration Service-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Die Connector-Pakete, die in Integration Service verfügbar sind, werden maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Databricks-Authentifizierung

Verbinden Sie UiPath mit einem Databricks-Arbeitsbereich mithilfe von OAuth 2.0-Client-Anmeldeinformationen mit einem Databricks OAuth-Dienstprinzipal oder einem Microsoft Entra ID-Dienstprinzipal.

Voraussetzungen​

Der Databricks-Connector authentifiziert sich als Dienstprinzipal mithilfe von OAuth 2.0-Client-Anmeldeinformationen (Maschine-zu-Maschine). Zwei Arten von Dienstprinzipal werden unterstützt:

  • Ein Databricks OAuth-Dienstprinzipal, der in der Databricks-Kontokonsole verwaltet wird.
  • Ein Microsoft Entra ID-Dienstprinzipal für Azure Databricks-Arbeitsbereiche.

Zum Erstellen einer Verbindung benötigen Sie die folgenden Werte:

FeldBeschreibung
Arbeitsbereich-HostNur Arbeitsbereich-Hostname ohne https:// oder einen nachgestellten Schrägstrich. Zum Beispiel: adb-1234567890123456.7.azuredatabricks.net.
Client-IDDie Anwendungs-ID (UUID) des Dienstprinzipals.
Geheimer ClientschlüsselEin für diesen Dienstprinzipal generiertes OAuth-Geheimnis. Dies ist kein persönliches Zugriffstoken.
OAuth-Token-URLDer Token-Endpunkt. Die Standardeinstellung ist https://{workspace.host}/oidc/v1/token.
OAuth-GeltungsbereichDer angeforderte Scope. Die Standardeinstellung ist all-apis.

Abrufen Ihrer Anmeldeinformationen​

  1. Extrahieren Sie den Arbeitsbereichshost aus der URL Ihres Databricks-Arbeitsbereichs. In https://adb-1234567890123456.7.azuredatabricks.net/browse/folders/workspace ist beispielsweise der Arbeitsbereichshost adb-1234567890123456.7.azuredatabricks.net.

  2. Wechseln Sie in der Databricks-Kontokonsole zu Benutzerverwaltung > Dienstprinzipal und erstellen Sie einen Dienstprinzipal oder wählen Sie einen vorhandenen aus.

  3. Kopieren Sie die Anwendungs-ID (UUID) des Dienstprinzipals – dies ist die Client-ID.

  4. Wechseln Sie auf dem Dienstprinzipal zu Geheimnisse > Geheimnis generieren und kopieren Sie das generierte OAuth-Geheimnis – dies ist das Client Secret. Das Geheimnis wird nur einmal angezeigt.

    Wichtig:

    Verwenden Sie ein OAuth-Geheimnis, kein persönliches Zugriffstoken. Persönliche Zugriffstoken werden von diesem Connector nicht unterstützt.

  5. Gewähren Sie dem Dienstprinzipal Zugriff auf den Arbeitsbereich und auf jedes Objekt, das Ihre Automatisierung verwendet, z. B. das SQL-Warehouse, Aufträge, Unity-Katalog-Sicherungen, Volumes, Genie-Spaces und Vektorsuchindizes.

Weitere Informationen finden Sie unter OAuth Machine-to-Machine (M2M)-Authentifizierung und Dienstprinzipal verwalten in der Databricks-Dokumentation.

Hinweis:

Mit dem standardmäßigen OAuth-Geltungsbereich all-apis kann das Token jede API erreichen, für die der Dienstprinzipal autorisiert ist. Databricks unterstützt auch OAuth-Geheimnisse mit Scope, die ein Geheimnis auf einen bestimmten Satz von API-Scopes wie sql, jobs oder unity-catalog beschränken. Wenn Sie einen verwenden, muss der Scope dennoch jede Databricks API abdecken, die Ihre Automatisierungsaufrufe aufruft, oder diese Aktivitäten schlagen zur Laufzeit fehl.

Fügen Sie die Databricks-Verbindung hinzu​

  1. Wählen Sie Orchestrator im Produktstartprogramm aus.

  2. Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .

  3. Wählen Sie Verbindung hinzufügen aus.

  4. Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.

  5. Geben Sie den Workspace-Host, die Client-ID und den Geheimen Clientschlüssel ein.

    Wenn verfügbar, wählen Sie das Menü neben einem Feld und dann Anmeldeinformations-Asset verwenden oder Orchestrator-Asset verwenden aus , um auf ein Orchestrator-Asset zu verweisen, anstatt den Wert direkt einzugeben. Weitere Informationen finden Sie unter Verwenden von Anmeldeinformationsassets für Verbindungen.

    Wenn Sie einen Microsoft Entra ID-Dienstprinzipal verwenden, aktualisieren Sie die OAuth Token-URL und den OAuth Scope wie unter Verwenden eines Microsoft Entra ID-Dienstprinzipals beschrieben. Andernfalls lassen Sie beide Felder auf ihren Standardwerten.

  6. Select Connect.

Ihre Databricks-Verbindung wurde nun hinzugefügt und ist für die Verwendung in UiPath Studio oder Studio Web verfügbar.

Verwenden Sie einen Microsoft Entra ID-Dienstprinzipal​

Wenn Sie sich mit einem Microsoft Entra ID-Dienstprinzipal anstelle eines Databricks OAuth-Dienstprinzipals authentifizieren, ändern Sie die OAuth-Token-URL und den OAuth-Scope wie folgt:

  1. Ersetzen Sie die OAuth-Token-URL vollständig durch den Token-Endpunkt der Microsoft Identity Platform:

    https://login.microsoftonline.com/{your-azure-tenant-guid}/oauth2/v2.0/token
    https://login.microsoftonline.com/{your-azure-tenant-guid}/oauth2/v2.0/token
    
    Wichtig:

    Ersetzen Sie die Literal-GUID des Azure-Mandanten durch die URL. Lassen Sie {your-azure-tenant-guid} nicht als Platzhalter stehen.

  2. Legen Sie OAuth Scope auf die Azure Databricks-Ressourcen-ID gefolgt von /.default fest:

    2ff814a6-3304-4ab8-85cb-cd0e6f879c1d/.default
    2ff814a6-3304-4ab8-85cb-cd0e6f879c1d/.default
    
    Hinweis:

    Im Gegensatz zur Mandanten-GUID in der Token-URL ist diese GUID kein Platzhalter. 2ff814a6-3304-4ab8-85cb-cd0e6f879c1d ist der feste Bezeichner für Azure Databricks in allen Azure-Umgebungen, also geben Sie ihn genau wie gezeigt ein.

Weitere Informationen finden Sie unter Manuelles Abrufen von Microsoft Entra ID-Tokens und Authentifizierung mit Microsoft Entra-Dienstprinzipal in der Azure Databricks-Dokumentation.

Hinweis:

Die Verbindung ist nur so fähig wie der Dienstprinzipal, der hinter ihr steht. Eine Verbindung kann erfolgreich erstellt werden und zur Laufzeit dennoch fehlschlagen, wenn der Dienstprinzipal keine Berechtigungen für das Objekt hat, auf das eine Aktivität abzielt.

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben