Profile konfiguracji dla interfejsu wiersza polecenia Databricks

Uwaga

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 opisano sposób używania interfejsu wiersza polecenia usługi Databricks z profilami konfiguracji. Przyjęto założenie, że interfejs wiersza polecenia usługi Databricks został już zainstalowany i utworzono plik profilów konfiguracji usługi Databricks. Zobacz Instalowanie lub aktualizowanie interfejsu wiersza polecenia usługi Databricks i profilów konfiguracji usługi Azure Databricks.

Uzyskiwanie informacji o profilach konfiguracji

Dodanie wielu profilów konfiguracji do pliku .databrickscfg umożliwia szybkie uruchamianie poleceń w różnych obszarach roboczych przez określenie nazwy docelowego profilu konfiguracji we fladze --profile lub -p polecenia. Jeśli nie określisz profilu, interfejs wiersza polecenia wybierze go w następującej kolejności:

  1. Zmienna DATABRICKS_CONFIG_PROFILE środowiskowa, jeśli jest ustawiona.
  2. Ustawienie default_profile w [__settings__] sekcji .databrickscfg, jeśli istnieje. Można to ustawić za pomocą polecenia databricks auth switch. Zobacz databricks auth switch.
  3. Profil DEFAULT.

Wskazówka

Możesz nacisnąć Tab po --profile lub -p, aby wyświetlić listę istniejących dostępnych profilów konfiguracji, z których chcesz wybrać.

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

Domyślnie interfejs wiersza poleceń Databricks szuka pliku .databrickscfg w folderze ~ (domowym folderze użytkownika) w systemach Unix, Linux i macOS lub w folderze %USERPROFILE% (domowym folderze użytkownika) w systemie Windows. Aby zmienić domyślną ścieżkę pliku .databrickscfg, ustaw zmienną środowiskową DATABRICKS_CONFIG_FILE na inną ścieżkę. Zobacz pola specyficzne dla platformy .databrickscfg.

Aby uzyskać informacje o istniejącym profilu konfiguracji, uruchom polecenie auth describe:

databricks auth describe --profile <configuration-profile-name>

Na przykład poniżej przedstawiono dane wyjściowe profilu skonfigurowanego przy użyciu uwierzytelniania osobistego tokenu dostępu usługi Azure Databricks:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Uwaga

Polecenie auth env jest przestarzałe. Użyj databricks auth describe, aby sprawdzić konfigurację profilu, lub databricks auth token, aby pobrać token dostępu OAuth z pamięci podręcznej.

Aby uzyskać informacje o wszystkich dostępnych profilach, uruchom polecenie auth profiles:

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

Dane wyjściowe auth profiles polecenia nie wyświetlają żadnych tokenów dostępu. Aby wyświetlić szczegóły tokenu dla określonego profilu, uruchom polecenie databricks auth describe --profile <profile-name> lub databricks auth token --profile <profile-name>.

Ważne

Interfejs wiersza poleceń Databricks nie działa z plikiem .netrc. Możesz mieć .netrc plik w swoim środowisku do innych celów, ale interfejs wiersza polecenia usługi Databricks nie będzie używać tego .netrc pliku.

Testowanie profilów konfiguracji

Aby przetestować profile konfiguracji i sprawdzić, czy prawidłowo skonfigurowaliśmy uwierzytelnianie, uruchom polecenie łączące się z obszarem roboczym.

Jeśli nie określisz profilu, zostanie użyty profil domyślny. Na przykład następujące polecenie wyświetla listę dostępnych wersji środowiska Databricks Runtime dla obszaru roboczego usługi Azure Databricks skojarzonego z profilem DEFAULT.

Uwaga

To polecenie zakłada, że nie masz żadnych zmiennych środowiskowych, które mają pierwszeństwo przed ustawieniami w profilu DEFAULT. Aby uzyskać więcej informacji, zobacz Kolejność uwierzytelniania oceny.

databricks clusters spark-versions

Aby zweryfikować określony profil konfiguracji, podaj nazwę profilu przy użyciu flagi -p.

databricks clusters spark-versions -p PROD
  • Last updated on