Alapszintű használat a Databricks parancssori felületéhez

Note

Ezek az információk a Databricks CLI 0.205-ös és újabb verzióira vonatkoznak. A Databricks parancssori felülete nyilvános előzetes verzióban érhető el.

A Databricks CLI használatára a Databricks Licenc és a Databricks adatvédelmi nyilatkozata vonatkozik, beleértve a használati adatokra vonatkozó rendelkezéseket is.

Ez a lap bemutatja, hogyan listázhatja a Databricks CLI parancscsoportjait és parancsait, hogyan jelenítheti meg a Databricks CLI súgóját, és hogyan használhatja a Databricks CLI kimenetét. Lásd: Mi a Databricks parancssori felület?

A Databricks parancssori felület hitelesítésének telepítéséhez és konfigurálásához tekintse meg a Databricks parancssori felületének oktatóanyagát.

Elérhető parancssori felületi parancsok listázása

Az elérhető CLI parancscsoportok listázásához használja a(z) --help vagy -h opciót, például:

databricks -h

Bármely parancscsoport parancsainak listázásához használja a --help vagy -h lehetőséget. Például a parancsok listázásához clusters :

databricks clusters -h

Parancssori felületi parancs súgójának megjelenítése

Egy parancs használati adatainak megjelenítéséhez használja a --help parancsot vagy -h a lehetőséget. Például a parancs súgójának clusters list megjelenítéséhez:

databricks clusters list -h

A parancshivatkozás is elérhető. Lásd Databricks CLI-parancsok.

Parancs futtatása

Az egyes parancsok teljes használati adatai és szintaxisa megtalálható a parancssori súgóban és a hivatkozásban, de a Databricks CLI-parancsok általában megfelelnek a következő szintaxisnak:

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

Nem minden parancs rendelkezik további alparancsokkal. A globális jelzők elérhetők, és egyes parancsok további jelzőkkel rendelkeznek. A következő parancs például parancsspecifikus jelölővel adja ki az elérhető fürtöket:

databricks clusters list --can-use-client JOBS

Tip

Databricks CLI-parancsokat futtathat egy Databricks-munkaterületről a webes terminál használatával. A munkaterület webes terminálja számos felhasználó számára használható egyetlen számításon, és nem igényel hitelesítést. Lásd: Rendszerhéjparancsok futtatása az Azure Databricks webes terminálban.

JSON-bemenet és -kimenet

Egyes Databricks CLI-parancsok rendelkeznek olyan --json jelölővel vagy más beállításokkal, amelyek JSON-sztringbemenetet fogadnak el. Ezenkívül egyes parancsok JSON-sztringet adnak ki.

Sztringformázás

A JSON-sztringek formátuma az operációs rendszertől függ:

Linux vagy macOS

A JSON-sztringparamétereket dupla idézőjelek közé foglalja, és a teljes JSON hasznos adatát egyetlen idézőjelbe foglalja. Például:

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

'["20230323", "Amsterdam"]'

Windows

A JSON-sztringparamétereket és a teljes JSON-hasznos adatot dupla idézőjelek közé foglalja, és a JSON hasznos adatában lévő dupla idézőjeleket egy fordított perjellel (\) előzi meg. Például:

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

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

Mezők beállítása JSON-sztringben

A --json számos parancs jelölője lehetővé teszi olyan objektummezők beállítását, amelyek nem érhetők el parancssori felületi parancsként vagy beállításként. Az alábbi hívás például hozzáad egy azonosítóval rendelkező 9ddddddd-1eee-4eee-a666-8fff7c111111 felhasználót a csoporthoz az azonosítóval 7eeeeeee-9ccc-4aaa-b777-1aaaaaaaaaa:

Linux vagy 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-kimenet szűrése jq

A JSON-t kimeneti Databricks CLI-parancsok esetében a jq parancssori processzorral szűrheti a kimenetet. Ha például csak egy Azure Databricks-fürt megjelenített nevét szeretné listázni a megadott fürtazonosítóval:

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

My-11.3-LTS-Cluster

Telepítheti jq macOS-en a Homebrew használatával brew install jq a Chocolatey és a choco install jqWindows használatával. További információkért jqlásd a jq kézikönyvet.

Proxykiszolgáló konfigurálása

A Databricks CLI-kérések és válaszok proxykiszolgálón keresztüli átirányításához állítsa be a HTTPS_PROXY környezeti változót azon a gépen, amelyen a Databricks parancssori felület telepítve van a proxykiszolgáló URL-címére.

A környezeti változók beállításához tekintse meg az operációs rendszer dokumentációját.