sys.database_query_store_options (Transact-SQL)sys.database_query_store_options (Transact-SQL)

GILT FÜR: jaSQL Server jaAzure SQL-DatenbankjaAzure SQL Data Warehouse neinParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

Die Abfrage von Store-Optionen für diese Datenbank zurückgegeben.Returns the Query Store options for this database.

Gilt für: SQL ServerSQL Server (SQL Server 2016 (13.x)SQL Server 2016 (13.x) bis SQL Server 2017SQL Server 2017), SQL-DatenbankSQL Database.Applies to: SQL ServerSQL Server (SQL Server 2016 (13.x)SQL Server 2016 (13.x) through SQL Server 2017SQL Server 2017), SQL-DatenbankSQL Database.

SpaltennameColumn name DatentypData type BeschreibungDescription
desired_statedesired_state smallintsmallint Gibt an, den gewünschten Betriebsmodus des Abfrage-Store, die explizit vom Benutzer festgelegt.Indicates the desired operation mode of Query Store, explicitly set by user.
0 = OFF0 = OFF
1 = READ_ONLY1 = READ_ONLY
2 = READ_WRITE2 = READ_WRITE
desired_state_descdesired_state_desc nvarchar(60)nvarchar(60) Textbeschreibung für den gewünschten Betriebsmodus des Query Store:Textual description of the desired operation mode of Query Store:
OFFOFF
READ_ONLYREAD_ONLY
READ_WRITEREAD_WRITE
actual_stateactual_state smallintsmallint Gibt den Betriebsmodus des Abfrage-Store an.Indicates the operation mode of Query Store. Zusätzlich zu der gewünschten Status seitens des Benutzers erforderlich kann die ist-Zustand Status "Fehler" sein.In addition to list of desired states required by the user, actual state can be an error state.
0 = OFF0 = OFF
1 = READ_ONLY1 = READ_ONLY
2 = READ_WRITE2 = READ_WRITE
3 = FEHLER3 = ERROR
actual_state_descactual_state_desc nvarchar(60)nvarchar(60) Die textbeschreibung der tatsächlichen Betriebsmodus des Abfrage-Store.Textual description of the actual operation mode of Query Store.
OFFOFF
READ_ONLYREAD_ONLY
READ_WRITEREAD_WRITE
FehlerERROR

Es gibt Situationen, wenn der tatsächliche Zustand vom gewünschten Zustand abweicht:There are situations when actual state is different from the desired state:
– Wenn die Datenbank in den schreibgeschützten Modus festgelegt ist, oder wenn Query Store-Größe das konfigurierte Kontingent überschreitet, kann Query Store im Nur-Lese Modus betrieben werden, auch wenn die Lese-/ Schreibzugriff, die vom Benutzer angegeben wurde.- If the database is set to read-only mode or if Query Store size exceeds its configured quota, Query Store may operate in read-only mode even if read-write was specified by the user.
– In extremen Szenarien können Query Store Status "Fehler" aufgrund von internen Fehlern eingeben.- In extreme scenarios Query Store can enter an ERROR state because of internal errors. In diesem, SQL 2017 und höher Fall können Query Store wiederhergestellt werden, durch Ausführen der sp_query_store_consistency_check gespeicherten Prozedur in die betroffene Datenbank aus.If this happens, for SQL 2017 and later, Query Store can be recovered by executing the sp_query_store_consistency_check stored procedure in the affected database. Wenn sp_query_store_consistency_check funktioniert nicht, und für SQL 2016, benötigen Sie die Daten durch Ausführen von gelöscht ALTER DATABASE [YourDatabaseName] SET QUERY_STORE CLEAR ALL;If running sp_query_store_consistency_check doesn't work and for SQL 2016, you will need to clear the data by running ALTER DATABASE [YourDatabaseName] SET QUERY_STORE CLEAR ALL;
readonly_reasonreadonly_reason intint Wenn die Desired_state_desc ist READ_WRITE und Actual_state_desc ist READ_ONLY, Readonly_reason gibt etwas angeben, warum die Query Store in zuordnen Schreibgeschützter Modus.When the desired_state_desc is READ_WRITE and the actual_state_desc is READ_ONLY, readonly_reason returns a bit map to indicate why the Query Store is in readonly mode.

