configure grupa poleceń

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.

Grupa configure poleceń w interfejsie wiersza polecenia usługi Databricks umożliwia uwierzytelnianie interfejsu wiersza polecenia usługi Databricks za pomocą usługi Azure Databricks przy użyciu osobistych tokenów dostępu usługi Azure Databricks lub tokenów microsoft Entra ID (dawniej Azure Active Directory).

Uwaga

Najlepszym rozwiązaniem w zakresie zabezpieczeń w przypadku uwierzytelniania za pomocą zautomatyzowanych narzędzi, systemów, skryptów i aplikacji usługa Databricks zaleca używanie osobistych tokenów dostępu należących do jednostek usługi zamiast użytkowników obszaru roboczego. Aby utworzyć tokeny dla jednostek usługi, zobacz Zarządzanie tokenami dla jednostki usługi.

Należy pamiętać, że w tym artykule opisano tylko osobisty token dostępu usługi Azure Databricks i uwierzytelnianie tokenu Entra ID firmy Microsoft umożliwiające wywoływanie poleceń na poziomie obszaru roboczego. Aby uzyskać dodatkowe opcje konfiguracji uwierzytelniania, zobacz Authentication for the Databricks CLI (Uwierzytelnianie dla interfejsu wiersza polecenia usługi Databricks).

Ważne

Przed uruchomieniem tego polecenia należy skonfigurować interfejs wiersza polecenia usługi Databricks.

configure Uruchamiasz polecenia, dołączając je do databricks configureelementu . Aby wyświetlić pomoc dotyczącą configure polecenia, uruchom polecenie databricks configure -h.

Tworzenie profilu konfiguracji

Profil konfiguracji to kolekcja ustawień, które zawierają informacje o uwierzytelnianiu, takie jak adres URL obszaru roboczego usługi Azure Databricks i wartość tokenu dostępu. Profil konfiguracji ma nazwę programową, taką jak DEFAULT, DEVlub PROD.

Aby utworzyć profil konfiguracji, uruchom polecenie w configure następujący sposób:

databricks configure --host <workspace-url>

W polu <workspace-url>wprowadź adres URL obszaru roboczego w formacie https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Aby uzyskać adres URL dla obszaru roboczego, zobacz Adres URL poszczególnych obszarów roboczych.

Polecenie wyświetla monit o wprowadzenie osobistego tokenu dostępu usługi Azure Databricks lub tokenu Microsoft Entra ID (dawniej Azure Active Directory) mapowania na określony <workspace-url>element :

✔ Databricks Token:

Po wprowadzeniu tokenu dostępu token dostępu jest przechowywany w pliku ~/.databrickscfg w systemie Linux lub macOS lub %USERPROFILE%\.databrickscfg w systemie Windows domyślnie. Plik zawiera domyślny wpis profilu połączenia o nazwie DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Aby użyć innej nazwy profilu połączenia zamiast DEFAULT, dodaj --profile opcję do configure polecenia, na przykład:

databricks configure --host <workspace-url> --profile <profile-name>

Napiwek

Możesz nacisnąć przycisk Tab po --profile lub -p wyświetlić listę istniejących dostępnych profilów konfiguracji do wyboru, zamiast ręcznie wprowadzać nazwę profilu konfiguracji.

Wszystkie istniejące informacje o hoście i tokenie w określonym profilu połączenia zostaną zastąpione nowymi informacjami o hoście i tokenie.

Dodanie wielu profilów połączeń do .databrickscfg pliku umożliwia szybkie uruchamianie poleceń w różnych obszarach roboczych przez określenie nazwy docelowego profilu połączenia w opcji polecenia --profile . Jeśli nie określisz --profile opcji w poleceniu, które obsługuje tę opcję, polecenie będzie domyślnie używać DEFAULT profilu połączenia.

Możesz na przykład mieć profil połączenia o nazwie, który odwołuje się do obszaru roboczego usługi Azure Databricks używanego na potrzeby obciążeń programistycznych i oddzielnego profilu połączenia o nazwie DEV PROD profil połączenia, który odwołuje się do innego obszaru roboczego usługi Azure Databricks używanego na potrzeby obciążeń produkcyjnych.

Możesz zmienić domyślną ścieżkę tego .databrickscfg pliku, ustawiając zmienną środowiskową DATABRICKS_CONFIG_FILE. Aby dowiedzieć się, jak ustawić zmienne środowiskowe, zobacz dokumentację systemu operacyjnego.

Aby uzyskać informacje o istniejących profilach konfiguracji, użyj grupy poleceń uwierzytelniania.