CLOSE SYMMETRIC KEY (Transact-SQL)

Applies To: SQL Server 2014, SQL Server 2016 Preview

Topic Status: Some information in this topic is preview and subject to change in future releases. Preview information describes new features or changes to existing features in Microsoft SQL Server 2016 Community Technology Preview 2 (CTP2).

Closes a symmetric key, or closes all symmetric keys open in the current session.

Applies to: SQL Server (SQL Server 2008 through current version), SQL Database V12 ( Preview in some regions).

Topic link icon Transact-SQL Syntax Conventions

Syntax
CLOSE { SYMMETRIC KEY key_name | ALL SYMMETRIC KEYS }
Arguments
Key_name

Is the name of the symmetric key to be closed.

Remarks

Open symmetric keys are bound to the session not to the security context. An open key will continue to be available until it is either explicitly closed or the session is terminated. CLOSE ALL SYMMETRIC KEYS will close any database master key that was opened in the current session by using the OPEN MASTER KEY statement. Information about open keys is visible in the sys.openkeys (Transact-SQL) catalog view.

Permissions

No explicit permission is required to close a symmetric key.

Examples

A. Closing a symmetric key

The following example closes the symmetric key ShippingSymKey04.

CLOSE SYMMETRIC KEY ShippingSymKey04;
GO

B. Closing all symmetric keys

The following example closes all symmetric keys that are open in the current session, and also the explicitly opened database master key.

CLOSE ALL SYMMETRIC KEYS;
GO