KATALOG OLUŞTURMA

  • Makale

Şunlar için geçerlidir:check marked yes Yalnızca Databricks SQL check marked yes Databricks Runtime 10.3 ve üzeri check marked yes Unity Kataloğu

Belirtilen ada sahip bir katalog oluşturur. Aynı ada sahip bir katalog zaten varsa, bir özel durum oluşturulur.

Bir FOREIGN katalog oluşturduğunuzda, tüm şemalar ve bunların tabloları kimlik doğrulayıcı kullanıcı tarafından görülebilir.

Sözdizimi

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 } [ , ... ] )

Parametreler

  • YABANCI

    Şunlar için geçerlidir:check marked yes Databricks SQL check marked yes Databricks Runtime 13.1 ve üzeri

    Kataloğun BIR BAĞLANTIDAN içeri aktarıldığını belirtir.

  • YOKSA

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

  • Catalog_name

    Oluşturulacak kataloğun adı.

  • SHARE provider_name.share_name KULLANMA

    İsteğe bağlı olarak, kataloğun bir Delta Sharing paylaşımını temel alındığını belirtir.

  • YÖNETILEN 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. Yönetilen tablolar ve Unity Kataloğu meta veri 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ı.

  • OPTIONS

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

    • seçenek

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

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

    • value

      Seçeneğin değeri. Değer bir BOOLEAN, STRING, INTEGERveya DECIMAL sabit 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 foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');