Teilen über


clean-room-assets 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 clean-room-assets der Befehlsgruppe in der Databricks CLI können Sie Reinraumressourcen verwalten. Clean Room-Assets sind Daten und Objekte wie z. B. Tabellen, Volumes und Notebooks, die gemeinsam mit dem Clean Room genutzt werden. Zu den unterstützten Objekttypen gehören FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, VIEW und VOLUME.

databricks Cleanroom-Assets erstellen

Erstellen Sie eine Reinraumressource. Für jedes Unity Catalog-Asset, das auf diese Weise hinzugefügt wird, muss der Clean Room-Besitzer auch über ausreichende Berechtigungen für das Asset verfügen, um es zu konsumieren. Die Berechtigung muss auf unbestimmte Zeit beibehalten werden, damit Clean Room auf das Asset zugreifen kann. Normalerweise sollten Sie eine Gruppe als Clean Room-Besitzer verwenden.

databricks clean-room-assets create CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Name des Reinraums.

Options

--asset-type CleanRoomAssetAssetType

    Der Typ des Assets. Unterstützte Werte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, , VIEWVOLUME

--json JSON

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

--name string

    Ein vollständig qualifizierter Name, der das Asset innerhalb von Clean Room eindeutig identifiziert.

Globale Kennzeichnungen

Examples

Das folgende Beispiel erstellt ein Tabellen-Asset in einem Clean Room:

databricks clean-room-assets create my-clean-room --asset-type TABLE --name "catalog.schema.table_name"

Im folgenden Beispiel wird eine Notizbuchressource in einem Reinraum erstellt:

databricks clean-room-assets create my-clean-room --asset-type NOTEBOOK_FILE --name "my_notebook.py"

Im folgenden Beispiel wird ein Volumen-Asset in einem Reinraum erstellt.

databricks clean-room-assets create my-clean-room --asset-type VOLUME --name "catalog.schema.volume_name"

databricks clean-room-assets delete

Löschen Sie ein Reinraum-Asset. Heben Sie die Freigabe auf und entfernen Sie das Asset aus dem Clean Room.

databricks clean-room-assets delete CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Name des Reinraums.

ASSET_TYPE

    Der Typ des Assets. Unterstützte Werte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, , VIEWVOLUME

NAME

    Der vollständig qualifizierte Name des Assets, er entspricht dem Namensfeld in CleanRoomAsset.

Options

Globale Kennzeichnungen

Examples

Das folgende Beispiel löscht ein Tabellen-Asset aus einem Clean Room:

databricks clean-room-assets delete my-clean-room TABLE "catalog.schema.table_name"

Im folgenden Beispiel wird eine Notizbuchressource aus einem Reinraum gelöscht:

databricks clean-room-assets delete my-clean-room NOTEBOOK_FILE "my_notebook.py"

Das folgende Beispiel löscht ein Volume Asset aus einem Clean Room:

databricks clean-room-assets delete my-clean-room VOLUME "catalog.schema.volume_name"

databricks clean-room-assets abrufen

Abrufen der Details eines Clean Room Assets anhand seines Typs und seines vollständigen Namens.

databricks clean-room-assets get CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Name des Reinraums.

ASSET_TYPE

    Der Typ des Assets. Unterstützte Werte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, , VIEWVOLUME

NAME

    Der vollständig qualifizierte Name des Assets, er entspricht dem Namensfeld in CleanRoomAsset.

Options

Globale Kennzeichnungen

Examples

Das folgende Beispiel ruft Details zu einem Tabellen-Asset in einem Clean Room ab:

databricks clean-room-assets get my-clean-room TABLE "catalog.schema.table_name"

Im folgenden Beispiel werden Details zu einer Notizbuchressource in einem Reinraum angezeigt:

databricks clean-room-assets get my-clean-room NOTEBOOK_FILE "my_notebook.py"

Im folgenden Beispiel werden Details zu einem Ansichtselement in einem Reinraum angezeigt.

databricks clean-room-assets get my-clean-room VIEW "catalog.schema.view_name"

databricks Clean-Room-Assets anzeigen

Auflisten von Assets in einem Clean Room.

databricks clean-room-assets list CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Name des Reinraums.

Options

--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 Ressourcen in einem Reinraum aufgelistet:

databricks clean-room-assets list my-clean-room

databricks Reinraum-Assets-Update

Aktualisieren einer Reinraumressource. Aktualisieren Sie beispielsweise den Inhalt eines Notizbuchs oder ändern Sie die geteilten Partitionen einer Tabelle.

databricks clean-room-assets update CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Name des Reinraums.

ASSET_TYPE

    Der Typ des Assets. Unterstützte Werte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, , VIEWVOLUME

NAME

    Ein vollständig qualifizierter Name, der das Asset innerhalb von Clean Room eindeutig identifiziert. Dies ist auch der Name, der in der Reinraum-Benutzeroberfläche angezeigt wird. Bei sicherbaren Ressourcen (Tabellen, Volumes usw.) im Unity-Katalog ist das Format shared_catalog.shared_schema.asset_name. Bei Notizbüchern entspricht der Name genau dem Dateinamen des Notizbuchs.

Options

--asset-type CleanRoomAssetAssetType

    Der Typ des Assets. Unterstützte Werte: FOREIGN_TABLE, NOTEBOOK_FILE, TABLE, , VIEWVOLUME

--json JSON

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

--name string

    Ein vollständig qualifizierter Name, der das Asset innerhalb von Clean Room eindeutig identifiziert.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine Tabellenressource in einem Reinraum aktualisiert:

databricks clean-room-assets update my-clean-room TABLE "catalog.schema.table_name" --json '{
  "asset_type": "TABLE",
  "name": "catalog.schema.table_name"
}'

Im folgenden Beispiel wird eine Notizbuchressource in einem Reinraum aktualisiert:

databricks clean-room-assets update my-clean-room NOTEBOOK_FILE "my_notebook.py" --name "updated_notebook.py"

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