ALTER SCHEMA (Transact-SQL)
Transfere um protegível entre esquemas.
Convenções da 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 ou 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 esquemas são completamente separados.
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, o proprietário permanecerá como SCHEMA OWNER; entretanto, após a movimentação, 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 por meio do 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.
Cuidado |
---|
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 exibições do catálogo novas. As exibições do catálogo novas levam em conta a separação de entidades e esquemas apresentada no SQL Server 2005. Para obter 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 por meio da transferência da tabela Address do esquema Person para o esquema.
USE AdventureWorks2012;
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, em seguida, transfere o tipo para o esquema Person.
USE AdventureWorks2012;
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