KEY_NAME (Transact-SQL)

适用于: SQL Server Azure SQL 数据库 Azure SQL 托管实例

从对称密钥 GUID 或密码文本返回对称密钥的名称。

Transact-SQL 语法约定

语法

KEY_NAME ( ciphertext | key_guid )   

参数

ciphertext
对称密钥加密的文本。 cyphertext 是 varbinary(8000) 类型

key_guid
对称密钥的 GUID。 key_guid 是 uniqueidentifier 类型

返回类型

varchar(128)

权限

从 SQL Server 2005 (9.x) 开始,元数据的可见性仅限用户所拥有的安全对象,或用户已获得某些权限的安全对象。 有关详细信息,请参阅 Metadata Visibility Configuration

示例

A. 使用 key_guid 显示对称密钥的名称

master 数据库包含一个名为 ##MS_ServiceMasterKey## 的对称密钥。 下面的示例从 sys.symmetric_keys 动态管理视图获取该密钥的 GUID,并将其赋值给一个变量,然后将该变量传递到 KEY_NAME 函数,从而演示如何返回与 GUID 对应的名称。

USE master;  
GO  
DECLARE @guid uniqueidentifier ;  
SELECT @guid = key_guid FROM sys.symmetric_keys  
WHERE name = '##MS_ServiceMasterKey##' ;  
-- Demonstration of passing a GUID to KEY_NAME to receive a name  
SELECT KEY_NAME(@guid) AS [Name of Key];  

B. 使用密码文本显示对称密钥的名称

下面的示例对创建一个对称密钥并将数据填充到表的整个过程进行了说明。 然后,该示例显示 KEY_NAME 如何在传递加密文本后返回密钥的名称。

-- Create a symmetric key  
CREATE SYMMETRIC KEY TestSymKey   
   WITH ALGORITHM = AES_128,  
   KEY_SOURCE = 'The square of the hypotenuse is equal to the sum of the squares of the sides',  
   IDENTITY_VALUE = 'Pythagoras'  
   ENCRYPTION BY PASSWORD = 'pGFD4bb925DGvbd2439587y' ;  
GO  
-- Create a table for the demonstration  
CREATE TABLE DemoKey  
(IDCol INT IDENTITY PRIMARY KEY,  
SecretCol VARBINARY(256) NOT NULL)  
GO  
-- Open the symmetric key if not already open  
OPEN SYMMETRIC KEY TestSymKey   
    DECRYPTION BY PASSWORD = 'pGFD4bb925DGvbd2439587y';  
GO  
-- Insert a row into the DemoKey table  
DECLARE @key_GUID uniqueidentifier;  
SELECT @key_GUID = key_guid FROM sys.symmetric_keys  
WHERE name LIKE 'TestSymKey' ;  
INSERT INTO DemoKey(SecretCol)  
VALUES ( ENCRYPTBYKEY (@key_GUID, 'EncryptedText'))  
GO  
-- Verify the DemoKey data  
SELECT * FROM DemoKey;  
GO  
-- Decrypt the data  
DECLARE @ciphertext VARBINARY(256);  
SELECT @ciphertext = SecretCol  
FROM DemoKey WHERE IDCol = 1 ;  
SELECT CAST (  
DECRYPTBYKEY( @ciphertext)  
AS VARCHAR(100) ) AS SecretText ;  
-- Use KEY_NAME to view the name of the key  
SELECT KEY_NAME(@ciphertext) AS [Name of Key] ;  

另请参阅

sys.symmetric_keys (Transact-SQL)
ENCRYPTBYKEY (Transact-SQL)
DECRYPTBYKEYAUTOASYMKEY (Transact-SQL)