configure polecenie

Note

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs CLI Databricks jest w publicznej wersji testowej.

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.

Polecenie configure 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).

Note

Najlepsza praktyka w zakresie zabezpieczeń zalecana przez Databricks w przypadku uwierzytelniania za pomocą zautomatyzowanych narzędzi, systemów, skryptów i aplikacji to 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.

Konfigurowanie usługi databricks

Skonfiguruj profil w ~/.databrickscfg pliku. 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. Dodanie wielu profilów 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.

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

Możesz zmienić domyślną ścieżkę .databrickscfg pliku, ustawiając zmienną środowiskową DATABRICKS_CONFIG_FILE.

Jeśli to polecenie jest wywoływane w trybie nieinterakcyjnym, odczytuje token ze stdin. Host musi być określony z flagą --host lub zmienną środowiskową DATABRICKS_HOST .

databricks configure [flags]

Opcje

--configure-cluster

    Komunikaty do skonfigurowania klastra

--host string

    Adres URL serwera obszaru roboczego usługi Databricks

Adres URL hosta obszaru roboczego to indywidualny adres URL przypisany do każdego obszaru roboczego z formatem https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Aby uzyskać adres URL dla poszczególnego obszaru roboczego, zobacz Adres URL poszczególnych obszarów roboczych.

--profile string

    Nazwa profilu połączenia do skonfigurowania. (domyślne "DEFAULT")

Flagi globalne

Examples

W poniższym przykładzie uwierzytelnianie jest konfigurowane dla profilu domyślnego:

databricks configure

W poniższym przykładzie uwierzytelnianie jest konfigurowane dla określonego profilu:

databricks configure --profile my-profile

W poniższym przykładzie uwierzytelnianie jest konfigurowane przy użyciu określonego hosta:

databricks configure --host https://my-workspace.cloud.databricks.com

W poniższym przykładzie uwierzytelnianie jest konfigurowane przy użyciu konfiguracji klastra:

databricks configure --configure-cluster

Flagi globalne

--debug

  Czy włączyć logowanie debugowe.

-h lub --help

    Wyświetl pomoc dla Databricks CLI lub dla powiązanej grupy poleceń czy pojedynczego polecenia.

--log-file struna

    Ciąg reprezentujący plik do zapisywania dzienników wyjściowych. Jeśli ta flaga nie zostanie określona, wartością domyślną jest zapisywanie dzienników wyjściowych w programie stderr.

--log-format formatowanie

    Format typu logu text lub json. Wartość domyślna to text.

--log-level struna

    Ciąg reprezentujący poziom formatu zapisu dziennika. Jeśli nie zostanie określony, poziom formatu dziennika jest wyłączony.

-o, --output typ

    Typ danych wyjściowych polecenia: text lub json. Wartość domyślna to text.

-p, --profile struna

    Nazwa profilu pliku ~/.databrickscfg, którego użyć do uruchomienia polecenia. Jeśli ta flaga nie zostanie określona, zostanie użyty profil o nazwie DEFAULT .

--progress-format formatowanie

    Format wyświetlania dzienników postępu: default, , appendinplacelubjson

-t, --target struna

    Jeśli ma to zastosowanie, docelowy obiekt pakietu do użycia

Tworzenie profilu konfiguracji

Aby utworzyć profil konfiguracji, uruchom configure polecenie:

databricks configure --host <workspace-url>

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 .

✔ 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>

Tip

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.