KingbaseES SQL Server模式扩展属性管理：三大存储过程实战指南

概述

本文讲解KingbaseES电科金仓数据库引擎的存储过程（SQL Server模式），分别是sp_addextendedproperty，sp_dropextendedproperty，sp_updateextendedproperty，作用的话是允许开发者为数据库对象添加自定义的描述信息

一、sp_addextendedproperty - 添加扩展属性

sp_addextendedproperty存储过程用于将扩展属性添加到数据库对象中，支持从数据库级别到列级别的多层次对象。语法结构如下：

sql 复制代码

sp_addextendedproperty
    [ @name = ] { 'property_name' }
    [ , [ @value = ] { 'value' }
        [ , [ @level0type = ] { 'level0_object_type' }
          , [ @level0name = ] { 'level0_object_name' }
                [,[@level1type= ] { 'level1_object_type' }
                 ,[@level1name= ] { 'level1_object_name' }
                    [,[@level2type=] { 'level2_object_type' }
                     ,[@level2name=] { 'level2_object_name' }
                    ]
                ]
        ]
    ]

我来解释一下参数 @name的类型是name，用于扩展属性名称，值的话不能是NULL @value的类型是sql_variant，是属性值，最大为7500字节 level0type的类型是varchar(128)，是0级对象类型 level0name的类型是name，是0级对象名称然后@level1type和@level1name就是1级对象类型和1级对象名称

对象的层次结构如下：

sql 复制代码

数据库 (Database)
├── 0级对象: SCHEMA, USER, TYPE, FILEGROUP, TRIGGER
│   └── 1级对象: TABLE, VIEW, FUNCTION, PROCEDURE, SEQUENCE
│       └── 2级对象: COLUMN, INDEX, CONSTRAINT, TRIGGER

实战操作

下面来进行实战操作，操作之前要保证我们的计算机安装了KingbaseES 可以参考如下文章来安装麒麟V10 + Docker部署KingbaseES数据库实战教程：点击跳转金仓数据库KingbaseES V9R1C10安装教程 - Windows版详细指南：点击跳转官方教程：点击跳转

案例1：为数据库添加扩展属性

为当前数据库添加版本信息

bash 复制代码

-- 添加数据库版本信息
EXEC sp_addextendedproperty
    @name = 'Database_Version',
    @value = 'v2.1.0';

验证添加结果：

sql 复制代码

-- 查询数据库扩展属性
SELECT class_desc, minor_id, name, value 
FROM sys.extended_properties 
WHERE name = 'Database_Version';

执行结果如下：

sql 复制代码

 class_desc | minor_id |      name       | value
------------+----------+-----------------+-------
 DATABASE   |        0 | Database_Version| v2.1.0
(1 row)

案例2：为Schema添加扩展属性

创建测试Schema并添加属性：

sql 复制代码

-- 创建业务Schema
CREATE SCHEMA business_schema;

-- 为Schema添加描述信息
EXEC sp_addextendedproperty
    @name = 'Description',
    @value = '业务核心数据Schema，包含订单、客户等核心表',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema';

案例3：为表添加扩展属性

创建客户表并添加详细描述：

sql 复制代码

