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 catalogs der Befehlsgruppe in der Databricks CLI können Sie Kataloge im Unity-Katalog verwalten. Ein Katalog ist die erste Ebene des dreistufigen Namespaces von Unity Catalog. Es wird verwendet, um Ihre Datenressourcen zu organisieren. Siehe Was ist Unity Catalog?.
Databricks-Kataloge erstellen
Erstellen Sie eine neue Kataloginstanz im übergeordneten Metastore, wenn der Aufrufer ein Metastore-Administrator ist oder über die CREATE_CATALOG Berechtigung verfügt.
databricks catalogs create NAME [flags]
Arguments
NAME
Name des Katalogs
Options
--comment string
Vom Benutzer bereitgestellte Freiformtextbeschreibung
--connection-name string
Der Name der Verbindung mit einer externen Datenquelle
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--provider-name string
Der Name des Delta-Sharing-Anbieters
--share-name string
Der Name der Freigabe unter dem Anbieter der Freigabe
--storage-root string
Speicherstamm-URL für verwaltete Tabellen im Katalog
Examples
Im folgenden Beispiel wird ein Katalog mit dem Namen saleserstellt:
databricks catalogs create sales
Im folgenden Beispiel wird ein Katalog mit einem Kommentar erstellt:
databricks catalogs create sales --comment "Sales data catalog"
Databricks-Kataloge löschen
Löschen Sie den Katalog, der dem angegebenen Namen entspricht. Der Aufrufer muss ein Metastore-Administrator oder der Besitzer des Katalogs sein.
databricks catalogs delete NAME [flags]
Arguments
NAME
Der Name des Katalogs
Options
--force
Löschen erzwingen, auch wenn der Katalog nicht leer ist
Examples
Im folgenden Beispiel wird ein Katalog mit dem Namen salesgelöscht:
databricks catalogs delete sales
Im folgenden Beispiel wird das Löschen eines nicht leeren Katalogs erzwungen:
databricks catalogs delete sales --force
Databricks-Kataloge abrufen
Rufen Sie den angegebenen Katalog in einem Metastore ab. Der Aufrufer muss ein Metastore-Administrator, der Besitzer des Katalogs oder ein Benutzer sein, der über die USE_CATALOG für sein Konto festgelegten Berechtigungen verfügt.
databricks catalogs get NAME [flags]
Arguments
NAME
Der Name des Katalogs
Options
--include-browse
Ob Kataloge in die Antwort aufgenommen werden sollen, für die das Prinzipal nur selektiv auf Metadaten zugreifen kann
Examples
Das folgende Beispiel ruft Informationen über einen Katalog namens sales ab:
databricks catalogs get sales
Im folgenden Beispiel werden Kataloginformationen einschließlich der nur zum Durchsuchen bestimmten Kataloge angezeigt:
databricks catalogs get sales --include-browse
Databricks-Katalogliste
Kataloge im Metastore auflisten. Wenn der Aufrufer der Metastore-Administrator ist, werden alle Kataloge abgerufen. Andernfalls werden nur Kataloge abgerufen, die dem Aufrufer gehören (oder für die der Anrufer über die USE_CATALOG Berechtigung verfügt). Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente im Array.
databricks catalogs list [flags]
Options
--include-browse
Ob Kataloge in die Antwort aufgenommen werden sollen, für die das Prinzipal nur selektiv auf Metadaten zugreifen kann
--max-results int
Maximale Anzahl von Katalogen, die zurückgegeben werden sollen
--page-token string
Undurchsichtiges Paginierungstoken, um basierend auf der vorherigen Abfrage zur nächsten Seite zu gelangen
Examples
Im folgenden Beispiel werden alle Kataloge aufgelistet:
databricks catalogs list
Im folgenden Beispiel werden Kataloge mit maximal 10 Ergebnissen aufgelistet:
databricks catalogs list --max-results 10
Im folgenden Beispiel werden Kataloge aufgelistet, einschließlich der Kataloge, die nur zur Ansicht sind.
databricks catalogs list --include-browse
Databricks-Kataloge aktualisieren
Aktualisieren Sie den Katalog, der dem angegebenen Namen entspricht. Der Aufrufer muss entweder der Besitzer des Katalogs oder ein Metastore-Administrator sein (beim Ändern des Besitzerfelds des Katalogs).
databricks catalogs update NAME [flags]
Arguments
NAME
Der Name des Katalogs
Options
--comment string
Vom Benutzer bereitgestellte Freiformtextbeschreibung
--enable-predictive-optimization EnablePredictiveOptimization
Gibt an, ob die prädiktive Optimierung für dieses Objekt und die untergeordneten Objekte aktiviert werden sollte. Unterstützte Werte: DISABLE, ENABLE, INHERIT
--isolation-mode CatalogIsolationMode
Gibt an, ob das aktuelle sicherbare Objekt in allen Arbeitsbereichen oder in einer bestimmten Gruppe von Arbeitsbereichen zugänglich ist. Unterstützte Werte: ISOLATED, OPEN
--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 Katalog
--owner string
Benutzername des aktuellen Besitzers des Katalogs
Examples
Im folgenden Beispiel wird der Kommentar eines Katalogs aktualisiert:
databricks catalogs update sales --comment "Updated sales data catalog"
Im folgenden Beispiel wird ein Katalog umbenannt:
databricks catalogs update sales --new-name sales-prod
Im folgenden Beispiel wird der Besitzer eines Katalogs geändert:
databricks catalogs update sales --owner someone@example.com
Im folgenden Beispiel wird eine prädiktive Optimierung für einen Katalog aktiviert:
databricks catalogs update sales --enable-predictive-optimization ENABLE
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