configure komut

Note

Bu bilgiler Databricks CLI 0.205 ve üzeri sürümleri için geçerlidir. Databricks CLI Genel Önizleme aşamasındadır.

Databricks CLI kullanımı, Kullanım Verileri sağlamaları da dahil olmak üzere Databricks Lisansı ve Databricks Gizlilik Bildirimi'ne tabidir.

configure Databricks CLI içindeki komut, Azure Databricks kişisel erişim belirteçlerini veya Microsoft Entra Id (eski adıyla Azure Active Directory) belirteçlerini kullanarak Azure Databricks ile Databricks CLI'sinin kimliğini doğrulamanızı sağlar.

Note

En iyi güvenlik uygulaması olarak otomatik araçlar, sistemler, betikler ve uygulamalarla kimlik doğrulaması yaptığınızda Databricks, çalışma alanı kullanıcıları yerine hizmet sorumlularına ait kişisel erişim belirteçlerini kullanmanızı önerir. Hizmet sorumluları için belirteçler oluşturmak amacıyla Hizmet sorumlusu için belirteçleri yönetme konusuna bakın.

Bu makalenin yalnızca Azure Databricks kişisel erişim belirtecini ve çalışma alanı düzeyinde komutların çağrılmasını etkinleştirmek için Microsoft Entra Id belirteci kimlik doğrulamasını kapsadığını unutmayın. Ek kimlik doğrulama yapılandırma seçenekleri için bkz . Databricks CLI için kimlik doğrulaması.

databricks yapılandır

~/.databrickscfg dosyanızda bir profil yapılandırın. Yapılandırma profili, Azure Databricks çalışma alanı URL'si ve erişim belirteci değeri gibi kimlik doğrulama bilgilerini içeren bir ayar koleksiyonudur.

Yapılandırma profilinin , DEFAULTveya DEVgibi PRODbir program adı vardır. Dosyaya birden çok profil eklemek, komutun .databrickscfg--profile seçeneğinde hedef bağlantı profilinin adını belirterek komutları çeşitli çalışma alanlarında hızla çalıştırmanıza olanak tanır. Bu seçeneği destekleyen bir komutta seçeneği belirtmezseniz --profile , komut varsayılan olarak bağlantı profilini kullanır DEFAULT .

Örneğin, geliştirme iş yükleri için kullandığınız Azure Databricks çalışma alanına başvuran adlı DEV bir bağlantı profiliniz ve üretim iş yükleri için kullandığınız farklı bir Azure Databricks çalışma alanına başvuran bağlantı profili adlı PROD ayrı bir bağlantı profiliniz olabilir.

Mevcut yapılandırma profilleri hakkında bilgi almak için komut grubunu kullanınauth.

ortam değişkenini .databrickscfgayarlayarak dosyanın varsayılan yolunu DATABRICKS_CONFIG_FILE değiştirebilirsiniz.

Bu komut etkileşimli olmayan modda çağrılırsa, belirteci stdin'den okur. Ana bilgisayar --host bayrağı veya DATABRICKS_HOST ortam değişkeni ile belirtilmelidir.

databricks configure [flags]

Options

--configure-cluster

    Kümeyi yapılandırma istemleri

--host string

    Databricks çalışma alanı ana bilgisayar bağlantı adresi

Çalışma alanı ana bilgisayar URL'si, https://adb-<workspace-id>.<random-number>.azuredatabricks.net biçiminde olan çalışma alanı başına URL'nizdir. Çalışma alanı başına URL'yi almak için bkz. Çalışma alanı başına URL.

--profile string

    Yapılandırılan bağlantı profilinin adı. (varsayılan "VARSAYıLAN")

Genel bayraklar

Examples

Aşağıdaki örnek, varsayılan profil için kimlik doğrulamasını yapılandırıyor:

databricks configure

Aşağıdaki örnekte belirli bir profil için kimlik doğrulaması yapılandırılır:

databricks configure --profile my-profile

Aşağıdaki örnek, belirli bir konak ile kimlik doğrulamasının yapılandırılmasıdır.

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

Aşağıdaki örnekte, küme yapılandırmasıyla kimlik doğrulaması yapılandırılır:

databricks configure --configure-cluster

Genel bayraklar

--debug

  Hata ayıklama günlüğünün etkinleştirilip etkinleştirilmeyileceği.

-h veya --help

    Databricks CLI veya ilgili komut grubu ya da ilgili komut için yardım görüntüleyin.

--log-file dizgi

    Yazılım günlüklerini yazmak için kullanılacak dosyayı temsil eden bir metin. Bu bayrak belirtilmezse varsayılan değer, çıkış günlüklerini stderr'a yazmaktır.

--log-format biçim

    Günlük biçimi türü, text veya json. Varsayılan değer şudur: text.

--log-level dizgi

    Günlük format düzeyini temsil eden bir karakter dizisi. Belirtilmezse günlük format seviyesi devre dışı bırakılır.

-o, --output tür

    Komut çıktı türü text veya json. Varsayılan değer şudur: text.

-p, --profile dizgi

    Komutu çalıştırmak için kullanılacak dosyadaki ~/.databrickscfg profilin adı. Bu bayrak belirtilmezse ve varsa, DEFAULT adlı profil kullanılır.

--progress-format biçim

    İlerleme günlüklerini görüntüleme biçimi: default, append, inplaceveya json

-t, --target dizgi

    Varsa, kullanılacak paket hedefi

Yapılandırma profili oluşturma

Yapılandırma profili oluşturmak için komutunu configure çalıştırın:

databricks configure --host <workspace-url>

Komut, sizden belirtilen ile eşleşen Azure Databricks kişisel erişim belirtecinizi veya <workspace-url> girmenizi ister:

✔ Databricks Token:

Erişim belirtecinizi girdikten sonra, erişim belirteciniz Linux veya macOS'taki dosyada ~/.databrickscfg ya da %USERPROFILE%\.databrickscfg varsayılan olarak Windows'ta depolanır. Dosya, adlı DEFAULTbir varsayılan bağlantı profili girişi içerir:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

bağlantı profilinizde DEFAULT yerine farklı bir ad kullanmak için, --profile komutuna configure seçeneğini ekleyin, örneğin:

databricks configure --host <workspace-url> --profile <profile-name>

Tip

yapılandırma profili adını el ile girmek yerine, Tab veya --profile sonra -p tuşuna basarak seçebileceğiniz mevcut yapılandırma profillerinin listesini görüntüleyebilirsiniz.

Belirtilen bağlantı profilindeki mevcut konak ve belirteç bilgilerinin üzerine yeni konak ve belirteç bilgileri yazılır.