Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Note
Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve verzi Public Preview.
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 volumes příkazů v rozhraní příkazového řádku Databricks obsahuje příkazy pro správu svazků v katalogu Unity. Svazky poskytují funkce pro přístup k souborům, jejich ukládání, řízení, uspořádání a zpracování. Viz Co jsou svazky katalogu Unity?.
Databricks svazky vytvořte
Vytvořte nový svazek.
Uživatel může vytvořit externí svazek nebo spravovaný svazek. Externí svazek se vytvoří v zadaném externím umístění, zatímco spravovaný svazek bude umístěn ve výchozím umístění určeném nadřazeným schématem nebo nadřazeným katalogem nebo metastorem.
Aby bylo vytvoření svazku úspěšné, musí uživatel splňovat následující podmínky:
- Volající musí být správcem metastoru nebo vlastníkem nadřazeného katalogu a schématu nebo musí mít
USE_CATALOGoprávnění pro nadřazený katalog aUSE_SCHEMAoprávnění nadřazeného schématu. - Volající musí mít
CREATE VOLUMEoprávnění k nadřazenému schématu.
U externího svazku musí být splněny také následující podmínky:
- Volající musí mít
CREATE EXTERNAL VOLUMEoprávnění k externímu umístění. - V zadaném umístění úložiště neexistují žádné jiné tabulky ani svazky. – Zadané umístění úložiště není pod umístěním jiných tabulek, ani svazků ani katalogů nebo schémat.
databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]
Arguments
CATALOG_NAME
Název katalogu, kde je schéma a svazek
SCHEMA_NAME
Název schématu, ve kterém je svazek
NAME
Název svazku
VOLUME_TYPE
Typ svazku. Externí svazek se nachází v zadaném externím umístění. Spravovaný svazek se nachází ve výchozím umístění určeném nadřazeným schématem nebo nadřazeným katalogem nebo metastorem. Viz Spravované a externí svazky. Podporované hodnoty: EXTERNAL, MANAGED
Možnosti
--comment string
Komentář připojený ke svazku.
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--storage-location string
Umístění úložiště v cloudu.
Examples
Následující příklad vytvoří spravovaný svazek:
databricks volumes create my_catalog my_schema my_volume MANAGED
Následující příklad vytvoří externí svazek s komentářem:
databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"
Odstraňte svazky Databricks
Odstraňte svazek ze zadaného nadřazeného katalogu a schématu.
Volající musí být správcem úložiště metadat nebo vlastníkem svazku. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.
databricks volumes delete NAME [flags]
Arguments
NAME
Tříúrovňový (plně kvalifikovaný) název svazku
Možnosti
Examples
Následující příklad odstraní svazek:
databricks volumes delete my_catalog.my_schema.my_volume
Seznam svazků Databricks
Seznamte svazky pro aktuální metastor pod nadřazeným katalogem a schématem.
Vrácené objemy jsou filtrovány na základě oprávnění volajícího uživatele. Správce metastoru může například zobrazit seznam všech svazků. Běžný uživatel musí být vlastníkem nebo mít oprávnění READ VOLUME ke svazku, aby mohl obdržet svazky v odpovědi. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.
Neexistuje žádná záruka konkrétního řazení prvků v poli.
databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]
Arguments
CATALOG_NAME
Identifikátor katalogu
SCHEMA_NAME
Identifikátor schématu
Možnosti
--include-browse
Zda zahrnout do odpovědi svazky, ke kterým může hlavní uživatel přistupovat pouze k selektivním metadatům.
--max-results int
Maximální počet svazků, které se mají vrátit (délka stránky).
--page-token string
Neprůhledný token vrácený předchozím požadavkem.
Examples
Následující příklad uvádí všechny svazky v katalogu a schématu:
databricks volumes list my_catalog my_schema
Čtení svazků Databricks
Získejte svazek z metastoru pro konkrétní katalog a schéma.
Volající musí být správcem metastoru nebo vlastníkem svazku (nebo mít READ VOLUME oprávnění). V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.
databricks volumes read NAME [flags]
Arguments
NAME
Tříúrovňový (plně kvalifikovaný) název svazku
Možnosti
--include-browse
Zda zahrnout do odpovědi svazky, ke kterým může hlavní uživatel přistupovat pouze k selektivním metadatům.
Examples
Následující příklad získá informace o svazku:
databricks volumes read my_catalog.my_schema.my_volume
Následující příklad získá informace o svazku včetně metadat procházení:
databricks volumes read my_catalog.my_schema.my_volume --include-browse
Aktualizace svazků Databricks
Aktualizujte zadaný svazek v rámci zadaného nadřazeného katalogu a schématu.
Volající musí být správcem úložiště metadat nebo vlastníkem svazku. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.
V současné době je možné aktualizovat pouze jméno, vlastník nebo komentář svazku.
databricks volumes update NAME [flags]
Arguments
NAME
Tříúrovňový (plně kvalifikovaný) název svazku
Možnosti
--comment string
Komentář připojený ke svazku.
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--new-name string
Nový název svazku
--owner string
Identifikátor uživatele, kterému patří svazek.
Examples
Následující příklad aktualizuje komentář ke svazku:
databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"
Následující příklad změní vlastníka svazku:
databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com
Následující příklad přejmenuje svazek:
databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name
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