sys-dm-xe-map-values-transact-sql.md

title	sys.dm_xe_map_values (Transact-SQL)
description	sys.dm_xe_map_values (Transact-SQL)
author	rwestMSFT
ms.author	randolphwest
ms.date	09/23/2025
ms.service	sql
ms.subservice	system-objects
ms.topic	reference
ms.custom	ignite-2025
f1_keywords	sys.dm_xe_map_values dm_xe_map_values dm_xe_map_values_TSQL sys.dm_xe_map_values_TSQL
helpviewer_keywords	sys.dm_xe_map_values dynamic management view xe
dev_langs	TSQL

sys.dm_xe_map_values (Transact-SQL)

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

Returns a mapping of internal numeric keys to human-readable text.

Column name	Data type	Description
name	nvarchar(256)	The name of the map. name is unique across the local system. Is not nullable.
object_package_guid	uniqueidentifier	The GUID of the package that contains the map. Is not nullable.
map_key	int	The internal key value. Is not nullable.
map_value	nvarchar(3072)	A description of the key value. Is not nullable.

Permissions

Requires VIEW SERVER STATE permission on the server.

Permissions for SQL Server 2022 and later

Requires VIEW SERVER PERFORMANCE STATE permission on the server.

Relationship cardinalities

From	To	Relationship
dm_xe_map_values.object_package_guid<br /><br /> dm_xe_map_values.name	sys.dm_xe_objects.package_guid sys.dm_xe_objects.name	Many-to-one

Related content

• Dynamic Management Views and Functions (Transact-SQL)
• sys.dm_xe_sessions (Transact-SQL)
• sys.dm_xe_session_events (Transact-SQL)
• Extended Events overview
• Quickstart: Extended Events
• Extended events in Azure SQL Database
• Event File target code for extended events in Azure SQL Database and SQL Managed Instance