configure grupa poleceń
Uwaga
Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs CLI 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 poleceń configure w interfejsie wiersza poleceń Databricks CLI umożliwia uwierzytelnianie dla Azure Databricks za pomocą osobistych tokenów dostępu Azure Databricks lub tokenów Microsoft Entra ID (dawniej Azure Active Directory).
Uwaga
Najlepsza praktyka w zakresie zabezpieczeń polega na tym, aby przy uwierzytelnianiu za pomocą zautomatyzowanych narzędzi, systemów, skryptów i aplikacji, Databricks zalecał używanie osobistych tokenów dostępu należących do jednostek usługi zamiast użytkowników przestrzeni roboczych. 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.
Ważne
Przed uruchomieniem tego polecenia upewnij się, że skonfigurowałeś interfejs wiersza polecenia usługi Databricks.
Uruchamiasz polecenia configure, dołączając je do databricks configure. 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 configure w następujący sposób:
databricks configure --host <workspace-url>
W polu <workspace-url> wprowadź adres URL konkretnego 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 prosi o wprowadzenie osobistego tokenu dostępu usługi Azure Databricks lub tokenu Microsoft Entra ID (dawniej Azure Active Directory), który odpowiada określonemu <workspace-url>.
✔ 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ąć Tab po --profile lub -p, aby 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.
Na przykład możesz mieć profil połączenia nazwany DEV, który odwołuje się do obszaru roboczego usługi Azure Databricks używanego na potrzeby obciążeń programistycznych, oraz oddzielny profil połączenia nazwany PROD, 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.