CERTPROPERTY (Transact-SQL)

2025-07-29

Si applica a:SQL Server Azure SQL Database Azure SQL Managed Instance SQL Database in Anteprima di Microsoft Fabric

Restituisce il valore di una proprietà del certificato specificata.

Convenzioni relative alla sintassi Transact-SQL

Syntax

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

Arguments

Cert_ID
Valore di ID certificato, tipo di dati int.

Expiry_Date
Data di scadenza del certificato.

Start_Date
Data in cui il certificato diventa valido.

Issuer_Name
Nome dell'autorità di certificazione.

Cert_Serial_Number
Numero di serie del certificato.

Subject
Soggetto del certificato.

SID
SID del certificato. Corrisponde anche al SID di qualsiasi account di accesso o utente sul quale è stato eseguito il mapping al certificato.

String_SID
SID del certificato nel formato di stringa di caratteri. Corrisponde anche al SID di qualsiasi account di accesso o utente sul quale è stato eseguito il mapping al certificato.

Return types

La specifica della proprietà deve essere racchiusa tra virgolette singole.

Il tipo restituito dipende dalla proprietà specificata nella chiamata alla funzione. Il tipo restituito sql_variant esegue il wrapping di tutti i valori restituiti.

Expiry_Date e Start_Date restituiscono datetime.
Cert_Serial_Number, Issuer_Name, String_SID e Subject restituiscono tutti nvarchar.
SID restituisce un valore varbinary.

Remarks

Le informazioni sui certificati sono disponibili nella vista del catalogo sys.certificates.

Permissions

Richiede le autorizzazioni appropriate per il certificato ed è necessario che al chiamante non sia stata negata l'autorizzazione VIEW per il certificato. Vedere CREATE CERTIFICATE (Transact-SQL) e GRANT (autorizzazioni per certificati) (Transact-SQL) per altre informazioni sulle autorizzazioni per i certificati.

Examples

Nell'esempio seguente viene restituito l'oggetto del certificato.

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

Condividi tramite