---
title: "设置行级访问权限控制 | OceanBase 文档中心"
description: 设置行级访问权限控制 OceanBase 数据库兼容了 Oracle 的 Label Security 功能，可以在行级别对访问进行控制，保证读写数据的安全。 Label Security 是强制访问控制的一种方式，通过在表中添加一个 Label 列来记录每行的 Label 值，在访问时通过比较用户的 Label 和…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 3.2.3 企业版 LTS

# 设置行级访问权限控制

更新时间：2023-11-10 15:01:06

OceanBase 数据库兼容了 Oracle 的 Label Security 功能，可以在行级别对访问进行控制，保证读写数据的安全。

Label Security 是强制访问控制的一种方式，通过在表中添加一个 Label 列来记录每行的 Label 值，在访问时通过比较用户的 Label 和数据的 Label，达到约束主体（用户）对客体（表中的数据）访问的目的。

## 使用限制

OceanBase 数据库目前仅支持在 Oracle 租户模式下的 Label Security 功能。

## 示例

### 步骤一：解锁用户

OceanBase 数据库提供了内置的安全管理员 `LBACSYS` 来管理和使用该功能，安全管理员可以通过创建安全策略、定义策略中的 Label、设置用户的 Label，来定制自己的安全策略。一个安全策略可以应用到多张表上，一张表也可以应用多个安全策略。每当一个安全策略被应用，这张表上自动会添加一列，用于该安全策略的访问控制。

1. 使用 `sys` 用户登录到 `Oracle` 租户。
 2. 解锁 `LBACSYS` 用户。

   OceanBase 数据库默认创建了 `LBACSYS` 用户，其密码固定为 `LBACSYS`。该用户处于锁定状态，使用 Label Security 功能需要先启用该用户。

   ```sql
   obclient> ALTER USER LBACSYS ACCOUNT UNLOCK;

   ```

### 步骤二：创建标签安全策略

1. 使用安全管理员 `LBACSYS` 用户登录到 `Oracle` 租户。
 2. 创建策略 `MY_POLICY`。

   有关创建新的标签安全策略的详细信息，请参见 [SA_SYSDBA.CREATE_POLICY](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000356786)。

   示例如下：

   ```sql
   obclient> CALL SA_SYSDBA.CREATE_POLICY('MY_POLICY','MY_LABEL','');

   ```

### 步骤三：为标签安全策略创建级别

1. 使用安全管理员 `LBACSYS` 用户登录到 `Oracle` 租户。
 2. 创建级别 Level 并指定其短名称和长名称。

   有关创建级别的详细信息，请参见 [SA_COMPONENTS.CREATE_LEVEL](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000356807)。

   示例如下：

   ```sql
   obclient> CALL SA_COMPONENTS.CREATE_LEVEL('MY_POLICY', 100, 'PUBLIC','Public Level');

   obclient> CALL SA_COMPONENTS.CREATE_LEVEL('MY_POLICY', 200, 'INTERNAL','Internal Level');

   obclient> CALL SA_COMPONENTS.CREATE_LEVEL('MY_POLICY', 300, 'HIGH', 'High Level');

   obclient> SELECT * FROM sys.ALL_VIRTUAL_TENANT_OLS_COMPONENT_AGENT;
   +-----------+-----------------------+------------------------------+------------------------------+--------------------+-----------+----------+------------+----------------+-------------+
   | TENANT_ID | LABEL_SE_COMPONENT_ID | GMT_CREATE                   | GMT_MODIFIED                 | LABEL_SE_POLICY_ID | COMP_TYPE | COMP_NUM | SHORT_NAME | LONG_NAME      | PARENT_NAME |
   +-----------+-----------------------+------------------------------+------------------------------+--------------------+-----------+----------+------------+----------------+-------------+
   |      1002 |      1101710651032553 | 30-DEC-21 02.35.19.069966 PM | 30-DEC-21 02.35.19.069966 PM |   1101710651032553 |         0 |      100 | PUBLIC     | PUBLIC LEVEL   | NULL        |
   |      1002 |      1101710651032554 | 30-DEC-21 02.35.25.787711 PM | 30-DEC-21 02.35.25.787711 PM |   1101710651032553 |         0 |      200 | INTERNAL   | INTERNAL LEVEL | NULL        |
   |      1002 |      1101710651032555 | 30-DEC-21 02.35.31.772544 PM | 30-DEC-21 02.35.31.772544 PM |   1101710651032553 |         0 |      300 | HIGH       | HIGH LEVEL     | NULL        |
   +-----------+-----------------------+------------------------------+------------------------------+--------------------+-----------+----------+------------+----------------+-------------+
   3 rows in set

   ```

