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.

Important

Parola veya belirteç gibi bir kimlik bilgilerini taşıyan katalog seçeneklerini, bunların güvenliğini sağlamak için ayarladığınızdaOPTIONS, değişmez değeri doğrudan yan tümcesine girmek yerine işlevini kullanarak secret değeri sağlayın. Bu, deyiminize kimlik bilgisi değeri dahil olmak yerine Databricks gizli dizi hizmetinde depolanan bir gizli diziye başvurmanızı sağlar.

Sözdizimi

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      RETAIN DROPPED FOR number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
      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 OpenSharing paylaşımını temel alındığı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 . Delta Lake ve Apache Iceberg için Unity Kataloğu yönetilen tabloları ve Unity Kataloğu meta veri deposu oluşturma.

  • { HOUR SAYıSı IÇIN BıRAKıLANı KORU | SAAT | GÜN | GÜN | HAFTA | HAFTALAR }

    Şunun için geçerlidir:evet olarak işaretlendi Databricks Runtime 17.3 ve üzeri onay onay işareti evet yalnızca Unity Kataloğu

    Important

    Bu özellik Genel Önizleme aşamasındadır.

    İsteğe bağlı olarak, bırakılan yönetilen tabloların kurtarma süresini katalogda ayarlar. Bırakılan tabloların kurtarılma süresi komutuyla UNDROP TABLE gerçekleştirilir. Belirtilmezse, varsayılan değer 7 gündür. Değer 0 saat (kurtarmayı devre dışı bırakmak için) veya 7-30 gün (dahil) arasında olmalıdır.

    Kurtarma süresini 0 olarak ayarlamak, bırakılan tabloların kullanılarak UNDROP kurtarılmaması ve veri dosyalarının 48 saat içinde bulut depolama alanından silinmesi anlamına gelir.

    Bir alt şemada da kurtarma süresi ayarlanırsa, şema düzeyi ayarı bu şemadaki tablolar için önceliklidir. Bu ayar yalnızca kurtarma dönemi yapılandırıldıktan sonra bırakılan tablolar için geçerlidir. Kurtarma süresi sona erdikten sonra, yönetilen tablolara ait veri dosyaları 48 saat içinde bulut depolama alanınızdan silinir.

    Yabancı veya paylaşılan kataloglar için desteklenmez. Ayrıca bkz . Yönetilen tabloyu bırakma.

  • 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.

Ö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 catalog with a 30-day recovery period for dropped managed tables.
> CREATE CATALOG customer_cat RETAIN DROPPED FOR 30 DAYS;

-- 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