CERTPROPERTY (Transact-SQL)

2025-07-29

Gäller för:SQL Server Azure SQL Database Azure SQL Managed Instance SQL-databas i Förhandsversion av Microsoft Fabric

Returnerar värdet för en angiven certifikategenskap.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

Cert_ID
Certifikat-ID-värdet för int-datatypen.

Expiry_Date
Certifikatets förfallodatum.

Start_Date
Det datum då certifikatet blir giltigt.

Issuer_Name
Namnet på certifikatutfärdaren.

Cert_Serial_Number
Certifikatets serienummer.

Subject
Certifikatämnet.

SID
Certifikat-SID. Det här är också SID för alla inloggningar eller användare som mappas till det här certifikatet.

String_SID
SID för certifikatet som en teckensträng. Detta är också SID för alla inloggningar eller användare som mappas till certifikatet.

Return types

Enkla citattecken måste omsluta egenskapsspecifikationen.

Returtypen beror på den egenskap som anges i funktionsanropet. Returtypen sql_variant omsluter alla returvärden.

Expiry_Date och Start_Date returnera datetime.
Cert_Serial_Number, Issuer_Name, String_SID och Subject returnerar alla nvarchar.
SID returnerar varbinary.

Remarks

Se certifikatinformation i katalogvyn sys.certificates .

Permissions

Kräver lämpliga behörigheter för certifikatet och kräver att anroparen inte har nekats VIEW-behörighet för certifikatet. Mer information om certifikatbehörigheter finns i SKAPA CERTIFIKAT (Transact-SQL) och BEVILJA CERTIFIKATBEHÖRIGHETER (Transact-SQL).

Examples

I följande exempel returneras certifikatämnet.

-- 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

Feedback

Var den här sidan till hjälp?