Databricks CLI öğreticisi

Not

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.

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. Bkz. Databricks CLI.

Bu makalede Databricks CLI'yi hızlı bir şekilde yükleme ve yapılandırma adımları gösterilmektedir.

Yerel makine gereksinimlerini onaylama

Bu öğreticide aşağıdakiler varsayılır:

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

  Not

  Homebrew 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 Windows Subsystem for Linux (WSL) yüklüdür.

  Not

  Databricks CLI'yi Chocolatey ile yüklemek deneyseldir. CLI'yı yüklemenin diğer yolları için bkz. Databricks CLI'yı yükleme veya güncelleştirme.

Databricks CLI'yi Yükleme

1. Databricks CLI'yi 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 Windows Subsystem for Linux (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'yi yüklemek için winget kullanarak aşağıdaki iki komutu çalıştırın ve ardından Komut İstemi'ni 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. curl ve zip'yi WSL aracılığıyla yükleyin. 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
   

Çalışma alanınıza erişimi yapılandırma

Ardından Databricks çalışma alanınıza erişimi yapılandırın.

Not

Bu öğreticide, Azure Databricks kullanıcı hesabınızı kullanarak CLI kimliğini doğrulamak için OAuth kullanıcıdan makineye (U2M) kimlik doğrulaması kullanılmaktadır. CLI'yı diğer Databricks kimlik doğrulama türlerini kullanacak şekilde yapılandırmak için bkz . Databricks CLI için kimlik doğrulaması.

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:

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

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

   çalışma alanı düzeyinde işlemler için aşağıdaki komutta <workspace-url> yerine Azure Databricks per-workspace URL yazın, örneğin https://adb-1234567890123456.7.azuredatabricks.net.

   databricks auth login --host <workspace-url>
   

2. Databricks CLI, Azure Databricks configuration profile 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

• 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ğrulayın.