Freigeben über


storage-credentials Befehlsgruppe

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.

Die storage-credentials Befehlsgruppe in der Databricks CLI enthält Befehle zum Verwalten von Speicheranmeldeinformationen im Unity-Katalog. Speicheranmeldedaten stellen einen Authentifizierungs- und Autorisierungsmechanismus für den Zugriff auf Daten dar, die in Ihrem Cloud-Tenant gespeichert sind. Jede Speicheranmeldeinformation unterliegt den Zugriffssteuerungsrichtlinien des Unity-Katalogs, die festlegen, welche Benutzer und Gruppen auf die Anmeldeinformationen zugreifen können. Wenn ein Benutzer keinen Zugriff auf Speicheranmeldeinformationen im Unity-Katalog hat, schlägt die Anforderung fehl, und Unity Catalog versucht nicht, sich für Ihren Cloudmandanten im Namen des Benutzers zu authentifizieren. Siehe Verwalten von Speicheranmeldeinformationen.

Databricks-Speicherberechtigungen erstellen

Erstellen Sie eine neue Speicheranmeldeinformation.

Der Aufrufer muss ein Metastore-Administrator sein oder über die CREATE_STORAGE_CREDENTIAL Berechtigungen für den Metastore verfügen.

databricks storage-credentials create NAME [flags]

Arguments

NAME

    Der Anmeldeinformationsname. Der Name muss für Speicher- und Dienstanmeldeinformationen im Metastore eindeutig sein.

Options

--comment string

    Kommentar, der den Zugangsdaten zugeordnet ist.

--json JSON

    Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.

--read-only

    Gibt an, ob die Anmeldeinformationen nur für Lesevorgänge verwendet werden können.

--skip-validation

    Wenn dieses Argument als "true" angegeben wird, wird die Validierung der erstellten Anmeldeinformation übersprungen.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden neue Speicheranmeldeinformationen erstellt:

databricks storage-credentials create my-storage-credential

Das folgende Beispiel erstellt eine Speicheranmeldeinformation mit einem Kommentar:

databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"

Im folgenden Beispiel wird ein schreibgeschützter Speicherberechtigungsnachweis erstellt:

databricks storage-credentials create my-storage-credential --read-only

Databricks Speicherzugangsberechtigungen löschen

Speicheranmeldeinformation aus dem Metastore löschen. Der Aufrufer muss Eigentümer der Speicheranmeldeinformation sein.

databricks storage-credentials delete NAME [flags]

Arguments

NAME

    Name der Speicheranmeldeinformationen.

Options

--force

    Aktualisierung erzwingen, auch wenn es abhängige externe Speicherorte oder Tabellen (wenn der Zweck STORAGE lautet) oder abhängige Dienste (wenn der Zweck SERVICE lautet) gibt.

Globale Kennzeichnungen

Examples

Das folgende Beispiel löscht eine Speicheranmeldeinformation:

databricks storage-credentials delete my-storage-credential

Das folgende Beispiel erzwingt das Löschen von Speicheranmeldedaten.

databricks storage-credentials delete my-storage-credential --force

databricks storage-credentials get (ruft die Speicheranmeldeinformationen ab)

Ruft eine Speicheranmeldeinformation aus dem Metastore ab. Der Aufrufer muss ein Metastore-Administrator, der Besitzer der Speicheranmeldeinformationen sein oder über eine Berechtigung für die Speicheranmeldeinformationen verfügen.

databricks storage-credentials get NAME [flags]

Arguments

NAME

    Name der Speicheranmeldeinformationen.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden Informationen zu Speicheranmeldedaten angezeigt.

databricks storage-credentials get my-storage-credential

Databricks Speicheranmeldedaten anzeigen

Auflisten der Speicheranmeldeinformationen. Die Liste ist nur auf die Speicheranmeldeinformationen beschränkt, auf die der Aufrufer über die Berechtigung zum Zugriff verfügt. Wenn der Aufrufer ein Metastore-Administrator ist, ist der Abruf von Anmeldeinformationen uneingeschränkt. Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente im Array.

