Profile konfiguracji 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 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 poprzez określenie nazwy docelowego profilu konfiguracji w fladze --profile lub -p polecenia. Jeśli nie zostanie określony, zostanie użyty profil konfiguracji DEFAULT.

Napiwek

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 polecenia usługi Databricks wyszukuje .databrickscfg plik w folderze (strona główna użytkownika) w ~ systemach Unix, Linux lub macOS lub folderze %USERPROFILE% (strona główna użytkownika) w systemie Windows. Aby zmienić domyślną ścieżkę pliku .databrickscfg, ustaw zmienną środowiskową DATABRICKS_CONFIG_FILE na inną ścieżkę. Zobacz specyficzne zmienne środowiskowe i pola dla .databrickscfg.

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

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

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

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

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

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ć token dostępu, uruchom poprzednie auth env polecenie.

Ważne

Interfejs wiersza polecenia usługi 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