Skip to content

Latest commit

 

History

History
125 lines (82 loc) · 8.69 KB

system-dynamic-management-views.md

File metadata and controls

125 lines (82 loc) · 8.69 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic helpviewer_keywords dev_langs monikerRange
System dynamic management views (Transact-SQL)
Dynamic management views and functions return server state information that can be used to monitor the health of a server instance, diagnose problems, and tune performance.
rwestMSFT
randolphwest
10/02/2023
sql
system-objects
reference
database scoped dynamic management objects [SQL Server]
dynamic management objects [SQL Server], about dynamic management objects
server state information [SQL Server]
dynamic management functions [SQL Server]
metadata [SQL Server], dynamic management objects
dynamic management views [SQL Server]
DMVs [SQL Server]
functions [SQL Server], dynamic management
server scoped dynamic management objects [SQL Server]
dynamic management objects [SQL Server]
TSQL
>=aps-pdw-2016 || =azuresqldb-current || =azure-sqldw-latest || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric

System dynamic management views

[!INCLUDE sql-asdb-asdbmi-asa-pdw-fabricse-fabricdw]

Dynamic management views (DMVs) and dynamic management functions (DMFs) return server state information that can be used to monitor the health of a server instance, diagnose problems, and tune performance.

Important

Dynamic management views and functions return internal, implementation-specific state data. Their schemas and the data they return may change in future releases of [!INCLUDE ssNoVersion]. Therefore, dynamic management views and functions in future releases may not be compatible with the dynamic management views and functions in this release. For example, in future releases of [!INCLUDE ssNoVersion], Microsoft may augment the definition of any dynamic management view by adding columns to the end of the column list. We recommend against using the syntax SELECT * FROM dynamic_management_view_name in production code because the number of columns returned might change and break your application.

There are two types of dynamic management views and functions:

  • Server-scoped dynamic management views and functions. These require VIEW SERVER STATE permission on the server. For SQL Server 2022 and later, VIEW SERVER PERFORMANCE STATE is required, or VIEW SERVER SECURITY STATE is required for a few DMVs that are security related.

  • Database-scoped dynamic management views and functions. These require VIEW DATABASE STATE permission on the database. For SQL Server 2022 and later, VIEW DATABASE PERFORMANCE STATE is required, or VIEW DATABASE SECURITY STATE is required for a few DMVs that are security related.

Query dynamic management views

Dynamic management views can be referenced in [!INCLUDE tsql] statements by using two-part, three-part, or four-part names. Dynamic management functions on the other hand can be referenced in [!INCLUDE tsql] statements by using either two-part or three-part names. Dynamic management views and functions can't be referenced in [!INCLUDE tsql] statements by using one-part names.

All dynamic management views and functions exist in the sys schema and follow this naming convention dm_*. When you use a dynamic management view or function, you must prefix the name of the view or function by using the sys schema. For example, to query the dm_os_wait_stats dynamic management view, run the following query:

SELECT wait_type, wait_time_ms
FROM sys.dm_os_wait_stats;

Required permissions

To query a dynamic management view or function requires SELECT permission on object and VIEW SERVER STATE or VIEW DATABASE STATE permission. This lets you selectively restrict access of a user or login to dynamic management views and functions. To do this, first create the user in master and then deny the user SELECT permission on the dynamic management views or functions that you don't want them to access. After this, the user can't select from these dynamic management views or functions, regardless of database context of the user.

Note

Because DENY takes precedence, if a user has been granted VIEW SERVER STATE permissions but denied VIEW DATABASE STATE permission, the user can see server-level information, but not database-level information.

In this section

Dynamic management views and functions have been organized into the following categories.

:::row::: :::column::: Always On Availability Groups Dynamic Management Views - Functions

    [Change Data Capture - sys.dm_cdc_errors](change-data-capture-sys-dm-cdc-errors.md)

    [Change Tracking - sys.dm_tran_commit_table](change-tracking-sys-dm-tran-commit-table.md)

    [Common Language Runtime Related Dynamic Management Views (Transact-SQL)](common-language-runtime-related-dynamic-management-views-transact-sql.md)

    [Database Mirroring - sys.dm_db_mirroring_auto_page_repair](database-mirroring-sys-dm-db-mirroring-auto-page-repair.md)

    [Database related dynamic management views (Transact-SQL)](database-related-dynamic-management-views-transact-sql.md)

    [Execution Related Dynamic Management Views and Functions (Transact-SQL)](execution-related-dynamic-management-views-and-functions-transact-sql.md)

    [Extended Events Dynamic Management Views](extended-events-dynamic-management-views.md)

    [FILESTREAM and FileTable dynamic management views (Transact-SQL)](filestream-and-filetable-dynamic-management-views-transact-sql.md)

    [Full-Text and Semantic Search Dynamic Management Views - Functions](full-text-and-semantic-search-dynamic-management-views-functions.md)

    [Geo-Replication Dynamic Management Views and Functions (Azure SQL Database)](geo-replication-dynamic-management-views-and-functions-azure-sql-database.md)

    [Index Related Dynamic Management Views and Functions (Transact-SQL)](index-related-dynamic-management-views-and-functions-transact-sql.md)

    [I/O Related Dynamic Management Views and Functions (Transact-SQL)](i-o-related-dynamic-management-views-and-functions-transact-sql.md)

    [Monitor and troubleshoot PolyBase](../polybase/polybase-troubleshooting.md)
:::column-end:::
:::column:::
    [Memory-Optimized Table Dynamic Management Views (Transact-SQL)](memory-optimized-table-dynamic-management-views-transact-sql.md)

    [Object Related Dynamic Management Views and Functions (Transact-SQL)](object-related-dynamic-management-views-and-functions-transact-sql.md)

    [Query Notifications - sys.dm_qn_subscriptions](query-notifications-sys-dm-qn-subscriptions.md)

    [Replication Related Dynamic Management Views (Transact-SQL)](replication-related-dynamic-management-views-transact-sql.md)

    [Resource Governor Related Dynamic Management Views (Transact-SQL)](resource-governor-related-dynamic-management-views-transact-sql.md)

    [Security-Related Dynamic Management Views and Functions (Transact-SQL)](security-related-dynamic-management-views-and-functions-transact-sql.md)

    [Server dynamic management views and functions (Transact-SQL)](server-related-dynamic-management-views-and-functions-transact-sql.md)

    [Service Broker Related Dynamic Management Views (Transact-SQL)](service-broker-related-dynamic-management-views-transact-sql.md)

    [Spatial Data - sys.dm_db_objects_disabled_on_compatibility_level_change](spatial-data-sys-dm-db-objects-disabled-on-compatibility-level-change.md)

    [SQL and Parallel Data Warehouse Dynamic Management Views](sql-and-parallel-data-warehouse-dynamic-management-views.md)

    [SQL Server Operating System Related Dynamic Management Views (Transact-SQL)](sql-server-operating-system-related-dynamic-management-views-transact-sql.md)

    [Stretch Database related dynamic management views (Transact-SQL)](/previous-versions/sql/relational-databases/system-dynamic-management-views/stretch-database-related-dynamic-management-views-transact-sql)

    [Transaction Related Dynamic Management Views and Functions (Transact-SQL)](transaction-related-dynamic-management-views-and-functions-transact-sql.md)
:::column-end:::

:::row-end:::

Related content