مشاركة عبر

إنشاء مستلم

  • مقالة

ينطبق على:وضع علامة Databricks SQL وضع علامة Databricks Runtime 10.4 LTS وما فوق وضع علامة كتالوج Unity فقط

إنشاء مستلم Delta Sharing بالاسم المحدد وإنشاء ارتباط تنشيط. إذا كان المستلم يحمل نفس الاسم موجودا بالفعل، يتم طرح استثناء.

لإنشاء مستلم وإدارته، يجب أن تكون مسؤول metastore أو لديك الامتياز CREATE RECIPIENT على metastore.

استخدم وصف المستلم لاسترداد ارتباط التنشيط.

بناء الجملة

CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
    [ USING ID sharing_identifier ]
    [ COMMENT comment ]
    [ PROPERTIES ( property_key [ = ] property_value [, ...] ) ]

المعلمات

  • إذا لم يكن موجودا

    إنشاء مستلم بالاسم المحدد إذا لم يكن موجودا. إذا كان المستلم يحمل نفس الاسم موجودا بالفعل، فلن يحدث أي شيء.

  • recipient_name

    اسم المستلم الذي سيتم إنشاؤه.

  • sharing_identifier

    معرف فريد عمومي اختياري لمخزن بيانات تعريف كتالوج Unity مملوك لمستلم Delta Sharing الذي ترغب في مشاركة البيانات معه. هذا هو إخراج الدالة current_metastore التي ينفذها مستلم Delta Sharing.

    يؤدي استخدام هذا الخيار إلى تعيين نوع المصادقة إلى DATABRICKS، وإلا يتم تعيين نوع المصادقة إلى TOKEN، مما يتطلب منك إرسال ارتباط تنشيط إلى المستلم للوصول إلى التاريخ المشترك.

  • التعليق

    قيمة حرفية اختيارية STRING . وصف المستلم.

  • PROPERTIES ( property_key [ = ] property_value [, ...] )

    ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime 12.2 LTS وما فوق.

    تعيين خاصية مخصصة على مستلم.

    يمكن استخدام خصائص المستلم لمشاركة أقسام جدول مختلفة مع مستلمين مختلفين باستخدام نفس كائن المشاركة. راجع إدارة خصائص المستلم واستخدام خصائص المستلم لإجراء تصفية القسم.

    property_key
{ identifier [. ...] | string_literal }

property_value
{ string_literal }

الأمثلة

-- A recipient created for Databricks to Databricks sharing
> CREATE RECIPIENT other_databricks_org USING ID 'azure:westus:f12dcb34-5678-9d4c-1234-c5ac67f8b90a';
> DESCRIBE RECIPIENT other_databricks_org;
 info_name           info_value
 -------------       ----------
 recipient_name      other_databricks_org
 authentication_type DATABRICKS
 owner               alwaysworks@databricks.com
 created_by          alwaysworks@databricks.com
 create_at           2022-01-01T00:00:00.000+0000
 updated_by          alwayswork@databricks.com
 updated_at          2022-01-05T12:00:00.000+0000
 comment
 cloud               azure
 region              westus
 metastore_id        f12dcb34-5678-9d4c-1234-c5ac67f8b90a

-- A recipient created for sharing outside of Databricks
> CREATE RECIPIENT other_org;
> DESCRIBE RECIPIENT other_org;
 info_name               info_value
 ----------------------- ----------
 recipient_name          other_org
 authentication_type     TOKEN
 owner                   alwaysworks@databricks.com
 created_by              alwaysworks@databricks.com
 create_at               2022-01-01T00:00:00.000+0000
 updated_by              alwayswork@databricks.com
 updated_at              2022-01-05T12:00:00.000+0000
 comment                 This is Other Corp
 active_token_id         0160c81f-5262-40bb-9b03-3ee12e6d98d7
 active_token_expiration 2023-01-05T12:00:00.000+0000
 activation_link         https://send/this