Aracılığıyla paylaş

CREATE CATALOG

Şunlar için geçerlidir:onay işareti ekli evet Databricks SQL onay işareti ekli evet Databricks Runtime 10.4 LTS ve üzeri onay işareti ekli evet yalnızca Unity Kataloğu için onaylandı

Belirtilen ada sahip bir katalog oluşturur. Zaten aynı ismde bir katalog varsa bir istisna oluşur.

bir FOREIGN kataloğu oluşturduğunuzda, bu katalog tüm şemalarla ve bunların tabloları kimlik doğrulayıcı kullanıcı tarafından görülebilir şekilde doldurulur.

Sözdizimi

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      COMMENT comment |
      DEFAULT COLLATION default_collation_name |
      OPTIONS ( { option_name = option_value } [ , ... ] ) ] [...]

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

Parametreler

  • YABANCI

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 13.3 LTS ve üzeri

    Kataloğun bir BAĞLANTIiçeri aktarıldığını belirtir.

  • YOKSA

    Mevcut değilse verilen ada sahip bir katalog oluşturur. Aynı isimde bir katalog zaten mevcutsa, hiçbir şey olmaz.

  • catalog_name

    Oluşturulacak kataloğun adı.

  • SHARE provider_name.share_name KULLANMA

    İsteğe bağlı olarak, kataloğun Delta Sharing paylaşımı'e dayandığını belirtir.

  • YÖNETİLEN KONUM location_path

    İsteğe bağlı olarak, meta veri deposunun kök depolama konumundan farklı olan kataloğun yönetilen depolama konumunun yolunu belirtir. Bu yol bir dış konum yapılandırmasında tanımlanmalıdır ve dış konum yapılandırmasında ayrıcalığınız olmalıdır CREATE MANAGED STORAGE . Dış konum yapılandırmasında veya bir alt yolda (başka bir deyişle 'abfss://container@storageaccount.dfs.core.windows.net/finance' veya 'abfss://container@storageaccount.dfs.core.windows.net/finance/product') tanımlanan yolu kullanabilirsiniz. Databricks SQL'de veya Databricks Runtime 11.3 LTS ve üzerini çalıştıran kümelerde desteklenir.

    Ayrıca bkz Azure Databricks'te Delta Lake ve Apache Iceberg için Unity Kataloğu tarafından yönetilen tablolar ve Unity Kataloğu meta deposu oluşturma.

  • BAĞLANTı connection_name KULLANMA

    Kaynak kataloğun bulunduğu bağlantıyı belirtir.

  • yorum

    İsteğe bağlı STRING bir değişmez değer. Kataloğun açıklaması.

  • VARSAYıLAN HARMANLAMA default_collation_name

    Şunun için geçerlidir:onay işareti evet Databricks SQL onay işareti evet Databricks Runtime 17.1 ve üzeri

    İsteğe bağlı olarak, katalogda tanımlanan nesneler için varsayılan harmanlamayı tanımlar. Belirtilmezse varsayılan harmanlama olur UTF8_BINARY.

  • SEÇENEKLER

    Bağlantıdaki kataloğu tanımlamak için gereken bağlantı türüne özgü parametreleri ayarlar.

    • option_name

      Seçenek tuşu. Anahtar, nokta veya değişmez değerle ayrılmış bir veya daha fazla STRING oluşabilir.

      Seçenek anahtarları benzersiz olmalı ve büyük/küçük harfe duyarlı olmalıdır.

    • seçenek_değeri

      Seçeneğin değeri. Değer bir BOOLEAN, STRING, INTEGERveya DECIMALsabit ifadesi olmalıdır. Değer, SQL işlevine SECRET yapılan bir çağrı da olabilir. Örneğin, value değişmez değer parolasını girmek yerine için password değeri oluşabilir secret('secrets.r.us', 'postgresPassword') .

Örnekler

-- 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 catalog with a case insesnitive and accent insensitive default collation.
> CREATE CATALOG customer_cat DEFAULT COLLATION UNICODE_CI_AI;

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