Sdílet prostřednictvím


metastores 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 metastores příkazů v rozhraní příkazového řádku Databricks umožňuje spravovat metastory. Metastore je kontejner objektů nejvyšší úrovně v katalogu Unity. Ukládá datové prostředky (tabulky a zobrazení) a oprávnění, která k nim řídí přístup. Viz Metastore.

Přiřazení metastorů Databricks

Vytvořte nové přiřazení metastore. Pokud přiřazení pro stejné workspace_id existuje, bude přepsáno novým metastore_id a default_catalog_name. Volající musí být správcem účtu.

databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]

Arguments

WORKSPACE_ID

    ID pracovního prostoru.

METASTORE_ID

    Jedinečné ID metastoru.

DEFAULT_CATALOG_NAME

    Deprecated. Použijte "Default Namespace API" k nakonfigurování výchozího katalogu pro pracovní prostor Databricks. Název výchozího katalogu v metastoru.

Možnosti

--json JSON

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

Globální příznaky

Examples

Následující příklad přiřadí metastoru pracovnímu prostoru:

databricks metastores assign 123456789 abc123-def456-ghi789 main

Vytvoření metastorů Databricks

Vytvořte nový metastor založený na zadaném názvu a volitelné kořenové cestě úložiště. Ve výchozím nastavení (pokud pole vlastníka není nastavené), vlastníkem nového metastoru je uživatel, který volá rozhraní CREATEMetastore API. Pokud je pole vlastníka nastavené na prázdný řetězec (""), je vlastnictví přiřazeno systémovému uživateli.

databricks metastores create NAME [flags]

Arguments

NAME

    Uživatelem zadaný název metastoru.

Možnosti

--json JSON

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

--region string

    Cloudová oblast, kterou metastore obsluhuje (např. us-west-2, westus).

--storage-root string

    Kořenová adresa URL pro úložiště metadata.

Globální příznaky

Examples

Následující příklad vytvoří metastor s názvem a kořenem úložiště:

databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2

Aktuální Metastore Databricks

Zjistěte přiřazení metastore pro pracovní prostor, který je přistupován.

databricks metastores current [flags]

Možnosti

Globální příznaky

Examples

Následující příklad získá aktuální přiřazení metastoru:

databricks metastores current

Odstranění metastorů Databricks

Odstraňte metastore Volající musí být správcem metastoru.

databricks metastores delete ID [flags]

Arguments

ID

    Jedinečné ID metastore-u.

Možnosti

--force

    Vynutit odstranění i v případě, že metastor není prázdný.

Globální příznaky

Examples

Následující příklad odstraní metastore:

databricks metastores delete abc123-def456-ghi789

Následující příklad vynucuje odstranění metastoru, i když není prázdný:

databricks metastores delete abc123-def456-ghi789 --force

Získat metabáze databricks

Získejte metastore, který odpovídá zadanému ID. Volající musí být správcem metastoru, aby mohl tyto informace načíst.

databricks metastores get ID [flags]

Arguments

ID

    Jedinečné ID metastore-u.

Možnosti

Globální příznaky

Examples

Následující příklad získá informace o konkrétním metastoru:

databricks metastores get abc123-def456-ghi789

Seznam metastorů databricks

Uveďte seznam dostupných metastorů. Volající musí být správcem, aby tyto informace získal. Neexistuje žádná záruka konkrétního řazení položek v seznamu.

databricks metastores list [flags]

Možnosti

--max-results int

    Maximální počet metastorů, 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 obsahuje seznam všech dostupných metastorů:

databricks metastores list

Následující příklad uvádí metastory se stránkováním:

databricks metastores list --max-results 10 --page-token abc123token

Souhrn metastorů Databricks

Získejte souhrnné informace o metastoru. Tento souhrn zahrnuje přihlašovací údaje úložiště, dodavatele cloudu, oblast cloudu a globální ID metastoru.

databricks metastores summary [flags]

Možnosti

Globální příznaky

Examples

Následující příklad získá souhrn metastoru:

databricks metastores summary

Zrušení přiřazení Databricks metastorů

Odstranit přiřazení metastore. Volající musí být správcem účtu.

databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]

Arguments

WORKSPACE_ID

    ID pracovního prostoru.

METASTORE_ID

    Zadejte dotaz na ID metastoru, které chcete odstranit.

Možnosti

Globální příznaky

Examples

Následující příklad zruší přiřazení metastoru z pracovního prostoru:

databricks metastores unassign 123456789 abc123-def456-ghi789

Aktualizace metastorů databricks

Aktualizujte informace o konkrétním metastore. Volající musí být správcem metastoru. Pokud je pole vlastníka nastavené na prázdný řetězec (""), vlastnictví se aktualizuje na systémového uživatele.

databricks metastores update ID [flags]

Arguments

ID

    Jedinečné ID metastore-u.

Možnosti

--delta-sharing-organization-name string

    Název společnosti v rámci entity Delta Sharing, který bude použit v rámci Databricks-to-Databricks Delta Sharing jako oficiální název.

--delta-sharing-recipient-token-lifetime-in-seconds int

    Životnost tokenu příjemce rozdílového sdílení v sekundách.

--delta-sharing-scope DeltaSharingScopeEnum

    Rozsah pro Delta Sharing povolený pro metastore. Podporované hodnoty: INTERNAL, INTERNAL_AND_EXTERNAL

--json JSON

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

--new-name string

    Nový název metastoru

--owner string

    Vlastník metastoru.

--privilege-model-version string

    Verze modelu oprávnění pro metastore ve formátu major.minor (např. 1.0).

--storage-root-credential-id string

    UUID přístupových údajů úložiště pro přístup k storage_root metastoru.

Globální příznaky

Examples

Následující příklad aktualizuje název metastoru:

databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore

Následující příklad aktualizuje metastore s konfigurací pro Delta Sharing:

databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org

Aktualizace přiřazení metastorů Databricks

Aktualizujte přiřazení metadatového úložiště. Tuto operaci lze použít k aktualizaci metastore_id nebo default_catalog_name pro zadaný pracovní prostor, pokud je již pracovnímu prostoru přiřazen metastore. Volající musí být správcem účtu, aby mohl aktualizovat metastore_id. V opačném případě může být volající správcem pracovního prostoru.

databricks metastores update-assignment WORKSPACE_ID [flags]

Arguments

WORKSPACE_ID

    ID pracovního prostoru.

Možnosti

--default-catalog-name string

    Název výchozího katalogu v metastoru.

--json JSON

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

--metastore-id string

    Jedinečné ID metastoru.

Globální příznaky

Examples

Následující příklad aktualizuje výchozí katalog přiřazení metastoru:

databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog

Následující příklad aktualizuje ID metastoru přiřazení metastoru:

databricks metastores update-assignment 123456789 --metastore-id new-metastore-id

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