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

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

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

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

بناء الجملة

CREATE EXTERNAL LOCATION [IF NOT EXISTS] location_name
    URL url_str
    WITH (STORAGE CREDENTIAL credential_name)
    [COMMENT comment]

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

المعلمات

  • location_name

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

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

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

  • url_str

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

  • credential_name

    بيانات الاعتماد المسماة المستخدمة للاتصال بهذا الموقع.

  • التعليق

    وصف اختياري للموقع أو NULL. الافتراضي هو NULL.

امثله

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION abfss_remote URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL abfss_remote_cred)
    COMMENT 'Default source for Azure exernal data';

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

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION `abfss-remote` URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL `abfss-remote-cred`)
    COMMENT 'Default source for Azure exernal data';