external-locations 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 external-locations příkazů v rozhraní příkazového řádku Databricks obsahuje příkazy pro vytváření a správu externích umístění pro katalog Unity. Viz Co jsou svazky katalogu Unity?.

Vytvoření umístění externích Databricks

Vytvořte novou položku externího umístění v metastoru. Volající musí být správcem metastoru nebo musí mít CREATE_EXTERNAL_LOCATION oprávnění k metastoru i přidruženým přihlašovacím údajům úložiště.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Název externího umístění

URL

    Adresa URL cesty externího umístění

CREDENTIAL_NAME

    Název přihlašovacích údajů úložiště, které se používají s tímto umístěním.

Možnosti

--comment string

    Popis bezplatného textu poskytnutého uživatelem

--enable-file-events

    Určuje, jestli chcete povolit události souborů v tomto externím umístění.

--fallback

    Určuje, jestli je pro toto externí umístění povolený záložní režim.

--json JSON

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

--read-only

    Určuje, jestli je externí umístění jen pro čtení.

--skip-validation

    Přeskočí ověření přihlašovacích údajů úložiště, které jsou spojeny s externím umístěním.

Globální příznaky

Examples

Následující příklad vytvoří externí umístění s komentářem:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

Následující příklad vytvoří externí umístění jen pro čtení:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

Odstranit externí umístění na platformě Databricks

Odstraňte určené externí umístění z databáze metadat. Volající musí být vlastníkem externího umístění.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Název externího umístění

Možnosti

--force

    Vynutit odstranění i v případě, že existují závislé externí tabulky nebo připojení.

Globální příznaky

Examples

Následující příklad odstraní externí umístění s názvem my-external-location:

databricks external-locations delete my-external-location

Následující příklad vynuceně odstraní externí umístění, i když existují závislosti:

databricks external-locations delete my-external-location --force

Získání externích lokalit v Databricks

Získejte externí umístění z metastore. Volající musí být správcem metastoru, vlastníkem externího umístění nebo uživatelem, který má určité oprávnění k externímu umístění.

databricks external-locations get NAME [flags]

Arguments

NAME

    Název externího umístění

Možnosti

--include-browse

    Určuje, zda v odpovědi mají být zahrnuty externí umístění, ke kterým může subjekt přistupovat pouze k vybraným metadatovým informacím.

Globální příznaky

Examples

Následující příklad získá informace o externím umístění s názvem my-external-location:

databricks external-locations get my-external-location

Následující příklad získá informace včetně metadat prohlížení:

databricks external-locations get my-external-location --include-browse

Seznam externích umístění Databricks

Výpis externích umístění z metastoru Volající musí být správcem metastoru, vlastníkem externího umístění nebo uživatelem, který má určité oprávnění k externímu umístění. Neexistuje žádná záruka konkrétního řazení prvků v poli.

databricks external-locations list [flags]

Možnosti

--include-browse

    Určuje, zda v odpovědi mají být zahrnuty externí umístění, ke kterým může subjekt přistupovat pouze k vybraným metadatovým informacím.

--include-unbound

    Zda zahrnout externí umístění, která nejsou svázaná s pracovním prostorem.

--max-results int

    Maximální počet externích míst, která mají být vrácena.

--page-token string

    Neprůznamný token stránkování, který přejde 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 externích umístění:

databricks external-locations list

Následující příklad uvádí externí lokace s maximálně 10 výsledky.

databricks external-locations list --max-results 10

Aktualizace externích umístění Databricks

Aktualizujte externí umístění v metastoru. Volající musí být vlastníkem externího umístění nebo správcem metastoru. V druhém případě může správce aktualizovat pouze název externího umístění.

databricks external-locations update NAME [flags]

Arguments

NAME

    Název externího umístění

Možnosti

--comment string

    Popis bezplatného textu poskytnutého uživatelem

--credential-name string

    Název přihlašovacích údajů úložiště, které se používají s tímto umístěním.

--enable-file-events

    Určuje, jestli chcete povolit události souborů v tomto externím umístění.

--fallback

    Určuje, jestli je pro toto externí umístění povolený záložní režim.

--force

    Vynuťte aktualizaci i v případě, že změna adresy URL zneplatní závislé externí tabulky nebo připojení.

--isolation-mode IsolationMode

    Podporované hodnoty: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

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

--new-name string

    Nový název externího umístění

--owner string

    Vlastník externího umístění.

--read-only

    Určuje, jestli je externí umístění jen pro čtení.

--skip-validation

    Přeskočí ověření přihlašovacích údajů úložiště, které jsou spojeny s externím umístěním.

--url string

    Adresa URL cesty externího umístění

Globální příznaky

Examples

Následující příklad přejmenuje externí umístění:

databricks external-locations update my-external-location --new-name my-renamed-location

Následující příklad změní vlastníka externího úložiště:

databricks external-locations update my-external-location --owner someone@example.com

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 pro zápis výstupních protokolů do. 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 nebo textjson. 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 nebo textjson. 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 název DEFAULT profilu, 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 možné, cíl sady prostředků, který se má použít