Unity Catalog CLI (قديم)

هام

تم إيقاف هذه الوثائق وقد لا يتم تحديثها.

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

للترحيل من Databricks CLI الإصدار 0.18 أو أقل إلى Databricks CLI الإصدار 0.205 أو أعلى، راجع ترحيل Databricks CLI.

إشعار

Cli كتالوج Unity تجريبي.

يتطلب CLI كتالوج Unity Databricks CLI (قديم) 0.17.0 أو أعلى، تم تكوينه باستخدام المصادقة. لتحديث Databricks CLI أو لسرد الإصدار المثبت، راجع تحديث CLI.

قيم نماذج الخيارات والحقول في الأمثلة التالية هي لأغراض توضيحية فقط.

استخدم CLI كتالوج Unity للعمل مع:

• موارد كتالوج Unity مثل metastores وبيانات اعتماد التخزين والمواقع الخارجية والكتالوجات والمخططات والجداول وأذوناتها.
• موارد مشاركة دلتا مثل المشاركات والمستلمين والموفرين.

يمكنك تشغيل الأوامر الفرعية ل Unity Catalog CLI عن طريق إلحاقها ب databricks unity-catalog. تستدعي هذه الأوامر الفرعية واجهة برمجة تطبيقات كتالوج Unity، والتي تتضمن أيضا واجهة برمجة تطبيقات مشاركة دلتا.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog --help.

إخراج:

