CERTPROPERTY (Transact-SQL)

Статья
10/16/2024

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

Возвращает значение указанного свойства сертификата.

Синтаксис

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

Аргументы

Cert_ID
Значение идентификатора сертификата, имеющее тип данных int.

Expiry_Date
Дата окончания действия сертификата.

Start_Date
Дата вступления сертификата в силу.

Issuer_Name
Имя издателя сертификата.

Cert_Serial_Number
Серийный номер сертификата.

Тема
Субъект сертификата.

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)Иерархия шифрования sys.certificates (Transact-SQL)Представления каталога безопасности (Transact-SQL)

Поделиться через