إظهار الجداول التي تم إسقاطها

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime 12.2 LTS وما فوق

هام

هذه الميزة في المعاينة العامة.

يسرد هذا الأمر كافة الجداول التي تم إسقاطها داخل المخطط في كتالوج Unity، ولكن لا يزال من الممكن إلغاء تحديدها. على وجه التحديد، فإنه يسرد جميع الجداول التي تم إسقاطها خلال فترة الاستبقاء (الافتراضي هو 7 أيام). إذا تم إسقاط المخطط أو الكتالوج، يتم رفع خطأ. إذا لم يتم تحديد أي مخطط، إرجاع الجداول من المخطط الحالي.

سيسرد الأمر الجداول التي يمكن للمطالب فقط من UNDROP. وبالتالي، يتمتع مالكو metastore/catalog/schema بامتيازات لسرد جميع الجداول التي تم إسقاطها ضمن الملكية القابلة للتأمين الخاصة بهم. سيتمكن المستخدمون الذين لديهم ملكية على مستوى الجدول فقط من عرض الجداول التي يمتلكونها داخل كتالوج/مخطط الإدخال طالما أن لديهم USE CATALOG الامتياز على الكتالوج الأصل والامتياز USE SCHEMA على المخطط الأصل.

بناء الجملة

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

المعلمات

  • schema_name

    يحدد اسم المخطط الذي سيتم إدراج الجداول منه. إذا لم يتم توفيره، يستخدم المخطط الحالي. إذا لم يكن المخطط أو الكتالوج موجودا أو تم إسقاطه، يتم رفع خطأ SCHEMA_NOT_FOUND .

  • maxResult

    عدد صحيح حرفي يحد من عدد الجداول التي تم إرجاعها.

المرتجعات

ينتج عن الأمر s تقرير بقائمة الجداول بالأعمدة التالية:

الاسم نوع البيانات بدون قيمة الوصف"
اسم الكتالوج سلسلة no اسم كتالوج الجدول المدرج.
اسم المخطط سلسلة no اسم مخطط الجدول المدرج.
اسم الجدول سلسلة no اسم الجدول الذي تم إسقاطه
tableId سلسلة no معرف الجدول الذي يمكن استخدامه لتعريف إصدار معين من الجدول الذي تم إسقاطه وإلغاء إسقاطه.
نوع الجدول سلسلة no نوع الجدول الذي تم إسقاطه في كتالوج Unity
المحذوفات سلسلة no الوقت الذي تم فيه إسقاط الجدول.
إنشاء قاعدة بيانات سلسلة no الوقت الذي تم فيه إنشاء الجدول.
التحديثات سلسلة no الوقت الذي تم فيه تحديث الجدول آخر مرة.
تم الإنشاء من خلال سلسلة no الأساسي الذي أنشأ الجدول.
المالك سلسلة no المدير الذي يمتلك الجدول.
تعليق سلسلة yes تعليق الجدول الاختياري.

الأمثلة

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