databricks storage-credentials list [flags]

Options

--max-results int

    Maximale Anzahl der zurückzugebenden Speicheranmeldeinformationen.

--page-token string

    Nicht transparentes Paginierungstoken, um basierend auf der vorherigen Abfrage zur nächsten Seite zu gelangen.

Globale Kennzeichnungen

Examples

Das folgende Beispiel listet alle Speicheranmeldeinformationen auf:

databricks storage-credentials list

Databricks-Aktualisierung von Speicheranmeldeinformationen

Aktualisiert eine Speicheranmeldeinformation im Metastore.

Der Aufrufer muss der Besitzer der Speicheranmeldeinformationen oder ein Metastore-Administrator sein. Wenn der Aufrufer ein Metastore-Administrator ist, kann nur das owner Feld geändert werden.

databricks storage-credentials update NAME [flags]

Arguments

NAME

    Name der Speicheranmeldeinformationen.

Options

--comment string

    Kommentar, der den Zugangsdaten zugeordnet ist.

--force

    Erzwingt die Aktualisierung auch, wenn abhängige externe Speicherorte oder Tabellen vorhanden sind.

--isolation-mode IsolationMode

    Gibt an, ob das aktuelle sicherbare Objekt in allen Arbeitsbereichen oder in einer bestimmten Gruppe von Arbeitsbereichen zugänglich ist. Unterstützte Werte: [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]

--json JSON

    Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.

--new-name string

    Neuer Name für die Speicheranmeldeinformation.

--owner string

    Benutzername des aktuellen Besitzers von Anmeldedaten.

--read-only

    Gibt an, ob die Anmeldeinformationen nur für Lesevorgänge verwendet werden können.

--skip-validation

    Wenn Sie dieses Argument mit dem Wert 'true' angeben, wird die Überprüfung der aktualisierten Anmeldeinformationen übersprungen.

Globale Kennzeichnungen

Examples

Das folgende Beispiel aktualisiert den Kommentar einer Speicheranmeldeinformation:

databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"

Im folgenden Beispiel wird der Besitzer einer Speicheranmeldeinformation geändert:

databricks storage-credentials update my-storage-credential --owner someone@example.com

Im folgenden Beispiel wird eine Anmeldeinformation für den Speicher umbenannt:

databricks storage-credentials update my-storage-credential --new-name updated-credential

Speicher-Anmeldeinformationen von Databricks validieren

Validiert eine Speicheranmeldeinformation. Mindestens einer von external_location_name und url muss bereitgestellt werden. Wenn nur eine davon bereitgestellt wird, wird sie zur Überprüfung verwendet. Und wenn beide bereitgestellt werden, wird url für die Validierung verwendet, und external_location_name bei der Überprüfung überlappender URLs ignoriert.

Entweder storage_credential_name oder die cloudspezifischen Anmeldeinformationen müssen bereitgestellt werden.

Der Aufrufer muss ein Metastoreadministrator oder der Besitzer der Speicheranmeldeinformationen sein oder über die CREATE_EXTERNAL_LOCATION Berechtigungen für den Metastore und die Speicheranmeldeinformationen verfügen.

databricks storage-credentials validate [flags]

Options

--external-location-name string

    Der Name eines vorhandenen externen Speicherorts, der überprüft werden soll.

--json JSON

    Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.

--read-only

    Gibt an, ob die Speicheranmeldeinformationen nur für Lesevorgänge verwendet werden können.

--storage-credential-name string

    Required.

--url string

    Die URL des externen Standorts, die überprüft werden soll.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine Speicheranmeldeinformation für einen externen Speicherort validiert:

databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location

Im folgenden Beispiel wird eine Speicheranmeldeinformation anhand einer URL überprüft:

databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path

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