CERTPROPERTY(Transact-SQL)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

지정된 인증서 속성 값을 반환합니다.

Transact-SQL 구문 표기 규칙

Syntax

CertProperty ( Cert_ID , '<PropertyName>' )  
  
<PropertyName> ::=  
   Expiry_Date | Start_Date | Issuer_Name   
   | Cert_Serial_Number | Subject | SID | String_SID   

인수

Cert_ID
int 데이터 형식의 인증서 ID 값입니다.

Expiry_Date
인증서 만료 날짜입니다.

Start_Date
인증서가 유효하게 되는 날짜입니다.

Issuer_Name
인증서 발급자의 이름입니다.

Cert_Serial_Number
인증서 일련 번호입니다.

Subject
인증서 주체입니다.

SID
인증서 SID입니다. 또한 이 인증서에 매핑된 로그인이나 사용자의 SID이기도 합니다.

String_SID
문자열 형식의 인증서 SID입니다. 또한 이 인증서에 매핑된 로그인이나 사용자의 SID이기도 합니다.

반환 형식

속성 지정은 작은따옴표로 묶어야 합니다.

반환 형식은 함수 호출에 지정된 속성에 따라 다릅니다. sql_variant 반환 형식은 모든 반환 값을 래핑합니다.

• Expiry_Date 및 Start_Date는 datetime을 반환합니다.
• Cert_Serial_Number, Issuer_Name, String_SID 및 Subject는 모두 nvarchar를 반환합니다.
• SID는 varbinary를 반환합니다.

설명

sys.certificates 카탈로그 뷰에서 인증서 정보를 참조합니다.

사용 권한

인증서에 대한 적절한 사용 권한이 필요하며 인증서에 대한 호출자의 VIEW 권한이 거부되지 않아야 합니다. 인증서 사용 권한에 대한 자세한 내용은 CREATE CERTIFICATE(Transact-SQL) 및GRANT CERTIFICATE PERMISSIONS(Transact-SQL)를 참조하세요.

예제

다음 예에서는 인증서 주체를 반환합니다.

-- First create a certificate.  
CREATE CERTIFICATE Marketing19 WITH   
    START_DATE = '04/04/2004' ,  
    EXPIRY_DATE = '07/07/2040' ,  
    SUBJECT = 'Marketing Print Division';  
GO  
  
-- Now use CertProperty to examine certificate  
-- Marketing19's properties.  
DECLARE @CertSubject sql_variant;  
set @CertSubject = CertProperty( Cert_ID('Marketing19'), 'Subject');  
PRINT CONVERT(nvarchar, @CertSubject);  
GO  

참고 항목

CREATE CERTIFICATE(Transact-SQL)
ALTER CERTIFICATE(Transact-SQL)
CERT_ID(Transact-SQL)Encryption Hierarchysys.certificates(Transact-SQL)보안 카탈로그 뷰(Transact-SQL)