close-symmetric-key-transact-sql.md

title	CLOSE SYMMETRIC KEY (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	05/15/2017
ms.prod	sql-non-specified
ms.prod_service	database-engine, sql-database
ms.service
ms.component	t-sql|statements
ms.reviewer
ms.suite	sql
ms.technology	database-engine
ms.tgt_pltfrm
ms.topic	language-reference
f1_keywords	CLOSE SYMMETRIC KEY CLOSE_SYMMETRIC_KEY_TSQL
dev_langs	TSQL
helpviewer_keywords	closing symmetric keys encryption [SQL Server], symmetric keys symmetric keys [SQL Server], closing CLOSE SYMMETRIC KEY statement cryptography [SQL Server], symmetric keys
ms.assetid	3b083cbb-3c6a-4f59-8d34-601db1efcc83
caps.latest.revision	29
author	edmacauley
ms.author	edmaca
manager	cguyer
ms.workload	Inactive

CLOSE SYMMETRIC KEY (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-asdb-xxxx-xxx-md]

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

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  

See Also

CREATE SYMMETRIC KEY (Transact-SQL)
ALTER SYMMETRIC KEY (Transact-SQL)
OPEN SYMMETRIC KEY (Transact-SQL)
DROP SYMMETRIC KEY (Transact-SQL)