ALTER SYMMETRIC KEY (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse Analytics

更改对称密钥的属性。

Transact-SQL 语法约定

注意

Azure Synapse Analytics 中的无服务器 SQL 池不支持此语法。

语法

ALTER SYMMETRIC KEY Key_name <alter_option>  
  
<alter_option> ::=  
   ADD ENCRYPTION BY <encrypting_mechanism> [ , ... n ]  
   |   
   DROP ENCRYPTION BY <encrypting_mechanism> [ , ... n ]  
<encrypting_mechanism> ::=  
   CERTIFICATE certificate_name  
   |  
   PASSWORD = 'password'  
   |  
   SYMMETRIC KEY Symmetric_Key_Name  
   |  
   ASYMMETRIC KEY Asym_Key_Name

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

参数

Key_name
要更改的对称密钥在数据库中所使用的名称。

ADD ENCRYPTION BY
使用指定的方法添加加密。

DROP ENCRYPTION BY
通过指定的方法删除加密。 您不能从对称密钥中删除所有的加密。

CERTIFICATE Certificate_name
指定用于对对称密钥进行加密的证书。 该证书必须已存在于数据库中。

PASSWORD ='password'
指定用于对对称密钥进行加密的密码。 password 必须符合运行 SQL Server 实例的计算机的 Windows 密码策略要求。

SYMMETRIC KEY Symmetric_Key_Name
指定用于对要更改的对称密钥进行加密的对称密钥。 该对称密钥必须已存在于数据库中，并且必须打开。

ASYMMETRIC KEY Asym_Key_Name
指定用于对要更改的对称密钥进行加密的非对称密钥。 此非对称密钥必须已经存在于数据库中。

备注

注意

当使用密码（而不是数据库主密钥的公钥）对对称密钥进行加密时，便会使用 TRIPLE_DES 加密算法。 因此，用强加密算法（如 AES）创建的密钥本身受较弱算法的保护。

若要更改对称密钥的加密，请使用 ADD ENCRYPTION 和 DROP ENCRYPTION 短语。 密钥始终不可能完全不进行加密。 因此，最佳实践是在删除旧加密格式之前添加新的加密格式。

若要更改对称密钥的所有者，请使用 ALTER AUTHORIZATION。

注意

RC4 算法仅用于支持向后兼容性。 仅当数据库兼容级别为 90 或 100 时，才能使用 RC4 或 RC4_128 对新材料进行加密。 （建议不要使用。）而是使用一种较新的算法，如 AES 算法之一。 在 SQL Server 2012 (11.x) 中，可以通过任何兼容级别对使用 RC4 或 RC4_128 加密的材料进行解密。

权限

要求对对称密钥具有 ALTER 权限。 如果使用证书或非对称密钥添加加密，则要求对证书或非对称密钥具有 VIEW DEFINITION 权限。 如果使用证书或非对称密钥删除加密，则要求对证书或非对称密钥具有 CONTROL 权限。

示例

以下示例更改用于保护对称密钥的加密方法。 当创建对称密钥 JanainaKey043 时，使用证书 Shipping04 对该密钥进行加密。 由于密钥始终不可能在不加密的情况下进行存储，因此在本例中，首先使用密码添加加密，然后使用证书删除加密。

CREATE SYMMETRIC KEY JanainaKey043 WITH ALGORITHM = AES_256   
    ENCRYPTION BY CERTIFICATE Shipping04;  
-- Open the key.   
OPEN SYMMETRIC KEY JanainaKey043 DECRYPTION BY CERTIFICATE Shipping04  
    WITH PASSWORD = '<enterStrongPasswordHere>';   
-- First, encrypt the key with a password.  
ALTER SYMMETRIC KEY JanainaKey043   
    ADD ENCRYPTION BY PASSWORD = '<enterStrongPasswordHere>';  
-- Now remove encryption by the certificate.  
ALTER SYMMETRIC KEY JanainaKey043   
    DROP ENCRYPTION BY CERTIFICATE Shipping04;  
CLOSE SYMMETRIC KEY JanainaKey043;

另请参阅

CREATE SYMMETRIC KEY (Transact-SQL)
OPEN SYMMETRIC KEY (Transact-SQL)
CLOSE SYMMETRIC KEY (Transact-SQL)
DROP SYMMETRIC KEY (Transact-SQL)
加密层次结构