Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein Azure Databricks-secret speichert einen sensiblen Wert, wie ein Passwort, einen API-Schlüssel oder Hashing-Salz, sodass Notebooks, Aufträge und Funktionen ihn verwenden können, ohne dass der Wert im Code erscheint. Du kannst Secrets an zwei Orten verwalten:
- Workspace-Secret-Scopes: Benannte Sammlungen von Geheimnissen in einem Workspace. Die Berechtigungen gelten für den gesamten Scope. Siehe Workspace Secret Scopes.
-
Secrets in Unity Catalog: Securable Objekte (
catalog.schema.secret), die in jedem Arbeitsbereich verfügbar sind, der dem Metastore angegliedert ist. Du kannst Zugriff auf jedes Secret gewähren. Siehe Geheimnisse im Unity Catalog.
Unity Catalog-Geheimnisse können von Azure Databricks verwaltet oder durch Azure Key Vault unterstützt werden. Siehe Azure Key Vault Secrets im Unity Catalog.
Auswahl des Speicherorts des Geheimnisses
Die folgende Tabelle vergleicht, wo jede Option geheime Werte speichert, von welchen Arbeitsbereichen sie verwendet werden können und wie Sie den Zugriff steuern.
| Workspace-Geheimnis-Scope | Azure Databricks-managed secret in Unity Catalog | Azure Key Vault-backed secret in Unity Catalog (Beta) | |
|---|---|---|---|
| Wo der Wert gespeichert ist | Azure Databricks, im Arbeitsbereich oder in Ihrem Azure Key Vault mit einem von Key Vault unterstützten Scope | Azure Databricks, in Unity Catalog | Azure Key Vault (Azure Databricks speichert nur den Namen des Secrets im Unity Catalog) |
| Verschlüsselung mit eigenem Schlüssel | Ja, mit einem vom Kunden verwalteten Schlüssel für verwaltete Dienste | Ja, mit einem kundenseitig verwalteten Schlüssel für den Katalog | |
| Verfügbar in | Ein Arbeitsbereich | Jeder Arbeitsbereich, der mit dem Metastore verbunden ist | Jeder Arbeitsbereich, der mit dem Metastore verbunden ist |
| Zugriffskontrolle | Berechtigungen für den Secret-Scope (keine Zugriffskontrolle auf Geheimnisebene) | Unity-Katalog-Privilegien für das Secret, das Schema oder den Katalog | Unity Catalog-Berechtigungen für das Secret, das Schema oder den Katalog |
| Zum Rotieren | Aktualisieren Sie den Wert in Azure Databricks oder in Key Vault für einen von Key Vault unterstützten Scope | Aktualisieren Sie den Wert in Azure Databricks | In Azure Key Vault rotieren. Keine Änderung in Azure Databricks. |
Wo du Secrets nutzen kannst
Workspace-Secret-Scopes und Unity-Catalog-Secrets werden an verschiedenen Stellen unterstützt. Bevor du eine auswählst, prüfe, ob sie dort funktioniert, wo dein Code ausgeführt wird.
| Surface | Workspace-Geheimnis-Scope | Secret in Unity Catalog |
|---|---|---|
dbutils.secrets in Notebooks und Aufträge |
Yes. Siehe Lies ein Geheimnis. | Ja, in der serverlosen Umgebung Version 4 und höher oder Databricks Runtime 17.3 LTS und höher. Siehe Lies ein Geheimnis. |
| REST API und Databricks CLI | Yes. Von der API zurückgegebene Werte sind nicht geschwärzt. | Yes. Von der API zurückgegebene Werte sind nicht geschwärzt. |
| Remote-Entwicklung, z. B. mit Databricks Connect | Ja, mit dbutils.secrets im Databricks Connect-Client. Siehe Databricks Utilities with Databricks Connect für Python. |
No |
| Unity Catalog Python und Scala UDFs | No | Yes. Anrufer brauchen nur EXECUTE. Siehe Geheimnisse in UDFs verwenden. |
| SQL-Warenhäuser | Ja, mit der geheimen Funktion | Nur über ein Unity-Katalog-Python- oder Scala-UDF, das das Geheimnis deklariert |
| Spark-Konfigurationseigenschaften und Umgebungsvariablen auf Compute | Yes. Weitere Informationen finden Sie unter Verwenden eines Geheimnisses in einer Spark-Konfigurationseigenschaft oder -Umgebungsvariable. | No |
| Umgebungsvariablen des Modellbereitstellungsendpunkts | Yes. Siehe Hinzufügen geheimer Umgebungsvariablen. | No |
| Standard-Paketquellen | Ja, im databricks-package-management Bereich. Siehe Standard-Paket-Repositorien konfigurieren. |
No |
Zusätzliche Ressourcen
| Resource | Description |
|---|---|
| Geheimnisse im Unity-Katalog | Erstellen Sie Unity Catalog-Geheimnisse, gewähren Sie Zugriff und lesen Sie sie in Notebooks, Aufträge und UDFs. |
| Bewährte Methoden für Unity Catalog-Geheimnisse | Organisieren Sie Geheimnisse nach Umgebung, Anwendung oder Team und lassen Sie Workloads Geheimnisse verwenden, ohne sie zu lesen. |