Databricks CLI sorunlarını giderme

Dikkat

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

Databricks CLI ile ilgili sorunları gidermek için aşağıdaki bilgileri kullanın.

Kayıt tutmayı etkinleştir

Bir komut başarısız olursa veya beklenen çıkışı üretmezse, neyin yanlış gittiğini belirlemenize yardımcı olması için günlüğe kaydetmeyi kullanabilirsiniz. Databricks CLI'nin çeşitli komut olayları, uyarılar ve hatalar hakkında verdiği iletileri günlüğe kaydedebilirsiniz. Bu iletileri günlüğe kaydetmek için aşağıdaki Databricks CLI komut seçeneklerini belirtin:

Bayrak	Açıklama
--log-file	Çıkış günlüklerinin yazılması için dosyayı temsil eden bir metin dizesi. Bu bayrak belirtilmezse varsayılan değer, çıkış günlüklerini stderr'a yazmaktır.
--log-format	text çıkış günlüklerini metne yazmak veya json çıktı günlüklerini JSON'a yazmak için. Bu bayrak belirtilmezse çıkış günlükleri metin olarak yazılır.
--log-level	Günlük format düzeyini temsil eden bir metin. Geçerli günlük düzeyleri: error, warn, info, debug, trace ve disabled. Varsayılan düzey disabled'dır ve bu, hiçbir şeyin günlüğe kaydedilmediği anlamına gelir. --debug eşdeğeri, --log-level debug olur.

Aşağıdaki örnek komut, belirtilen komut için izleme iletilerini JSON biçiminde, databricks-cli.log adlı bir dosyaya günlüğe kaydeder.

databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace

Terraform indirilirken hata oluştu

Databricks CLI'nın bazı sürümlerinde süresi dolan bir anahtar çalıştırılırken databricks bundle deployaşağıdaki hataya neden olur:

error downloading Terraform: unable to verify checksums signature: openpgp: key expired

Bu hatayı çözmek için Databricks CLI'yi en son düzeltme eki uygulanmış sürüme yükseltin. Bu sürüm doğrulama mekanizmasını daha yeni bir anahtarla çalışacak şekilde güncelleştirir. Geçerli CLI ikincil sürümünüze karşılık gelen yamanmış sürüme yükseltin.

• Binary install: GitHub’daki Databricks CLI yayınları sayfasından yama uygulanmış versiyonu indirin.

• setup-cli (yükleme betiği veya GitHub Eylemi olarak): Yapılandırmanızdaki sürümü GitHub Databricks CLI yayınları sayfasından düzeltme eki uygulanmış bir sürüme güncelleştirin.

  Örneğin, GitHub Eylemi ile 0.296.1 kullanmak için:

  - uses: databricks/setup-cli@main
    with:
      version: 0.296.1
  

Depolanan kimlik bilgileri hatası

Databricks CLI sürüm 1.0.0'dan başlayarak Databricks CLI, kullanıcıdan makineye (U2M) kimlik doğrulama belirteçlerini JSON dosyası yerine işletim sistemi yerel güvenli depolama alanında (macOS'ta anahtar zinciri, Windows'de Credential Manager, Linux'ta D-Bus Gizli Hizmeti) depolar. Bkz . Belirteç depolama. İş akışınız JSON dosyasının üzerine oluşturduğunuzda yeni depolama yönteminde çalışmaz ve aşağıdaki senaryolarda sorunlarla karşılaşabilirsiniz:

• Ga'ya yükseltildi, henüz yeniden oturum açmadı. Databricks CLI artık eski sürümler tarafından depolanan kimlik bilgilerini okumaz ve bir hata döndürür:

  Stored credentials from older CLI versions are no longer used.
  Run "databricks auth login" to sign in again.
  
  If secure storage is not available in this environment, set
  DATABRICKS_AUTH_STORAGE=plaintext and re-run login.
  

  Bu sorunu çözmek için komutunu çalıştırın databricks auth login .

• Güvenli depolama denetimi oturum açma sırasında başarısız oluyor sırasında databricks auth loginDatabricks CLI, OAuth akışını başlatmadan önce güvenli depolamayı denetler. Denetim başarısız olursa (En yaygın olarak Linux kapsayıcılarında, SSH oturumlarında, WSL1'de ve D-Bus'ın çalışmadığı başsız sunucularda), davranış güvenli depolamanın açıkça yapılandırılıp yapılandırılmadığına bağlıdır:

  • Varsayılan modda, açık bir depolama ayarı yoksa: Databricks CLI sessizce düz metne geri döner ve auth_storage = plaintext değerini ~/.databrickscfg içindeki [__settings__] bölümüne yazar. Sonraki komutlar yeniden denetlemeden düz metin kullanır.
  • Açıkça belirtilen güvenli modda (DATABRICKS_AUTH_STORAGE=secure veya auth_storage = secure, yapılandırma profilinde): Databricks CLI, DATABRICKS_AUTH_STORAGE=plaintext geri dönüşüne işaret eden bir hata döndürür.

  Kontrol, hemen başarısız olmak yerine zaman aşımına uğrarsa (örneğin, anahtarlık kilitli ancak erişilebilir durumdaysa), Databricks CLI anahtarlık arka ucunu kullanmaya devam eder ve işletim sisteminin kilit açma istemi, tarayıcıdaki OAuth akışıyla paralel olarak çalışır.

  Databricks CLI'nin oturum açma sonrasında hangi depolama modunu kullandığını onaylamak için komutunu çalıştırın databricks auth describe.

• Depolanan bir belirteç okunurken anahtarlığa ulaşılamıyor. Oturum açma sırasından farklı olarak Databricks CLI, belirteç okuma zamanında anahtarlığa ulaşamadığında sessizce geri çekilmez. Örneğin, bir masaüstü makinede oturum açtıysanız ve ardından başsız bir oturumda SSH üzerinden bağlandıysanız, depolanan belirtece ihtiyaç duyan komutlar bir hatayla başarısız olur. Bu sorunu çözmek için düz metin geri dönüşünü kullanın. Bkz. Düz metin geri dönüşünü kullanma.

Komutlar tamamlenmiyor

gibi databricks cluster list bir komut çalıştırırsanız ve kilitleniyor gibi görünürse Databricks CLI sürümünüzü en son sürüme güncelleştirin. Listedeki öğelerin sayısı büyük olsa bile CLI'nın önceki sürümleri tam listeleri yüklemeyi denerdi ve komut tamamlanmadı gibi görünürdü.