Udostępnij za pośrednictwem

Profile konfiguracji interfejsu wiersza polecenia usługi Databricks

  • Artykuł

Uwaga

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej, które są dostępne w publicznej wersji zapoznawczej. Aby znaleźć swoją wersję interfejsu wiersza polecenia usługi Databricks, uruchom polecenie databricks -v.

W tym artykule opisano sposób konfigurowania uwierzytelniania między interfejsem wiersza polecenia usługi Databricks a kontami i obszarami roboczymi usługi Azure 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:

Uzyskiwanie informacji o profilach konfiguracji

Dodanie wielu profilów konfiguracji do .databrickscfg pliku umożliwia szybkie uruchamianie poleceń w różnych obszarach roboczych przez określenie nazwy docelowego profilu konfiguracji w --profile poleceniu lub -p opcji dla tych poleceń, które obsługują tę opcję. Jeśli nie określisz --profile opcji lub -p w poleceniu, które obsługuje tę opcję, polecenie domyślnie użyje DEFAULT profilu konfiguracji.

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.

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. Możesz zmienić domyślną ścieżkę .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ącym profilu konfiguracji, uruchom auth env polecenie:

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": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

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

databricks auth profiles

Dane wyjściowe (wielokropek reprezentuje pominiętą zawartość dla zwięzłości):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

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 konfiguracji DOMYŚLNEj konfiguracji

Aby sprawdzić, czy prawidłowo skonfigurowano uwierzytelnianie, możesz uruchomić polecenie, takie jak poniżej, które zawiera listę dostępnych wersji środowiska Databricks Runtime dla obszaru roboczego usługi Azure Databricks skojarzonego z DEFAULT profilem.

Poniższe wywołanie zakłada, że nie masz żadnego specjalnego zestawu 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

Testowanie profilów konfiguracji

Aby sprawdzić, czy poprawnie skonfigurować profile konfiguracji, możesz uruchomić polecenie, takie jak następujące z jedną z nazw profilów konfiguracji na poziomie obszaru roboczego. To polecenie wyświetla listę dostępnych wersji środowiska Databricks Runtime dla obszaru roboczego usługi Azure Databricks skojarzonego z określonym profilem konfiguracji reprezentowanym tutaj przez symbol zastępczy <configuration-profile-name>:

databricks clusters spark-versions -p <configuration-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.

Aby wyświetlić szczegóły określonego profilu, uruchom następujące polecenie:

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

Aby wyświetlić szczegóły wszystkich dostępnych profilów, uruchom następujące polecenie:

databricks auth profiles