Skip to content

Commit 8bc7499

Browse files
authored
Merge pull request #15180 from pmasl/patch-821
Update alter-database-transact-sql-set-options.md
2 parents bae79ff + 0fc3560 commit 8bc7499

2 files changed

Lines changed: 47 additions & 65 deletions

File tree

docs/relational-databases/performance/monitoring-performance-by-using-the-query-store.md

Lines changed: 2 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -147,38 +147,11 @@ Here are some examples how you can get more insights into your workload before a
147147

148148
## <a name="Options"></a> Configuration Options
149149

150-
The following options are available to configure Query Store parameters.
151-
152-
*OPERATION_MODE*
153-
Can be **READ_WRITE** (default) or READ_ONLY.
154-
155-
*CLEANUP_POLICY (STALE_QUERY_THRESHOLD_DAYS)*
156-
Configure the `STALE_QUERY_THRESHOLD_DAYS` argument to specify the number of days to retain data in the Query Store. The default value is 30. For [!INCLUDE[sqldbesa](../../includes/sqldbesa-md.md)] Basic edition, default is **7** days.
157-
158-
*DATA_FLUSH_INTERVAL_SECONDS*
159-
Determines the frequency at which data written to the Query Store is persisted to disk. To optimize for performance, data collected by the query store is asynchronously written to the disk. The frequency at which this asynchronous transfer occurs is configured via `DATA_FLUSH_INTERVAL_SECONDS`. The default value is **900** (15 min).
160-
161-
*MAX_STORAGE_SIZE_MB*
162-
Configures the maximum size of the Query Store. If the data in the Query Store hits the `MAX_STORAGE_SIZE_MB` limit, the Query Store automatically changes the state from read-write to read-only and stops collecting new data. The default value is **100 MB** for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] ([!INCLUDE[ssSQL15](../../includes/sssql15-md.md)] through [!INCLUDE[ssSQL17](../../includes/sssql17-md.md)]). Starting with [!INCLUDE[sql-server-2019](../../includes/sssqlv15-md.md)], the default value is **1 GB**. For [!INCLUDE[sqldbesa](../../includes/sqldbesa-md.md)] Premium edition, default is **1 GB** and for [!INCLUDE[sqldbesa](../../includes/sqldbesa-md.md)] Basic edition, default is **10 MB**.
163-
164-
*INTERVAL_LENGTH_MINUTES*
165-
Determines the time interval at which runtime execution statistics data is aggregated into the Query Store. To optimize for space usage, the runtime execution statistics in the Runtime Stats Store are aggregated over a fixed time window. This fixed time window is configured via `INTERVAL_LENGTH_MINUTES`. The default value is **60**.
166-
167-
*SIZE_BASED_CLEANUP_MODE*
168-
Controls whether the cleanup process will be automatically activated when total amount of data gets close to maximum size. Can be **AUTO** (default) or OFF.
169-
170-
*QUERY_CAPTURE_MODE*
171-
Designates if the Query Store captures all queries, or relevant queries based on execution count and resource consumption, or stops adding new queries and just tracks current queries. Can be **ALL** (capture all queries), AUTO (ignore infrequent and queries with insignificant compile and execution duration), CUSTOM (user defined capture policy), or NONE (stop capturing new queries). The default value is **ALL** for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] ([!INCLUDE[ssSQL15](../../includes/sssql15-md.md)] through [!INCLUDE[ssSQL17](../../includes/sssql17-md.md)]). Starting with [!INCLUDE[sql-server-2019](../../includes/sssqlv15-md.md)], the default value is **AUTO**. The default value for [!INCLUDE[ssSDSfull](../../includes/sssdsfull-md.md)] is **AUTO**.
172-
173-
*MAX_PLANS_PER_QUERY*
174-
An integer representing the maximum number of plans maintained for each query. The default value is **200**.
175-
176-
*WAIT_STATS_CAPTURE_MODE*
177-
Controls if Query Store captures wait statistics information. Can be OFF or **ON** (default).
150+
For the available options to configure Query Store parameters, see [ALTER DATABASE SET options (Transact-SQL)](../../t-sql/statements/alter-database-transact-sql-set-options.md#query-store).
178151

179152
Query the **sys.database_query_store_options** view to determine the current options of the Query Store. For more information about the values, see [sys.database_query_store_options](../../relational-databases/system-catalog-views/sys-database-query-store-options-transact-sql.md).
180153

181-
For more information about setting options by using [!INCLUDE[tsql](../../includes/tsql-md.md)] statements, see [Option Management](#OptionMgmt).
154+
For examples about setting configuration options using [!INCLUDE[tsql](../../includes/tsql-md.md)] statements, see [Option Management](#OptionMgmt).
182155

183156
## <a name="Related"></a> Related Views, Functions, and Procedures
184157

0 commit comments

Comments
 (0)