volumes 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 volumes Befehlsgruppe in der Databricks CLI enthält Befehle zum Verwalten von Volumes im Unity-Katalog. Volumes bieten Features für den Zugriff auf Dateien, das Speichern, Verwalten, Organisieren und Verarbeiten von Dateien. Weitere Informationen finden Sie unter Was sind Unity Catalog-Volumes?.

Databricks-Volumes erstellen

Erstellen Sie ein neues Volume.

Der Benutzer kann entweder ein externes Volume oder ein verwaltetes Volume erstellen. Ein externes Volume wird am angegebenen externen Speicherort erstellt, während sich ein verwaltetes Volume am Standardspeicherort befindet, der durch das übergeordnete Schema oder den übergeordneten Katalog oder den Metaspeicher angegeben wird.

Damit die Volumenerstellung erfolgreich durchgeführt wird, muss der Benutzer die folgenden Voraussetzungen erfüllen:

• Der Aufrufer muss ein Metastore-Administrator sein oder der Besitzer des übergeordneten Katalogs und Schemas sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.
• Der Aufrufer muss über CREATE VOLUME Privilegien für das übergeordnete Schema verfügen.

Für ein externes Volume müssen außerdem die folgenden Anforderungen erfüllt sein:

• Der Anrufer muss das Privileg CREATE EXTERNAL VOLUME für den externen Speicherort haben.
• Es gibt keine anderen Tabellen oder Volumes, die am angegebenen Speicherort vorhanden sind. - Der angegebene Speicherort befindet sich nicht unter dem Speicherort anderer Tabellen, Volumes, Kataloge oder Schemas.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    Der Name des Katalogs, in dem sich das Schema und das Volume befinden

SCHEMA_NAME

    Der Name des Schemas, in dem sich das Volume befindet

NAME

    Der Name des Volumens

VOLUME_TYPE

    Der Typ des Volumes. Ein externes Volume befindet sich am angegebenen externen Speicherort. Ein verwaltetes Volume befindet sich am Standardort, der durch das übergeordnete Schema, den Katalog oder den Metastore festgelegt wird. Siehe verwaltete und externe Volumes. Unterstützte Werte: EXTERNAL, MANAGED

Options

--comment string

    Ein an das Volume angefügter Kommentar.

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

--storage-location string

    Der Speicherort in der Cloud.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein verwaltetes Volume erstellt:

databricks volumes create my_catalog my_schema my_volume MANAGED

Das folgende Beispiel erstellt ein externes Volume mit einem Kommentar:

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

Databricks-Volumes löschen

Ein Volumen aus dem angegebenen übergeordneten Katalog und Schema löschen.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des Volumes sein. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

databricks volumes delete NAME [flags]

Arguments

NAME

    Der dreistufige (vollqualifizierte) Name des Volumens

Options

Globale Kennzeichnungen

Examples

Das folgende Beispiel löscht ein Volume:

databricks volumes delete my_catalog.my_schema.my_volume

Databricks-Volumesliste

Volumes für den aktuellen Metastore unter dem übergeordneten Katalog und Schema auflisten.

Die zurückgegebenen Volumes werden basierend auf den Berechtigungen des aufrufenden Benutzers gefiltert. Beispielsweise kann der Metastore-Administrator alle Volumes auflisten. Ein normaler Benutzer muss der Besitzer sein oder über die READ VOLUME Berechtigung für das Volume verfügen, um die Volumes in der Antwort zu erhalten. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente im Array.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Der Bezeichner des Katalogs

SCHEMA_NAME

    Der Bezeichner des Schemas

Options

--include-browse

    Ob Volumes in die Antwort aufgenommen werden sollen, für die der Prinzipal nur selektiv auf Metadaten zugreifen kann.

--max-results int

    Maximale Anzahl der zurückzugebenden Volumen (Seitenlänge).

--page-token string

    Intransparentes Token, das von einer früheren Anfrage zurückgegeben wurde.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden alle Volumes in einem Katalog und Schema aufgelistet:

databricks volumes list my_catalog my_schema

Databricks-Volumes lesen

Rufen Sie ein Volume aus dem Metaspeicher für einen bestimmten Katalog und ein bestimmtes Schema ab.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des Volumes sein (oder über das READ VOLUME Recht verfügen). Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

databricks volumes read NAME [flags]

Arguments

NAME

    Der dreistufige (vollqualifizierte) Name des Volumens

Options

--include-browse

    Ob Volumes in die Antwort aufgenommen werden sollen, für die der Prinzipal nur selektiv auf Metadaten zugreifen kann.

Globale Kennzeichnungen

Examples

Das folgende Beispiel ruft Informationen über ein Volume ab:

databricks volumes read my_catalog.my_schema.my_volume

Das folgende Beispiel ruft Volumeninformationen ab, einschließlich Browsen-Metadaten:

databricks volumes read my_catalog.my_schema.my_volume --include-browse

Databricks-Volumes aktualisieren

Aktualisieren Sie das angegebene Volume unter dem angegebenen übergeordneten Katalog und Schema.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des Volumes sein. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

Derzeit kann nur der Name, der Besitzer oder der Kommentar des Volumes aktualisiert werden.

databricks volumes update NAME [flags]

Arguments

NAME

    Der dreistufige (vollqualifizierte) Name des Volumens

Options

--comment string

    Ein an das Volume angefügter Kommentar.

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

--new-name string

    Neuer Name für das Volumen.

--owner string

    Die Kennung des Benutzers, dem das Volume gehört.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird der Kommentar eines Volumes aktualisiert:

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

Im folgenden Beispiel wird der Besitzer eines Volumes geändert:

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

Im folgenden Beispiel wird ein Volume umbenannt:

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

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 wird, wird, falls vorhanden, das Profil mit dem Namen 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