إنشاء كتالوج

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

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

عند إنشاء كتالوج FOREIGN ، سيتم ملؤه بجميع المخططات وجداولها المرئية للمستخدم المصادق عليه.

بناء الجملة

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name ]
    [ MANAGED LOCATION 'location_path' ]
    [ COMMENT comment ]

CREATE FOREIGN CATALOG [ IF NOT EXISTS ] catalog_name
    USING CONNECTION connection_name
    [ COMMENT comment ]
    OPTIONS ( { option_name = option_value } [ , ... ] )

المعلمات

• أجنبي

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

  تحديد استيراد الكتالوج من CONNECTION.

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

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

• catalog_name

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

• استخدام SHARE_NAME SHARE provider_name.

  يحدد اختياريا أن الكتالوج يستند إلى مشاركة Delta Sharing.

  • provider_name

    اسم موفر مشاركة دلتا الذي قام بتوفير المشاركة.

  • share_name

    اسم المشاركة التي تقدمها provider_name.

• الموقع المدار 'location_path'

  يحدد اختياريا المسار إلى موقع تخزين مدار للكتالوج الذي يختلف عن موقع التخزين الجذر لمخزن metastore. يجب تعريف هذا المسار في تكوين موقع خارجي، ويجب أن يكون لديك الامتياز CREATE MANAGED STORAGE على تكوين الموقع الخارجي. يمكنك استخدام المسار الذي تم تعريفه في تكوين الموقع الخارجي أو مسار فرعي (بمعنى آخر، 'abfss://container@storageaccount.dfs.core.windows.net/finance' أو 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). مدعوم في Databricks SQL أو على أنظمة المجموعات التي تقوم بتشغيل Databricks Runtime 11.3 LTS وما فوق.

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

• استخدام CONNECTION_NAME الاتصال

  تحديد الاتصال حيث يوجد الكتالوج المصدر.

• التعليق

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

• خيارات

  تعيين معلمات محددة من نوع الاتصال اللازمة لتعريف الكتالوج في الاتصال.

  • option_name

    مفتاح الخيار. يمكن أن يتكون المفتاح من معرف واحد أو أكثر مفصول بنقطة أو حرفيةSTRING.

    يجب أن تكون مفاتيح الخيارات فريدة وأن تكون حساسة لحالة الأحرف.

  • option_value

    قيمة الخيار . يجب أن تكون القيمة تعبير ثابت BOOLEANSTRINGINTEGERأو.DECIMAL قد تكون القيمة أيضا استدعاء لدالة SECRET SQL. على سبيل المثال، value قد يتكون secret('secrets.r.us', 'postgresPassword') ل password بدلا من إدخال كلمة المرور الحرفية.

الأمثلة

-- Create catalog `customer_cat`. This throws exception if catalog with name customer_cat
-- already exists.
> CREATE CATALOG customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist.
> CREATE CATALOG IF NOT EXISTS customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist, with a comment.
> CREATE CATALOG IF NOT EXISTS customer_cat COMMENT 'This is customer catalog';

-- Create a catalog from a Delta Sharing share.
> CREATE CATALOG customer_cat USING SHARE cdc.vaccinedata;

-- Create a catalog with a different managed storage location than the metastore's.
> CREATE CATALOG customer_cat MANAGED LOCATION 'abfss://container@storageaccount.dfs.core.windows.net/finance';

-- Create a foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');

المقالات ذات الصلة

• تغيير الكتالوج
• وصف الكتالوج
• إسقاط الكتالوج
• الاستعلامات الموحدة
• تحديث خارجي
• إظهار المشاركات في الموفر