Databricks CLI öğreticisi

  • Makale

Not

Bu bilgiler, Genel Önizleme sürümündeki Databricks CLI 0.205 ve üzeri sürümleri için geçerlidir. Databricks CLI sürümünüzü bulmak için komutunu çalıştırın databricks -v.

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:

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 zip yükleyincurl. 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

    komutunu çalıştırır databricks ancak gibi command not found: databricksbir hata alırsanız veya çalıştırırsanız databricks -v ve 0,18 veya daha yeni 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:

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ını kullanmak istediğiniz varsayılı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:

    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 URL'nizle değiştirin<workspace-url>. Ö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'yi 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ğerlere sahip birden çok profiliniz varsa, Databricks CLI'sının --hostdoğru eşleşen OAuth belirteci bilgilerini bulmasına yardımcı olmak için , --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ğerlere sahip birden çok profiliniz varsa Databricks CLI'sının --host doğru eşleşen OAuth belirteci bilgilerini bulmasına yardımcı olmak için 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.
  • CLI çalışmazsa veya beklenmeyen sonuçlar üretirse bkz . CLI yüklemenizi doğrulama.