Sdílet prostřednictvím


schemas 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 schemas příkazů v rozhraní příkazového řádku Databricks obsahuje příkazy pro správu schémat v katalogu Unity. Schéma je druhá vrstva tříúrovňového pojmenovaného prostoru katalogu Unity. Schéma uspořádá tabulky, zobrazení a funkce. Podívejte se, co jsou schémata v Azure Databricks?

Vytvořit schémata Databricks

Vytvořte nové schéma pro katalog v metastoru. Volající musí být správcem metastoru CREATE_SCHEMA nebo musí mít oprávnění v nadřazeném katalogu.

databricks schemas create NAME CATALOG_NAME [flags]

Arguments

NAME

    Název schématu vzhledem k nadřazenému katalogu.

CATALOG_NAME

    Název nadřazeného katalogu

Možnosti

--comment string

    Popis bezplatného textu poskytnutého uživatelem

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--storage-root string

    Kořenová adresa URL úložiště pro spravované tabulky ve schématu

Globální příznaky

Examples

Následující příklad vytvoří nové schéma pojmenované analytics v main katalogu:

databricks schemas create analytics main

Následující příklad vytvoří nové schéma s komentářem:

databricks schemas create analytics main --comment "Schema for analytics data"

Odstranění schémat databricks

Odstraňte zadané schéma z nadřazeného katalogu. Volající musí být vlastníkem schématu nebo vlastníkem nadřazeného katalogu.

databricks schemas delete FULL_NAME [flags]

Arguments

FULL_NAME

    Úplný název schématu.

Možnosti

--force

    Vynutit odstranění i v případě, že schéma není prázdné.

Globální příznaky

Examples

Následující příklad odstraní schéma:

databricks schemas delete main.analytics

Následující příklad násilně odstraní schéma, i když není prázdné:

databricks schemas delete main.analytics --force

Získání schémat databricks

Získejte zadané schéma v rámci metastoru. Volající musí být správcem metastoru, vlastníkem schématu nebo uživatelem, který má USE_SCHEMA oprávnění ke schématu.

databricks schemas get FULL_NAME [flags]

Arguments

FULL_NAME

    Úplný název schématu.

Možnosti

--include-browse

    Zda zahrnout schémata do odpovědi, ke kterým může hlavní subjekt přistupovat pouze pro selektivní metadata.

Globální příznaky

Examples

Následující příklad získá informace o schématu:

databricks schemas get main.analytics

Následující příklad získá informace o schématu, včetně oprávnění pro procházení:

databricks schemas get main.analytics --include-browse

Seznam schémat databricks

Zobrazí seznam schémat pro katalog v metastoru. Pokud je volající správcem metastoru nebo vlastníkem nadřazeného katalogu, budou načtena všechna schémata katalogu. V opačném případě se načtou pouze schémata, která vlastní volající (nebo ke kterým má volající oprávnění USE_SCHEMA). Neexistuje žádná záruka konkrétního řazení prvků v poli.

databricks schemas list CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Nadřazený katalog pro schémata, která nás zajímají

Možnosti

--include-browse

    Zda zahrnout schémata do odpovědi, ke kterým může hlavní subjekt přistupovat pouze pro selektivní metadata.

--max-results int

    Maximální počet schémat, která se mají vrátit.

--page-token string

    Netransparentní token stránkování pro přechod na další stránku na základě předchozího dotazu.

Globální příznaky

Examples

Následující příklad uvádí všechna schémata v main katalogu:

databricks schemas list main

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

databricks schemas list main --max-results 10

Následující příklad uvádí schémata pomocí stránkování:

databricks schemas list main --page-token <token>

Aktualizace schémat Databricks

Aktualizace schématu pro katalog Volající musí být vlastníkem schématu nebo správce metastoru. Pokud je volající správcem metastoru owner , může se v aktualizaci změnit jenom pole. Pokud musí být pole name aktualizováno, volající musí být správcem metastoru nebo mít CREATE_SCHEMA oprávnění k nadřazenému katalogu.

databricks schemas update FULL_NAME [flags]

Arguments

FULL_NAME

    Úplný název schématu.

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]

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--new-name string

    Nový název schématu

--owner string

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

Globální příznaky

Examples

Následující příklad aktualizuje komentář schématu:

databricks schemas update main.analytics --comment "Updated analytics schema"

Následující příklad změní vlastníka schématu:

databricks schemas update main.analytics --owner someone@example.com

Následující příklad přejmenuje schéma:

databricks schemas update main.analytics --new-name analytics_v2

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