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

  • مقالة

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

تغيير خصائص موقع خارجي أو إعادة تسمية الموقع.

بناء الجملة

ALTER EXTERNAL LOCATION location_name
   { RENAME TO to_location_name |
     SET URL url_str [ FORCE ] |
     SET STORAGE CREDENTIAL credential_name |
     [ SET ] OWNER TO principal }

يجب أن يكون أي اسم كائن يتضمن أحرفا خاصة، مثل الواصلات (-)، محاطا بخلفيات (` `). لا تتطلب أسماء الكائنات ذات التسطير السفلي (_) أحرفا خلفية. راجع الأسماء والأمثلة.

المعلمات

  • location_name

    تحديد الموقع الخارجي الذي يتم تغييره.

  • إعادة التسمية إلى to_location_name

    إعادة تسمية الموقع. يجب أن يكون الاسم فريدا بين جميع المواقع في metastore.

  • SET URL url_str [ FORCE ]

    url_str يجب أن يكون حرفيا STRING مع موقع التخزين السحابي الموصوف على أنه عنوان URL مطلق.

    ما لم تحدد FORCE العبارة ستفشل إذا كان الموقع قيد الاستخدام حاليا.

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

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

  • [ SET ] المالك إلى الأساسي

    نقل ملكية موقع التخزين إلى principal.

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

    SET مسموح به ككلمة أساسية اختيارية.

امثله

تستخدم الأمثلة التالية أسماء المواقع التي لا تتضمن أحرفا خاصة، مثل الواصلات (-). يجب أن يكون أي اسم كائن يتضمن أحرفا خاصة محاطا بخلفية (` `). راجع الأسماء.

-- Rename a location
> ALTER EXTERNAL LOCATION descend_loc RENAME TO decent_loc;

-- Redirect the URL associated with the location
> ALTER EXTERNAL LOCATION best_loc SET URL 'abfss://container@storageaccount.dfs.core.windows.net/best_location' FORCE;

-- Change the credentials used to access the location
> ALTER EXTERNAL LOCATION best_loc SET STORAGE CREDENTIAL street_cred;

-- Change ownership of the external location
> ALTER EXTERNAL LOCATION best_loc OWNER TO `alf@melmak.et`