Sdílet prostřednictvím


catalogs skupina příkazů

Note

Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve veřejné ukázce.

Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.

Skupina catalogs příkazů v rozhraní příkazového řádku Databricks umožňuje spravovat katalogy v katalogu Unity. Katalog představuje první vrstvu tříúrovňového oboru názvů v rámci Unity Catalog. Slouží k uspořádání datových prostředků. Viz téma Co je katalog Unity?.

Vytvoření katalogů Databricks

Pokud je volající správcem metastoru nebo má oprávnění CREATE_CATALOG, vytvořte novou instanci katalogu v nadřazeném metastoru.

databricks catalogs create NAME [flags]

Arguments

NAME

    Název katalogu

Možnosti

--comment string

    Popis bezplatného textu poskytnutého uživatelem

--connection-name string

    Název připojení k externímu zdroji dat

--json JSON

    Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku

--provider-name string

    Název poskytovatele sdílení Delta

--share-name string

    Název sdílené složky pod poskytovatelem sdílení

--storage-root string

    Kořenová adresa URL úložiště pro spravované tabulky v katalogu

Globální příznaky

Examples

Následující příklad vytvoří katalog s názvem sales:

databricks catalogs create sales

Následující příklad vytvoří katalog s komentářem:

databricks catalogs create sales --comment "Sales data catalog"

Odstranění katalogů Databricks

Odstraňte katalog, který odpovídá zadanému názvu. Volající musí být správcem metastoru nebo vlastníkem katalogu.

databricks catalogs delete NAME [flags]

Arguments

NAME

    Název katalogu

Možnosti

--force

    Vynucení odstranění i v případě, že katalog není prázdný

Globální příznaky

Examples

Následující příklad odstraní katalog s názvem sales:

databricks catalogs delete sales

Následující příklad vynutí odstranění neprázdného katalogu:

databricks catalogs delete sales --force

Získejte katalogy Databricks

Získejte zadaný katalog v metastoru. Volající musí být správcem metastoru, vlastníkem katalogu nebo uživatelem, který má USE_CATALOG nastavené oprávnění pro svůj účet.

databricks catalogs get NAME [flags]

Arguments

NAME

    Název katalogu

Možnosti

--include-browse

    Zda zahrnout katalogy ve odpovědi, ve které má subjekt přístup pouze k výběrovým metadatům.

Globální příznaky

Examples

Následující příklad získá informace o katalogu s názvem sales:

databricks catalogs get sales

Následující příklad získá informace o katalozích, včetně katalogů pouze pro procházení.

databricks catalogs get sales --include-browse

Seznam katalogů Databricks

Seznam katalogů v metastoru Pokud je volající správcem metastoru, všechny katalogy budou načteny. V opačném případě se načtou pouze katalogy vlastněné volajícím (nebo pro které má volající USE_CATALOG oprávnění). Neexistuje žádná záruka konkrétního řazení prvků v poli.

databricks catalogs list [flags]

Možnosti

--include-browse

    Zda zahrnout katalogy ve odpovědi, ve které má subjekt přístup pouze k výběrovým metadatům.

--max-results int

    Maximální počet katalogů, které se mají vrátit

--page-token string

    Neprůhledný token stránkování umožňující přechod na další stránku na základě předchozího dotazu

Globální příznaky

Examples

Následující příklad obsahuje seznam všech katalogů:

databricks catalogs list

Následující příklad uvádí katalogy s maximálně 10 výsledky:

databricks catalogs list --max-results 10

Následující příklad uvádí katalogy včetně katalogů jen pro procházení:

databricks catalogs list --include-browse

Aktualizace katalogů Databricks

Aktualizujte katalog, který odpovídá zadanému názvu. Volající musí být vlastníkem katalogu nebo správcem metastoru (při změně pole vlastníka katalogu).

databricks catalogs update NAME [flags]

Arguments

NAME

    Název katalogu

Možnosti

--comment string

    Popis bezplatného textu poskytnutého uživatelem

--enable-predictive-optimization EnablePredictiveOptimization

    Zda by měla být pro tento objekt a objekty povolena prediktivní optimalizace. Podporované hodnoty: DISABLE, ENABLE, INHERIT

--isolation-mode CatalogIsolationMode

    Zda je aktuální zabezpečený objekt dostupný ze všech workspaceů nebo z konkrétní sady pracovních prostorů. Podporované hodnoty: ISOLATED, OPEN

--json JSON

    Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku

--new-name string

    Nový název katalogu

--owner string

    Uživatelské jméno aktuálního vlastníka katalogu

Globální příznaky

Examples

Následující příklad aktualizuje komentář katalogu:

databricks catalogs update sales --comment "Updated sales data catalog"

Následující příklad přejmenuje katalog:

databricks catalogs update sales --new-name sales-prod

Následující příklad změní vlastníka katalogu:

databricks catalogs update sales --owner someone@example.com

Následující příklad umožňuje prediktivní optimalizaci katalogu:

databricks catalogs update sales --enable-predictive-optimization ENABLE

Globální příznaky

--debug

  Zda povolit protokolování ladění.

-h nebo --help

    Zobrazení nápovědy k rozhraní příkazového řádku Databricks nebo související skupině příkazů nebo souvisejícímu příkazu

--log-file řetězec

    Řetězec představující soubor, do kterého se zapisují výstupní protokoly. Pokud tento příznak není zadaný, výchozí hodnota je zápis výstupních protokolů do stderru.

--log-format formát

    Typ formátu protokolu, text nebo json. Výchozí hodnota je text.

--log-level řetězec

    Řetězec představující úroveň formátu protokolu. Pokud není zadána, je úroveň formátu protokolu zakázaná.

-o, --output typ

    Typ výstupu příkazu, text nebo json. Výchozí hodnota je text.

-p, --profile řetězec

    Název profilu v ~/.databrickscfg souboru, který se má použít ke spuštění příkazu. Pokud tento příznak není zadán, použije se profil s názvem DEFAULT, pokud existuje.

--progress-format formát

    Formát pro zobrazení protokolů průběhu: default, append, inplacenebo json

-t, --target řetězec

    Pokud je to relevantní, cílový balíček, který se má použít