CERTPRIVATEKEY (Transact-SQL)

2025-07-29

Van toepassing op:SQL Server Azure SQL Database Azure SQL Managed Instance SQL-database in Microsoft Fabric Preview

Deze functie retourneert de persoonlijke sleutel van een certificaat in binaire indeling. Deze functie heeft drie argumenten.

Een certificaat-id.
Een versleutelingswachtwoord dat wordt gebruikt voor het versleutelen van de bits van de persoonlijke sleutel die door de functie worden geretourneerd. Met deze methode worden de sleutels niet als duidelijke tekst voor gebruikers weergegeven.
Een optioneel ontsleutelingswachtwoord. Er wordt een opgegeven ontsleutelingswachtwoord gebruikt om de persoonlijke sleutel van het certificaat te ontsleutelen. Anders wordt de hoofdsleutel van de database gebruikt.

Alleen gebruikers met toegang tot de persoonlijke sleutel van het certificaat kunnen deze functie gebruiken. Deze functie retourneert de persoonlijke sleutel in PVK-indeling.

Syntax

CERTPRIVATEKEY   
    (  
          cert_ID   
        , ' encryption_password '   
      [ , ' decryption_password ' ]  
    )

Arguments

certificate_ID
De certificate_id van het certificaat. Haal deze waarde op uit sys.certificates of de functie CERT_ID (Transact-SQL). cert_id heeft het gegevenstype int.

encryption_password
Het wachtwoord dat wordt gebruikt om de geretourneerde binaire waarde te versleutelen.

decryption_password
Het wachtwoord dat wordt gebruikt om de geretourneerde binaire waarde te ontsleutelen.

Return types

varbinary

Remarks

Gebruik CERTENCODED en CERTPRIVATEKEY samen om verschillende delen van een certificaat in binaire vorm te retourneren.

Permissions

CERTPRIVATEKEY is openbaar beschikbaar.

Examples

CREATE DATABASE TEST1;  
GO  
USE TEST1  
CREATE MASTER KEY ENCRYPTION BY PASSWORD = 'Use 5tr0ng P^55Words'  
GO  
CREATE CERTIFICATE Shipping04   
WITH SUBJECT = 'Sammamish Shipping Records',   
EXPIRY_DATE = '20401031';  
GO  
SELECT CERTPRIVATEKEY(CERT_ID('Shipping04'), 'jklalkaa/; uia3dd');

Zie CERTENCODED (Transact-SQL), voorbeeld B, voor een complexer voorbeeld waarin CERTPRIVATEKEY en CERTENCODED worden gebruikt om een certificaat naar een andere database te kopiëren.

Delen via