1 -Datenbank befindet sich im schreibgeschützten Modus1 - database is in read-only mode

2 -Datenbank befindet sich im Einzelbenutzermodus2 - database is in single-user mode

4 -Datenbank befindet sich im Notfallmodus4 - database is in emergency mode

8 -Datenbank ist sekundären Replikat (gilt für Always On und Azure SQL-DatenbankAzure SQL Database georeplikation).8 - database is secondary replica (applies to Always On and Azure SQL-DatenbankAzure SQL Database geo-replication). Dieser Wert kann nur auf effektiv beobachtet werden lesbare sekundäre ReplikateThis value can be effectively observed only on readable secondary replicas

65536 -die Query Store wurde erreicht das Größenlimit von der MAX_STORAGE_SIZE_MB-Option festgelegt.65536 - the Query Store has reached the size limit set by the MAX_STORAGE_SIZE_MB option.

131072 -die Anzahl der verschiedene Anweisungen in Query Store hat das interne Arbeitsspeicherlimit erreicht.131072 - The number of different statements in Query Store has reached the internal memory limit. Entfernen Sie ggf. Abfragen, die Sie nicht benötigen oder ein Upgrade auf eine höhere Dienstebene zu aktivieren, übertragen Query Store in Lese-/ Schreibmodus fest.Consider removing queries that you do not need or upgrading to a higher service tier to enable transferring Query Store to read-write mode.
Gilt für: Azure SQL-DatenbankAzure SQL Database.Applies to: Azure SQL-DatenbankAzure SQL Database.

262144 -Größe der Elemente im Arbeitsspeicher, die darauf warten, auf dem Datenträger beibehalten werden der internen Speicher erreicht hat.262144 - Size of in-memory items waiting to be persisted on disk has reached the internal memory limit. Query Store werden im Nur-Lese Modus ist vorübergehend, bis die Elemente im Arbeitsspeicher auf dem Datenträger beibehalten werden.Query Store will be in read-only mode temporarily until the in-memory items are persisted on disk.
Gilt für: Azure SQL-DatenbankAzure SQL Database.Applies to: Azure SQL-DatenbankAzure SQL Database.

524288 -Datenbank hat die datenträgergrößenbegrenzung erreicht.524288 - Database has reached disk size limit. Query Store ist Teil des Benutzerdatenbank, sodass es ist nicht mehr verfügbaren Speicherplatz für eine Datenbank, die das bedeutet, dass Query Store weiter wachsen kann nicht mehr.Query Store is part of user database, so if there is no more available space for a database, that means that Query Store cannot grow further anymore.
Gilt für: Azure SQL-DatenbankAzure SQL Database.Applies to: Azure SQL-DatenbankAzure SQL Database.

So wechseln Sie die Abfrage von Store-Vorgänge Modus Back Lese-/ Schreibzugriff, finden Sie unter überprüfen Query Store wird das Sammeln von kontinuierlich Abschnitt bewährte Methoden für die Query Store.To switch the Query Store operations mode back to read-write, see Verify Query Store is Collecting Query Data Continuously section of Best Practice with the Query Store.
current_storage_size_mbcurrent_storage_size_mb bigintbigint Die Größe des Abfrage-Store auf dem Datenträger in Megabyte.Size of Query Store on disk in megabytes.
flush_interval_secondsflush_interval_seconds bigintbigint Der Zeitraum für das reguläre leeren Abfrage von Store-Daten auf dem Datenträger in Sekunden.The period for regular flushing of Query Store data to disk in seconds. Standardwert ist 900 (15 Min.).Default value is 900 (15 min).

Ändern Sie mithilfe der ALTER DATABASE <database> SET QUERY_STORE (DATA_FLUSH_INTERVAL_SECONDS = <interval>) Anweisung.Change by using the ALTER DATABASE <database> SET QUERY_STORE (DATA_FLUSH_INTERVAL_SECONDS = <interval>) statement.
interval_length_minutesinterval_length_minutes bigintbigint Die Statistiken aggregationsintervall in Minuten.The statistics aggregation interval in minutes. Beliebige Werte sind nicht zulässig.Arbitrary values are not allowed. Verwenden Sie einen der folgenden Werte: 1, 5, 10, 15, 30, 60 und 1440 Minuten.Use one of the following: 1, 5, 10, 15, 30, 60, and 1440 minutes. Der Standardwert ist 60 Minuten.The default value is 60 minutes.
max_storage_size_mbmax_storage_size_mb bigintbigint Maximale Datenträgergröße für die Query Store in Megabyte (MB).Maximum disk size for the Query Store in megabytes (MB). Standardwert ist 100 MB.Default value is 100 MB.
Für SQL-DatenbankSQL Database Premium Edition, Standard ist 1 GB und für SQL-DatenbankSQL Database Basic Edition, Standardwert ist 10 MB.For SQL-DatenbankSQL Database Premium edition, default is 1 GB and for SQL-DatenbankSQL Database Basic edition, default is 10 MB.

