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

إشعار

تنطبق هذه المعلومات على إصدارات Databricks CLI 0.205 والإصدارات الأحدث. Databricks CLI في المعاينة العامة.

يخضع استخدام Databricks CLI لترخيص Databricks وإشعار خصوصية Databricks، بما في ذلك أي أحكام لبيانات الاستخدام.

توضح هذه المقالة كيفية سرد مجموعات أوامر 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

تشغيل أمر

يمكن العثور على معلومات الاستخدام الكاملة وبناء الجملة للأوامر الفردية في تعليمات سطر الأوامر، ولكن أوامر Databricks CLI تتوافق بشكل عام مع بناء الجملة التالي:

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

لا يحتوي كل أمر على أوامر فرعية إضافية. تتوفر علامات عمومية ، وبعض الأوامر تحتوي على علامات إضافية. على سبيل المثال، يقوم الأمر التالي لإخراج المجموعات المتوفرة، باستخدام علامة خاصة بالأمر:

databricks clusters list --can-use-client JOBS

تلميح

يمكنك تشغيل أوامر Databricks CLI من داخل مساحة عمل Databricks باستخدام محطة الويب. يمكن استخدام محطة الويب من قبل العديد من المستخدمين على حساب واحد ولا يتطلب إعداد المفاتيح. راجع تشغيل أوامر shell في محطة ويب Azure Databricks.

استخدم jq لتصفية إخراج JSON

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

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 للخادم الوكيل.

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