Freigeben über


providers 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 providers Befehlsgruppe innerhalb der Databricks CLI enthält Befehle zum Verwalten von Delta Sharing-Anbietern. Ein Datenanbieter stellt die Organisation in der realen Welt dar, die die Daten gemeinsam verwendet. Weitere Informationen finden Sie unter Was ist Delta Sharing?.

Databricks-Anbieter erstellen

Erstellen Sie einen neuen Authentifizierungsanbieter minimal basierend auf einem Namen und Authentifizierungstyp. Der Aufrufer muss ein Administrator im Metastore sein.

databricks providers create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    Der Name des Anbieters.

AUTHENTICATION_TYPE

    Der Authentifizierungstyp für die Delta-Freigabe. Unterstützte Werte: DATABRICKS, OAUTH_CLIENT_CREDENTIALS, OIDC_FEDERATION, TOKEN

Options

--comment string

    Beschreibung des Anbieters.

--json JSON

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

--recipient-profile-str string

    Dieses Feld ist erforderlich, wenn authentication_typeTOKEN, OAUTH_CLIENT_CREDENTIALS oder nicht angegeben ist.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein Anbieter mit TOKEN-Authentifizierung erstellt:

databricks providers create my_provider TOKEN --comment "My data provider" --recipient-profile-str "my_profile"

Im folgenden Beispiel wird ein Anbieter mit DATABRICKS-Authentifizierung erstellt:

databricks providers create my_provider DATABRICKS --comment "Internal provider"

Databricks-Anbieter löschen

Löschen Sie einen Authentifizierungsanbieter, wenn der Aufrufer ein Metastore-Administrator ist oder der Besitzer des Anbieters ist.

databricks providers delete NAME [flags]

Arguments

NAME

    Name des Anbieters.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein Anbieter gelöscht:

databricks providers delete my_provider

databricks-Anbieter erhalten

Ruft einen bestimmten Anbieter für die Authentifizierung ab. Der Aufrufer muss den Namen des Anbieters angeben und muss entweder ein Metastore-Administrator oder der Besitzer des Anbieters sein.

databricks providers get NAME [flags]

Arguments

NAME

    Name des Anbieters.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden Details eines Anbieters angezeigt:

databricks providers get my_provider

Liste der Databricks-Anbieter

Auflisten der verfügbaren Authentifizierungsanbieter. Der Aufrufer muss entweder ein Metastore-Administrator oder der Besitzer der Anbieter sein. Anbieter, die nicht im Besitz des Anrufers sind, sind nicht in der Antwort enthalten. Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente im Array.

databricks providers list [flags]

Options

--data-provider-global-metastore-id string

    Wenn nicht angegeben, werden alle Anbieter zurückgegeben.

--max-results int

    Maximale Anzahl von Anbietern, 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 Anbieter aufgelistet:

databricks providers list

Im folgenden Beispiel werden Anbieter mit Paginierung aufgelistet:

databricks providers list --max-results 10

Im folgenden Beispiel werden Anbieter für einen bestimmten Metaspeicher aufgelistet:

databricks providers list --data-provider-global-metastore-id "my-metastore-id"

databricks-Anbieter Befehl: list-provider-share-assets

Liste der Assets, die mit der Freigabe eines bestimmten Anbieters verbunden sind. Der Aufrufer ist der Empfänger der Freigabe.

databricks providers list-provider-share-assets PROVIDER_NAME SHARE_NAME [flags]

Arguments

PROVIDER_NAME

    Der Name des Anbieters, dem die Freigabe gehört.

SHARE_NAME

    Der Name der Freigabe.

Options

--function-max-results int

    Maximale Anzahl von Funktionen, die zurückgegeben werden sollen.

--notebook-max-results int

    Maximale Anzahl von Notizbüchern, die zurückgegeben werden sollen.

--table-max-results int

    Maximale Anzahl der zurückzugebenden Tabellen.

--volume-max-results int

    Maximale Anzahl von Datenträgern, die zurückgegeben werden sollen.

Globale Kennzeichnungen

Examples

Das folgende Beispiel listet alle Assets in der Freigabe eines Anbieters auf:

databricks providers list-provider-share-assets my_provider my_share

Im folgenden Beispiel werden Ressourcen mit Grenzwerten für jeden Typ aufgelistet:

databricks providers list-provider-share-assets my_provider my_share --table-max-results 5 --function-max-results 3

Databricks-Anbieter Listenfreigaben

Auflisten der Freigaben des angegebenen Anbieters innerhalb des Metastores wo:

  • Der Aufrufer ist ein Metastore-Administrator.
  • oder der Anrufer ist der Besitzer.
databricks providers list-shares NAME [flags]

Arguments

NAME

    Name des Anbieters, bei dem Aktien aufgeführt werden sollen.

Options

--max-results int

    Maximale Anzahl von Aktien, 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

Das folgende Beispiel listet alle Freigaben für einen Anbieter auf:

databricks providers list-shares my_provider

Im folgenden Beispiel sind Aktien mit Seitennummerierung gelistet:

databricks providers list-shares my_provider --max-results 10

Update von Databricks-Anbietern

Aktualisieren Sie die Informationen für einen Authentifizierungsanbieter, wenn der Aufrufer ein Metastore-Administrator ist oder der Besitzer des Anbieters ist. Wenn das Update den Anbieternamen ändert, muss der Aufrufer sowohl ein Metastore-Administrator als auch der Besitzer des Anbieters sein.

databricks providers update NAME [flags]

Arguments

NAME

    Name des Anbieters.

Options

--comment string

    Beschreibung des Anbieters.

--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 Anbieter.

--owner string

    Benutzername des Anbieterbesitzers.

--recipient-profile-str string

    Dieses Feld ist erforderlich, wenn authentication_typeTOKEN, OAUTH_CLIENT_CREDENTIALS oder nicht angegeben ist.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird der Kommentar eines Anbieters aktualisiert:

databricks providers update my_provider --comment "Updated provider description"

Im folgenden Beispiel wird der Name und der Besitzer eines Anbieters aktualisiert:

databricks providers update my_provider --new-name "my_new_provider" --owner "new_owner@example.com"

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