ALTER ROLE (Transact-SQL)ALTER ROLE (Transact-SQL)

ESTE TÓPICO APLICA-SE A:simSQL Server (a partir de 2008)simBanco de Dados SQL do Microsoft AzurenãoAzure SQL Data Warehouse nãoParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Adiciona ou remove membros de uma função de banco de dados ou altera o nome de uma função de banco de dados definido pelo usuário.Adds or removes members to or from a database role, or changes the name of a user-defined database role.

Observação

Para alterar as funções em SQL Data WarehouseSQL Data Warehouse ou Parallel Data WarehouseParallel Data Warehouse, use sp_addrolemember ( Transact-SQL ) e sp_droprolemember ( Transact-SQL ) .To alter roles in SQL Data WarehouseSQL Data Warehouse or Parallel Data WarehouseParallel Data Warehouse, use sp_addrolemember (Transact-SQL) and sp_droprolemember (Transact-SQL).

Ícone de link do tópico Convenções da sintaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

-- Syntax for SQL Server (starting with 2012) and Azure SQL Database  

ALTER ROLE  role_name  
{  
       ADD MEMBER database_principal  
    |  DROP MEMBER database_principal  
    |  WITH NAME = new_name  
}  
[;]  
-- Syntax for SQL Server 2008 only  

-- Change the name of a user-defined database role  
ALTER ROLE role_name   
    WITH NAME = new_name  
[;]  

ArgumentosArguments

nome_da_funçãorole_name
Aplica-se a: SQL ServerSQL Server (começando com o 2008) Banco de dados SQL do AzureAzure SQL DatabaseAPPLIES TO: SQL ServerSQL Server (starting with 2008), Banco de dados SQL do AzureAzure SQL Database

Especifica a função de banco de dados para alterar.Specifies the database role to change.

Adicionar membro database_principallADD MEMBER database_principall
Aplica-se a: SQL ServerSQL Server (começando com o 2012) Banco de dados SQL do AzureAzure SQL DatabaseAPPLIES TO: SQL ServerSQL Server (starting with 2012), Banco de dados SQL do AzureAzure SQL Database

Especifica para adicionar o banco de dados principal para a associação de uma função de banco de dados.Specifies to add the database principal to the membership of a database role.

  • database_principal é um usuário de banco de dados ou uma função de banco de dados definido pelo usuário.database_principal is a database user or a user-defined database role.

  • database_principal não pode ser uma função de banco de dados fixa ou uma entidade de servidor.database_principal cannot be a fixed database role or a server principal.

Remover membro database_principalDROP MEMBER database_principal
Aplica-se a: SQL ServerSQL Server (começando com o 2012) Banco de dados SQL do AzureAzure SQL DatabaseAPPLIES TO: SQL ServerSQL Server (starting with 2012), Banco de dados SQL do AzureAzure SQL Database

Especifica para remover um banco de dados principal da associação de uma função de banco de dados.Specifies to remove a database principal from the membership of a database role.

  • database_principal é um usuário de banco de dados ou uma função de banco de dados definido pelo usuário.database_principal is a database user or a user-defined database role.

  • database_principal não pode ser uma função de banco de dados fixa ou uma entidade de servidor.database_principal cannot be a fixed database role or a server principal.

COM nome = novo_nomeWITH NAME = new_name
Aplica-se a: SQL ServerSQL Server (começando com o 2008) Banco de dados SQL do AzureAzure SQL DatabaseAPPLIES TO: SQL ServerSQL Server (starting with 2008), Banco de dados SQL do AzureAzure SQL Database

Especifica para alterar o nome de uma função de banco de dados definido pelo usuário.Specifies to change the name of a user-defined database role. O novo nome não deve existir no banco de dados.The new name must not already exist in the database.

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.Changing the name of a database role does not change ID number, owner, or permissions of the role.

PermissõesPermissions

Para executar esse comando, é necessário um ou mais dessas permissões ou associações:To run this command you need one or more of these permissions or memberships:

  • ALTER permissão na funçãoALTER permission on the role
  • ALTER ANY ROLE no banco de dadosALTER ANY ROLE permission on the database
  • Associação de db_securityadmin função de banco de dados fixaMembership in the db_securityadmin fixed database role

Além disso, para alterar a associação em uma função de banco de dados fixa, você precisa:Additionally, to change the membership in a fixed database role you need:

  • Associação de db_owner função de banco de dados fixaMembership in the db_owner fixed database role

Limitações e restriçõesLimitations and restrictions

Não é possível alterar o nome de uma função de banco de dados fixa.You cannot change the name of a fixed database role.

MetadadosMetadata

Essas exibições do sistema contêm informações sobre as funções de banco de dados e objetos de banco de dados.These system views contain information about database roles and database principals.

ExemplosExamples

A.A. Alterar o nome de uma função de banco de dadosChange the name of a database role

Aplica-se a: SQL ServerSQL Server (começando com o 2008) Banco de Dados SQLSQL DatabaseAPPLIES TO: SQL ServerSQL Server (starting with 2008), Banco de Dados SQLSQL Database

O exemplo a seguir altera o nome da função buyers para purchasing.The following example changes the name of role buyers to purchasing. Este exemplo pode ser executado no banco de dados de exemplo AdventureWorks.This example can be executed in the AdventureWorks sample database.

ALTER ROLE buyers WITH NAME = purchasing;  

B.B. Adicionar ou remover membros da funçãoAdd or remove role members

Aplica-se a: SQL ServerSQL Server (começando com o 2012) Banco de Dados SQLSQL DatabaseAPPLIES TO: SQL ServerSQL Server (starting with 2012), Banco de Dados SQLSQL Database

Este exemplo cria uma função de banco de dados denominada Sales.This example creates a database role named Sales. Ele adiciona um usuário de banco de dados chamado Barry para a associação e, em seguida, mostra como remover o membro Barry.It adds a database user named Barry to the membership, and then shows how to remove the member Barry. Este exemplo pode ser executado no banco de dados de exemplo AdventureWorks.This example can be executed in the AdventureWorks sample database.

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

Consulte tambémSee Also

Criar função ( Transact-SQL ) CREATE ROLE (Transact-SQL)
Entidades (Mecanismo de Banco de Dados) Principals (Database Engine)
Remover função ( Transact-SQL ) DROP ROLE (Transact-SQL)
sp_addrolemember (Transact-SQL) sp_addrolemember (Transact-SQL)
sys.database_role_members (Transact-SQL) sys.database_role_members (Transact-SQL)
sys.database_principals (Transact-SQL)sys.database_principals (Transact-SQL)