إظهار TBLPROPERTIES

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

إرجاع قيمة خاصية جدول نظرا لقيمة اختيارية لمفتاح خاصية. إذا لم يتم تحديد مفتاح، إرجاع جميع الخصائص والخيارات. خيارات الجدول مسبوقة ب option.

بناء الجملة

SHOW TBLPROPERTIES table_name
   [ ( [unquoted_property_key | property_key_as_string_literal] ) ]

unquoted_property_key
  key_part1 [. ...]

المعلمات

  • table_name

    تعريف الجدول. يجب ألا يتضمن الاسم مواصفات زمنية.

  • unquoted_property_key

    مفتاح الخاصية في نموذج غير مدرج. يمكن أن يتكون المفتاح من أجزاء متعددة مفصولة بنقطة.

  • property_key_as_string_literal

    قيمة مفتاح الخاصية كسلسلة حرفية.

إشعار

تستبعد قيمة الخاصية التي تم إرجاعها بواسطة هذه العبارة بعض الخصائص الداخلية ل spark و hive. الخصائص المستبعدة هي:

  • كافة الخصائص التي تبدأ بالبادئة spark.sql
  • مفاتيح الخصائص مثل: EXTERNAL، comment
  • جميع الخصائص التي تم إنشاؤها داخليا بواسطة الخلية لتخزين الإحصائيات. بعض هذه الخصائص هي: numFiles، ، numPartitions. numRows

الأمثلة

-- create a table `customer` in schema `salessc`
> USE salessc;
> CREATE TABLE customer(cust_code INT, name VARCHAR(100), cust_addr STRING)
    TBLPROPERTIES ('created.by.user' = 'John', 'created.date' = '01-01-2001');

-- show all the user specified properties for table `customer`
> SHOW TBLPROPERTIES customer;
                   key      value
 --------------------- ----------
       created.by.user       John
          created.date 01-01-2001
 transient_lastDdlTime 1567554931

-- show all the user specified properties for a qualified table `customer`
-- in schema `salessc`
> SHOW TBLPROPERTIES salessc.customer;
                   key      value
 --------------------- ----------
       created.by.user       John
          created.date 01-01-2001
 transient_lastDdlTime 1567554931

-- show value for unquoted property key `created.by.user`
> SHOW TBLPROPERTIES customer (created.by.user);
 value
 -----
  John

-- show value for property `created.date`` specified as string literal
> SHOW TBLPROPERTIES customer ('created.date');
      value
 ----------
 01-01-2001