PostgreSQL 17 文档: SECURITY LABEL

SECURITY LABEL
上一个	上	SQL 命令	主页	下一个

SECURITY LABEL

SECURITY LABEL — 定义或更改应用到对象的安全性标签

语法

SECURITY LABEL [ FOR provider ] ON
{
  TABLE object_name |
  COLUMN table_name.column_name |
  AGGREGATE aggregate_name ( aggregate_signature ) |
  DATABASE object_name |
  DOMAIN object_name |
  EVENT TRIGGER object_name |
  FOREIGN TABLE object_name |
  FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
  LARGE OBJECT large_object_oid |
  MATERIALIZED VIEW object_name |
  [ PROCEDURAL ] LANGUAGE object_name |
  PROCEDURE procedure_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
  PUBLICATION object_name |
  ROLE object_name |
  ROUTINE routine_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
  SCHEMA object_name |
  SEQUENCE object_name |
  SUBSCRIPTION object_name |
  TABLESPACE object_name |
  TYPE object_name |
  VIEW object_name
} IS { string_literal | NULL }

where aggregate_signature is:

* |
[ argmode ] [ argname ] argtype [ , ... ] |
[ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname ] argtype [ , ... ]

描述

SECURITY LABEL 将安全性标签应用到数据库对象。可以将任意数量的安全性标签（每个标签提供者一个）与给定的数据库对象关联起来。标签提供者是可以加载的模块，它们会使用函数 register_label_provider 注册自己。

注释

register_label_provider 不是一个 SQL 函数；它只能从加载到后端的 C 代码中进行调用。

标签提供者确定给定的标签是否有效以及是否允许将该标签分配给给定对象。给定标签的含义同样由标签提供者自行决定。

PostgreSQL 没有限制标签提供者如何解释安全标签；它仅提供用于存储标签的机制。在实践中，此机制旨在允许与基于标签的强制访问控制 (MAC) 系统（例如 SELinux）集成。这些系统基于对象标签（而不是传统任意访问控制 (DAC) 概念，例如用户和组）来做出所有访问控制决策。

参数: object_name
table_name.column_name
aggregate_name
function_name
procedure_name
routine_name
需要标记的对象名称。驻留在模式（表、函数等）中的对象的名称可以是对模式限定的。: provider
与该标签关联的提供者的名称。命名的提供者必须加载并必须同意拟议的标记操作。如果仅加载了一个提供者，则可以省略提供者名称以简化操作。: argmode
函数、过程或聚集函数参数的模式：IN、OUT、INOUT 或 VARIADIC。如果省略，则默认为 IN。请注意，SECURITY LABEL实际上并未关注OUT 参数，因为只需要输入参数即可确定函数的身份。因此，列出 IN、INOUT 和 VARIADIC 参数就足够了。: argname
函数、过程或聚集函数参数的名称。请注意，SECURITY LABEL实际上并不关注参数名称，因为只需要参数数据类型即可确定函数的身份。: argtype
函数、过程或聚集函数参数的数据类型。: large_object_oid
大对象 OID。: PROCEDURAL
这是一个噪音词。: string_literal
作为字符串文字编写的安全标签的新设置。: NULL

编写 `NULL` 可删除安全标签。

以下示例展示如何设置或更改表的安全标签

SECURITY LABEL FOR selinux ON TABLE mytable IS 'system_u:object_r:sepgsql_table_t:s0';

删除标签

SECURITY LABEL FOR selinux ON TABLE mytable IS NULL;

兼容性

SQL 标准中没有 SECURITY LABEL 命令。

另请参见

sepgsql、src/test/modules/dummy_seclabel

SECURITY LABEL

语法

描述

注释

编写 NULL 可删除安全标签。

兼容性

另请参见

编写 `NULL` 可删除安全标签。