sys.dm_io_cluster_valid_path_names (Transact-SQL)
Applies to:
SQL Server
Returns information on all valid shared disks, including clustered shared volumes, for a SQL Server failover cluster instance. If the instance is not clustered, an empty rowset is returned.
Column name | Data type | Description |
---|---|---|
path_name | Nvarchar(512) | Volume mount point or drive path that can be used as a root directory for database and log files. Is not nullable. |
cluster_owner_node | Nvarchar(64) | Current owner of the drive. For cluster shared volumes (CSV), the owner is the node which is hosting the MetaData Server. Is not nullable. |
is_cluster_shared_volume | Bit | Returns 1 if the drive on which this path is located is a cluster shared volume; otherwise, returns 0. |
Remarks
A SQL Server failover cluster instance (FCI) must use shared storage between all nodes of the FCI for data and log file storage. The disks listed in this view are those that are in the cluster resource group associated with the instance and are the only disks that can be used for data or log file storage.
Note
This view will replace sys.dm_io_cluster_shared_drives (Transact-SQL) in a future release.
Permissions
The user must have VIEW SERVER STATE permission for the SQL Server instance.
Permissions for SQL Server 2022 and later
Requires VIEW SERVER PERFORMANCE STATE permission on the server.
Examples
The following example uses sys.dm_io_cluster_valid_path_names to determine the shared drives on a clustered server instance:
SELECT * FROM sys.dm_io_cluster_valid_path_names;
See also
sys.dm_os_cluster_nodes (Transact-SQL)
sys.dm_io_cluster_shared_drives (Transact-SQL)
Dynamic Management Views and Functions (Transact-SQL)