Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
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 metastores der Befehlsgruppe in der Databricks CLI können Sie Metastores verwalten. Ein Metastore ist der Objektcontainer der obersten Ebene in Unity Catalog. Es speichert Datenobjekte (Tabellen und Ansichten) und die Berechtigungen, die den Zugriff darauf steuern. Siehe Metastore.
databricks metastores zuweisen
Erstellen Sie eine neue Metaspeicherzuweisung. Wenn eine Zuordnung für dasselbe workspace_id vorhanden ist, wird sie von den neuen metastore_id und default_catalog_name überschrieben. Der Anrufer muss ein Kontoadministrator sein.
databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]
Arguments
WORKSPACE_ID
Eine Arbeitsbereichs-ID.
METASTORE_ID
Die eindeutige ID des Metastores.
DEFAULT_CATALOG_NAME
Deprecated. Verwenden Sie "Standardnamespace-API", um den Standardkatalog für einen Databricks-Arbeitsbereich zu konfigurieren. Der Name des Standardkatalogs im Metastore.
Options
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
Examples
Im folgenden Beispiel wird einem Arbeitsbereich ein Metaspeicher zugewiesen:
databricks metastores assign 123456789 abc123-def456-ghi789 main
Databricks-Metastores erstellen
Erstellen Sie einen neuen Metaspeicher basierend auf einem angegebenen Namen und optionalem Speicherstammpfad. Standardmäßig (wenn das Besitzerfeld nicht festgelegt ist), ist der Besitzer des neuen Metastores der Benutzer, der die createMetastore-API aufruft. Wenn das Besitzerfeld auf die leere Zeichenfolge ("") festgelegt ist, wird dem Systembenutzer stattdessen der Besitz zugewiesen.
databricks metastores create NAME [flags]
Arguments
NAME
Der vom Benutzer angegebene Name des Metastores.
Options
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--region string
Cloudregion, die der Metastore bedient (z.B. us-west-2, westus).
--storage-root string
Die Root-URL des Speicherorts für den Metastore.
Examples
Im folgenden Beispiel wird ein Metaspeicher mit einem Namen und einem Speicherstamm erstellt:
databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2
Databricks Metastores aktuell
Rufen Sie die Metaspeicherzuweisung für den Arbeitsbereich ab, auf den zugegriffen wird.
databricks metastores current [flags]
Options
Examples
Das folgende Beispiel ruft die aktuelle Metaspeicherzuweisung ab:
databricks metastores current
Databricks Metastores löschen
Löschen eines Metaspeichers. Der Aufrufer muss ein Metastore-Administrator sein.
databricks metastores delete ID [flags]
Arguments
ID
Eindeutige ID des Metastores.
Options
--force
Das Löschen erzwingen, auch wenn der Metastore nicht leer ist.
Examples
Im folgenden Beispiel wird ein Metaspeicher gelöscht:
databricks metastores delete abc123-def456-ghi789
Im folgenden Beispiel wird ein Metastore erzwungen gelöscht, auch wenn er nicht leer ist:
databricks metastores delete abc123-def456-ghi789 --force
Databricks-Metastores abrufen
Rufen Sie einen Metaspeicher ab, der der angegebenen ID entspricht. Der Aufrufer muss ein Metastore-Administrator sein, um diese Informationen abzurufen.
databricks metastores get ID [flags]
Arguments
ID
Eindeutige ID des Metastores.
Options
Examples
Das folgende Beispiel ruft Informationen zu einem bestimmten Metaspeicher ab:
databricks metastores get abc123-def456-ghi789
Databricks-Metaspeicherliste
Liste die verfügbaren Metastores auf. Der Anrufer muss ein Administrator sein, um diese Informationen abzurufen. Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente in der Liste.
databricks metastores list [flags]
Options
--max-results int
Maximale Anzahl von Metastoren, die zurückgegeben werden.
--page-token string
Intransparentes Token für die Paginierung, um auf der Grundlage der vorherigen Abfrage zur nächsten Seite zu gelangen.
Examples
Im folgenden Beispiel werden alle verfügbaren Metaspeicher aufgelistet:
databricks metastores list
Im folgenden Beispiel werden Metastores mit Paginierung aufgelistet:
databricks metastores list --max-results 10 --page-token abc123token
databricks Metastore-Zusammenfassung
Zusammenfassende Informationen zu einem Metastore abrufen. Diese Zusammenfassung umfasst die Speicheranmeldeinformationen, den Cloudanbieter, die Cloudregion und die globale Metastore-ID.
databricks metastores summary [flags]
Options
Examples
Das folgende Beispiel ruft eine Metastore-Zusammenfassung ab.
databricks metastores summary
Zuordnung der Databricks-Metastores aufheben
Löschen einer Metaspeicherzuweisung. Der Aufrufer muss ein Kontoadministrator sein.
databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]
Arguments
WORKSPACE_ID
Eine Arbeitsbereichs-ID.
METASTORE_ID
Fragen Sie die ID des zu löschenden Metastores ab.
Options
Examples
Im folgenden Beispiel wird ein Metastore einem Arbeitsbereich nicht mehr zugewiesen:
databricks metastores unassign 123456789 abc123-def456-ghi789
Databricks-Metastore-Aktualisierungen
Aktualisieren sie Informationen für einen bestimmten Metastore. Der Aufrufer muss ein Metastore-Administrator sein. Wenn das Besitzerfeld auf die leere Zeichenfolge ("") festgelegt ist, wird der Besitz auf den Systembenutzer aktualisiert.
databricks metastores update ID [flags]
Arguments
ID
Eindeutige ID des Metastores.
Options
--delta-sharing-organization-name string
Der Organisationsname einer Delta Sharing-Entität, die in Databricks-to-Databricks Delta Sharing als offizieller Name verwendet werden soll.
--delta-sharing-recipient-token-lifetime-in-seconds int
Die Lebensdauer des Delta-Sharing-Empfänger-Tokens in Sekunden.
--delta-sharing-scope DeltaSharingScopeEnum
Der Bereich, in dem Delta Sharing für den Metastore aktiviert ist. Unterstützte Werte: INTERNAL, INTERNAL_AND_EXTERNAL
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--new-name string
Neuer Name für den Metastore.
--owner string
Der Besitzer des Metastores.
--privilege-model-version string
Version des Berechtigungsmodells des Metastores im Format major.minor (z. B. 1.0).
--storage-root-credential-id string
UUID der Speicher-Berechtigung für den Zugriff auf den Metastore storage_root.
Examples
Im folgenden Beispiel wird ein Metastorename aktualisiert:
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore
Im folgenden Beispiel wird ein Metastore mit der Delta Sharing-Konfiguration aktualisiert:
databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org
databricks Metastores Update-Zuweisung
Aktualisieren einer Metaspeicherzuweisung. Dieser Vorgang kann zum Aktualisieren metastore_id oder default_catalog_name für einen angegebenen Arbeitsbereich verwendet werden, wenn dem Arbeitsbereich bereits ein Metaspeicher zugewiesen ist. Der Aufrufer muss ein Kontoadmin sein, um metastore_id zu aktualisieren; andernfalls kann der Aufrufer ein Admin des Arbeitsbereichs sein.
databricks metastores update-assignment WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
Eine Arbeitsbereichs-ID.
Options
--default-catalog-name string
Der Name des Standardkatalogs im Metastore.
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--metastore-id string
Die eindeutige ID des Metastores.
Examples
Im folgenden Beispiel wird der Standardkatalog einer Metastorezuweisung aktualisiert:
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
Das folgende Beispiel aktualisiert die Metastore-ID einer Metastore-Zuweisung:
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
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