Sdílet prostřednictvím


storage-credentials 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 storage-credentials příkazů v rozhraní příkazového řádku Databricks obsahuje příkazy pro správu přihlašovacích údajů ke skladování v Unity Catalogu. Přihlašovací údaje úložiště představují mechanismus ověřování a autorizace pro přístup k datům uloženým ve vašem cloudovém tenantovi. Každé přihlašovací údaje úložiště podléhají zásadám řízení přístupu katalogu Unity, které určují, kteří uživatelé a skupiny mají přístup k přihlašovacím údajům. Pokud uživatel nemá přístup k pověření úložiště v katalogu Unity, požadavek selže a Unity Catalog se nepokusí ověřit váš cloudový tenant jménem uživatele. Podívejte se na správu úložných přihlašovacích údajů.

Vytvoření přihlašovacích údajů úložiště databricks

Vytvořte nové přihlašovací údaje úložiště.

Volající musí být správcem metastoru nebo musí mít CREATE_STORAGE_CREDENTIAL oprávnění k metastoru.

databricks storage-credentials create NAME [flags]

Arguments

NAME

    Název přihlašovacích údajů. Název musí být jedinečný mezi přihlašovacími údaji úložiště a služby v rámci metadatového úložiště.

Možnosti

--comment string

    Komentář přidružený k přihlašovacím údajům

--json JSON

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

--read-only

    Určuje, jestli je přihlašovací údaje použitelné jenom pro operace čtení.

--skip-validation

    Zadání true pro tento argument přeskočí ověření vytvořených přihlašovacích údajů.

Globální příznaky

Examples

Následující příklad vytvoří nové přihlašovací údaje úložiště:

databricks storage-credentials create my-storage-credential

Následující příklad vytvoří přihlašovací údaje úložiště s komentářem:

databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"

Následující příklad vytvoří přihlašovací údaje úložiště jen pro čtení:

databricks storage-credentials create my-storage-credential --read-only

Odstranění přihlašovacích údajů úložiště databricks

Odstraňte přihlašovací údaje úložiště z metastoru. Volající musí být vlastníkem přihlašovacích údajů úložiště.

databricks storage-credentials delete NAME [flags]

Arguments

NAME

    Název přihlašovacích údajů úložiště.

Možnosti

--force

    Vynutit aktualizaci i v případě, že existují závislá externí umístění nebo externí tabulky (pokud je STORAGE účel) nebo závislé služby (pokud je SERVICE účel).

Globální příznaky

Examples

Následující příklad odstraní přihlašovací údaje úložiště:

databricks storage-credentials delete my-storage-credential

Následující příklad nuceně odstraní přihlašovací údaje úložiště:

databricks storage-credentials delete my-storage-credential --force

Získání přihlašovacích údajů úložiště databricks

Získejte přihlašovací údaje úložiště z metastoru. Volající musí být správcem metastoru, vlastníkem oprávnění k úložišti nebo mít nějaké oprávnění k úložišti.

databricks storage-credentials get NAME [flags]

Arguments

NAME

    Název přihlašovacích údajů úložiště.

Možnosti

Globální příznaky

Examples

Následující příklad získá informace o přihlašovacích údaji úložiště:

databricks storage-credentials get my-storage-credential

Seznam úložných pověření pro databricks

Výpis přihlašovacích údajů k úložišti Seznam je omezen pouze na přihlašovací údaje úložiště, ke kterému má volající oprávnění. Pokud je volající správcem metastoru, načtení přihlašovacích údajů je neomezené. Neexistuje žádná záruka konkrétního řazení prvků v poli.

databricks storage-credentials list [flags]

Možnosti

--max-results int

    Maximální počet přihlašovacích údajů úložiště k vrácení.

--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 přihlašovacích údajů úložiště:

databricks storage-credentials list

Aktualizace přihlašovacích údajů úložiště databricks

Aktualizujte přihlašovací údaje úložiště v metastoru.

Volající musí být vlastníkem přihlašovacích údajů úložiště nebo správce metastoru. Pokud je volající správcem metastoru owner , je možné změnit pouze pole.

databricks storage-credentials update NAME [flags]

Arguments

NAME

    Název přihlašovacích údajů úložiště.

Možnosti

--comment string

    Komentář přidružený k přihlašovacím údajům

--force

    Vynuťte aktualizaci i v případě, že existují závislé externí lokace nebo externí tabulky.

--isolation-mode IsolationMode

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

--json JSON

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

--new-name string

    Nový název přihlašovacích údajů úložiště

--owner string

    Uživatelské jméno aktuálního vlastníka přihlašovacích údajů

--read-only

    Určuje, jestli je přihlašovací údaje použitelné jenom pro operace čtení.

--skip-validation

    Zadání true pro tento argument přeskočí ověření aktualizovaných přihlašovacích údajů.

Globální příznaky

Examples

Následující příklad aktualizuje komentář k přihlašovacím údajům úložiště:

databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"

Následující příklad změní vlastníka přihlašovacích údajů úložiště:

databricks storage-credentials update my-storage-credential --owner someone@example.com

Následující příklad přejmenuje přihlašovací údaje úložiště:

databricks storage-credentials update my-storage-credential --new-name updated-credential

Ověřit přihlašovací údaje úložiště Databricks

Ověřte přihlašovací údaje úložiště. Aspoň jeden z external_location_name nebo url musí být poskytnut. Pokud je k dispozici pouze jeden z nich, použije se k ověření. A pokud jsou k dispozici obojí, url použije se k ověření a external_location_name při kontrole překrývajících se adres URL se bude ignorovat.

Musí být zadány buď storage_credential_name, nebo přihlašovací údaje specifické pro cloud.

Volající musí být správcem metastoru nebo vlastníkem přihlašovacích údajů úložiště nebo mít CREATE_EXTERNAL_LOCATION oprávnění k metastoru a přihlašovacím údajům úložiště.

databricks storage-credentials validate [flags]

Možnosti

--external-location-name string

    Název existujícího externího umístění, které je třeba ověřit.

--json JSON

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

--read-only

    Určuje, jestli je přihlašovací údaje úložiště použitelné jenom pro operace čtení.

--storage-credential-name string

    Required.

--url string

    Adresa URL externího umístění, která se má ověřit.

Globální příznaky

Examples

Následující příklad ověří přihlašovací údaje úložiště pro externí umístění:

databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location

Následující příklad ověří přihlašovací údaje úložiště na adrese URL:

databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path

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