ALTER ROLE (Transact-SQL)

Adiciona membros a uma função de banco de dados ou altera o nome de uma função de banco de dados definida pelo usuário.

Convenções de sintaxe Transact-SQL

Sintaxe

ALTER ROLE role_name
{
      [ ADD MEMBER database_principal ]
    | [ DROP MEMBER database_principal ]
    | WITH NAME = new_name
}

Argumentos

• role_name
  É o nome da função a ser alterada.

• ADD MEMBER database_principal
  Adiciona a entidade do banco de dados especificada à função de banco de dados. database_principal pode ser um usuário ou uma função de banco de dados definida pelo usuário. database_principal não pode ser uma função de banco de dados fixa ou uma entidade de segurança de servidor.

• DROP MEMBER database_principal
  Remove a entidade de segurança de banco de dados especificada da função de banco de dados. database_principal pode ser um usuário ou uma função de banco de dados definida pelo usuário. database_principal não pode ser uma função de banco de dados fixa, uma entidade de segurança de servidor.

• WITH NAME =new_name
  Especifica o novo nome da função definida pelo usuário. Esse nome ainda não deve existir no banco de dados. Não é possível alterar o nome de funções de banco de dados fixas.

Comentários

A alteração do nome de uma função de banco de dados não altera o número da ID, o proprietário ou as permissões da função.

As funções de banco de dados são visíveis nas exibições de catálogo sys.database_role_members e sys.database_principals.

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 de catálogo, consulte Exibições do catálogo (Transact-SQL).

Permissões

Exige a permissão ALTER ANY ROLE no banco de dados, ou a permissão ALTER na função ou a associação no db_securityadmin. A adição de membros a funções de banco de dados fixas requer associação na função de banco de dados fixa db_owner.

Exemplos

A.Alterando o nome de uma função de banco de dados

O exemplo a seguir altera o nome da função buyers para purchasing.

USE AdventureWorks2012;
ALTER ROLE buyers WITH NAME = purchasing;
GO

B.Adicionando e removendo membros da função

O exemplo a seguir cria uma função chamada Sales, adiciona e em seguida remove um usuário chamado Barry.

CREATE ROLE Sales;
ALTER ROLE Sales ADD MEMBER Barry;
ALTER ROLE Sales DROP MEMBER Barry;

Consulte também

Referência

CREATE ROLE (Transact-SQL)

DROP ROLE (Transact-SQL)

sp_addrolemember (Transact-SQL)

sys.database_role_members (Transact-SQL)

sys.database_principals (Transact-SQL)

Conceitos

Entidades (Mecanismo de Banco de Dados)