Podstawowe użycie interfejsu wiersza polecenia usługi Databricks

Uwaga

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej, które są dostępne w publicznej wersji zapoznawczej. Aby znaleźć swoją wersję interfejsu wiersza polecenia usługi Databricks, uruchom polecenie databricks -v.

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?.

W tym artykule założono, że masz już zainstalowany interfejs wiersza polecenia usługi Databricks i skonfigurowano interfejs wiersza polecenia na potrzeby uwierzytelniania. 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

Grupy poleceń można wyświetlić przy użyciu --help opcji lub -h . Na przykład:

databricks -h

Wyświetlanie listy poleceń interfejsu wiersza polecenia

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

databricks clusters -h

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

Zostanie wyświetlona pomoc dla polecenia przy użyciu --help opcji lub -h . Aby na przykład wyświetlić pomoc dla clusters list polecenia:

databricks clusters list -h

Uruchamianie polecenia

Pełne informacje o użyciu i składni poszczególnych poleceń można znaleźć w pomocy wiersza polecenia, 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 narzędzia jq, zobacz Podręcznik dotyczący 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 znakiem \. 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.