Aracılığıyla paylaş

Azure Databricks yapılandırma profilleri

Azure Databricks yapılandırma profili, kimlik doğrulama ayarlarını dosyada .databrickscfg depolar. Yapılandırma profilleri kodunuzu değiştirmeden farklı çalışma alanları, ortamlar veya kimlik doğrulama yöntemleri arasında geçiş yapmayı kolaylaştırır.

Araçlar, SDK'lar, betikler ve uygulamalar Azure Databricks ile kimlik doğrulaması yapmak için yapılandırma profillerine başvurabilir. Birleşik kimlik doğrulaması uygulayan tüm araçlar ve SDK'lar yapılandırma profillerini destekler.

Yapılandırma profili nedir?

Yapılandırma profili, dosyada .databrickscfg aşağıdakini içeren adlandırılmış bir bölümdür:

  • Kimlik doğrulama kimlik bilgileri, belirteçler veya hizmet sorumlusu kimlik bilgileri gibi
  • Azure Databricks çalışma alanı veya hesap URL'si
  • Kimlik doğrulama yönteminize özgü isteğe bağlı ayarlar

Geliştirme, hazırlama ve üretim gibi farklı çalışma alanlarına veya ortamlara bağlantıları yönetmek için tek .databrickscfg bir dosyada birden çok profil oluşturun.

Yapılandırma profili oluşturma

Databricks CLI kullanarak veya dosyayı el ile düzenleyerek .databrickscfg bir yapılandırma profili oluşturun.

CLI ile profil oluşturma

Etkileşimli kullanıcı kimlik doğrulaması için yapılandırma profili oluşturmanın en kolay yolu Databricks CLI'dır:

databricks auth login --host <workspace-url>

CLI, kimlik doğrulama akışını tamamlamak için web tarayıcınızı açar. Oturum açtığınızda CLI, kimlik bilgilerini yapılandırma profili olarak kaydeder.

Profili el ile oluşturma

El ile yapılandırma profili oluşturmak için:

  1. Giriş dizininizde adlı .databrickscfg bir dosya oluşturun:

    • Unix, Linux, macOS:~/.databrickscfg
    • Windows:%USERPROFILE%\.databrickscfg

  2. Aşağıdaki biçime sahip bir profil ekleyin:

    [<profile-name>]
<field-name> = <field-value>

    Yer tutucuları değiştirin:

    • <profile-name>: DEFAULT, DEVELOPMENT veya PRODUCTION gibi benzersiz bir ad
    • <field-name> ve <field-value>: Kimlik doğrulama yönteminizin kimlik doğrulama alanları

Örneğin, OAuth makineden makineye (M2M) kimlik doğrulaması için .databrickscfg dosya şöyle görünür:

[DEFAULT]
host          = https://<workspace-url>
client_id     = <client-id>
client_secret = <client-secret>

Birden çok profil oluşturma

Farklı çalışma alanlarını veya ortamları yönetmek için aynı .databrickscfg dosyada birden çok profil tanımlayın. Her profilin benzersiz bir adı olmalıdır.

[DEFAULT]
host          = https://production-workspace-url
client_id     = <production-client-id>
client_secret = <production-client-secret>

[DEVELOPMENT]
host          = https://dev-workspace-url
client_id     = <dev-client-id>
client_secret = <dev-client-secret>

[STAGING]
host          = https://staging-workspace-url
client_id     = <staging-client-id>
client_secret = <staging-client-secret>

Kimlik doğrulama türlerini birleştirme

Yapılandırma dosyanızdaki ayrı profillerde birden çok kimlik doğrulama yöntemi tanımlayın. Bu, farklı iş akışları veya araçlar için farklı kimlik bilgileri kullanmak istediğinizde kullanışlıdır. Örneğin, etkileşimli kullanım için bulutta yerel kimlik doğrulaması ve otomasyon için OAuth kimlik bilgileri kullanabilirsiniz:

[DEFAULT]
host = https://<workspace-url>

[SERVICE_PRINCIPAL]
azure_workspace_resource_id = /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Databricks/workspaces/<workspace-name>
azure_tenant_id             = <tenant-id>
azure_client_id             = <client-id>
azure_client_secret         = <client-secret>

Kimlik doğrulama türleri ve gerekli alanları hakkında daha fazla bilgi için bkz. Databricks birleşik kimlik doğrulaması.

Yapılandırma profili kullanma

Bir yapılandırma profili oluşturduktan sonra, araçlarınızda ve kodunuzda bu profile başvurun. Profil adı belirtmezseniz Azure Databricks araçları ve SDK'ları profili otomatik olarak kullanır DEFAULT .

dışında DEFAULTbir profil kullanmak için profil adını belirtin:

Databricks CLI ile:

databricks workspace list --profile DEVELOPMENT

Ortam değişkeniyle:

export DATABRICKS_CONFIG_PROFILE=DEVELOPMENT
databricks workspace list

Python SDK ile:

from databricks.sdk import WorkspaceClient

# Specify profile in code
w = WorkspaceClient(profile="DEVELOPMENT")

# Or use environment variable DATABRICKS_CONFIG_PROFILE

En iyi yöntemler

  • Profil adlarını belirtme gereksinimini en aza indirmek için en yaygın çalışma alanınız için DEFAULT profilini kullanın.
  • Genel adlar yerine , PRODUCTIONveya DEVELOPMENT gibi STAGINGaçıklayıcı profil adları kullanın.
  • Kısıtlanmış dosya izinleri ayarlayarak dosyanızı .databrickscfg koruyun (yalnızca kullanıcınız tarafından okunabilir).
  • Sürüm denetimine eklemeyin .databrickscfg. Dosyanıza .gitignore ekleyin.
  • Kişisel erişim belirteçleri yerine üretim iş yükleri için hizmet sorumlularını kullanın.
  • Kimlik bilgilerini düzenli olarak döndürün ve profillerinizi uygun şekilde güncelleştirin.

Sorun giderme

Profil bulunamıyorsa aşağıdakileri doğrulayın:

  • Dosya .databrickscfg ana dizinindedir.
  • Tam profil adını kullanırsınız.
  • Dosya adı .databrickscfg.txt veya benzeri bir şey değil.

Kimlik doğrulaması başarısız olursa aşağıdakileri doğrulayın:

  • Kimlik bilgileriniz güncel ve süresi dolmamış.
  • host URL doğru.
  • Denediğiniz işlemler için gerekli izinlere sahipsiniz.

Databricks CLI kullanarak yapılandırma profillerinizi test edin:

# Inspect a specific profile
databricks auth env --profile DEVELOPMENT

# List all profiles
databricks auth profiles

Daha fazla bilgi için bkz . Yapılandırma profillerinizi test edin.

Daha fazla bilgi edinin

  • Last updated on