HAS_PERMS_BY_NAME(Transact-SQL)

아티클
10/16/2024

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance

보안 개체에 대한 현재 사용자의 유효 사용 권한을 평가합니다. 연관된 함수는 fn_my_permissions입니다.

구문

HAS_PERMS_BY_NAME ( securable , securable_class , permission    
    [ , sub-securable ] [ , sub-securable_class ] )

인수

securable
보안 개체의 이름입니다. 보안 개체가 서버 자체인 경우 이 값을 NULL로 설정해야 합니다. securable은 sysname 형식의 스칼라 식입니다. 기본값은 없습니다.

securable_class
사용 권한을 테스트한 보안 개체 클래스의 이름입니다. securable_class는 nvarchar(60) 형식의 스칼라 식입니다.

Azure SQL Database에서 securable_class 인수는 DATABASE, OBJECT, ROLE, SCHEMA, USER 중 하나로 설정해야 합니다.

permission
확인할 사용 권한 이름을 나타내는 sysname 형식의 Null이 아닌 스칼라 식입니다. 기본값은 없습니다. 사용 권한 이름 ANY는 와일드카드입니다.

sub-securable
사용 권한이 테스트되는 대상 보안 개체 하위 엔터티의 이름을 나타내는 sysname 형식의 선택적 스칼라 식입니다. 기본값은 NULL입니다.

참고

sub-securable에 ‘[sub name]’ 형식의 대괄호를 사용할 수 없습니다. 대신 'sub name' 을 사용하세요.

sub-securable_class
사용 권한이 테스트되는 대상 보안 개체 하위 엔터티의 클래스를 나타내는 nvarchar(60) 형식의 선택적 스칼라 식입니다. 기본값은 NULL입니다.

Azure SQL Database에서 sub-securable_class 인수는 securable_class 인수가 OBJECT로 설정된 경우에만 유효합니다. securable_class 인수가 OBJECT로 설정된 경우 sub-securable_class 인수는 COLUMN으로 설정해야 합니다.

반환 형식

int

쿼리가 실패하면 NULL을 반환합니다.

설명

이 기본 제공 함수는 지정된 보안 개체에 대한 특정 유효 사용 권한이 현재 보안 주체에 있는지 여부를 테스트합니다. HAS_PERMS_BY_NAME은 사용자에게 보안 개체에 대한 유효 사용 권한이 있으면 1을 반환하고, 사용자에게 보안 개체에 대한 유효 사용 권한이 없으면 0을 반환하며, 보안 개체 클래스 또는 사용 권한이 유효하지 않으면 NULL을 반환합니다. 유효 사용 권한은 다음 중 하나입니다.

보안 주체에게 직접 부여되고 거부되지 않은 사용 권한
보안 주체가 소유하는 더 높은 수준의 사용 권한에 포함되고 거부되지 않은 사용 권한
보안 주체가 멤버로 속한 역할이나 그룹에 부여되고 거부되지 않은 사용 권한
보안 주체가 멤버로 속한 역할이나 그룹이 소유하고 거부되지 않은 사용 권한

사용 권한은 항상 호출자의 보안 컨텍스트에서 평가됩니다. 다른 사용자에게 유효 사용 권한이 있는지 여부를 확인하려면 해당 사용자에 대한 IMPERSONATE 권한이 호출자에게 있어야 합니다.

스키마 수준 엔터티의 경우 한 부분, 두 부분 또는 세 부분으로 된 Null이 아닌 이름을 사용할 수 있습니다. 데이터베이스 수준 엔터티의 경우 한 부분으로 된 이름을 사용할 수 있으며 Null 값은 "현재 데이터베이스"를 나타냅니다. 서버 자체인 경우에는 Null 값("현재 서버"를 나타냄)이 필요합니다. 이 함수로는 서버 수준 보안 주체가 생성되지 않은 Windows 사용자 또는 연결된 서버의 사용 권한을 확인할 수 없습니다.