Ändern Sie mithilfe der ALTER DATABASE <database> SET QUERY_STORE (MAX_STORAGE_SIZE_MB = <size>) Anweisung.Change by using the ALTER DATABASE <database> SET QUERY_STORE (MAX_STORAGE_SIZE_MB = <size>) statement.
stale_query_threshold_daysstale_query_threshold_days bigintbigint Anzahl der Tage, die Abfragen mit keine Richtlinieneinstellungen in Query Store gespeichert werden.Number of days that queries with no policy settings are kept in Query Store. Standardwert ist 30.Default value is 30. So deaktivieren Sie die Aufbewahrungsrichtlinie auf 0 festgelegt.Set to 0 to disable the retention policy.
Für die Basic-Edition von SQL-DatenbankSQL Database ist der Standardwert 7 Tage.For SQL-DatenbankSQL Database Basic edition, default is 7 days.

Ändern Sie mithilfe der ALTER DATABASE <database> SET QUERY_STORE ( CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = <value> ) ) Anweisung.Change by using the ALTER DATABASE <database> SET QUERY_STORE ( CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = <value> ) ) statement.
max_plans_per_querymax_plans_per_query bigintbigint Beschränkt die maximale Anzahl von gespeicherten Pläne an.Limits the maximum number of stored plans. Standardwert ist 200.Default value is 200. Wenn der Höchstwert erreicht ist, beendet Query Store die Erfassung neuer Pläne für diese Abfrage.If the maximum value is reached, Query Store stops capturing new plans for that query. Einstellung auf 0 wird die Beschränkung im Hinblick auf die Anzahl der erfassten Pläne.Setting to 0 removes the limitation with regards to the number of captured plans.

Ändern Sie mithilfe der ALTER DATABASE<database> SET QUERY_STORE (MAX_PLANS_PER_QUERY = <n>) Anweisung.Change by using the ALTER DATABASE<database> SET QUERY_STORE (MAX_PLANS_PER_QUERY = <n>) statement.
query_capture_modequery_capture_mode smallintsmallint Die derzeit aktiven abfrageerfassungsmodus:The currently active query capture mode:

1 = ALL - alle Abfragen werden erfasst.1 = ALL - all queries are captured. Dies ist der standardkonfigurationswert für SQL ServerSQL Server (SQL Server 2016 (13.x)SQL Server 2016 (13.x) über SQL Server 2017SQL Server 2017).This is the default configuration value for SQL ServerSQL Server (SQL Server 2016 (13.x)SQL Server 2016 (13.x) through SQL Server 2017SQL Server 2017).

2 = die AUTO - Erfassung relevante Abfragen basierend auf Anzahl und Ausführung des Ressourcenverbrauchs.2 = AUTO - capture relevant queries based on execution count and resource consumption. Dies ist der standardkonfigurationswert für SQL-DatenbankSQL Database.This is the default configuration value for SQL-DatenbankSQL Database.

3 = keine - Erfassung neuer Abfragen beendet.3 = NONE - stop capturing new queries. Der Abfragedatenspeicher sammelt weiterhin Statistiken zur Kompilierung und Runtime für Abfragen, die bereits erfasst wurden.Query Store will continue to collect compile and runtime statistics for queries that were captured already. Verwenden Sie diese Konfiguration mit Vorsicht, da Sie dadurch möglicherweise wichtige Abfragen zu erfassen.Use this configuration cautiously since you may miss capturing important queries.
query_capture_mode_descquery_capture_mode_desc nvarchar(60)nvarchar(60) Die textbeschreibung der tatsächlichen Aufzeichnungsmodus Query Store:Textual description of the actual capture mode of Query Store:

