# 查看表属性
#### 功能描述
查看表的属性。SHOW TBLPROPERTIES 用于返回表的属性键值对信息，可查看全部属性或指定属性的值。
#### 语法格式
```
SHOW TBLPROPERTIES [ db_name. ] table_name [ ( 'property_name' ) ]
```
#### 关键字
**SHOW TBLPROPERTIES**：查看表属性的关键字，TBLPROPERTIES和PROPERTIES可互换使用。
#### 参数说明
| **参数**            | **是否必选** | **描述**                                                                                               |
|:---|:---|:---|
| **db_name**       | 否        | 数据库名称。若未指定，则默认使用当前数据库。                                                                               |
| **table_name**    | 是        | 表名称。                                                                                                 |
| **property_name** | 否        | 属性名称，需用单引号包围。若未指定，则返回表的所有属性及其值；若指定，则仅返回该属性对应的值。注意：property_name 大小写敏感，且不能同时指定多个 property_name，否则会出错。 |
   
#### 注意事项
- 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' 被视为不同的属性名。使用时需确保大小写与定义时一致。