다음 쿼리는 기본 제공 보안 개체 클래스의 목록을 반환합니다.

SELECT class_desc FROM sys.fn_builtin_permissions(default);

사용되는 데이터 정렬은 다음과 같습니다.

현재 데이터베이스 데이터 정렬: 스키마에 포함되지 않은 보안 개체를 포함하는 데이터베이스 수준 보안 개체, 한 부분 또는 두 부분으로 된 스키마 범위 보안 개체, 세 부분으로 된 이름을 사용할 경우 대상 데이터베이스
master 데이터베이스 데이터 정렬: 서버 수준 보안 개체
열 수준 확인에는 'ANY'를 사용할 수 없습니다. 적절한 사용 권한을 지정해야 합니다.

예제

A. 서버 수준 VIEW SERVER STATE 권한이 있는지 확인

적용 대상: SQL Server 2008(10.0.x) 이상

SELECT HAS_PERMS_BY_NAME(null, null, 'VIEW SERVER STATE');

B. Ps 서버 보안 주체에 대한 IMPERSONATE 권한이 있는지 확인

적용 대상: SQL Server 2008(10.0.x) 이상

SELECT HAS_PERMS_BY_NAME('Ps', 'LOGIN', 'IMPERSONATE');

C. 현재 데이터베이스에서 사용 권한이 있는지 확인

SELECT HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'ANY');

D. 현재 데이터베이스에서 Pd 데이터베이스 보안 주체에 부여된 사용 권한 확인

Pd 보안 주체에 대한 IMPERSONATE 권한이 호출자에게 있다고 가정합니다.

EXECUTE AS user = 'Pd'  
GO  
SELECT HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'ANY');  
GO  
REVERT;  
GO

E. S 스키마에서 프로시저와 테이블을 만들 수 있는지 확인

다음 예에는 ALTER에 대한 S 권한과 데이터베이스에 대한 CREATE PROCEDURE 권한이 필요합니다. 테이블의 경우에도 비슷합니다.

SELECT HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'CREATE PROCEDURE')  
    & HAS_PERMS_BY_NAME('S', 'SCHEMA', 'ALTER') AS _can_create_procs,  
    HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'CREATE TABLE') &  
    HAS_PERMS_BY_NAME('S', 'SCHEMA', 'ALTER') AS _can_create_tables;

F. 어떤 테이블에 대해 SELECT 권한이 있는지 확인

SELECT HAS_PERMS_BY_NAME  
(QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name),   
    'OBJECT', 'SELECT') AS have_select, * FROM sys.tables

G. AdventureWorks2022의 SalesPerson 테이블에 대한 INSERT 권한이 있나요?

다음 예에서는 AdventureWorks2022가 현재 데이터베이스 컨텍스트이고 두 부분으로 된 이름을 사용한다고 가정합니다.

SELECT HAS_PERMS_BY_NAME('Sales.SalesPerson', 'OBJECT', 'INSERT');

다음 예에서는 현재 데이터베이스 컨텍스트에 대한 가정을 하지 않고 세 부분으로 된 이름을 사용합니다.

SELECT HAS_PERMS_BY_NAME('AdventureWorks2022.Sales.SalesPerson',   
    'OBJECT', 'INSERT');

H. T 테이블의 어떤 열에 대해 SELECT 권한이 있는지 확인

SELECT name AS column_name,   
    HAS_PERMS_BY_NAME('T', 'OBJECT', 'SELECT', name, 'COLUMN')   
    AS can_select   
    FROM sys.columns AS c   
    WHERE c.object_id=object_id('T');

참고 항목

사용 권한(데이터베이스 엔진)
보안 개체
사용 권한 계층(데이터베이스 엔진)
sys.fn_builtin_permissions(Transact-SQL)
보안 카탈로그 뷰(Transact-SQL)

다음을 통해 공유