查看表属性

功能描述

查看表的属性。SHOW TBLPROPERTIES 用于返回表的属性键值对信息，可查看全部属性或指定属性的值。

语法格式

SHOW TBLPROPERTIES [ db_name. ] table_name [ ( 'property_name' ) ]

关键字

SHOW TBLPROPERTIES：查看表属性的关键字，TBLPROPERTIES和PROPERTIES可互换使用。

参数说明

注意事项

• property_name 大小写敏感。例如 'owner' 和 'Owner' 是不同的属性。
• 不能同时指定多个 property_name，否则会出错。
• 若指定的 property_name 不存在，将返回空值。

示例1：查看表的所有属性

查看 employee 表的所有属性及其值。

SHOW TBLPROPERTIES employee;

返回结果示例：

+---------------------+--------------------+
|key                  |value               |
+---------------------+--------------------+
|owner                |spark               |
|transient_lastDdlTime|1718534400          |
+---------------------+--------------------+

示例2：查看指定属性的值

查看 employee 表中属性 owner 的值。

SHOW TBLPROPERTIES employee ('owner');

返回结果示例：

+-----+
|value|
+-----+
|spark|
+-----+

示例3：查看带自定义属性的表的属性

先创建一个带有自定义TBLPROPERTIES的表，再查看其属性：

-- 创建带有自定义属性的表
CREATE TABLE employee (id INT, name STRING)
  TBLPROPERTIES ('owner' = 'admin', 'department' = 'hr', 'created_by' = 'spark_sql');

-- 查看所有属性
SHOW TBLPROPERTIES employee;

示例4：property_name 大小写敏感说明

property_name 大小写敏感，以下查询将返回不同结果：

-- 查看小写属性名 'owner' 的值（可正确匹配）
SHOW TBLPROPERTIES employee ('owner');

-- 查看大写属性名 'Owner' 的值（与 'owner' 不同，可能返回空值）
SHOW TBLPROPERTIES employee ('Owner');

'owner' 和 'Owner' 被视为不同的属性名。使用时需确保大小写与定义时一致。