Databricks CLI için yapılandırma profilleri

Not

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

Bu makalede Databricks CLI'nin yapılandırma profilleriyle nasıl kullanılacağı açıklanmaktadır. Databricks CLI'yi zaten yüklediğiniz ve bir Databricks yapılandırma profilleri dosyası oluşturduğunuz varsayılır. Bkz. Databricks CLI ve Azure Databricks yapılandırma profillerini yükleme veya güncelleştirme.

Yapılandırma profilleri hakkında bilgi alma

Dosyaya birden çok yapılandırma profili eklemek, komutun .databrickscfg--profile veya -p bayrağında hedef yapılandırma profilinin adını belirterek komutları çeşitli çalışma alanlarında hızla çalıştırmanıza olanak tanır. Bir profil belirtmezseniz, CLI aşağıdaki sırayla bir profil seçer:

  1. DATABRICKS_CONFIG_PROFILE Ortam değişkeni ayarlanırsa.
  2. .databrickscfg içindeki [__settings__] bölümündeki default_profile ayarı, varsa. Bunu databricks auth switch ile ayarlayabilirsiniz. Bkz. databricks auth switch.
  3. Profil DEFAULT .

İpucu

Mevcut yapılandırma profillerinin listesini görüntülemek için Tab veya --profile sonrasında -p tuşuna basabilirsiniz.

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

Varsayılan olarak Databricks CLI, dosyayı Unix, Linux veya macOS'taki .databrickscfg (kullanıcı giriş) klasörünüzde veya Windows'taki (kullanıcı giriş klasörünüzde ~ ) arar%USERPROFILE%. Dosyanın varsayılan yolunu .databrickscfg değiştirmek için ortam değişkenini DATABRICKS_CONFIG_FILE farklı bir yola ayarlayın. Bkz. .databrickscfg'ye özgü alanlar.

Mevcut bir yapılandırma profili hakkında bilgi almak için komutunu auth describe çalıştırın:

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

Örneğin, Azure Databricks kişisel erişim belirteci kimlik doğrulaması ile yapılandırılmış bir profilin çıktısı aşağıda verilmiştir:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Not

Komut auth env kullanım dışıdır. Bir profilin yapılandırmasını incelemek için databricks auth describe veya önbelleğe alınmış bir OAuth erişim belirtecini almak için databricks auth token kullanın.

Kullanılabilir tüm profiller hakkında bilgi almak için komutunu auth profiles çalıştırın:

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

auth profiles komutunun çıktısı herhangi bir erişim belirteci göstermez. Belirli bir profil için belirteç ayrıntılarını görüntülemek üzere databricks auth describe --profile <profile-name> veya databricks auth token --profile <profile-name> komutunu çalıştırın.

Önemli

Databricks CLI bir .netrc dosyasıyla çalışmaz. Ortamınızda başka amaçlarla bir .netrc dosyanız olabilir, ancak Databricks CLI bu .netrc dosyayı kullanmaz.

Yapılandırma profillerinizi test edin

Yapılandırma profillerinizi test etmek ve kimlik doğrulamasını doğru ayarladığınızı doğrulamak için bir çalışma alanına bağlanan bir komut çalıştırın.

Bir profil belirtmezseniz, varsayılan profil kullanılır. Örneğin, aşağıdaki komut, DEFAULT profilinizle ilişkili Azure Databricks çalışma alanı için kullanılabilir Databricks Runtime sürümlerini listeler.

Not

Bu komut, profilinizdeki DEFAULT ayarlardan öncelikli olan herhangi bir ortam değişkeni ayarlamadığınız varsayılır. Daha fazla bilgi için bkz: Kimlik doğrulama değerlendirme sırası.

databricks clusters spark-versions

Belirli bir yapılandırma profilini doğrulamak için -p bayrağını kullanarak profil adını sağlayın.

databricks clusters spark-versions -p PROD