CERTPROPERTY (Transact-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Mengembalikan nilai properti sertifikat yang ditentukan.

Konvensi sintaks transact-SQL

Sintaksis

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

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

Cert_ID
Nilai ID sertifikat, dari int tipe data.

Expiry_Date
Tanggal kedaluwarsa sertifikat.

Tanggal_mulai
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

Baca juga

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