REFRESH FOREIGN (CATALOG, SCHEMA, dan TABLE)

Berlaku untuk: Databricks SQL dicentang ya Databricks Runtime 13.3 LTS ke atas Unity Catalog saja

Menyegarkan metadata yang dikelola di Katalog Unity untuk:

• Katalog asing dan elemen yang dapat diamankan
• Skema asing dan jaminannya, atau
• Tabel asing.

Untuk menjalankan REFRESH FOREIGN CATALOG, Anda memerlukan setidaknya salah satu hal berikut:

• Jadilah admin metastore
• Memiliki hak istimewa USE CATALOG pada katalog, hak istimewa USE SCHEMA pada semua skema turunan, dan hak istimewa SELECT pada semua tabel turunan.

Untuk menjalankan REFRESH FOREIGN SCHEMA, Anda memerlukan setidaknya salah satu hal berikut:

• Menjadi admin metastore
• Jadilah pemilik katalog induk
• Memiliki hak istimewa MANAGE dan USE SCHEMA pada skema dan USE CATALOG pada katalog induk
• Memiliki hak istimewa USE CATALOG pada katalog induk, hak istimewa USE SCHEMA pada skema, dan hak istimewa SELECT pada semua tabel anak

Untuk mengeksekusi REFRESH FOREIGN TABLE , Anda memerlukan setidaknya salah satu hal berikut:

• Menjadi admin metastore
• Jadilah pemilik katalog induk
• Jadilah pemilik skema induk dan miliki hak istimewa USE CATALOG pada katalog induk
• Memiliki hak istimewa MANAGE dan USE SCHEMA pada skema induk dan USE CATALOG pada katalog induk
• Memiliki hak istimewa USE CATALOG dan USE SCHEMA pada katalog dan skema induk, masing-masing, dan hak istimewa SELECT pada tabel

Untuk menjalankan klausul opsional RESOLVE DBFS LOCATION dalam rangka memperbarui lokasi DBFS tertentu dari tabel federasi metastore Hive, Anda memerlukan setidaknya salah satu hal berikut:

• Jadilah pemilik tabel.
• Memiliki hak istimewa MANAGE pada tabel, bersama dengan USE SCHEMA pada skema dan USE CATALOG pada katalog induk

Syntax

REFRESH FOREIGN
 { CATALOG foreign_catalog_name |
   SCHEMA foreign_schema_name [ RESOLVE DBFS LOCATION ] |
   TABLE foreign_table_name [ RESOLVE DBFS LOCATION ] }

Parameters

• foreign_catalog_name

  Mengidentifikasi katalog asing untuk di-refresh.

• foreign_schema_name

  Mengidentifikasi skema asing untuk diperbarui.

• foreign_table_name

  Mengidentifikasi tabel asing yang akan diperbarui. Nama tidak boleh menyertakan spesifikasi temporal atau spesifikasi opsi.

• MENYELESAIKAN LOKASI DBFS

  Gunakan opsi ini untuk memperbarui lokasi DBFS yang telah ditetapkan jika tabel atau skema asing merupakan metastore Hive yang telah difederasi, disimpan di DBFS, dan titik pemasangan DBFS yang mendukung tabel telah dipetakan kembali sejak tabel terakhir kali diakses.

  Anda harus menjadi OWNER atau memiliki privilege MANAGE pada tabel atau skema. Untuk informasi selengkapnya tentang federasi metastore Apache Hive, lihat federasi metastore Apache Hive: aktifkan Katalog Unity untuk mengatur tabel yang terdaftar dalam metastore Apache Hive.

  Saat menjalankan REFRESH FOREIGN SCHEMA dengan opsi ini, Katalog Unity memperbarui lokasi DBFS yang diselesaikan skema dan mengalirkan resolusi ke semua tabel dalam skema.

Examples

> REFRESH FOREIGN CATALOG some_catalog;

> REFRESH FOREIGN SCHEMA some_catalog.some_schema;

> REFRESH FOREIGN TABLE some_catalog.some_schema.some_table;

—- Resolves the DBFS location of the foreign table and updates it in Unity Catalog.
> REFRESH FOREIGN TABLE hms_fed_catalog.schema.table RESOLVE DBFS LOCATION;

-- Resolves the DBFS location of the foreign schema and all eligible foreign tables within the schema.
> REFRESH FOREIGN SCHEMA hms_fed_catalog.schema RESOLVE DBFS LOCATION;

Keterbatasan

Untuk tabel Delta, REFRESH FOREIGN CATALOG dan REFRESH FOREIGN SCHEMA tidak memperbarui skema tabel dan peta nilai-kunci properti (bidang kolom dan bidang properti masing-masing). Untuk melakukan ini, jalankan REFRESH FOREIGN TABLE.

Pernyataan terkait

• CREATE CATALOG