### 步骤四：创建数据标签 Label

1. 使用安全管理员 `LBACSYS` 用户登录到 `Oracle` 租户。
 2. 创建数据标签 Label 并查看结果。

   有关创建数据标签的详细信息，请参见 [SA_LABEL_ADMIN.CREATE_LABEL](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000356790)。

   示例如下：

   ```sql
   obclient> DELIMITER /
   obclient> BEGIN
               SA_LABEL_ADMIN.CREATE_LABEL('MY_POLICY',10000,'PUBLIC',TRUE);
               SA_LABEL_ADMIN.CREATE_LABEL('MY_POLICY',20000,'INTERNAL',TRUE);
               SA_LABEL_ADMIN.CREATE_LABEL('MY_POLICY',30000, 'HIGH',TRUE);
             END;
            /
   Query OK, 0 rows affected

   obclient> DELIMITER ;
   obclient> SELECT * FROM sys.ALL_VIRTUAL_TENANT_OLS_LABEL_AGENT;
   +-----------+-------------------+------------------------------+------------------------------+--------------------+-----------+----------+------+
   | TENANT_ID | LABEL_SE_LABEL_ID | GMT_CREATE                   | GMT_MODIFIED                 | LABEL_SE_POLICY_ID | LABEL_TAG | LABEL    | FLAG |
   +-----------+-------------------+------------------------------+------------------------------+--------------------+-----------+----------+------+
   |      1002 |  1101710651032553 | 30-DEC-21 02.41.06.668980 PM | 30-DEC-21 02.41.06.668980 PM |   1101710651032553 |     10000 | PUBLIC   |    1 |
   |      1002 |  1101710651032554 | 30-DEC-21 02.42.09.740930 PM | 30-DEC-21 02.42.09.740930 PM |   1101710651032553 |     20000 | INTERNAL |    1 |
   |      1002 |  1101710651032555 | 30-DEC-21 02.42.09.750423 PM | 30-DEC-21 02.42.09.750423 PM |   1101710651032553 |     30000 | HIGH     |    1 |
   +-----------+-------------------+------------------------------+------------------------------+--------------------+-----------+----------+------+
   3 rows in set

   ```

### 步骤五：指定用户的 Label

1. 以 `sys` 用户登录到 `Oracle` 租户，创建用户 `user1` 并授予用户 `user1` 除 `GRANT OPTION` 以外所有当前用户拥有的权限。

   ```sql
   obclient> CREATE USER user1 IDENTIFIED BY ******;
   Query OK, 0 rows affected

   obclient> GRANT ALL PRIVILEGES TO user1;
   Query OK, 0 rows affected

   ```
 2. 以安全管理员 `LBACSYS` 登录，为用户 `user1` 指定 Label。

   有关为用户指定标签的详细信息，请参见 [SA_USER_ADMIN.SET_LEVELS](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000356804)。

   ```sql
   obclient> CALL SA_USER_ADMIN.SET_LEVELS('MY_POLICY', 'user1', 'HIGH','PUBLIC', 'PUBLIC', 'PUBLIC');
   Query OK, 0 rows affected

   obclient> SELECT * FROM sys.ALL_VIRTUAL_TENANT_OLS_USER_LEVEL_AGENT;
   +-----------+------------------------+------------------------------+------------------------------+------------------+--------------------+---------------+---------------+---------------+-----------+
   | TENANT_ID | LABEL_SE_USER_LEVEL_ID | GMT_CREATE                   | GMT_MODIFIED                 | USER_ID          | LABEL_SE_POLICY_ID | MAXIMUM_LEVEL | MINIMUM_LEVEL | DEFAULT_LEVEL | ROW_LEVEL |
   +-----------+------------------------+------------------------------+------------------------------+------------------+--------------------+---------------+---------------+---------------+-----------+
   |      1002 |       1101710651032553 | 30-DEC-21 04.04.06.712035 PM | 30-DEC-21 04.04.06.712035 PM | 1101710651032553 |   1101710651032553 |           300 |           100 |           100 |       100 |
   +-----------+------------------------+------------------------------+------------------------------+------------------+--------------------+---------------+---------------+---------------+-----------+
   1 row in set

   ```

