Databricks CLI için temel kullanım

  • 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.

Bu makalede Databricks CLI komut gruplarını ve komutlarını listeleme, Databricks CLI yardımını görüntüleme ve Databricks CLI çıkışıyla çalışma işlemleri gösterilir. Bkz . Databricks CLI nedir?.

Bu makalede Databricks CLI'yı zaten yüklediğiniz ve CLI'yi kimlik doğrulaması için ayarladığınız varsayılır. Bkz.

CLI komut gruplarını listeleme

komut gruplarını veya -h seçeneğini kullanarak --help listeleyebilirsiniz. Örneğin:

databricks -h

CLI komutlarını listeleme

veya -h seçeneğini kullanarak herhangi bir komut grubunun komutlarını --help listeleyebilirsiniz. Örneğin, komutları listelemek clusters için:

databricks clusters -h

CLI komut yardımlarını görüntüleme

veya -h seçeneğini kullanarak bir komutun yardımını --help görüntülersiniz. Örneğin, komutunun yardımını clusters list görüntülemek için:

databricks clusters list -h

CLI JSON çıkışını ayrıştırmak için kullanın jq

Bazı Databricks CLI komutları çıkış yanıtları JSON olarak biçimlendirilir. Çoğu durumda Databricks CLI, JSON çıkışını daha kolay okunacak şekilde biçimlendirmektedir. Ancak bazen yanıtın tamamını listelemek yerine JSON'un bölümlerini ayrıştırmak yararlı olabilir. Örneğin, belirtilen küme kimliğine sahip bir Azure Databricks kümesinin yalnızca görünen adını listelemek için yardımcı programını jqkullanabilirsiniz:

databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name

Çıkış:

My-11.3-LTS-Cluster

Örneğin, ile Homebrew kullanarak macOS'a veya ile brew install jq Chocolatey choco install jqkullanarak Windows'a yükleyebilirsinizjq. jq hakkında daha fazla bilgi edinmek için bkz. jq kullanıcı kılavuzu.

JSON dizesi parametreleri

Dize parametrelerinin biçimi, işletim sisteminize bağlı olarak JSON'da farklı şekilde işlenir:

Linux veya macos

JSON dize parametrelerini çift tırnak içine almanız ve JSON yükünün tamamını tek tırnak içine almanız gerekir. Bazı örnekler:

'{"cluster_id": "1234-567890-abcde123"}'

'["20230323", "Amsterdam"]'

Windows

JSON dize parametrelerini ve JSON yükünün tamamını çift tırnak içine almanız ve JSON yükü içindeki çift tırnak karakterlerinin önünde \olması gerekir. Bazı örnekler:

"{\"cluster_id\": \"1234-567890-abcde123\"}"

"[\"20230323\", \"Amsterdam\"]"

Ara sunucu yapılandırması

Databricks CLI isteklerini ve yanıtlarını bir ara sunucu üzerinden yönlendirmek için, Databricks CLI'sinin yüklü olduğu makinedeki ortam değişkenini ara sunucunun URL'sine ayarlayın HTTPS_PROXY .

Ortam değişkenlerini ayarlamak için işletim sisteminizin belgelerine bakın.

Genel bayraklar

Aşağıdaki bayraklar tüm Databricks CLI komutlarında kullanılabilir. Bazı bayrakların bazı komutlara uygulanmadığını unutmayın. Daha fazla bilgi için komutun belgelerine bakın.

Bayrak Açıklama
-h veya --help Databricks CLI veya ilgili komut grubu ya da ilgili komut için yardım görüntüleyin.
-e veya --environment string İlgili komut için uygunsa kullanılacak paket ortamını temsil eden bir dize.
--log-file Çıkış günlüklerinin yazılması için öğesini temsil eden bir dize. 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 biçimi düzeyini temsil eden bir dize. Belirtilmezse, günlük biçimi düzeyi devre dışı bırakılır.
-o veya --output text çıktıyı metin olarak yazmak veya json çıktıyı JSON olarak yazmak için. Bu bayrak belirtilmezse çıkış metin olarak yazılır.
-p veya --profile Dosyanızda .databrickscfg kullanılacak adlandırılmış yapılandırma profilini temsil eden bir dize. Bu bayrak belirtilmezse DEFAULT , varsa adlandırılmış profil kullanılır. Yapılandırma profili adını el ile girmek yerine seçebileceğiniz mevcut yapılandırma profillerinin listesini görüntülemek için veya --profile-p sonrasına basabilirsinizTab.
--progress-format İlerleme durumu günlüklerinin görüntülenme biçimi (default (varsayılan) veya append veya inplacejson).