Podstawowe użycie interfejsu wiersza polecenia usługi Databricks

W tym artykule pokazano, jak wyświetlić listę grup poleceń i poleceń interfejsu wiersza polecenia usługi Databricks , wyświetlić pomoc interfejsu wiersza polecenia usługi Databricks i pracować z danymi wyjściowymi interfejsu wiersza polecenia usługi Databricks. Zobacz Co to jest interfejs wiersza polecenia usługi Databricks?.

Ten artykuł zakłada, że CLI dla usługi Databricks został już zainstalowany i skonfigurowano uwierzytelnianie dla CLI. Zobacz Instalowanie lub aktualizowanie interfejsu wiersza polecenia usługi Databricks i uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks.

Wyświetlanie listy grup poleceń interfejsu wiersza polecenia

Aby wyświetlić listę dostępnych grup poleceń wiersza polecenia, użyj opcji --help lub -h, na przykład:

databricks -h

Lista poleceń CLI

Aby wyświetlić listę poleceń dla dowolnej grupy poleceń, użyj --help opcji lub -h . Aby na przykład wyświetlić listę poleceń clusters:

databricks clusters -h

Wyświetlanie pomocy dotyczącej poleceń interfejsu wiersza polecenia

Aby wyświetlić informacje o użyciu polecenia, użyj opcji --help albo -h wraz z poleceniem. Aby na przykład wyświetlić pomoc dla clusters list polecenia:

databricks clusters list -h

Dostępne jest również odwołanie do poleceń. Zobacz Polecenia CLI Databricks.

Uruchamianie polecenia

Pełne informacje o użyciu i składnia poszczególnych poleceń można znaleźć w pomocy wiersza polecenia i dokumentacji, ale polecenia interfejsu wiersza polecenia usługi Databricks są ogólnie zgodne z następującą składnią:

databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]

Nie każde polecenie ma dodatkowe polecenia podrzędne. Dostępne są flagi globalne, a niektóre polecenia mają dodatkowe flagi. Na przykład następujące polecenie zwraca dostępne klastry przy użyciu flagi specyficznej dla polecenia:

databricks clusters list --can-use-client JOBS

Użyj jq polecenia , aby filtrować dane wyjściowe JSON

Niektóre polecenia interfejsu wiersza polecenia usługi Databricks wyświetlają dane JSON, co oznacza, że do filtrowania danych wyjściowych można użyć języka jq . Aby na przykład wyświetlić tylko nazwę wyświetlaną klastra usługi Azure Databricks o określonym identyfikatorze klastra:

databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name

My-11.3-LTS-Cluster

Instalację w systemie macOS można zainstalować jq przy użyciu oprogramowania Homebrew z brew install jq systemem Windows lub w systemie Windows przy użyciu narzędzia Chocolatey z choco install jqprogramem . Aby uzyskać więcej informacji na temat jq, zapoznaj się z podręcznikiem jq.

Parametry ciągu JSON

Format parametrów ciągu jest obsługiwany inaczej w formacie JSON w zależności od systemu operacyjnego:

Linux lub macOS

Parametry ciągu JSON należy ująć w cudzysłów podwójnych, a cały ładunek JSON należy ująć w cudzysłów pojedynczych. Kilka przykładów:

'{"cluster_id": "1234-567890-abcde123"}'

'["20230323", "Amsterdam"]'

Windows

Należy ująć parametry ciągu JSON i cały ładunek JSON w podwójny cudzysłów, a znaki podwójnego cudzysłowu wewnątrz ładunku JSON muszą być poprzedzone \. Kilka przykładów:

"{\"cluster_id\": \"1234-567890-abcde123\"}"

"[\"20230323\", \"Amsterdam\"]"

Konfiguracja serwera proxy

Aby kierować żądania interfejsu wiersza polecenia usługi Databricks i odpowiedzi za pośrednictwem serwera proxy, ustaw HTTPS_PROXY zmienną środowiskową na maszynie, na której jest zainstalowany interfejs wiersza polecenia usługi Databricks, na adres URL serwera proxy.

Aby ustawić zmienne środowiskowe, zapoznaj się z dokumentacją systemu operacyjnego.