ALTER SCHEMA (Transact-SQL)

项目
05/23/2023

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)Microsoft Fabric 中的 SQL 分析终结点 Microsoft Fabric 中的仓库

在架构之间传输安全对象。

Transact-SQL 语法约定

语法

-- Syntax for SQL Server and Azure SQL Database  
  
ALTER SCHEMA schema_name   
   TRANSFER [ <entity_type> :: ] securable_name   
[;]  
  
<entity_type> ::=  
    {  
    Object | Type | XML Schema Collection  
    }

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse and Microsoft Fabric
  
ALTER SCHEMA schema_name   
   TRANSFER [ OBJECT :: ] securable_name   
[;]

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

参数

schema_name
当前数据库中的架构名称，安全对象将移入其中。其数据类型不能为 SYS 或 INFORMATION_SCHEMA。

<entity_type>
更改其所有者的实体的类。 Object 是默认值。

securable_name
要移入架构中的架构范围内的安全对象的一部分或两部分名称。

备注

用户与架构完全分离。

ALTER SCHEMA 仅可用于在同一数据库中的架构之间移动安全对象。若要更改或删除架构中的安全对象，请使用特定于该安全对象的 ALTER 或 DROP 语句。

如果对 securable_name 使用了由一部分组成的名称，则将使用当前生效的名称解析规则查找该安全对象。

将安全对象移入新架构时，将删除与该安全对象关联的全部权限。如果已显式设置安全对象的所有者，则该所有者保持不变。如果安全对象的所有者已设置为 SCHEMA OWNER，则该所有者将保持为 SCHEMA OWNER；但移动之后，SCHEMA OWNER 将解析为新架构的所有者。新所有者的 principal_id 将为 NULL。

无论是 sys.sql_modules 目录视图的 definition 列中的相应对象，还是使用 OBJECT_DEFINITION 内置函数获取的相应对象，移动存储过程、函数、视图或触发器都不会更改其架构名称（如有）。因此，我们建议不要使用 ALTER SCHEMA 移动这些对象类型。而是删除对象，然后在新架构中重新创建该对象。

移动表或同义词不会自动更新对该对象的引用。必须手动修改引用已移动对象的任何对象。例如，如果移动了某个表，并且触发器中引用了该表，则必须修改触发器以反映新的架构名称。请使用 sys.sql_expression_dependencies 列出该对象上的依赖关系，然后再进行移动。

若要通过使用 SQL Server Management Studio 更改表的架构，请在对象资源管理器中右键单击该表，然后单击“设计”。按 F4 以打开“属性”窗口。在“架构”框中，选择新架构。

ALTER SCHEMA 使用架构级别锁。

注意

从 SQL Server 2005 开始，架构的行为发生了更改。因此，假设架构与数据库用户等价的代码不再返回正确的结果。包含 sysobjects 的旧目录视图不应在曾经使用任何下列 DDL 语句的数据库中使用：CREATE SCHEMA、ALTER SCHEMA、DROP SCHEMA、CREATE USER、ALTER USER、DROP USER、CREATE ROLE、ALTER ROLE、DROP ROLE、CREATE APPROLE、ALTER APPROLE、DROP APPROLE、ALTER AUTHORIZATION。在这类数据库中，必须改用新目录视图。新的目录视图将采用在 SQL Server 2005 中引入的使主体和架构分离的方法。有关目录视图的详细信息，请参阅目录视图 (Transact-SQL)。

权限

若要从另一个架构中传输安全对象，当前用户必须拥有对该安全对象（非架构）的 CONTROL 权限，并拥有对目标架构的 ALTER 权限。

如果已为安全对象指定 EXECUTE AS OWNER，且所有者已设置为 SCHEMA OWNER，则用户还必须拥有对目标架构所有者的 IMPERSONATE 权限。

在移动安全对象后，将删除与所传输的安全对象相关联的所有权限。

示例

A. 传递表的所有权

以下示例通过将表 Address 从架构 Person 传输到 HumanResources 架构来修改架构 HumanResources。

USE AdventureWorks2022;  
GO  
ALTER SCHEMA HumanResources TRANSFER Person.Address;  
GO

B. 传递类型的所有权

以下示例在 Production 架构中创建一个类型，然后将该类型传递到 Person 架构。

USE AdventureWorks2022;  
GO  
  
CREATE TYPE Production.TestType FROM [VARCHAR](10) NOT NULL ;  
GO  
  
-- Check the type owner.  
SELECT sys.types.name, sys.types.schema_id, sys.schemas.name  
    FROM sys.types JOIN sys.schemas   
        ON sys.types.schema_id = sys.schemas.schema_id   
    WHERE sys.types.name = 'TestType' ;  
GO  
  
-- Change the type to the Person schema.  
ALTER SCHEMA Person TRANSFER type::Production.TestType ;  
GO  
  
-- Check the type owner.  
SELECT sys.types.name, sys.types.schema_id, sys.schemas.name  
    FROM sys.types JOIN sys.schemas   
        ON sys.types.schema_id = sys.schemas.schema_id   
    WHERE sys.types.name = 'TestType' ;  
GO

示例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

C. 传递表的所有权

下面的示例在 dbo 架构中创建一个表 Region，创建一个 Sales 架构，然后将 Region 表从 dbo 架构移动到 Sales 架构。

CREATE TABLE dbo.Region   
    (Region_id INT NOT NULL,  
    Region_Name CHAR(5) NOT NULL)  
WITH (DISTRIBUTION = REPLICATE);  
GO  
  
CREATE SCHEMA Sales;  
GO  
  
ALTER SCHEMA Sales TRANSFER OBJECT::dbo.Region;  
GO

另请参阅

CREATE SCHEMA (Transact-SQL)
DROP SCHEMA (Transact-SQL)
EVENTDATA (Transact-SQL)