Usage: databricks unity-catalog [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks Unity Catalog.

Options:
  -v, --version  0.17.1
  -h, --help     Show this message and exit.

Commands:
  catalogs
  external-locations
  lineage
  metastores
  permissions
  providers
  recipients
  schemas
  shares
  storage-credentials
  tables

المخازن الوصفية

unity-catalog metastores استخدم الأمر الفرعي للعمل مع metastores.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores --help.

• إنشاء مخزن بيانات التعريف
• ربط metastore بمساحة عمل
• تحديث إعدادات metastore
• سرد المخازن الوصفية المتوفرة
• الحصول على معلومات حول مخزن بيانات التعريف
• الحصول على معلومات ملخصة حول metastore الحالي
• الحصول على تعيين metastore الحالي لمساحة عمل
• إلغاء ربط metastore من مساحة عمل
• حذف مخزن بيانات التعريف

إنشاء مخزن بيانات التعريف

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores create --help. راجع أيضا إنشاء مخزن بيانات تعريف كتالوج Unity.

إشعار

لا يؤدي إنشاء metastore إلى إقران metastore تلقائيا بمساحة عمل أو بيانات اعتماد تخزين. لإكمال هذه المهام، راجع ربط metastore بمساحة عمل وإنشاء بيانات اعتماد تخزين وتحديث إعدادات metastore.

ربط metastore بمساحة عمل

إذا قمت بتشغيل هذا الأمر على مساحة عمل تحتوي بالفعل على metastore معين، فستحدث metastore المعين لمساحة العمل هذه.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores assign --help.

databricks unity-catalog metastores assign --workspace-id 1234567890123456 \
                                           --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --default-catalog-name main

للحصول على معرف مساحة العمل، راجع أسماء مثيلات مساحة العمل وعناوين URL والمعرفات.

للحصول على معرف metastore، قم بتشغيل databricks unity-catalog metastores get-summary. على سبيل المثال، راجع الحصول على معلومات ملخصة حول metastore الحالي.

إخراج:

{}

راجع أيضا إنشاء مخزن بيانات تعريف كتالوج Unity.

تحديث إعدادات metastore

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores update --help.

databricks unity-catalog metastores update --id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --json-file update-metastore.json

للحصول على معرف metastore، قم بتشغيل databricks unity-catalog metastores get-summary. على سبيل المثال، راجع الحصول على معلومات ملخصة حول metastore الحالي.

update-metastore.json:

{
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
}

للحصول على معرف بيانات اعتماد جذر التخزين، راجع الحصول على معلومات حول بيانات اعتماد التخزين.

سرد المخازن الوصفية المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores list --help.

databricks unity-catalog metastores list

الحصول على معلومات حول مخزن بيانات التعريف

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores get --help.

databricks unity-catalog metastores get --id 12a345b6-7890-1cd2-3456-e789f0a12b34

للحصول على معرف metastore، قم بتشغيل databricks unity-catalog metastores get-summary. على سبيل المثال، راجع الحصول على معلومات ملخصة حول metastore الحالي.

الحصول على معلومات ملخصة حول metastore الحالي

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores get-summary --help.

databricks unity-catalog metastores get-summary

الحصول على تعيين metastore الحالي لمساحة عمل

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores get-assignment --help.

databricks unity-catalog metastores get-assignment

إخراج:

{
  "workspace_id": 1234567890123456,
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "default_catalog_name": "main"
}

إلغاء ربط metastore من مساحة عمل

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores unassign --help.

databricks unity-catalog metastores unassign --workspace-id 1234567890123456 \
                                             --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34

للحصول على معرف مساحة العمل، راجع أسماء مثيلات مساحة العمل وعناوين URL والمعرفات.

للحصول على معرف metastore، قم بتشغيل databricks unity-catalog metastores get-summary. على سبيل المثال، راجع الحصول على معلومات ملخصة حول metastore الحالي.

إخراج:

{}

حذف مخزن بيانات التعريف

تحذير

قبل حذف metastore، يجب حذف أي مساحات عمل تستخدم metastore أو إزالة ارتباط metastore إلى مساحات العمل هذه. اتصل بدعم Azure Databricks للمساعدة في إزالة ارتباطات metastore من مساحات العمل.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog metastores delete --help.

لحذف metastore قسرا، استخدم --force الخيار .

databricks unity-catalog metastores delete --id 12a345b6-7890-1cd2-3456-e789f0a12b34

للحصول على معرف metastore، قم بتشغيل databricks unity-catalog metastores get-summary. على سبيل المثال، راجع الحصول على معلومات ملخصة حول metastore الحالي.

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

بيانات اعتماد التخزين

unity-catalog storage-credentials استخدم الأمر الفرعي للعمل مع بيانات اعتماد التخزين. راجع إنشاء بيانات اعتماد تخزين للاتصال ب Azure Data Lake Storage Gen2.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog storage-credentials --help.

• إنشاء بيانات اعتماد تخزين
• تحديث إعدادات بيانات اعتماد التخزين
• سرد بيانات اعتماد التخزين المتوفرة
• الحصول على معلومات حول بيانات اعتماد التخزين
• حذف بيانات اعتماد التخزين

إنشاء بيانات اعتماد تخزين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog storage-credentials create --help.

راجع أيضا إنشاء بيانات اعتماد تخزين للاتصال ب Azure Data Lake Storage Gen2.

تحديث إعدادات بيانات اعتماد التخزين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog storage-credentials update --help.

سرد بيانات اعتماد التخزين المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog storage-credentials list --help.

databricks unity-catalog storage-credentials list

الحصول على معلومات حول بيانات اعتماد التخزين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog storage-credentials get --help.

databricks unity-catalog storage-credentials get --name my-storage-root-credential

حذف بيانات اعتماد التخزين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog storage-credentials delete --help.

لحذف بيانات اعتماد التخزين قسرا، استخدم --force الخيار .

databricks unity-catalog storage-credentials delete --name my-storage-root-credential

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

المواقع الخارجية

unity-catalog external-locations استخدم الأمر الفرعي للعمل مع مواقع خارجية. راجع إنشاء موقع خارجي لتوصيل التخزين السحابي ب Azure Databricks.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog external-locations --help.

• إنشاء موقع خارجي
• التحقق من صحة موقع خارجي وزوج بيانات الاعتماد
  • التحقق من صحة اسم موقع خارجي وزوج بيانات الاعتماد بعد إنشائها
• تحديث إعدادات موقع خارجي
• سرد المواقع الخارجية المتوفرة
• الحصول على معلومات حول موقع خارجي
• حذف موقع خارجي

إنشاء موقع خارجي

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog external-locations create --help. راجع أيضا إنشاء موقع خارجي لتوصيل التخزين السحابي ب Azure Databricks.

التحقق من صحة موقع خارجي وزوج بيانات الاعتماد

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog external-locations validate --help.

التحقق من صحة اسم موقع خارجي وزوج بيانات الاعتماد بعد إنشائها

databricks unity-catalog external-locations validate --name my-external-location \
                                                     --cred-name my-storage-root-credential

إخراج:

{
  "isDir": true,
  "results": [
    {
      "operation": "READ",
      "result": "PASS"
    },
    {
      "operation": "LIST",
      "result": "PASS"
    },
    {
      "operation": "WRITE",
      "result": "PASS"
    },
    {
      "operation": "DELETE",
      "result": "PASS"
    }
  ]
}

تحديث إعدادات موقع خارجي

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog external-locations update --help.

databricks unity-catalog external-locations update --name my-external-location \
                                                   --json-file update-external-location.json

udpate-external-location.json:

{
  "name": "my-external-location-2"
}

سرد المواقع الخارجية المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog external-locations list --help.

databricks unity-catalog external-locations list

الحصول على معلومات حول موقع خارجي

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog external-locations get --help.

databricks unity-catalog external-locations get --name my-external-location

حذف موقع خارجي

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog external-locations delete --help.

لحذف الموقع الخارجي قسرا، استخدم --force الخيار .

databricks unity-catalog external-locations delete --name my-external-location

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

الكتالوجات

unity-catalog catalogs استخدم الأمر الفرعي للعمل مع الكتالوجات.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog catalogs --help.

• إنشاء كتالوج
• تحديث إعدادات الكتالوج
• قائمة الكتالوجات المتوفرة
• الحصول على معلومات حول كتالوج
• حذف كتالوج

إنشاء كتالوج

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog catalogs create --help. راجع أيضا إنشاء كتالوجات.

databricks unity-catalog catalogs create --name my-catalog

إخراج:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

تحديث إعدادات الكتالوج

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog catalogs update --help.

databricks unity-catalog catalogs update --name my-catalog \
                                         --json-file update-catalog.json

update-catalog.json:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com"
}