Alle (Standard für SQL Server 2016 (13.x)SQL Server 2016 (13.x))ALL (default for SQL Server 2016 (13.x)SQL Server 2016 (13.x))

AUTOMATISCHE (Standard für SQL-DatenbankSQL Database)AUTO (default for SQL-DatenbankSQL Database)

KeineNONE
size_based_cleanup_modesize_based_cleanup_mode smallintsmallint Steuert, ob die Bereinigung automatisch aktiviert wird, wenn sich die Gesamtmenge der Daten der maximalen Größe nähert:Controls whether cleanup will be automatically activated when total amount of data gets close to maximum size:

0 = OFF - größenbasierte Cleanup wird nicht automatisch aktiviert.0 = OFF - size-based cleanup won't be automatically activated.

1 = die AUTO - größenbasierte Cleanup wird automatisch aktiviert, wenn der Wert auf dem Datenträger erreicht 90 Prozent von Max_storage_size_mb.1 = AUTO - size-based cleanup will be automatically activated when size on disk reaches 90 percent of max_storage_size_mb. Dies ist der Standardkonfigurationswert.This is the default configuration value.

Ein auf der Größe basierendes Cleanup entfernt die am wenigsten aufwendigen und die ältesten Abfragen.Size-based cleanup removes the least expensive and oldest queries first. Beendet, wenn ungefähr 80 Prozent von Max_storage_size_mb erreicht ist.It stops when approximately 80 percent of max_storage_size_mb is reached.
size_based_cleanup_mode_descsize_based_cleanup_mode_desc nvarchar(60)nvarchar(60) Die textbeschreibung der tatsächlichen größenbasierte Cleanup-Modus des Query Store:Textual description of the actual size-based cleanup mode of Query Store:

OFFOFF
AUTOMATISCHE (Standard)AUTO (default)
wait_stats_capture_modewait_stats_capture_mode smallintsmallint Steuert, ob Query Store Erfassung von Statistiken zu abfragewartevorgängen ausführt:Controls whether Query Store performs capture of wait statistics:

0 = OFF0 = OFF
1 = ON1 = ON
Gilt für: SQL Server 2017 (14.x)SQL Server 2017 (14.x) bis SQL Server 2017SQL Server 2017.Applies to: SQL Server 2017 (14.x)SQL Server 2017 (14.x) through SQL Server 2017SQL Server 2017.
wait_stats_capture_mode_descwait_stats_capture_mode_desc nvarchar(60)nvarchar(60) Die textbeschreibung der tatsächlichen Wait Statistiken standarderfassungsmodus ein Modus:Textual description of the actual wait statistics capture mode:

OFFOFF
ON (Standard)ON (default)
Gilt für: SQL Server 2017 (14.x)SQL Server 2017 (14.x) bis SQL Server 2017SQL Server 2017.Applies to: SQL Server 2017 (14.x)SQL Server 2017 (14.x) through SQL Server 2017SQL Server 2017.

BerechtigungenPermissions

Erfordert die VIEW DATABASE STATE-Berechtigung.Requires the VIEW DATABASE STATE permission.

Siehe auchSee Also

sys.query_context_settings (Transact-SQL) sys.query_context_settings (Transact-SQL)
sys.query_store_plan (Transact-SQL) sys.query_store_plan (Transact-SQL)
sys.query_store_query (Transact-SQL) sys.query_store_query (Transact-SQL)
sys.query_store_query_text (Transact-SQL) sys.query_store_query_text (Transact-SQL)
sys.query_store_runtime_stats (Transact-SQL) sys.query_store_runtime_stats (Transact-SQL)
sys.query_store_wait_stats (Transact-SQL)sys.query_store_wait_stats (Transact-SQL)
sys.query_store_runtime_stats_interval (Transact-SQL) sys.query_store_runtime_stats_interval (Transact-SQL)
Überwachen der Leistung mit dem Abfragespeicher Monitoring Performance By Using the Query Store
Katalogsichten (Transact-SQL) Catalog Views (Transact-SQL)
sys.fn_stmt_sql_handle_from_sql_stmt (Transact-SQL) sys.fn_stmt_sql_handle_from_sql_stmt (Transact-SQL)
Query Store gespeicherte Prozeduren (Transact-SQL)Query Store Stored Procedures (Transact-SQL)