CERTPROPERTY (Transact-SQL)

Artikel
10/16/2024

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance

Mengembalikan nilai properti sertifikat yang ditentukan.

Sintaks

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

Argumen

Cert_ID
Nilai ID sertifikat, dari int tipe data.

Expiry_Date
Tanggal kedaluwarsa sertifikat.

Start_Date
Tanggal ketika sertifikat menjadi valid.

Issuer_Name
Nama penerbit sertifikat.

Cert_Serial_Number
Nomor seri sertifikat.

Subjek
Subjek sertifikat.

SID
Sertifikat SID. Ini juga merupakan SID dari setiap login atau pengguna yang dipetakan ke sertifikat ini.

String_SID
SID sertifikat sebagai string karakter. Ini juga merupakan SID dari setiap login atau pengguna yang dipetakan ke sertifikat.

Jenis yang dikembalikan

Tanda kutip tunggal harus mengapit spesifikasi properti.

Jenis pengembalian tergantung pada properti yang ditentukan dalam panggilan fungsi. Jenis pengembalian sql_variant membungkus semua nilai yang dikembalikan.

Expiry_Date dan Start_Date mengembalikan tanggalwaktu.
Cert_Serial_Number, Issuer_Name, String_SID, dan Subjek semuanya mengembalikan nvarchar.
SID mengembalikan varbinary.

Keterangan

Lihat informasi sertifikat dalam tampilan katalog sys.certificates .

Izin

Memerlukan izin yang sesuai pada sertifikat, dan mengharuskan pemanggil belum ditolak izin VIEW pada sertifikat. Lihat MEMBUAT SERTIFIKAT (Transact-SQL) dan MEMBERIKAN IZIN SERTIFIKAT (Transact-SQL) untuk informasi selengkapnya tentang izin sertifikat.

Contoh

Contoh berikut mengembalikan subjek sertifikat.

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

Lihat juga

BUAT SERTIFIKAT (Transact-SQL)
UBAH SERTIFIKAT (Transact-SQL)
CERT_ID (Transact-SQL)Hierarki enkripsi sys.certificates (Transact-SQL)Tampilan Katalog Keamanan (Transact-SQL)

Bagikan melalui