إخراج:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656355967835,
  "created_by": "someone@example.com",
  "updated_at": 1656356095989,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

قائمة الكتالوجات المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog catalogs list --help.

databricks unity-catalog catalogs list

إخراج:

{
  "catalogs": [
    {
      "name": "main",
      "owner": "someone@example.com",
      "comment": "Main catalog (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656112029355,
      "created_by": "someone@example.com",
      "updated_at": 1656112029355,
      "updated_by": "someone@example.com",
      "catalog_type": "MANAGED_CATALOG"
    },
    {
      "...": "..."
    }
  ]
}

الحصول على معلومات حول كتالوج

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog catalogs get --help.

databricks unity-catalog catalogs get --name my-catalog

إخراج:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

حذف كتالوج

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog catalogs delete --help. راجع أيضا حذف كتالوج.

لحذف كتالوج قسرا، استخدم --purge الخيار .

databricks unity-catalog catalogs delete --name my-catalog

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

المخططات

unity-catalog schemas استخدم الأمر الفرعي للعمل مع المخططات.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog schemas --help.

• إنشاء مخطط
• تغيير إعدادات المخطط
• قائمة المخططات المتوفرة
• الحصول على معلومات حول مخطط
• حذف مخطط

إنشاء مخطط

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog schemas create --help. راجع أيضا إنشاء المخططات.

databricks unity-catalog schemas create --catalog-name my-catalog \
                                        --name my-schema

إخراج:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

تغيير إعدادات المخطط

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog schemas update --help.

databricks unity-catalog schemas update --full-name my-catalog.my-schema \
                                        --json-file update-schema.json

update-schema.json:

{
  "name": "my-schema-2",
  "owner": "someone@example.com"
}

إخراج:

{
  "name": "my-schema-2",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "comment": "Default schema (auto-created)",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema-2",
  "created_at": 1656355967837,
  "created_by": "someone@example.com",
  "updated_at": 1656356592786,
  "updated_by": "someone@example.com"
}

قائمة المخططات المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog schemas list --help.

databricks unity-catalog schemas list --catalog-name my-catalog

إخراج:

