Edit

Share via


sys.query_store_replicas (Transact-SQL)

Applies to: SQL Server 2025 (17.x) Azure SQL Database

Contains information about Query Store replicas, when Query Store for readable secondaries is enabled. You can use this information to determine what replica_group_id to use when using Query Store to force or unforce a plan on a secondary replica with sys.sp_query_store_set_query_hints.

Query Store for secondary replicas is supported starting in SQL Server 2025 (17.x) and later versions, and in Azure SQL Database. For complete platform support, see Query Store for secondary replicas.

Column name Data type Description
replica_group_id bigint Identifies the replica set number for this replica.
role_type tinyint 1=Primary
2=Secondary
3=Geo-Primary
4=Geo-Secondary
5 or greater=Named replica
replica_name nvarchar(max) Instance name of the replica. NULL for replicas in Azure SQL Managed Instance.

Remarks

This catalog view returns the same row data on all replicas. The catalog view contains a row per replica for every role_type where it was observed. For example, a two-replica availability group initially contains two rows. After a failover, it contains four rows: one row for each replica in both the primary and secondary roles.

Permissions

Requires the VIEW DATABASE STATE permission.