Databricks CLI için temel kullanım

Note

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.

Bu sayfada 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?.

Databricks CLI kimlik doğrulamasını yüklemek ve yapılandırmak için bkz. Databricks CLI öğreticisi.

Kullanılabilir CLI komutlarını listeleme

Kullanılabilir CLI komut gruplarını listelemek için --help veya -h seçeneğini kullanın, örneğin:

databricks -h

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

databricks clusters -h

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

Bir komutun kullanım bilgilerini görüntülemek için --help veya -h seçeneğini komutla birlikte kullanın. Örneğin, komutunun yardımını clusters list görüntülemek için:

databricks clusters list -h

Komut referansı da mevcuttur. Bkz. Databricks CLI komutları.

Komut çalıştırma

Komut satırı yardımı ve başvurusunda tek tek komutlar için tam kullanım bilgileri ve söz dizimi bulunabilir, ancak Databricks CLI komutları genellikle aşağıdaki söz dizimine uygundur:

databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]

Her komutun ek alt komutları olmaz. Genel bayraklar kullanılabilir ve bazı komutların ek bayrakları vardır. Örneğin, aşağıdaki komut, komuta özgü bir bayrak kullanarak kullanılabilir kümelerin çıkışını oluşturur:

databricks clusters list --can-use-client JOBS

Tip

Databricks CLI komutlarını web terminalini kullanarak bir Databricks çalışma alanından çalıştırabilirsiniz. Çalışma alanı web terminali tek bir işlemde birçok kullanıcı tarafından kullanılabilir ve kimlik doğrulamasını yapılandırmanızı gerektirmez. Bkz. Azure Databricks web terminalinde kabuk komutlarını çalıştırma.

JSON girişi ve çıkışı

Bazı Databricks CLI komutlarının bir --json bayrağı veya JSON dize girişini kabul eden diğer seçenekleri vardır. Buna ek olarak, bazı komutlar bir JSON dizesi çıkışı verir.

Dize biçimlendirme

JSON dizelerinin biçimi işletim sisteminize bağlıdır:

Linux veya macOS

JSON dize parametrelerini çift tırnak içine alın ve JSON yükünün tamamını tek tırnak içine alın. Örneğin:

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

'["20230323", "Amsterdam"]'

Windows

JSON dizgi parametrelerini ve tüm JSON yükünü çift tırnak içine alın, ayrıca JSON yükü içindeki çift tırnak karakterlerinden önce ters eğik çizgi (\) koyun. Örneğin:

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

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

JSON dizesindeki alanları ayarlama

--json Birçok komutta bayrağı, CLI komutları veya seçenekleri olarak kullanılamayabilecek nesne alanlarını ayarlamanıza olanak tanır. Örneğin, aşağıdaki çağrı kimliğine 9ddddddd-1eee-4eee-a666-8fff7c111111 sahip bir kullanıcıyı kimliğiyle 7eeeeeee-9ccc-4aaa-b777-1aaaaaaaaaagruba ekler:

Linux veya macOS

databricks account groups patch 7eeeeeee-9ccc-4aaa-b777-1aaa2eeeee6f --json '{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [
    {
      "op": "add",
      "path": "members",
      "value": [
        {
        "value": "9ddddddd-1eee-4eee-a666-8fff7c111111"
        }
      ]
    }
  ]
}'

Windows

databricks account groups patch 7eeeeeee-9ccc-4aaa-b777-1aaa2eeeee6f --json "{
  \"schemas\": [\"urn:ietf:params:scim:api:messages:2.0:PatchOp\"],
  \"Operations\": [
    {
      \"op\": \"add\",
      \"path\": \"members\",
      \"value\": [
        {
            \"value\": \"9ddddddd-1eee-4eee-a666-8fff7c111111\"
        }
      ]
    }
  ]
}"

JSON çıkışını jq ile filtreleme

JSON çıkışını veren Databricks CLI komutlarında, çıkışı filtrelemek için jq komut satırı işlemcisini kullanabilirsiniz. Örneğin, belirtilen küme kimliğine sahip bir Azure Databricks kümesinin yalnızca görünen adını listelemek için:

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

My-11.3-LTS-Cluster

ile Homebrew kullanarak macOS'a veya ile jq Chocolatey brew install jqkullanarak Windows'a yükleyebilirsinizchoco install jq. jq hakkında daha fazla bilgi için jq Kılavuzu'na bakın.

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.