{
  "schemas": [
    {
      "name": "default",
      "catalog_name": "my-catalog",
      "owner": "someone@example.com",
      "comment": "Default schema (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "full_name": "my-catalog.default",
      "created_at": 1656113178996,
      "created_by": "someone@example.com",
      "updated_at": 1656113178996,
      "updated_by": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

الحصول على معلومات حول مخطط

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog schemas get --help.

databricks unity-catalog schemas get --full-name my-catalog.my-schema

إخراج:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

حذف مخطط

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog schemas delete --help. راجع أيضا حذف مخطط.

لحذف مخطط قسرا، استخدم --purge الخيار .

databricks unity-catalog schemas delete --full-name my-catalog.my-schema

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

الجداول

unity-catalog tables استخدم الأمر الفرعي للعمل مع الجداول.

إشعار

إنشاء جداول باستخدام CLI كتالوج Unity غير معتمد. لإنشاء جداول، راجع ما هي الجداول وطرق العرض؟ والبرنامج التعليمي: إنشاء الجدول الأول ومنح الامتيازات.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog tables --help.

• سرد الجداول المتوفرة
• سرد ملخصات الجداول المتوفرة
• الحصول على معلومات حول جدول
• حذف جدول

سرد الجداول المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog tables list --help.

databricks unity-catalog tables list --catalog-name main \
                                     --schema-name default

سرد ملخصات الجداول المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog tables list-summaries --help.

databricks unity-catalog tables list-summaries --catalog-name main

إخراج:

{
  "tables": [
    {
      "full_name": "main.default.mytable",
      "table_type": "MANAGED"
    },
    {
      "...": "..."
    }
  ]
}

الحصول على معلومات حول جدول

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog tables get --help.

databricks unity-catalog tables get --full-name main.default.mytable

حذف جدول

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog tables delete --help.

databricks unity-catalog tables delete --full-name main.default.mytable

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

الانساب

unity-catalog lineage استخدم الأمر الفرعي للعمل مع نسب الجداول والأعمدة.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog lineage --help.

• سرد دورة حياة جدول
• سرد دورة حياة العمود

سرد دورة حياة جدول

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog lineage table --help.

databricks unity-catalog lineage table --table-name main.default.mytable \
                                       --level 1

سرد دورة حياة العمود

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog lineage column --help.

databricks unity-catalog lineage column --table-name main.default.mytable \
                                        --column-name id

الأذونات

unity-catalog permissions استخدم الأمر الفرعي للعمل مع أذونات الكائنات القابلة للتأمين. راجع أيضا إدارة الامتيازات في كتالوج Unity.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog permissions --help.

• الحصول على معلومات حول أذونات كائن قابل للتأمين
  • Catalog
  • المخطط
  • جدول
  • بيانات اعتماد التخزين
  • الموقع الخارجي
• تحديث أذونات كائن قابل للتأمين
  • Catalog
  • المخطط
  • جدول
  • بيانات اعتماد التخزين
  • الموقع الخارجي

الحصول على معلومات حول أذونات كائن قابل للتأمين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog permissions get --help. راجع أيضا امتيازات كتالوج Unity والكائنات القابلة للتأمين.

Catalog

databricks unity-catalog permissions get --catalog main

إخراج:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "USE CATALOG"
      ]
    }
  ]
}

مخطط

databricks unity-catalog permissions get --schema main.default

إخراج:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "USE SCHEMA"
      ]
    }
  ]
}

جدول

databricks unity-catalog permissions get --table main.default.mytable

إخراج:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

بيانات اعتماد التخزين

databricks unity-catalog permissions get --storage-credential my-storage-root-credential

إخراج:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "READ_FILES"
      ]
    }
  ]
}

الموقع الخارجي

databricks unity-catalog permissions get --external-location my-external-location

إخراج:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "READ_FILES"
      ]
    }
  ]
}

تحديث أذونات كائن قابل للتأمين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog permissions update --help. راجع أيضا امتيازات كتالوج Unity والكائنات القابلة للتأمين.

Catalog

databricks unity-catalog permissions update --catalog \
                                            --json-file update-catalog-permissions.json

update-catalog-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "USE CATALOG" ],
      "remove": [ "CREATE SCHEMA" ]
    }
  ]
}

مخطط

databricks unity-catalog permissions update --schema \
                                            --json-file update-schema-permissions.json

update-schema-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "USE SCHEMA" ],
      "remove": [ "CREATE TABLE" ]
    },
    {
      "principal": "admin team",
      "add": [ "CREATE TABLE" ]
    }
  ]
}

جدول

databricks unity-catalog permissions update --table \
                                            --json-file update-table-permissions.json

