BUAT KATALOG
Berlaku untuk: Databricks SQL Databricks Runtime 10.4 LTS dan di atas Unity Catalog saja
Membuat katalog dengan nama yang ditentukan. Jika katalog dengan nama yang sama sudah ada, pengecualian akan dibuang.
Saat Anda membuat FOREIGN
katalog, katalog akan diisi dengan semua skema dan tabelnya yang terlihat oleh pengguna yang mengautentikasi.
Sintaks
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 } [ , ... ] )
Parameter
ASING
Berlaku untuk: Databricks SQL Databricks Runtime 13.3 LTS ke atas
Menentukan bahwa katalog diimpor dari KONEKSI.
IF NOT EXISTS
Membuat katalog dengan nama yang ditentukan jika tidak ada. Jika katalog dengan nama yang sama sudah ada, tidak akan terjadi apa-apa.
-
Nama katalog yang akan dibuat.
MENGGUNAKAN share provider_name share_name
.
Secara opsional menentukan bahwa katalog didasarkan pada berbagi Delta Sharing.
-
Nama penyedia Delta Sharing yang menyediakan berbagi.
-
Nama berbagi yang disediakan oleh provider_name.
-
LOKASI TERKELOLA
'location_path'
Secara opsional menentukan jalur ke lokasi penyimpanan terkelola untuk katalog yang berbeda dari lokasi penyimpanan akar metastore. Jalur ini harus ditentukan dalam konfigurasi lokasi eksternal, dan Anda harus memiliki
CREATE MANAGED STORAGE
hak istimewa pada konfigurasi lokasi eksternal. Anda dapat menggunakan jalur yang ditentukan dalam konfigurasi lokasi eksternal atau subpath (dengan kata lain,'abfss://container@storageaccount.dfs.core.windows.net/finance'
atau'abfss://container@storageaccount.dfs.core.windows.net/finance/product'
). Didukung di Databricks SQL atau pada kluster yang menjalankan Databricks Runtime 11.3 LTS ke atas.Lihat juga Bekerja dengan tabel terkelola dan Membuat metastore Unity Catalog.
MENGGUNAKAN connection_name KONEKSI
Menentukan koneksi tempat katalog sumber berada.
komentar
Harfiah opsional
STRING
. Deskripsi untuk katalog.OPSI
Mengatur parameter spesifik jenis koneksi yang diperlukan untuk mengidentifikasi katalog pada koneksi.
pilihan
Kunci opsi. Kunci dapat terdiri dari satu atau beberapa pengidentifikasi yang dipisahkan oleh titik, atau
STRING
harfiah.Kunci opsi harus unik dan peka huruf besar/kecil.
value
Nilai untuk opsi tersebut. Nilai harus berupa
BOOLEAN
ekspresi ,STRING
,INTEGER
, atauDECIMAL
konstanta. Nilainya mungkin juga merupakan panggilan keSECRET
fungsi SQL. Misalnya,value
untukpassword
dapat terdirisecret('secrets.r.us', 'postgresPassword')
daripada memasukkan kata sandi harfiah.
Contoh
-- 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');