الاستخدام الأساسي ل Databricks CLI

إشعار

تنطبق هذه المعلومات على إصدارات Databricks CLI 0.205 والإصدارات الأحدث، الموجودة في المعاينة العامة. للعثور على إصدار Databricks CLI الخاص بك، قم بتشغيل databricks -v.

توضح هذه المقالة كيفية سرد مجموعات أوامر Databricks CLI والأوامر، وعرض تعليمات Databricks CLI، والعمل مع إخراج Databricks CLI. راجع ما هو Databricks CLI؟.

تفترض هذه المقالة أنك قمت بالفعل بتثبيت Databricks CLI وإعداد CLI للمصادقة. راجع:

• تثبيت Databricks CLI أو تحديثه
• مصادقة Databricks CLI

سرد مجموعات أوامر CLI

يمكنك سرد مجموعات الأوامر باستخدام --help الخيار أو -h . على سبيل المثال:

databricks -h

قائمة أوامر CLI

يمكنك سرد الأوامر لأي مجموعة أوامر باستخدام --help الخيار أو -h . على سبيل المثال، لسرد clusters الأوامر:

databricks clusters -h

عرض تعليمات أمر CLI

يمكنك عرض التعليمات لأمر باستخدام --help الخيار أو -h . على سبيل المثال، لعرض تعليمات clusters list الأمر:

databricks clusters list -h

يستخدم jq لتحليل إخراج CLI JSON

يتم تنسيق بعض استجابات إخراج أوامر Databricks CLI ك JSON. في كثير من الحالات، يقوم Databricks CLI بتنسيق إخراج JSON بحيث يكون من الأسهل قراءته. ومع ذلك، في بعض الأحيان قد يكون من المفيد تحليل أجزاء من JSON بدلا من سرد الاستجابة بأكملها. على سبيل المثال، لسرد اسم العرض فقط لنظام مجموعة Azure Databricks مع معرف نظام المجموعة المحدد، يمكنك استخدام الأداة المساعدة jq:

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

إخراج:

My-11.3-LTS-Cluster

يمكنك التثبيت jq على سبيل المثال على macOS باستخدام Homebrew مع brew install jq أو على Windows باستخدام Chocolatey مع choco install jq. لمزيد من المعلومات حول jq، راجع دليل jq.

معلمات سلسلة JSON

يتم التعامل مع تنسيق معلمات السلسلة بشكل مختلف في JSON اعتمادا على نظام التشغيل الخاص بك:

Linux أو macos

يجب إحاطة معلمات سلسلة JSON بعلامات اقتباس مزدوجة، ويجب إحاطة حمولة JSON بأكملها بعلامات اقتباس مفردة. بعض الأمثلة:

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

'["20230323", "Amsterdam"]'

Windows

يجب إحاطة معلمات سلسلة JSON وحمولة JSON بأكملها بعلامات اقتباس مزدوجة، ويجب أن تسبق أحرف الاقتباس المزدوجة داخل حمولة JSON .\ بعض الأمثلة:

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

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

تكوين الخادم الوكيل

لتوجيه طلبات واستجابات Databricks CLI من خلال خادم وكيل، قم بتعيين HTTPS_PROXY متغير البيئة على الجهاز حيث يتم تثبيت Databricks CLI على عنوان URL للخادم الوكيل.

لتعيين متغيرات البيئة، راجع وثائق نظام التشغيل الخاص بك.

علامات عمومية

تتوفر العلامات التالية لجميع أوامر Databricks CLI. لاحظ أن بعض العلامات لا تنطبق على بعض الأوامر. لمزيد من المعلومات، راجع وثائق الأمر.

العلامة	‏‏الوصف
-h أو --help	عرض التعليمات ل Databricks CLI أو مجموعة الأوامر ذات الصلة أو الأمر ذي الصلة.
-e أو --environment string	سلسلة تمثل بيئة المجموعة لاستخدامها إذا كان ذلك ممكنا للأمر ذي الصلة.
--log-file	سلسلة تمثل لكتابة سجلات الإخراج إليها. إذا لم يتم تحديد هذه العلامة، فإن الإعداد الافتراضي هو كتابة سجلات الإخراج إلى stderr.
--log-format	text لكتابة سجلات الإخراج إلى نص أو json لكتابة سجلات الإخراج إلى JSON. إذا لم يتم تحديد هذه العلامة، فستتم كتابة سجلات الإخراج كنص.
--log-level	سلسلة تمثل مستوى تنسيق السجل. إذا لم يتم تحديده، فسيتم تعطيل مستوى تنسيق السجل.
-o أو --output	text لكتابة الإخراج كنص أو json لكتابة الإخراج ك JSON. إذا لم يتم تحديد هذه العلامة، تتم كتابة الإخراج كنص.
-p أو --profile	سلسلة تمثل ملف تعريف التكوين المسمى لاستخدامه داخل الملف الخاص بك .databrickscfg . إذا لم يتم تحديد هذه العلامة، فسيتم استخدام ملف التعريف المسمى DEFAULT إذا كان موجودا. يمكنك الضغط Tab بعد --profile أو -p لعرض قائمة بملفات تعريف التكوين المتوفرة الحالية للاختيار من بينها بدلا من إدخال اسم ملف تعريف التكوين يدويا.
--progress-format	تنسيق سجلات التقدم لعرض ( (defaultالافتراضي) أو أو appendinplace ).json