update-table-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "SELECT" ],
      "remove": [ "MODIFY" ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

بيانات اعتماد التخزين

databricks unity-catalog permissions update --storage-credential \
                                            --json-file update-storage-credential-permissions.json

update-storage-credential-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": [ "READ FILES" ]
    },
    {
      "principal": "storage team",
      "add": [ "READ FILES",
               "WRITE FILES",
               "CREATE EXTERNAL TABLE"
             ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

الموقع الخارجي

databricks unity-catalog permissions update --external-location \
                                            --json-file update-external-location-permissions.json

update-external-location-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": [ "READ FILES" ]
    },
    {
      "principal": "storage team",
      "add": [ "READ FILES",
               "WRITE FILES",
               "CREATE EXTERNAL TABLE"
             ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

المشاركات

unity-catalog shares استخدم الأمر الفرعي للعمل مع المشاركات، وهي كائنات تحتوي على مجموعات من الجداول في مخزن بيانات تعريف كتالوج Unity ممكن لمشاركة دلتا الذي تريد مشاركته كمجموعة مع مستلمي Delta Sharing. يمكن أن تحتوي المشاركة على جداول من مخزن بيانات تعريف واحد فقط. راجع إنشاء مشاركات وإدارتها لمشاركة دلتا.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares --help.

• إنشاء مشاركة
• تحديث إعدادات المشاركة
  • إضافة جدول إلى مشاركة
  • إزالة جدول من مشاركة
• تحديث أذونات المشاركة
• سرد المشاركات المتوفرة
• الحصول على معلومات حول مشاركة
• سرد أذونات المشاركة
• حذف مشاركة

إنشاء مشاركة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares create --help. راجع أيضا إنشاء مشاركات وإدارتها لمشاركة دلتا.

databricks unity-catalog shares create --name my-share

إخراج:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

تحديث إعدادات المشاركة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares update --help. راجع أيضا تحديث المشاركات.

إضافة جدول إلى مشاركة

databricks unity-catalog shares update --name my-share \
                                       --add-table main.default.mytable

إخراج:

{
  "name": "my-share",
  "objects": [
    {
      "name": "main.default.mytable",
      "data_object_type": "TABLE",
      "added_at": 1656434168847,
      "added_by": "someone@example.com",
      "shared_as": "default.mytable",
      "cdf_enabled": false
    }
  ],
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

راجع أيضا إضافة جداول إلى مشاركة.

إزالة جدول من مشاركة

databricks unity-catalog shares update --name my-share \
                                       --remove-table main.default.mytable

إخراج:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

راجع أيضا إضافة جداول إلى مشاركة.

تحديث أذونات المشاركة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares update-permissions --help. راجع أيضا إدارة الوصول إلى مشاركات بيانات Delta Sharing (للموفرين).

databricks unity-catalog shares update-permissions --name my-share \
                                                   --json-file update-share-permissions.json

update-share-permissions.json:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

سرد المشاركات المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares list --help. راجع أيضا عرض المشاركات وتفاصيل المشاركة.

databricks unity-catalog shares list

إخراج:

{
  "shares": [
    {
      "name": "my-share",
      "created_at": 1656433327533,
      "created_by": "someone@example.com",
      "owner": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

الحصول على معلومات حول مشاركة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares get --help. راجع أيضا عرض المشاركات وتفاصيل المشاركة.

databricks unity-catalog shares get --name my-share

إخراج:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

سرد أذونات المشاركة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares list-permissions --help. راجع أيضا عرض المستلمين الذين لديهم أذونات للمشاركة.

databricks unity-catalog shares list-permissions --name my-share

إخراج:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

حذف مشاركة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog shares delete --help. راجع أيضا حذف مشاركة.

databricks unity-catalog shares delete --name my-share

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

المستلمون

unity-catalog recipients استخدم الأمر الفرعي للعمل مع مستلمي البيانات لمخازن تعريف كتالوج Unity الممكنة لمشاركة دلتا. مستلمو البيانات هم أشخاص أو مجموعات يشاركها مستخدم Azure Databricks مع خارج مؤسسة مستخدم Azure Databricks. راجع إنشاء مستلمي البيانات وإدارتهم لمشاركة دلتا.

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients --help.

• إنشاء مستلم
• تغيير إعدادات المستلم
• تدوير الرمز المميز للمستلم
• قائمة المستلمين المتوفرين
• سرد أذونات مشاركة المستلم
• الحصول على معلومات حول مستلم
• حذف مستلم

إنشاء مستلم

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients create --help. راجع أيضا إنشاء مستلمي البيانات وإدارتهم لمشاركة دلتا.

لإنشاء عنوان URL جديد للتنشيط لمستلم، قم بتشغيل databricks unity-catalog recipients rotate-token. على سبيل المثال، راجع تدوير الرمز المميز للمستلم.

databricks unity-catalog recipients create --name my-recipient

إخراج:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

تغيير إعدادات المستلم

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients update --help.

databricks unity-catalog recipients update --name my-recipient \
                                           --json-file update-recipient-settings.json

update-recipient-settings.json:

{
  "name": "my-recipient-2"
}

إخراج:

{
  "name": "my-recipient-2",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656436740986,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

تدوير الرمز المميز للمستلم

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients rotate-token --help. راجع أيضا إدارة الرموز المميزة للمستلم (مشاركة مفتوحة) .

databricks unity-catalog recipients rotate-token --name my-recipient \
                                                 --existing-token-expire-in-seconds 900

إخراج:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

قائمة المستلمين المتوفرين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients list --help. راجع أيضا عرض المستلمين.

databricks unity-catalog recipients list

إخراج:

{
  "recipients": [
    {
      "name": "my-recipient",
      "created_at": 1656435288003,
      "created_by": "someone@example.com",
      "tokens": [
        {
          "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
          "created_at": 1656435288005,
          "created_by": "someone@example.com",
          "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
          "expiration_time": 1656521688006,
          "updated_at": 1656435288006,
          "updated_by": "someone@example.com"
        }
      ],
      "authentication_type": "TOKEN",
      "updated_at": 1656435288003,
      "updated_by": "someone@example.com",
      "owner": "someone@example.com"
    }
  ]
}

سرد أذونات مشاركة المستلم

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients list-permissions --help. راجع أيضا عرض أذونات مشاركة المستلم.

databricks unity-catalog recipients list-permissions --name my-recipient

إخراج:

{
  "permissions_out": [
    {
      "share_name": "my-share",
      "privilege_assignments": [
        {
          "privileges": [
            "SELECT"
          ]
        }
      ]
    }
  ]
}

الحصول على معلومات حول مستلم

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients get --help. راجع أيضا عرض تفاصيل المستلم.

databricks unity-catalog recipients get --name my-recipient

إخراج:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

حذف مستلم

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog recipients delete --help. راجع أيضا حذف مستلم.

databricks unity-catalog recipients delete --name my-recipient

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.

الموفرون

إذا كنت أحد مستلمي البيانات المشتركة لمشاركة دلتا، فاستخدم unity-catalog providers الأمر الفرعي للعمل مع موفري بيانات Delta Sharing. راجع إدارة موفري مشاركة دلتا (لمستلمي البيانات).

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog providers --help.

• إنشاء موفر
• تحديث إعدادات الموفر
• سرد الموفرين المتاحين
• الحصول على معلومات حول موفر
• سرد مشاركات الموفر المتوفرة
• حذف موفر

إنشاء موفر

إذا كنت مستلما للبيانات المشتركة باستخدام بروتوكول المشاركة المفتوح وكنت تستخدم مساحة عمل Databricks مرفقة بمخزن بيانات تعريف كتالوج Unity، يمكنك إنشاء كائن موفر في مخزن بيانات تعريف كتالوج Unity. يمكنك بعد ذلك إدارة الوصول إلى البيانات المشتركة باستخدام كتالوج Unity.

هام

هذا السيناريو نادر. إذا كنت تستخدم مساحة عمل Databricks ممكنة لكتالوج Unity، وكان عميل Databricks آخر يشارك البيانات معك، فيجب عليه استخدام مشاركة Databricks-to-Databricks. مع مشاركة Databricks-to-Databricks، يتم إنشاء كائنات الموفر لك في كتالوج Unity.

لإنشاء موفر، يجب عليك:

• كن مسؤول metastore أو مستخدما يتمتع بامتياز CREATE_PROVIDER metastore.
• لديك حق الوصول إلى ملف بيانات الاعتماد الذي تم تنزيله. راجع الحصول على حق الوصول في نموذج المشاركة المفتوح.

قم بتشغيل الأمر التالي، مع my-provider استبدال بالاسم الذي تريد منحه للموفر والمسار config.share إلى ملف بيانات الاعتماد الذي تم تنزيله، والذي يسمى config.share بشكل افتراضي.

databricks unity-catalog providers create --name my-provider  \
                  --recipient-profile-json-file config.share

تحديث إعدادات الموفر

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog providers update --help.

databricks unity-catalog providers update --name my-provider \
                                          --new-name my-provider-2

سرد الموفرين المتاحين

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog providers list --help.

databricks unity-catalog providers list

الحصول على معلومات حول موفر

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog providers get --help.

databricks unity-catalog providers get --name my-provider

سرد مشاركات الموفر المتوفرة

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog providers list-shares --help.

databricks unity-catalog providers list-shares --name my-provider

حذف موفر

لعرض وثائق الاستخدام، قم بتشغيل databricks unity-catalog providers delete --help.

databricks unity-catalog providers delete --name my-provider

إذا نجحت العملية، فلن يتم إرجاع أي نتائج.