Databricks CLI öğreticisi

Databricks komut satırı arabirimi (Databricks CLI olarak da bilinir) yardımcı programı, terminal, komut istemi veya otomasyon betiklerinizden Azure Databricks platformunu otomatikleştirmek için kullanımı kolay bir arabirim sağlar.

Bu makalede, Databricks CLI ile hızlı bir şekilde çalışmaya başlamak için yerel geliştirme makinenizin nasıl kullanılacağı gösterilmektedir. Bkz . Databricks CLI nedir?.

Aşağıdaki uygulamalı öğreticide şunlar varsayılır:

• Linux veya macOS için Homebrew yüklüdür.

  Not

  Homebrew'u kullanamıyorsanız, CLI'yi yüklemenin diğer yolları için bkz: Databricks CLI'yi yükleme veya güncelleştirme.

• Windows için winget, Chocolatey veya Linux için Windows Alt Sistemi (WSL) yüklüdür. Yükleme yönergeleri için işletim sisteminizin belgelerine bakın.

  Not

  Databricks CLI'yi Chocolatey ile yüklemek deneyseldir.

  CLI'yi yüklemenin veya güncellemenin başka yolları için, , Chocolatey veya WSL'yi kullanamıyorsanız,Databricks CLI yükleme veya güncelleştirme bölümüne bakın.

Aşağıdaki adımları tamamlayın:

1. Henüz yüklü değilse Databricks CLI'yi aşağıdaki gibi yükleyin:

   Linux, macOS

   Aşağıdaki iki komutu çalıştırarak Databricks CLI'yi yüklemek için Homebrew kullanın:

   brew tap databricks/tap
   brew install databricks
   

   Windows

   Databricks CLI'yı yüklemek için winget, Chocolatey veya Linux için Windows Alt Sistemi (WSL) kullanabilirsiniz. , Chocolatey veya WSL kullanamıyorsanız winget, bu yordamı atlayıp Komut İstemi'ni veya PowerShell'i kullanarak Databricks CLI'yi kaynaktan yüklemeniz gerekir.

   Not

   Databricks CLI'yi Chocolatey ile yüklemek deneyseldir.

   Databricks CLI'yı yüklemek için kullanmak winget için aşağıdaki iki komutu çalıştırın ve komut isteminizi yeniden başlatın:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

   Chocolatey'yi kullanarak Databricks CLI'yı yüklemek için aşağıdaki komutu çalıştırın:

   choco install databricks-cli
   

   WSL kullanarak Databricks CLI'yi yüklemek için:

   1. WSL aracılığıyla ve curl yükleyinzip. Daha fazla bilgi için işletim sisteminizin belgelerine bakın.

   2. Aşağıdaki komutu çalıştırarak Databricks CLI'yi yüklemek için WSL kullanın:

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
      

2. Yüklü Databricks CLI'nın geçerli sürümünü görüntüleyen aşağıdaki komutu çalıştırarak Databricks CLI'nin yüklendiğini onaylayın. Bu sürüm 0.205.0 veya üzeri olmalıdır:

   databricks -v
   

   Not

   databricks çalıştırırsanız ancak command not found: databricksgibi bir hata alırsanız veya databricks -v çalıştırırsanız ve 0,18 veya altı bir sürüm numarası listelenirse, bu makinenizin Databricks CLI yürütülebilir dosyasının doğru sürümünü bulamadığı anlamına gelir. Bunu düzeltmek için bkz . CLI yüklemenizi doğrulama.

Databricks CLI'yı yükledikten sonra aşağıdaki adımları tamamlayın:

1. Her hedef hesap veya çalışma alanı için aşağıdaki komutu çalıştırarak yerel olarak OAuth belirteci yönetimini başlatmak için Databricks CLI'sini kullanın.

   Hesap düzeyinde işlemler için, aşağıdaki komutta aşağıdaki yer tutucuları değiştirin:

   • değerini Azure Databricks <account-console-url>ile değiştirinhttps://accounts.azuredatabricks.net.
   • değerini Azure Databricks hesap kimliğiniz ile değiştirin <account-id> . Bkz . Hesap kimliğinizi bulma.

   databricks auth login --host <account-console-url> --account-id <account-id>
   

   Çalışma alanı düzeyindeki işlemler için aşağıdaki komutta değerini çalışma alanı başına Azure Databricks <workspace-url> değiştirin. Örneğinhttps://adb-1234567890123456.7.azuredatabricks.net.

   databricks auth login --host <workspace-url>
   

2. Databricks CLI, Azure Databricks yapılandırma profili olarak girdiğiniz bilgileri kaydetmenizi ister. Önerilen profil adını kabul etmek için basın Enter veya yeni veya mevcut bir profilin adını girin. Girdiğiniz bilgilerle aynı ada sahip mevcut tüm profillerin üzerine yazılır. Birden çok hesap veya çalışma alanı arasında kimlik doğrulama bağlamınızı hızla değiştirmek için profilleri kullanabilirsiniz.

   Mevcut profillerin listesini almak için, ayrı bir terminalde veya komut isteminde Databricks CLI'yı kullanarak komutunu databricks auth profilesçalıştırın. Belirli bir profilin mevcut ayarlarını görüntülemek için komutunu databricks auth env --profile <profile-name>çalıştırın.

3. Web tarayıcınızda, Azure Databricks hesabınızda veya çalışma alanınızda oturum açmak için ekrandaki yönergeleri tamamlayın.

4. Profilin geçerli OAuth belirteci değerini ve belirtecin yaklaşan süre sonu zaman damgasını görüntülemek için aşağıdaki komutlardan birini çalıştırın:

   Hesap düzeyinde işlemler için aşağıdaki komutları çalıştırın:

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url> --account-id <account-id>
   • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

   Aynı --host ve --account-id değerlerine sahip birden çok profiliniz varsa Databricks CLI'sının doğru eşleşen OAuth belirteci bilgilerini bulmasına yardımcı olmak için --host, --account-idve -p seçeneklerini birlikte belirtmeniz gerekebilir.

   Çalışma alanı düzeyindeki işlemler için aşağıdaki komutları çalıştırın:

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url>
   • databricks auth token --host <workspace-url> -p <profile-name>

   Aynı --host değerlerine sahip birden çok profiliniz varsa Databricks CLI'sının doğru eşleşen OAuth belirteci bilgilerini bulmasına yardımcı olmak için --host ve -p seçeneklerini birlikte belirtmeniz gerekebilir.

Sonraki adımlar

Databricks CLI'yı ayarladıktan sonra:

• CLI'yı kullanmayı öğrenmek için bkz . Databricks CLI için temel kullanım.
• Kullanılabilir CLI komutlarına genel bakış için bkz . Databricks CLI komutları.
• CLI çalışmazsa veya beklenmeyen sonuçlar üretirse bkz . CLI yüklemenizi doğrulama.