南大通用GBase8s 常用SQL语句（183）

1. 1. RENAME TRUSTED CONTEXT 语句

使用 RENAME TRUSTED CONTEXT 语句来更改可信的上下文对象的名称。

此语句是对 SQL 的 ANSI/ISO 标准的扩展。您必须持有数据库安全管理员（DBSECADM）角色来重命名可信的上下文。

语法

 

元素	描述	限制	语法
old_name	new_name 替代的可信的上下文标识符	必须为数据库服务器的现有的可信的上下文对象	标识符
new_name	您在此为可信的上下文声明的新名称	必须为一部分名称，无限定符。它不可以字符 "SYS" 开头，且必须不标识在数据库服务器上业已存在的可信的上下文。	标识符

用法

new_name 和 old_name 不可包括限定符，诸如 owner、database 或 dbserver。

成功地执行 RENAME TRUSTED CONTEXT 语句之后，所有对 old_name 的引用都会被 GBase 8s 数据库服务器实例的 sysuser 数据库中的这些表中的 new_name 所替代：

1. systrustedcontext
2. systcxattributes
3. systcxusers.

此外，那些尝试通过引用该 old_name 来建立到该数据库的连接的应用程序将会失败，除非已经声明该 old_name 作为新的可信的上下文对象的标识符。

如果在此上下文的可信的连接为活动的时候，您重命名该可信的上下文，则那些连接保持为可信的，直到它们终止为止，或直到下一重用尝试为止。然而，如果尝试着切换在这些可信的连接上的用户，则返回错误。

下例是一个完整的 RENAME TRUSTED CONTEXT 语句，以 cntx2 作为 cntx1 可信的上下文的新名称替代安全对象标识符 cntx1：

RENAME TRUSTED CONTEXT cntx1 TO cntx2;

在下列任一情况下，此示例失败：

• 如果 cntx1 不是当前数据库服务器实例的可信的上下文对象的名称，
• 或如果 cntx2 已是同一数据库服务器的现有的可信的上下文对象的名称。