Teilen über


clean-rooms 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-rooms der Befehlsgruppe in der Databricks CLI können Sie Saubere Räume verwalten. Ein Reinraum verwendet Delta Sharing und serverlose Berechnung, um eine sichere und datenschutzgeschützte Umgebung bereitzustellen, in der mehrere Parteien gemeinsam an vertraulichen Unternehmensdaten zusammenarbeiten können, ohne direkt auf die Daten des anderen zuzugreifen. Siehe Was sind Azure Databricks-Reinräume?.

databricks Reinräume erstellen

Erstellen Sie einen neuen Reinraum mit den angegebenen Mitarbeitern. Diese Methode ist asynchron; Das zurückgegebene Namensfeld innerhalb des felds clean_room kann verwendet werden, um den Status des Reinraums mithilfe der Get-Methode abzufragen. Wenn diese Methode zurückkehrt, befindet sich der Clean Room in einem PROVISIONING Status, in dem nur Name, Besitzer, Kommentar, created_at und Status ausgefüllt sind. Der Clean Room ist benutzbar, sobald er einen ACTIVE Status erreicht.

Der Aufrufer muss ein Metastore-Administrator sein oder über die CREATE_CLEAN_ROOM Berechtigungen für den Metastore verfügen.

databricks clean-rooms create [flags]

Arguments

None

Options

--comment string

    Kommentar für den Clean Room.

--json JSON

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

--name string

    Der Name des Reinraums.

--owner string

    Dies ist der Databricks-Benutzername des Besitzers des lokalen Clean Rooms, der für die Verwaltung der Berechtigungen gesichert ist.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein Reinraum mit einem Namen und Besitzer erstellt:

databricks clean-rooms create --name "my-clean-room" --owner "someone@example.com"

Im folgenden Beispiel wird ein Reinraum mit einem Kommentar erstellt:

databricks clean-rooms create --name "analytics-clean-room" --owner "someone@example.com" --comment "Clean room for analytics collaboration"

databricks Clean-Rooms Ausgabe-Katalog-erstellen

Erstellen eines Clean Room-Ausgabekatalog.

databricks clean-rooms create-output-catalog CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Name des Reinraums.

Options

--catalog-name string

    Der Name des Ausgabekatalogs im Unity-Katalog.

--json JSON

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

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein Ausgabekatalog für einen Reinraum erstellt:

databricks clean-rooms create-output-catalog my-clean-room --catalog-name "my_output_catalog"

Löschen von Databricks-Reinräumen

Einen Reinraum löschen. Nach der Löschung wird der Clean Room aus dem Metastore entfernt. Wenn die anderen Mitwirkenden den Reinraum nicht gelöscht haben, bleibt er weiterhin in ihrem Metaspeicher, befindet sich jedoch im Zustand "DELETED", und es können keine anderen Vorgänge außer der Löschung darauf ausgeführt werden.

databricks clean-rooms delete NAME [flags]

Arguments

NAME

    Name des Reinraums.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein Reinraum gelöscht:

databricks clean-rooms delete my-clean-room

databricks Clean-Räume abrufen

Abrufen der Details eines Clean Rooms anhand seines Namens.

databricks clean-rooms get NAME [flags]

Arguments

NAME

    Name des Reinraums.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden Details eines Reinraums angezeigt:

databricks clean-rooms get my-clean-room

Im folgenden Beispiel werden Reinraumdetails mithilfe eines bestimmten Profils angezeigt:

databricks clean-rooms get analytics-clean-room --profile production

Databricks Cleanroom-Listen

Alle Clean Rooms des Metastores auflisten. Nur Saubere Räume, auf die der Anrufer Zugriff hat, werden zurückgegeben.

databricks clean-rooms list [flags]

Arguments

None

Options

--page-size int

    Maximale Anzahl der Clean Rooms, die zurückgegeben werden sollen (d.h. die Seitenlänge).

--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 barrierefreien Reinräume aufgelistet:

databricks clean-rooms list

Im folgenden Beispiel werden Reinräume mit einem bestimmten Seitenformat aufgelistet:

databricks clean-rooms list --page-size 10

Databricks Clean-Rooms-Update

Aktualisieren eines Clean Rooms. Der Aufrufer muss der Besitzer des Clean Rooms sein, das MODIFY_CLEAN_ROOM-Privileg haben oder Metastore-Admin sein.

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

databricks clean-rooms update NAME [flags]

Arguments

NAME

    Name des Reinraums.

Options

--json JSON

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

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein Reinraum mithilfe der JSON-Konfiguration aktualisiert:

databricks clean-rooms update my-clean-room --json '{"comment": "Updated clean room description"}'

Das folgende Beispiel aktualisiert einen Besitzer eines Clean Rooms (nur Metastore-Admin):

databricks clean-rooms update my-clean-room --json '{"owner": "new-someone@example.com"}'

Im folgenden Beispiel wird ein Reinraum mithilfe einer JSON-Datei aktualisiert:

databricks clean-rooms update my-clean-room --json @update-config.json

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