Skip to content

Latest commit

 

History

History
65 lines (52 loc) · 2.6 KB

File metadata and controls

65 lines (52 loc) · 2.6 KB
title SYMKEYPROPERTY (Transact-SQL)
description SYMKEYPROPERTY (Transact-SQL)
author VanMSFT
ms.author vanto
ms.date 03/06/2017
ms.service sql
ms.subservice t-sql
ms.topic reference
ms.custom
ignite-2025
f1_keywords
SYMKEYPROPERTY_TSQL
SYMKEYPROPERTY
helpviewer_keywords
SYMKEYPROPERTY
dev_langs
TSQL
monikerRange =azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb

SYMKEYPROPERTY (Transact-SQL)

[!INCLUDE SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB]

Returns the algorithm of a symmetric key created from an EKM module.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

SYMKEYPROPERTY ( Key_ID , 'algorithm_desc' | 'string_sid' | 'sid' )  

Arguments

Key_ID
Is the Key_ID of a symmetric key in the database. To find the Key_ID when you only know the key name, use SYMKEY_ID. Key_ID is data type int.

'algorithm_desc'
Specifies that the output returns the algorithm description of the symmetric key. Only available for symmetric keys created from an EKM module.

Return Types

sql_variant

Permissions

Requires some permission on the symmetric key and that the caller has not been denied VIEW permission on the symmetric key.

Examples

The following example returns the algorithm of the symmetric key with Key_ID 256.

SELECT SYMKEYPROPERTY(256, 'algorithm_desc') AS Algorithm ;  
GO  

See Also

ASYMKEY_ID (Transact-SQL)
ALTER SYMMETRIC KEY (Transact-SQL)
DROP SYMMETRIC KEY (Transact-SQL)
Encryption Hierarchy
sys.symmetric_keys (Transact-SQL)
Security Catalog Views (Transact-SQL)
KEY_ID (Transact-SQL)
ASYMKEYPROPERTY (Transact-SQL)