CERTPROPERTY (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna o valor de uma propriedade de certificado especificada.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

Cert_ID
O valor da ID de certificado, do tipo de dados int.

Expiry_Date
A data de expiração do certificado.

Start_Date
A data em que o certificado se torna válido.

Issuer_Name
O nome do emissor do certificado.

Cert_Serial_Number
O número de série do certificado.

Assunto
A entidade do certificado.

SID
O SID do certificado. Também é o SID de qualquer logon ou usuário mapeado para esse certificado.

String_SID
O SID do certificado como uma cadeia de caracteres. Também é o SID de qualquer logon ou usuário mapeado para o certificado.

Tipos de retorno

Aspas simples devem incluir a especificação da propriedade.

O tipo de retorno depende da propriedade especificada na chamada de função. O tipo de retorno sql_variant encapsula todos os valores retornados.

• Expiry_Date e Start_Date retornam datetime.
• Cert_Serial_Number, Issuer_Name, String_SID e Subject retornam nvarchar.
• SID retorna varbinary.

Comentários

Consulte as informações de certificado na exibição de catálogo sys.certificates.

Permissões

Exige as permissões apropriadas no certificado e que a permissão VIEW não tenha sido negada ao chamador no certificado. Consulte CREATE CERTIFICATE (Transact-SQL) e GRANT CERTIFICATE PERMISSIONS (Transact-SQL) para obter mais informações sobre permissões de certificado.

Exemplos

O exemplo a seguir retorna o assunto do certificado.

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

Confira também

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)Hierarquia de criptografiaCertificados (Transact-SQL)Exibições do catálogo de segurança (Transact-SQL)