SET SCHEMA 语句

调用 SET SCHEMA

此语句可嵌入应用程序中或者以交互方式发出。 它是可动态准备的可执行语句。

授权 SET SCHEMA

不需要执行任何操作。

描述 SET SCHEMA

schema-name

标识模式。 在设置当前架构时，不验证架构是否存在。 例如，如果一个模式名称拼写错误，可能会影响后续SQL的运行方式。

SESSION_USER 或 USER

指定 SESSION_USER（USER）特殊寄存器的值。

主机变量

指定一个包含模式名称的主变量。 内容不会自动变为大写。

主机变量必须：

• 可以是CHAR、VARCHAR、GRAPHIC或VARGRAPHIC变量。 宿主变量内容的实际长度不得超过模式名称的长度。
• 不能设置为空。 如果宿主变量有一个相关的指示变量，则该指示变量的值不能为空。
• 包含一个左对齐的架构名称，该名称符合普通标识符或分隔标识符的规则。 如果标识符是定界符，则不能为空或仅包含空格。
• 如果宿主变量是固定长度的，则在右侧用空格填充。
• 不包含 SESSION_USER、USER 或 DEFAULT。

字符串常量

指定一个包含模式名称的字符串常量。 内容不会自动变为大写。

该字符串常量必须：

• 长度不得超过模式名称的最大长度。
• 包含一个左对齐的架构名称，该名称符合普通标识符或分隔标识符的规则。 如果标识符是定界符，则不能为空或仅包含空格。
• 不包含 SESSION_USER、USER 或 DEFAULT。

缺省值

指定将当前模式设置为初始值，就像在应用过程中从未明确设置过一样。 有关当前方案初始值的信息，请参阅当前方案特殊登记册。

备注 SET SCHEMA

关键词注意事项：

将单个关键字（如SESSION_USER或DEFAULT）指定为单个关键字或分隔标识符是有区别的。 为了表示应该使用 SESSION_USER 特殊寄存器的当前值来设置当前模式，请将 SESSION_USER 指定为关键字。 为了表示特殊寄存器应设置为默认值，请指定 DEFAULT 作为关键字。 如果将 SESSION_USER 或 DEFAULT 指定为分隔标识符（例如“SESSION_USER”），则将其解释为该值的架构名称（“SESSION_USER”）。

交易注意事项：

SET SCHEMA语句不是可提交操作。 ROLLBACK对CURRENT SCHEMA没有影响。

指定值的使用：

当前模式特殊寄存器的值（由该语句设置）在所有动态SQL语句中用作模式名称。 限定符绑定选项指定了模式名称，用于在静态SQL语句中作为非限定数据库对象名称的限定符。

对其他特殊登记的影响：

设置当前模式特殊寄存器不会影响任何其他特殊寄存器。 因此，当前模式不会包含在SQL路径中，该路径用于解析动态SQL语句中对函数、过程和用户定义类型的非限定引用。 为了在SQL路径中包含当前模式值，每当发出SET SCHEMA语句时，也要发出SET PATH语句，其中包含SET SCHEMA语句中的模式名称。