### 步骤六：将标签策略应用到表上

1. 以 `user1` 用户登录到 `Oracle` 租户，创建表 `tbl1`。

   ```sql
   obclient> CREATE TABLE tbl1(col1 INT,col2 INT);
   Query OK, 0 rows affected

   ```
 2. 以安全管理员 `LBACSYS` 登录，将策略 `MY_POLICY` 应用到表 `tbl1` 上。

   有关将指定的策略添加到表中的详细信息，请参见 [SA_POLICY_ADMIN.APPLY_TABLE_POLICY](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000356793)。

   ```sql
   obclient> CALL SA_POLICY_ADMIN.APPLY_TABLE_POLICY('MY_POLICY','user1', 'tbl1', '', '', '');
    Query OK, 0 rows affected

   ```

### 步骤七：测试标签安全策略

向表中插入数据，根据查询结果进行验证。

1. 以 `user1` 用户登录，在 `tbl1` 表中插入 `col1` 和 `MY_LABEL` 两列数据。

   ```sql
   obclient> INSERT INTO tbl1 VALUES(1,1,10000);
   Query OK, 1 row affected

   obclient> INSERT INTO tbl1(MY_LABEL) VALUES(20000);
   Query OK, 1 row affected

   obclient> INSERT INTO tbl1(col1) VALUES (2);
   Query OK, 1 row affected

   obclient> COMMIT;
   Query OK, 0 rows affected

   ```
 2. 在 `user1` 用户下设置 `SESSION LABEL` 和 `ROW LABEL`。

   有关设置当前数据库会话的标签的详细信息，请参见 [SA_SESSION.SET_LABEL](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000356801)；有关设置当前数据库会话的默认行标签值，请参见 [SA_SESSION.SET_ROW_LABEL](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000356802)。

   ```sql
   obclient> CALL SA_SESSION.SET_LABEL('MY_POLICY', 'INTERNAL');
   Query OK, 0 rows affected

   obclient> CALL SA_SESSION.SET_ROW_LABEL('MY_POLICY', 'INTERNAL');
   Query OK, 0 rows affected

   obclient> SELECT SA_SESSION.LABEL('MY_POLICY') FROM DUAL;
   +-------------------------------+
   | SA_SESSION.LABEL('MY_POLICY') |
   +-------------------------------+
   | INTERNAL                      |
   +-------------------------------+
   1 row in set

   obclient> SELECT SA_SESSION.ROW_LABEL('MY_POLICY') FROM DUAL;
   +-----------------------------------+
   | SA_SESSION.ROW_LABEL('MY_POLICY') |
   +-----------------------------------+
   | INTERNAL                          |
   +-----------------------------------+
   1 row in set

   ```
 3. 进行查询，可以看到用户 `user1` 可以访问到 Level 为 `INTERNAL` 以下级别的数据。

   ```sql
   obclient> SELECT * FROM tbl1;
   +------+------+----------+
   | COL1 | COL2 | MY_LABEL |
   +------+------+----------+
   |    1 |    1 |    10000 |
   | NULL | NULL |    20000 |
   |    2 | NULL |    10000 |
   +------+------+----------+
   3 rows in set

   ```
 4. 修改 Label 后，再次查询，可以看到用户 `user1` 只能访问到 Level 为 `PUBLIC` 级别的数据。

   ```sql
   obclient> CALL SA_SESSION.SET_LABEL('MY_POLICY', 'PUBLIC');
   Query OK, 0 rows affected

   obclient> CALL SA_SESSION.SET_ROW_LABEL('MY_POLICY', 'PUBLIC');
   Query OK, 0 rows affected

   obclient> SELECT * FROM tbl1;
   +------+------+----------+
   | COL1 | COL2 | MY_LABEL |
   +------+------+----------+
   |    1 |    1 |    10000 |
   |    2 | NULL |    10000 |
   +------+------+----------+
   2 rows in set

   ```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
