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. Interfejs wiersza polecenia usługi Databricks jest w publicznej wersji zapoznawczej.
Korzystanie z interfejsu wiersza polecenia usługi Databricks podlega licencjom usługi Databricks i powiadomieniom o ochronie prywatności usługi Databricks, w tym wszelkim przepisom dotyczącym danych użycia.
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
Napiwek
Polecenia interfejsu wiersza polecenia usługi Databricks można uruchamiać z poziomu obszaru roboczego usługi Databricks przy użyciu terminalu internetowego. Terminal internetowy może być używany przez wielu użytkowników w jednym środowisku obliczeniowym i nie wymaga konfigurowania kluczy. Zobacz Uruchamianie poleceń powłoki w terminalu internetowym usługi Azure Databricks.
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.