تغيير الموقع الخارجي
ينطبق على: 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 }
يجب أن يكون أي اسم كائن يتضمن أحرفا خاصة، مثل الواصلات (-
)، محاطا بخلفيات (` `
). لا تتطلب أسماء الكائنات ذات التسطير السفلي (_
) أحرفا خلفية. راجع الأسماء والأمثلة.
المعلمات
-
تحديد الموقع الخارجي الذي يتم تغييره.
إعادة التسمية إلى 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`