PERLIHATKAN TABEL YANG DIHILANGKAN

  • Artikel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 12.2 LTS ke atas

Penting

Fitur ini ada di Pratinjau Publik.

Perintah ini mencantumkan semua tabel yang telah dihilangkan dalam skema di Katalog Unity, tetapi masih dapat di-undropped. Secara khusus, ini mencantumkan semua tabel yang dihilangkan dalam periode retensi (defaultnya adalah 7 hari). Jika skema atau katalog telah dihilangkan, kesalahan akan muncul. Jika tidak ada skema yang ditentukan, maka tabel dikembalikan dari skema saat ini.

Perintah hanya akan mencantumkan tabel yang dapat di-UNDROP oleh pemohon. Akibatnya, pemilik metastore/katalog/skema memiliki hak istimewa untuk mencantumkan semua tabel yang dihilangkan dalam kepemilikannya masing-masing yang dapat diamankan. Pengguna dengan kepemilikan tingkat tabel hanya akan dapat melihat tabel yang mereka miliki dalam katalog/skema input selama mereka memiliki USE CATALOG hak istimewa pada katalog induk dan USE SCHEMA hak istimewa pada skema induk.

Sintaks

SHOW TABLES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]

Parameter

  • schema_name

    Menentukan nama skema dari tabel mana yang akan dicantumkan. Jika tidak disediakan, gunakan skema saat ini. Jika skema atau katalog tidak ada atau telah dihilangkan, kesalahan SCHEMA_NOT_FOUND akan muncul.

  • maxResult

    Bilangan bulat yang membatasi jumlah tabel yang dikembalikan.

Mengembalikan

Perintah menghasilkan laporan daftar tabel dengan kolom berikut:

Nama Jenis Data Dapat diubah ke null Deskripsi"
catalogName STRING no Nama katalog tabel yang tercantum.
schemaName STRING no Nama skema tabel yang tercantum.
tableName STRING no Nama tabel yang dihilangkan
tableId STRING no ID tabel yang dapat digunakan untuk mengidentifikasi dan membatalkan status versi tertentu dari tabel yang dihilangkan.
tableType STRING no Jenis tabel yang dihilangkan di Katalog Unity
deletedAt STRING no Waktu ketika tabel dihilangkan.
createdAt STRING no Waktu ketika tabel dibuat.
updatedAt STRING no Waktu saat tabel terakhir diperbarui.
createdBy STRING no Kepala sekolah yang membuat tabel.
pemilik STRING no Kepala sekolah yang memiliki meja.
komentar STRING yes Komentar tabel opsional.

Contoh

— List dropped tables from an existing schema + catalog.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> CREATE TABLE my_table_2;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

-- Create a new table with name `my_table_1` since other was dropped.
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED IN default.my_schema;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

— List dropped tables when some are past the retention period.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
-- Wait 8 days (1 more than 7 day retention period)
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner        comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------