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

Mit der Befehlsgruppe shares innerhalb der Databricks CLI können Sie Freigaben im Unity Catalog verwalten.

Eine Freigabe ist ein mit shares create instanziierter Container. Nach der Erstellung können Sie eine Sammlung vorhandener Datenressourcen, die im Metastore shares updatedefiniert sind, iterativ registrieren. Sie können Datenressourcen unter ihrem ursprünglichen Namen registrieren (qualifiziert durch das ursprüngliche Schema) oder alternative verfügbar gemachte Namen angeben.

Databricks-Aktien erstellen

Erstellt eine neue Freigabe für Datenobjekte. Datenobjekte können nach der Erstellung mit updatehinzugefügt werden. Der Aufrufer muss ein Metastore-Administrator sein oder über die CREATE_SHARE Berechtigungen für den Metastore verfügen.

databricks shares create NAME [flags]

Arguments

NAME

    Name der Freigabe.

Options

--comment string

    Vom Benutzer bereitgestellte Freiformtextbeschreibung.

--json JSON

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

--storage-root string

    Basis-URL für Speicher von Notizbuchdateien im Freigabebereich.

Globale Kennzeichnungen

Examples

Die folgenden Beispiele erstellen eine Freigabe namens my-analytics-share und einen Kommentar:

databricks shares create my-analytics-share --comment "Sales analytics data share"

Im folgenden Beispiel wird eine Freigabe mit einem bestimmten Speicherstamm erstellt:

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

Databricks-Anteile löschen

Löscht eine Freigabe aus dem Metastore. Der Anrufer muss ein Besitzer der Freigabe sein.

databricks shares delete NAME [flags]

Arguments

NAME

    Der Name der Freigabe.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine Freigabe namens my-analytics-share gelöscht:

databricks shares delete my-analytics-share

Databricks-Aktien erhalten

Ruft eine Freigabe aus dem Metastore ab. Der Aufrufer muss ein Metastore-Administrator oder der Besitzer der Freigabe sein.

databricks shares get NAME [flags]

Arguments

NAME

    Der Name der Freigabe.

Options

--include-shared-data

    Abfrage von Daten, die in die Freigabe einbezogen werden sollen.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden Informationen zu einer Freigabe namens my-analytics-share abgerufen:

databricks shares get my-analytics-share

Im folgenden Beispiel wird eine Freigabe mit Details zu den freigegebenen Daten abgerufen:

databricks shares get my-analytics-share --include-shared-data

(Überholt) Databricks-Aktienliste

Deprecated. Listet Freigaben aus dem Metastore auf. Der Aufrufer muss ein Metastore-Administrator oder der Besitzer der Freigabe sein. Die Reihenfolge der Elemente im Array ist nicht garantiert.

databricks shares list [flags]

Arguments

None

Options

--max-results int

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

Listet Freigaben aus dem Metastore auf. Der Aufrufer muss ein Metastore-Administrator oder der Besitzer der Freigabe sein. Die Reihenfolge der Elemente im Array ist nicht garantiert.

databricks shares list-shares [flags]

Arguments

None

Options

--max-results int

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

Examples

Im folgenden Beispiel werden alle Freigaben aufgelistet:

databricks shares list-shares

Databricks-Aktien-Update

Aktualisiert die Freigabe mit den Änderungen und Datenobjekten in der Anforderung. Der Aufrufer muss der Besitzer der Freigabe oder ein Metastore-Administrator sein.

Wenn der Aufrufer ein Metastore-Administrator ist, kann nur das owner Feld aktualisiert werden.

Falls der Freigabename geändert wird, erfordert updateShare, dass der Aufrufer der Besitzer der Freigabe ist und über die Berechtigung CREATE_SHARE verfügt.

Wenn die Freigabe Notebookdateien enthält, kann das storage_root-Feld nicht aktualisiert werden.

Für jede Tabelle, die mit dieser Methode hinzugefügt wird, muss der Freigabebesitzer auch über die SELECT-Berechtigung für die Tabelle verfügen. Diese Berechtigung muss auf unbestimmte Zeit beibehalten werden, damit Empfänger auf die Tabelle zugreifen können. In der Regel sollten Sie eine Gruppe als Freigabebesitzer verwenden.

Für die Entfernung von Tabellen mit update sind keine zusätzlichen Berechtigungen erforderlich.

databricks shares update NAME [flags]

Arguments

NAME

    Der Name der Freigabe.

Options

--comment string

    Vom Benutzer bereitgestellte Freiformtextbeschreibung.

--json JSON

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

--new-name string

    Neuer Name für die Freigabe.

--owner string

    Benutzername des aktuellen Freigabebesitzers.

--storage-root string

    Basis-URL für Speicher von Notizbuchdateien im Freigabebereich.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird der Kommentar einer Freigabe aktualisiert:

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

Im folgenden Beispiel wird der Name einer Freigabe geändert:

databricks shares update my-analytics-share --new-name "sales-analytics-share"

Im folgenden Beispiel wird der Besitzer einer Freigabe aktualisiert:

databricks shares update my-analytics-share --owner "someone@example.com"

Im folgenden Beispiel wird eine Freigabe mithilfe der JSON-Konfiguration aktualisiert:

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

databricks teilt Freigabeberechtigungen

Berechtigungen für einen Datenaustausch vom Metastore abrufen. Der Aufrufer muss ein Metastore-Administrator oder der Besitzer der Freigabe sein.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Der Name der Freigabe.

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

Examples

Im folgenden Beispiel werden Berechtigungen für eine Freigabe namens my-analytics-share vergeben:

databricks shares share-permissions my-analytics-share

databricks teilt Updateberechtigungen

Aktualisieren Sie die Berechtigungen für eine Datenfreigabe im Metastore. Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer der Freigabe sein.

Für neue Empfängererteilungen muss der Benutzer auch der Empfängerbesitzer oder Metastore-Administrator sein. Empfängersperrungen erfordern keine zusätzlichen Berechtigungen.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Der Name der Freigabe.

Options

--json JSON

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

--omit-permissions-list

    Optional.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden einem Empfänger Berechtigungen erteilt:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

Im folgenden Beispiel werden Berechtigungen von einem Empfänger widerrufen:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

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