external-locations Befehlsgruppe

Die external-locations Befehlsgruppe in der Databricks CLI enthält Befehle zum Erstellen und Verwalten externer Speicherorte für Unity-Katalog. Weitere Informationen finden Sie unter Was sind Unity Catalog-Volumes?.

Databricks externe-Standorte erstellen

Erstellen Sie einen neuen eintrag für externe Speicherorte im Metastore. Der Aufrufer muss ein Metastore-Administrator sein oder über die CREATE_EXTERNAL_LOCATION Berechtigungen für den Metastore und die zugehörigen Speicheranmeldeinformationen verfügen.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Name des externen Speicherorts.

URL

    Pfad-URL des externen Speicherorts.

CREDENTIAL_NAME

    Der Name der Speicheranmeldedaten, die mit diesem Speicherort genutzt werden.

Options

--comment string

    Vom Benutzer bereitgestellte Freiformtextbeschreibung.

--enable-file-events

    Gibt an, ob Dateiereignisse an diesem externen Speicherort aktiviert werden sollen.

--fallback

    Gibt an, ob der Fallbackmodus für diesen externen Speicherort aktiviert ist.

--json JSON

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

--read-only

    Gibt an, ob der externe Speicherort schreibgeschützt ist.

--skip-validation

    Überspringt die Validierung des mit dem externen Speicherort verknüpften Speicherberechtigungsnachweises.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein externer Speicherort mit einem Kommentar erstellt:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

Im folgenden Beispiel wird ein schreibgeschützter externer Speicherort erstellt:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

databricks external-locations löschen

Löschen Sie den angegebenen externen Speicherort aus dem Metastore. Der Aufrufer muss der Besitzer des externen Standorts sein.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Name des externen Speicherorts.

Options

--force

    Erzwingen der Löschung, auch wenn es abhängige externe Tabellen oder Mounts gibt.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein externer Speicherort mit dem Namen gelöscht my-external-location:

databricks external-locations delete my-external-location

Im folgenden Beispiel wird ein externer Speicherort erzwungen gelöscht, auch wenn Abhängigkeiten vorhanden sind:

databricks external-locations delete my-external-location --force

databricks external-locations get

Rufen Sie einen externen Speicherort aus dem Metastore ab. Der Aufrufer muss entweder ein Metastoreadministrator, der Besitzer des externen Speicherorts oder ein Benutzer sein, der über einige Berechtigungen für den externen Speicherort verfügt.

databricks external-locations get NAME [flags]

Arguments

NAME

    Name des externen Speicherorts.

Options

--include-browse

    Ob externe Speicherorte in die Antwort aufgenommen werden sollen, für die der Prinzipal nur auf selektive Metadaten zugreifen kann.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden Informationen zu einem externen Speicherort namens my-external-location abgerufen:

databricks external-locations get my-external-location

Das folgende Beispiel ruft Informationen einschließlich Browse-Metadaten ab:

databricks external-locations get my-external-location --include-browse

Databricks-Liste externer Standorte

Listet externe Speicherorte aus dem Metastore auf. Der Aufrufer muss ein Metastoreadministrator, der Besitzer des externen Speicherorts oder ein Benutzer sein, der über einige Berechtigungen für den externen Speicherort verfügt. Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente im Array.

databricks external-locations list [flags]

Options

--include-browse

    Ob externe Speicherorte in die Antwort aufgenommen werden sollen, für die der Prinzipal nur auf selektive Metadaten zugreifen kann.

--include-unbound

    Gibt an, ob externe Speicherorte einbezogen werden sollen, die nicht an den Arbeitsbereich gebunden sind.

--max-results int

    Maximale Anzahl externer Speicherorte, die zurückgegeben werden sollen.

--page-token string

    Intransparentes Token für die Paginierung, um auf der Grundlage der vorherigen Abfrage zur nächsten Seite zu gelangen.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden alle externen Speicherorte aufgelistet:

databricks external-locations list

Im folgenden Beispiel werden externe Speicherorte mit maximal 10 Ergebnissen aufgelistet:

databricks external-locations list --max-results 10

databricks externe-standorte aktualisieren

Aktualisieren Sie einen externen Speicherort im Metastore. Der Aufrufer muss der Besitzer des externen Speicherorts oder ein Metastore-Administrator sein. Im zweiten Fall kann der Administrator nur den Namen des externen Speicherorts aktualisieren.

databricks external-locations update NAME [flags]

Arguments

NAME

    Name des externen Speicherorts.

Options

--comment string

    Vom Benutzer bereitgestellte Freiformtextbeschreibung.

--credential-name string

    Der Name der Speicheranmeldedaten, die mit diesem Speicherort genutzt werden.

--enable-file-events

    Gibt an, ob Dateiereignisse an diesem externen Speicherort aktiviert werden sollen.

--fallback

    Gibt an, ob der Fallbackmodus für diesen externen Speicherort aktiviert ist.

--force

    Aktualisierung erzwingen, selbst wenn das Ändern der URL abhängige externe Tabellen oder Einbindungen ungültig macht.

--isolation-mode IsolationMode

    Unterstützte Werte: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--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 den externen Speicherort.

--owner string

    Der Besitzer des externen Speicherorts.

--read-only

    Gibt an, ob der externe Speicherort schreibgeschützt ist.

--skip-validation

    Überspringt die Validierung des mit dem externen Speicherort verknüpften Speicherberechtigungsnachweises.

--url string

    Pfad-URL des externen Speicherorts.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein externer Speicherort umbenannt:

databricks external-locations update my-external-location --new-name my-renamed-location

Im folgenden Beispiel wird der Besitzer eines externen Speicherorts geändert:

databricks external-locations update my-external-location --owner someone@example.com

Globale Kennzeichnungen

--debug

  Ob die Debug-Protokollierung 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 Zeichenfolge

    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 Typ des Protokollformats, text oder json. Der Standardwert ist text.

--log-level Zeichenfolge

    Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.

-o, --output Typ

    Der Typ der Befehlsausgabe, text oder json. Der Standardwert ist text.

-p, --profile Zeichenfolge

    Der Name des Profils in der Datei ~/.databrickscfg, 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 für die Anzeige der Fortschrittsprotokolle: default, append, inplace, oder json

-t, --target Zeichenfolge

    Falls zutreffend, das zu verwendende Bundle-Ziel