recipients Befehlsgruppe

Note

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. Siehe Was ist OpenSharing?.

Databricks-Empfänger erstellen

Erstellen Sie einen neuen Empfänger mit dem OpenSharing-Authentifizierungstyp 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 OpenSharing-Authentifizierungstyp. 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

Drehen Sie das OpenSharing-Authentifizierungstoken des angegebenen Empfängers mit den 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