-- 创建客户表
CREATE TABLE business_schema.customers (
    customer_id SERIAL PRIMARY KEY,
    customer_name VARCHAR(100) NOT NULL,
    email VARCHAR(255),
    phone VARCHAR(20),
    created_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 为表添加扩展属性
EXEC sp_addextendedproperty
    @name = 'Table_Purpose',
    @value = '存储客户基本信息，包括联系方式和创建时间',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers';

-- 添加表的创建者信息
EXEC sp_addextendedproperty
    @name = 'Created_By',
    @value = '张三 - 数据架构师',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers';

案例4：为列添加扩展属性

为表的关键列添加详细说明：

sql 复制代码

-- 为customer_id列添加说明
EXEC sp_addextendedproperty
    @name = 'Column_Description',
    @value = '客户唯一标识符，自动递增主键',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers',
    @level2type = 'COLUMN',
    @level2name = 'customer_id';

-- 为email列添加业务规则说明
EXEC sp_addextendedproperty
    @name = 'Business_Rule',
    @value = '邮箱地址必须符合RFC标准，用于发送营销邮件和账单通知',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers',
    @level2type = 'COLUMN',
    @level2name = 'email';

二、sp_dropextendedproperty - 删除扩展属性

sp_dropextendedproperty存储过程用于删除现有的扩展属性，支持精确定位到具体对象的特定属性。语法结构如下：

sql 复制代码

sp_dropextendedproperty
    [ @name = ] { 'property_name' }
    [ , [ @level0type = ] { 'level0_object_type' }
      , [ @level0name = ] { 'level0_object_name' }
          [ , [ @level1type = ] { 'level1_object_type' }
            , [ @level1name = ] { 'level1_object_name' }
              [ , [@level2type= ] { 'level2_object_type' }
                , [@level2name=] { 'level2_object_name' }
              ]
          ]
    ]

实战案例

下面来进行实战操作，我会根据几个案例来进行演示

案例1：删除数据库级别的扩展属性

sql 复制代码

-- 查看当前数据库的扩展属性
SELECT name, value FROM sys.extended_properties 
WHERE class_desc = 'DATABASE';

-- 删除数据库版本信息
EXEC sp_dropextendedproperty
    @name = 'Database_Version';

-- 验证删除结果
SELECT name, value FROM sys.extended_properties 
WHERE class_desc = 'DATABASE' AND name = 'Database_Version';

执行结果

sql 复制代码

 sp_dropextendedproperty
-------------------------
                       0
(1 row)

-- 查询结果为空，表示删除成功

案例2：删除表级别的扩展属性

sql 复制代码

-- 删除表的创建者信息
EXEC sp_dropextendedproperty
    @name = 'Created_By',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers';

案例3：批量删除操作

创建一个便捷的查询来查看所有扩展属性：

sql 复制代码

-- 创建视图来方便查看扩展属性
CREATE OR REPLACE VIEW v_extended_properties AS
SELECT 
    ep.class_desc,
    COALESCE(s.schema_name, '') as schema_name,
    COALESCE(o.object_name, '') as object_name,
    COALESCE(c.column_name, '') as column_name,
    ep.name as property_name,
    ep.value as property_value
FROM sys.extended_properties ep
LEFT JOIN (
    SELECT oid, nspname as schema_name 
    FROM pg_namespace
) s ON ep.major_id = s.oid AND ep.class_desc = 'SCHEMA'
LEFT JOIN (
    SELECT oid, relname as object_name, relnamespace
    FROM pg_class
) o ON ep.major_id = o.oid AND ep.class_desc = 'OBJECT_OR_COLUMN'
LEFT JOIN (
    SELECT attrelid, attname as column_name, attnum
    FROM pg_attribute
) c ON ep.major_id = c.attrelid AND ep.minor_id = c.attnum AND ep.class_desc = 'OBJECT_OR_COLUMN';

-- 查看所有扩展属性
SELECT * FROM v_extended_properties ORDER BY class_desc, schema_name, object_name;

三、sp_updateextendedproperty - 更新扩展属性

sp_updateextendedproperty存储过程用于更改现有扩展属性的值，保持属性名称不变。

语法结果如下：

sql 复制代码

sp_updateextendedproperty  
    [ @name = ]{ 'property_name' }
    [ , [ @value = ]{ 'value' }
        [, [ @level0type = ]{ 'level0_object_type' }
         , [ @level0name = ]{ 'level0_object_name' }
            [, [ @level1type = ]{ 'level1_object_type' }
             , [ @level1name = ]{ 'level1_object_name' }
                [,[@level2type= ]{ 'level2_object_type' }
                ,[@level2name = ]{ 'level2_object_name' }
                ]
            ]  
        ]  
    ]

实战案例

下面来进行实战操作，我会根据几个案例来进行演示

案例1：更新数据库版本信息

sql 复制代码

-- 重新添加数据库版本信息
EXEC sp_addextendedproperty
    @name = 'Database_Version',
    @value = 'v2.1.0';

-- 更新数据库版本到新版本
EXEC sp_updateextendedproperty
    @name = 'Database_Version',
    @value = 'v2.2.0-release';

-- 验证更新结果
SELECT name, value FROM sys.extended_properties 
WHERE name = 'Database_Version';

执行结果如下：

sql 复制代码

 sp_updateextendedproperty
---------------------------
                         0
(1 row)

     name      |     value
---------------+---------------
Database_Version| v2.2.0-release
(1 row)

案例2：更新表描述信息

sql 复制代码

-- 查看当前表的描述
SELECT name, value FROM sys.extended_properties 
WHERE name = 'Table_Purpose';

-- 更新表的用途描述
EXEC sp_updateextendedproperty
    @name = 'Table_Purpose',
    @value = '客户主数据表，存储客户基本信息、联系方式和重要业务标识',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers';

案例3：批量更新列的业务规则

sql 复制代码

-- 为多个列添加数据质量规则
EXEC sp_addextendedproperty
    @name = 'Data_Quality_Rule',
    @value = '不能为空，长度1-100字符',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers',
    @level2type = 'COLUMN',
    @level2name = 'customer_name';

-- 更新数据质量规则
EXEC sp_updateextendedproperty
    @name = 'Data_Quality_Rule',
    @value = '必填字段，长度2-100字符，不能包含特殊符号',
    @level0type = 'SCHEMA',
    @level0name = 'business_schema',
    @level1type = 'TABLE',
    @level1name = 'customers',
    @level2type = 'COLUMN',
    @level2name = 'customer_name';

总结

总结一下，本文详细的介绍了KingbaseES数据库引擎（SQL Server）模式下三个重要的扩展属性管理存储过程。 sp_addextendedproperty：添加扩展属性，为数据库对象增加自定义描述信息 sp_dropextendedproperty：删除扩展属性，清理不需要的元数据 sp_updateextendedproperty：更新扩展属性，修改现有属性值

支持从数据库级别到列级别的完整对象层次结构，以及参数设计的也非常灵活。实际应用价值话在于，可以为数据库对象添加业务含义说明，记录一些数据质量规则和业务规则。便于团队的新成员快速理解数据库结构。

总之，这三个存储过程构成了完整的扩展属性生命周期管理体系，是KingbaseES数据库进行元数据管理和文档化的重要工具，特别适合企业级应用中对数据库对象进行规范化管理的场景。