Základní použití rozhraní příkazového řádku Databricks
Poznámka:
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í.
V tomto článku se dozvíte, jak vypsat skupiny příkazů a příkazy rozhraní příkazového řádku Databricks, zobrazit nápovědu k rozhraní příkazového řádku Databricks a pracovat s výstupem rozhraní příkazového řádku Databricks. Podívejte se, co je rozhraní příkazového řádku Databricks?
Tento článek předpokládá, že jste už nainstalovali Rozhraní příkazového řádku Databricks a nastavili rozhraní příkazového řádku pro ověřování. Viz Instalace nebo aktualizace rozhraní příkazového řádku Databricks a ověřování pro Rozhraní příkazového řádku Databricks.
Výpis skupin příkazů rozhraní příkazového řádku
Skupiny příkazů zobrazíte pomocí --help nebo -h možnosti. Příklad:
databricks -h
Výpis příkazů rozhraní příkazového řádku
Příkazy pro libovolnou skupinu příkazů zobrazíte pomocí --help možnosti nebo -h příkazu. Pokud chcete například zobrazit seznam clusters příkazů:
databricks clusters -h
Zobrazení nápovědy k příkazu rozhraní příkazového řádku
Nápovědu k příkazu zobrazíte pomocí --help možnosti nebo -h příkazu. Pokud chcete například zobrazit nápovědu clusters list pro příkaz:
databricks clusters list -h
Spuštění příkazu
Kompletní informace o použití a syntaxi jednotlivých příkazů najdete v nápovědě k příkazovému řádku, ale příkazy rozhraní příkazového řádku Databricks obecně odpovídají následující syntaxi:
databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]
Ne každý příkaz má další podpříkazy. K dispozici jsou globální příznaky a některé příkazy mají další příznaky. Například následující příkaz vypíše dostupné clustery pomocí příznaku specifického pro příkaz:
databricks clusters list --can-use-client JOBS
Tip
Příkazy rozhraní příkazového řádku Databricks můžete spouštět z pracovního prostoru Databricks pomocí webového terminálu. Webový terminál může používat mnoho uživatelů na jednom výpočetním prostředí a nevyžaduje nastavení klíčů. Viz příkazy run shellu ve webovém terminálu Azure Databricks.
Slouží jq k filtrování výstupu JSON.
Některé příkazy rozhraní příkazového řádku Databricks výstup JSON, což znamená, že výstup můžete filtrovat pomocí jq . Pokud například chcete zobrazit jenom zobrazovaný název clusteru Azure Databricks se zadaným ID clusteru:
databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name
My-11.3-LTS-Cluster
Na macOS můžete nainstalovat jq homebrew s brew install jq windows nebo ve Windows pomocí Chocolatey s choco install jq. Další informace o nástroji jq najdete v příručce k nástroji jq.
Parametry řetězců JSON
Formát parametrů řetězce se zpracovává jinak ve formátu JSON v závislosti na vašem operačním systému:
Linux nebo macOS
Parametry řetězce JSON musíte uzavřít do dvojitých uvozovek a musíte uzavřít celou datovou část JSON do jednoduchých uvozovek. Některé příklady:
'{"cluster_id": "1234-567890-abcde123"}'
'["20230323", "Amsterdam"]'
Windows
Parametry řetězce JSON a celou datovou část JSON musíte uzavřít do dvojitých uvozovek a před znaky s dvojitou uvozovkou uvnitř datové části \JSON. Některé příklady:
"{\"cluster_id\": \"1234-567890-abcde123\"}"
"[\"20230323\", \"Amsterdam\"]"
Konfigurace proxy serveru
Pokud chcete směrovat požadavky a odpovědi rozhraní příkazového řádku Databricks prostřednictvím proxy serveru, nastavte HTTPS_PROXY proměnnou prostředí na počítači, kde je rozhraní příkazového řádku Databricks nainstalované na adresu URL proxy serveru.
Pokud chcete nastavit proměnné prostředí, přečtěte si dokumentaci k vašemu operačnímu systému.