sp_addrolemember(Transact-SQL)
적용 대상:
SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)
현재 데이터베이스의 데이터베이스 역할에 데이터베이스 사용자, 데이터베이스 역할, Windows 로그인 또는 Windows 그룹을 추가합니다.
중요
Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 ALTER ROLE 을 사용합니다.
Syntax
sp_addrolemember [ @rolename = ] 'role', [ @membername = ] 'security_account'
참고
이 구문은 Azure Synapse Analytics의 서버리스 SQL 풀에서 지원되지 않습니다.
인수
[ @rolename= ] 'role'
현재 데이터베이스에 있는 데이터베이스 역할의 이름입니다. 역할은 기본값이 없는 sysname입니다.
[ @membername= ] 'security_account'
역할에 추가될 보안 계정입니다. security_account 기본값이 없는 sysname입니다. security_account 데이터베이스 사용자, 데이터베이스 역할, Windows 로그인 또는 Windows 그룹일 수 있습니다.
반환 코드 값
0(성공) 또는 1(실패)
설명
sp_addrolemember를 사용하여 역할에 추가된 멤버는 해당 역할의 사용 권한을 상속합니다. 새 멤버가 해당 데이터베이스 사용자가 없는 Windows 수준의 보안 주체인 경우에는 데이터베이스 사용자가 생성되지만 로그인에 완전히 매핑되지 않을 수 있습니다. 로그인이 있고 데이터베이스에 액세스할 수 있는지 항상 확인하세요.
역할은 자신의 역할 자체를 멤버로 포함할 수 없습니다. 이와 같은 "순환" 정의는 하나 이상의 중간 멤버 자격을 통해 멤버 자격이 간접적으로 유추되는 경우에도 유효하지 않습니다.
sp_addrolemember 고정 데이터베이스 역할, 고정 서버 역할 또는 dbo를 역할에 추가할 수 없습니다.
데이터베이스 역할에 멤버를 추가할 경우에만 sp_addrolemember를 사용하십시오. 서버 역할에 멤버를 추가하려면 sp_addsrvrolemember(Transact-SQL)을 사용합니다.
사용 권한
멤버를 유연한 데이터베이스 역할에 추가하려면 다음 항목 중 하나가 필요합니다.
db_securityadmin 또는 db_owner 고정 데이터베이스 역할의 멤버 자격입니다.
역할을 소유하는 역할의 멤버 자격
역할에 대한 ALTER ANY ROLE 권한 또는 ALTER 권한입니다.
고정 데이터베이스 역할에 멤버를 추가하려면 db_owner 고정 데이터베이스 역할의 멤버 자격이 필요합니다.
예제
A. Windows 로그인 추가
다음 예제에서는 데이터베이스에 Windows 로그인 Contoso\Mary5 을 AdventureWorks2012 사용자 Mary5로 추가합니다. 그런 다음 Mary5 사용자를 Production 역할에 추가합니다.
참고
Contoso\Mary5 은 AdventureWorks2022 데이터베이스의 데이터베이스 사용자 Mary5 라고 하므로 사용자 이름을 Mary5 지정해야 합니다. Contoso\Mary5라는 로그인이 없으면 문이 실패합니다. 사용자 도메인의 로그인을 사용하여 테스트하세요.
USE AdventureWorks2012;
GO
CREATE USER Mary5 FOR LOGIN [Contoso\Mary5] ;
GO
B. 데이터베이스 사용자 추가
다음 예에서는 Mary5 데이터베이스 사용자를 현재 데이터베이스의 Production 데이터베이스 역할에 추가합니다.
EXEC sp_addrolemember 'Production', 'Mary5';
예제: 분석 플랫폼 시스템(PDW)
C. Windows 로그인 추가
다음 예제에서는 사용자 UserMary로 데이터베이스에 로그인 LoginMary 을 AdventureWorks2008R2 추가합니다. 그런 다음 UserMary 사용자를 Production 역할에 추가합니다.
참고
로그인 LoginMary 을 AdventureWorks2022 데이터베이스의 데이터베이스 사용자 UserMary 라고 하므로 사용자 이름을 UserMary 지정해야 합니다. Mary5라는 로그인이 없으면 문이 실패합니다. 로그인 및 사용자는 일반적으로 동일한 이름을 갖습니다. 이 예제에서는 다른 이름을 사용하여 로그인과 사용자에 영향을 주는 작업을 구분합니다.
-- Uses AdventureWorks
CREATE USER UserMary FOR LOGIN LoginMary ;
GO
EXEC sp_addrolemember 'Production', 'UserMary'
D. 데이터베이스 사용자 추가
다음 예에서는 UserMary 데이터베이스 사용자를 현재 데이터베이스의 Production 데이터베이스 역할에 추가합니다.
EXEC sp_addrolemember 'Production', 'UserMary'
참고 항목
보안 저장 프로시저(Transact-SQL)
sp_addsrvrolemember(Transact-SQL)
sp_droprolemember(Transact-SQL)
sp_grantdbaccess(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)
데이터베이스 수준 역할