ALTER SCHEMA (Transact-SQL)

Transfere um protegível entre esquemas.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

ALTER SCHEMA schema_name 
      TRANSFER [ <entity_type> :: ] securable_name [;]
<entity_type> ::=
    {
        Object | Type | XML Schema Collection
    }

Argumentos

  • schema_name
    É o nome de um esquema no banco de dados atual para o qual o protegível será movido. Não pode ser SYS nem INFORMATION_SCHEMA.

  • <entity_type>
    É a classe da entidade para a qual o proprietário está sendo alterado. Objeto é o padrão.

  • securable_name
    É o nome de uma parte ou de duas partes de um protegível contido em esquema a ser movido para o esquema.

Comentários

Os usuários e os esquemas são completamente separados. Para obter mais informações, consulte Separação do esquema de usuário.

ALTER SCHEMA só pode ser usado para mover protegíveis entre esquemas no mesmo banco de dados. Para alterar ou descartar um protegível dentro de um esquema, use a instrução ALTER ou DROP específica para esse protegível.

Se o nome de uma parte for usado para securable_name, as regras de resolução de nome atualmente em vigor serão usadas para localizar o protegível.

Todas as permissões associadas ao protegível serão descartadas quando o protegível for movido para o novo esquema. Se o proprietário do protegível tiver sido definido explicitamente, o proprietário permanecerá inalterado. Se o proprietário do protegível tiver sido definido como SCHEMA OWNER, permanecerá como SCHEMA OWNER; no entanto, após o deslocamento, SCHEMA OWNER reconhecerá o proprietário do novo esquema. O principal_id do novo proprietário será NULL.

Para alterar o esquema de uma tabela ou exibição usando o SQL Server Management Studio, no Pesquisador de Objetos, clique com o botão direito do mouse na tabela ou exibição e clique em Design. Pressione F4 para abrir a janela Propriedades. Na caixa Esquema, selecione um novo esquema.

Observação sobre cuidadosCuidado

A partir do SQL Server 2005, o comportamento de esquemas mudou. Como resultado, o código que pressupõe que esquemas sejam equivalentes a usuários de banco de dados pode não retornar mais resultados corretos. Exibições antigas do catálogo, incluindo sysobjects, não devem ser usadas em um banco de dados no qual uma das instruções DDL a seguir já tenha sido utilizada: 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. Nesses bancos de dados você deve usar as novas exibições do catálogo. As exibições do catálogo novas levam em conta a separação de entidades e esquemas apresentada no SQL Server 2005. Para mais informações sobre exibições do catálogo, consulte Exibições do catálogo (Transact-SQL).

Permissões

Para transferir um protegível de outro esquema, o usuário atual deve ter permissão CONTROL sobre o protegível (não esquema) e permissão ALTER sobre o esquema de destino.

Se o protegível tiver uma especificação EXECUTE AS OWNER e o proprietário estiver definido como SCHEMA OWNER, o usuário deverá ter também permissão IMPERSONATION sobre o proprietário do esquema de destino.

Todas as permissões associadas ao protegível que estão sendo transferidas serão descartadas após o deslocamento.

Exemplos

A. Transferindo a propriedade de uma tabela

O exemplo a seguir modifica o esquema HumanResources transferindo a tabela Address do esquema Person para o esquema.

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

B. Transferindo a propriedade de um tipo

O exemplo a seguir cria um tipo no esquema Production e depois transfere o tipo para o esquema Person.

USE AdventureWorks;
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

Histórico de alterações

Conteúdo atualizado

Sintaxe corrigida pela adição do tipo e das opções de coleção de esquemas XML.

Adicionado o exemplo B.