Teilen über


recipients 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 recipients Befehlsgruppe innerhalb der Databricks CLI enthält Befehle zum Verwalten von Freigabeempfängern im Unity Catalog. Weitere Informationen finden Sie unter Was ist Delta Sharing?.

Databricks-Empfänger erstellen

Erstellt einen neuen Empfänger mit dem Authentifizierungstyp Deltafreigabe im Metastore. Der Aufrufer muss ein Metastore-Administrator sein oder über die CREATE_RECIPIENT Berechtigungen für den Metastore verfügen.

databricks recipients create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    Name des Empfängers.

AUTHENTICATION_TYPE

    Der Authentifizierungstyp Deltafreigabe. Unterstützte Werte: DATABRICKS, OAUTH_CLIENT_CREDENTIALS, OIDC_FEDERATION, TOKEN

Options

--comment string

    Beschreibung des Empfängers.

--data-recipient-global-metastore-id string

    Die globale Unity Catalog-Metastore-ID, die vom Datenempfänger bereitgestellt wird.

--expiration-time int

    Ablaufzeitstempel des Tokens, in Epochen-Millisekunden.

--json JSON

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

--owner string

    Benutzername des Empfängerbesitzers.

--sharing-code string

    Der einmalige Freigabecode, bereitgestellt vom Datenempfänger.

Globale Kennzeichnungen

Databricks-Empfänger löschen

Löschen Sie den angegebenen Empfänger aus dem Metastore. Der Anrufer muss der Besitzer des Empfängers sein.

databricks recipients delete NAME [flags]

Arguments

NAME

    Name des Empfängers.

Options

Globale Kennzeichnungen

databricks-Empfänger erhalten

Ruft einen Freigabeempfänger aus dem Metastore ab, wenn:

  • der Aufrufer Eigentümer des Freigabeempfängers ist,
  • oder ist ein Metastore-Administrator.
databricks recipients get NAME [flags]

Arguments

NAME

    Name des Empfängers.

Options

Globale Kennzeichnungen

Databricks-Empfängerliste

Listet alle Freigabeempfänger im aktuellen Metastore auf, wenn Folgendes gilt:

  • Der Aufrufer ist ein Metastore-Administrator.
  • oder der Anrufer ist der Besitzer.

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

databricks recipients list [flags]

Arguments

None

Options

--data-recipient-global-metastore-id string

    Wenn nicht angegeben, werden alle Empfänger zurückgegeben.

--max-results int

    Maximale Anzahl von Empfängern, die zurückgegeben werden sollen.

--page-token string

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

Globale Kennzeichnungen

databricks Empfänger rotate-token

Rotiert das Authentifizierungstoken für die Deltafreigabe des angegebenen Empfängers unter Verwendung der bereitgestellten Tokeninformationen. Der Anrufer muss der Besitzer des Empfängers sein.

databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]

Arguments

NAME

    Der Name des Empfängers.

EXISTING_TOKEN_EXPIRE_IN_SECONDS

    Die Ablaufzeit des Bearertokens im ISO 8601-Format. Dadurch wird die expiration_time des vorhandenen Tokens nur verkürzt. Sie kann nicht verlängert werden. Verwenden Sie 0, um das vorhandene Token sofort ablaufen zu lassen. Eine negative Zahl führt zu einem Fehler.

Options

--json JSON

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

Globale Kennzeichnungen

Databricks-Empfänger aktualisieren

Aktualisieren eines vorhandenen Empfängers im Metastore. Der Aufrufer muss ein Metastore-Administrator oder der Besitzer des Empfängers sein. Wenn der Empfängername aktualisiert wird, muss der Benutzer sowohl ein Metastore-Administrator als auch der Besitzer des Empfängers sein.

databricks recipients update NAME [flags]

Arguments

NAME

    Name des Empfängers.

Options

--comment string

    Beschreibung des Empfängers.

--expiration-time int

    Ablaufzeitstempel des Tokens, in Epochen-Millisekunden.

--json JSON

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

--new-name string

    Neuer Name für den Empfänger.

--owner string

    Benutzername des Empfängerbesitzers.

Globale Kennzeichnungen

Databricks-Berechtigungen für Empfänger zum Teilen

Ruft die Freigabeberechtigungen für den angegebenen Empfänger ab. Der Aufrufer muss ein Metastore-Administrator oder der Besitzer des Empfängers sein.

databricks recipients share-permissions NAME [flags]

Arguments

NAME

    Der Name des Empfängers.

Options

--max-results int

    Maximale Anzahl der zurückzugebenden Berechtigungen.

--page-token string

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

Globale Kennzeichnungen

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