Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
Note
Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.
Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.
Mit users der Befehlsgruppe in der Databricks CLI können Sie Benutzeridentitäten in Ihrem Databricks-Arbeitsbereich verwalten. Benutzeridentitäten, die von Databricks erkannt werden, werden durch E-Mail-Adressen dargestellt. Weitere Informationen finden Sie unter Verwalten von Benutzern.
Databricks empfiehlt die Verwendung der SCIM-Bereitstellung, um Benutzer und Gruppen automatisch von Ihrem Identitätsanbieter mit Ihrem Databricks-Arbeitsbereich zu synchronisieren. SCIM optimiert das Onboarding eines neuen Mitarbeiters oder Teams mithilfe Ihres Identitätsanbieters, um Benutzer und Gruppen im Databricks-Arbeitsbereich zu erstellen und ihnen den richtigen Zugriff zu gewähren. Wenn ein Benutzer Ihre Organisation verlässt oder keinen Zugriff mehr auf den Databricks-Arbeitsbereich benötigt, können Administratoren den Benutzer in Ihrem Identitätsanbieter beenden, und das Konto dieses Benutzers wird auch aus dem Arbeitsbereich "Databricks" entfernt. Dadurch wird ein konsistenter Offboardingprozess sichergestellt und verhindert, dass nicht autorisierte Benutzer auf vertrauliche Daten zugreifen. Siehe hierzu Synchronisieren von Benutzern und Gruppen aus Microsoft Entra ID mithilfe von SCIM.
Databricks-Benutzer erstellen
Erstellen Sie einen neuen Benutzer im Databricks-Arbeitsbereich. Dieser neue Benutzer wird auch dem Databricks-Konto hinzugefügt.
databricks users create [flags]
Options
--active
Wenn dieser Benutzer aktiv ist.
--display-name string
Zeichenfolge, die eine Kombination von Vor- und Familiennamen darstellt.
--external-id string
Die externe ID wird derzeit nicht unterstützt.
--id string
Databricks-Benutzer-ID.
--json JSON
Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.
--user-name string
E-Mail-Adresse des Databricks-Benutzers.
Examples
Im folgenden Beispiel wird ein Benutzer mit einem Anzeigenamen und einer E-Mail erstellt:
databricks users create --display-name "John Doe" --user-name "someone@example.com"
Im folgenden Beispiel wird ein Benutzer mit JSON erstellt:
databricks users create --json '{"display_name": "John Doe", "user_name": "someone@example.com", "active": true}'
Databricks-Benutzer löschen
Löscht einen Benutzer. Durch das Löschen eines Benutzers aus einem Databricks-Arbeitsbereich werden auch Objekte entfernt, die dem Benutzer zugeordnet sind.
databricks users delete ID [flags]
Arguments
ID
Eindeutige ID für einen Benutzer im Databricks-Arbeitsbereich.
Options
Examples
Im folgenden Beispiel wird ein Benutzer anhand der ID gelöscht:
databricks users delete 12345
Databricks-Benutzer erhalten
Abrufen von Informationen für einen bestimmten Benutzer im Databricks-Arbeitsbereich.
databricks users get ID [flags]
Arguments
ID
Eindeutige ID für einen Benutzer im Databricks-Arbeitsbereich.
Options
--attributes string
Durch Trennzeichen getrennte Liste der Attribute, die als Antwort zurückgegeben werden sollen.
--count int
Gewünschte Anzahl von Ergebnissen pro Seite.
--excluded-attributes string
Durch Trennzeichen getrennte Liste der Attribute, die als Antwort ausgeschlossen werden sollen.
--filter string
Abfrage, nach der die Ergebnisse gefiltert werden müssen.
--sort-by string
Attribut zum Sortieren der Ergebnisse.
--sort-order GetSortOrder
Die Reihenfolge zum Sortieren der Ergebnisse. Unterstützte Werte: ascending, descending
--start-index int
Gibt den Index des ersten Ergebnisses an.
Examples
Das folgende Beispiel ruft Details für einen Benutzer ab:
databricks users get 12345
Das folgende Beispiel ruft Benutzerdetails im JSON-Format ab:
databricks users get 12345 --output json
Databricks-Benutzerliste
Listet Details für alle Benutzer auf, die einem Databricks-Arbeitsbereich zugeordnet sind.
databricks users list [flags]
Options
--attributes string
Durch Trennzeichen getrennte Liste der Attribute, die als Antwort zurückgegeben werden sollen.
--count int
Gewünschte Anzahl von Ergebnissen pro Seite.
--excluded-attributes string
Durch Trennzeichen getrennte Liste der Attribute, die als Antwort ausgeschlossen werden sollen.
--filter string
Abfrage, nach der die Ergebnisse gefiltert werden müssen.
--sort-by string
Attribut zum Sortieren der Ergebnisse.
--sort-order ListSortOrder
Die Reihenfolge zum Sortieren der Ergebnisse. Unterstützte Werte: ascending, descending
--start-index int
Gibt den Index des ersten Ergebnisses an.
Examples
Im folgenden Beispiel werden alle Benutzer aufgelistet:
databricks users list
Im folgenden Beispiel werden Benutzer mit Filterung aufgelistet:
databricks users list --filter "userName eq 'someone@example.com'"
Im folgenden Beispiel werden Benutzer mit Paginierung aufgelistet:
databricks users list --count 10 --start-index 0
Patch für Databricks-Nutzer
Aktualisieren Sie eine Benutzerressource teilweise, indem Sie die bereitgestellten Vorgänge auf bestimmte Benutzerattribute anwenden.
databricks users patch ID [flags]
Arguments
ID
Eindeutige ID im Databricks-Arbeitsbereich.
Options
--json JSON
Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.
Examples
Im folgenden Beispiel wird ein Benutzer gepatcht:
databricks users patch 12345 --json '{"display_name": "Jane Doe"}'
Im folgenden Beispiel wird ein Benutzer mithilfe einer JSON-Datei gepatcht:
databricks users patch 12345 --json @update.json
Databricks-Benutzer aktualisieren
Ersetzen Sie die Informationen eines Benutzers durch die in Anforderung bereitgestellten Daten.
databricks users update ID [flags]
Arguments
ID
Databricks-Benutzer-ID.
Options
--active
Wenn dieser Benutzer aktiv ist.
--display-name string
Zeichenfolge, die eine Kombination von Vor- und Familiennamen darstellt.
--external-id string
Die externe ID wird derzeit nicht unterstützt.
--id string
Databricks-Benutzer-ID.
--json JSON
Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.
--user-name string
E-Mail-Adresse des Databricks-Benutzers.
Examples
Im folgenden Beispiel wird ein Benutzer aktualisiert:
databricks users update 12345 --display-name "Jane Doe" --user-name "new-someone@example.com" --active
Im folgenden Beispiel wird ein Benutzer mithilfe von JSON aktualisiert:
databricks users update 12345 --json '{"display_name": "Jane Doe", "user_name": "new-someone@example.com", "active": true}'
Databricks-Benutzer erhalten Berechtigungsstufen
Rufen Sie die Berechtigungsstufen ab, die ein Benutzer für ein Objekt haben kann.
databricks users get-permission-levels [flags]
Options
Examples
Das folgende Beispiel ruft Berechtigungsstufen für Benutzer ab:
databricks users get-permission-levels
Das folgende Beispiel ruft Berechtigungsstufen im JSON-Format ab:
databricks users get-permission-levels --output json
Databricks-Benutzer get-Permissions
Ruft die Berechtigungen aller Kennwörter ab. Kennwörter können Berechtigungen von ihrem Stammobjekt erben.
databricks users get-permissions [flags]
Options
Examples
Im folgenden Beispiel werden Berechtigungen für Benutzer abgerufen:
databricks users get-permissions
Das folgende Beispiel ruft Berechtigungen im JSON-Format ab:
databricks users get-permissions --output json
databricks-Benutzer Berechtigungen festlegen
Legen Sie Kennwortberechtigungen fest.
Legt Berechtigungen für ein Objekt fest, wobei vorhandene Berechtigungen ersetzt werden, sofern vorhanden. Löscht alle direkten Berechtigungen, wenn keine angegeben sind. Objekte können Berechtigungen vom Stammobjekt erben.
databricks users set-permissions [flags]
Options
--json JSON
Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.
Examples
Im folgenden Beispiel werden Berechtigungen mithilfe von JSON festgelegt:
databricks users set-permissions --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'
Im folgenden Beispiel werden Berechtigungen mithilfe einer JSON-Datei festgelegt:
databricks users set-permissions --json @permissions.json
Databricks-Benutzer Berechtigungen aktualisieren
Aktualisieren Sie die Berechtigungen für alle Kennwörter. Kennwörter können Berechtigungen von ihrem Stammobjekt erben.
databricks users update-permissions [flags]
Options
--json JSON
Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.
Examples
Im folgenden Beispiel werden Berechtigungen mithilfe von JSON aktualisiert:
databricks users update-permissions --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_USE"}]}'
Im folgenden Beispiel werden Berechtigungen mithilfe einer JSON-Datei aktualisiert:
databricks users update-permissions --json @permissions.json
Globale Kennzeichnungen
--debug
Gibt an, ob die Debugprotokollierung aktiviert werden soll.
-h oder --help
Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.
--log-file Schnur
Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.
--log-format Format
Der Protokollformattyp text oder json. Der Standardwert ist text.
--log-level Schnur
Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.
-o, --output Typ
Der Befehlsausgabetyp text oder json. Der Standardwert ist text.
-p, --profile Schnur
Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben ist, aber existiert, wird das Profil DEFAULT verwendet.
--progress-format Format
Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json
-t, --target Schnur
Falls zutreffend, das zu verwendende Bündelziel