sys.database_query_store_options (Transact-SQL)
Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Banco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse Analytics
Retorna as opções de Repositório de Consultas para esse banco de dados.
Aplica-se a: SQL Server (SQL Server 2016 (13.x) e posterior), Banco de Dados SQL.
Nome da coluna | Tipo de dados | Descrição |
---|---|---|
desired_state | smallint | Indica o modo de operação desejado de Repositório de Consultas, definido explicitamente pelo usuário. 0 = OFF 1 = READ_ONLY 2 = READ_WRITE 4 = READ_CAPTURE_SECONDARY |
desired_state_desc | nvarchar(60) | Descrição textual do modo de operação desejado de Repositório de Consultas: OFF READ_ONLY READ_WRITE READ_CAPTURE_SECONDARY |
actual_state | smallint | Indica o modo de operação de Repositório de Consultas. Além da lista de estados desejados exigidos pelo usuário, o estado real pode ser um estado de erro. 0 = OFF 1 = READ_ONLY 2 = READ_WRITE 3 = ERRO 4 = READ_CAPTURE_SECONDARY |
actual_state_desc | nvarchar(60) | Descrição textual do modo de operação real de Repositório de Consultas. OFF READ_ONLY READ_WRITE ERROR READ_CAPTURE_SECONDARY Há situações em que o estado real é diferente do estado desejado: - Se o banco de dados estiver definido como modo somente leitura ou se Repositório de Consultas tamanho exceder sua cota configurada, Repositório de Consultas poderá operar no modo somente leitura mesmo se a leitura-gravação tiver sido especificada pelo usuário. - Em cenários extremos Repositório de Consultas pode inserir um estado ERROR devido a erros internos. Começando com o SQL Server 2017 (14.x), se isso acontecer, o Repositório de Consultas pode ser recuperado executando o procedimento armazenado sp_query_store_consistency_check no banco de dados afetado. Se a execução sp_query_store_consistency_check não funcionar ou se você estiver usando SQL Server 2016 (13.x), precisará limpar os dados executandoALTER DATABASE [YourDatabaseName] SET QUERY_STORE CLEAR ALL; |
readonly_reason | int | Quando o desired_state_desc é READ_WRITE e o actual_state_desc é READ_ONLY, readonly_reason retorna um mapa de bits para indicar por que a Repositório de Consultas está no modo somente leitura. 1 – o banco de dados está no modo somente leitura 2 – o banco de dados está no modo de usuário único 4 – o banco de dados está no modo de emergência 8 – o banco de dados é secundário réplica (aplica-se a grupos de disponibilidade e SQL do Azure replicação geográfica do Banco de Dados). Esse valor só pode ser observado efetivamente em réplicas secundárias legíveis 65536 – o Repositório de Consultas atingiu o limite de tamanho definido pela opção MAX_STORAGE_SIZE_MB . Para obter mais informações sobre essa opção, consulte Opções ALTER DATABASE SET (Transact-SQL).131072 - O número de instruções diferentes em Repositório de Consultas atingiu o limite de memória interna. Considere remover consultas de que você não precisa ou atualizar para uma camada de serviço mais alta para habilitar a transferência de Repositório de Consultas para o modo de leitura/gravação. 262144 - O tamanho dos itens na memória aguardando para serem persistidos no disco atingiu o limite de memória interna. Repositório de Consultas estará temporariamente no modo somente leitura até que os itens na memória sejam persistidos no disco. 524288 – o banco de dados atingiu o limite de tamanho do disco. Repositório de Consultas faz parte do banco de dados do usuário, portanto, se não houver mais espaço disponível para um banco de dados, isso significa que Repositório de Consultas não podem mais crescer. Para alternar o modo de operações de Repositório de Consultas de volta para leitura-gravação, consulte Verificar se Repositório de Consultas está coletando dados de consulta continuamente seção de Práticas Recomendadas com o Repositório de Consultas. |
current_storage_size_mb | bigint | Tamanho de Repositório de Consultas no disco em megabytes. |
flush_interval_seconds | bigint | O período de liberação regular de Repositório de Consultas dados para o disco em segundos. O valor padrão é 900 (15 min). Altere usando a instrução ALTER DATABASE <database> SET QUERY_STORE (DATA_FLUSH_INTERVAL_SECONDS = <interval>) . |
interval_length_minutes | bigint | O intervalo de agregação de estatísticas em minutos. Valores arbitrários não são permitidos. Use uma das seguintes opções: 1, 5, 10, 15, 30, 60 e 1440 minutos. O valor padrão é 60 minutos. |
max_storage_size_mb | bigint | Tamanho máximo do disco para o Repositório de Consultas em megabytes (MB). O valor padrão é 100 MB até SQL Server 2017 (14.x) e 1 GB começando com SQL Server 2019 (15.x). Para o Banco de Dados SQL Premium Edition, o padrão é 1 GB e, para o Banco de Dados SQL Basic Edition, o padrão é 10 MB. Altere usando a instrução ALTER DATABASE <database> SET QUERY_STORE (MAX_STORAGE_SIZE_MB = <size>) . |
stale_query_threshold_days | bigint | Número de dias em que as informações de uma consulta são mantidas no Repositório de Consultas. O valor padrão é 30. Defina como 0 para desabilitar a política de retenção. Para o Banco de Dados SQL Basic Edition, o padrão é 7 dias. Altere usando a instrução ALTER DATABASE <database> SET QUERY_STORE ( CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = <value> ) ) . |
max_plans_per_query | bigint | Limita o número máximo de planos armazenados. O valor padrão é 200. Se o valor máximo for atingido, Repositório de Consultas interromperá a captura de novos planos para essa consulta. A configuração como 0 remove a limitação em relação ao número de planos capturados. Altere usando a instrução ALTER DATABASE<database> SET QUERY_STORE (MAX_PLANS_PER_QUERY = <n>) . |
query_capture_mode | smallint | O modo de captura de consulta ativo no momento: 1 = ALL – todas as consultas são capturadas. Esse é o valor de configuração padrão para SQL Server (SQL Server 2016 (13.x) e posterior). 2 = AUTO – capturar consultas relevantes com base na contagem de execuções e no consumo de recursos. Esse é o valor de configuração padrão para Banco de Dados SQL. 3 = NONE – parar de capturar novas consultas. O Repositório de Consultas continuará a coletar estatísticas de compilação e runtime para consultas que já foram capturadas. Use essa configuração com cautela, pois você pode perder a captura de consultas importantes. 4 = CUSTOM – permite controle adicional sobre a política de captura de consulta usando as opções de QUERY_CAPTURE_POLICY. Aplica-se a: SQL Server 2019 (15.x) e posterior. |
query_capture_mode_desc | nvarchar(60) | Descrição textual do modo de captura real de Repositório de Consultas: ALL (padrão para SQL Server 2016 (13.x)) AUTO (padrão para Banco de Dados SQL) Nenhuma CUSTOM |
capture_policy_execution_count | int | Opção de política CUSTOM do Modo de Captura de Consulta. Define o número de vezes que uma consulta é executada durante o período de avaliação. O padrão é 30. Aplica-se a: SQL Server 2019 (15.x) e posterior. |
capture_policy_total_compile_cpu_time_ms | bigint | Opção de política CUSTOM do Modo de Captura de Consulta. Define o tempo total decorrido da CPU de compilação usado por uma consulta durante o período de avaliação. O padrão é 1000. Aplica-se a: SQL Server 2019 (15.x) e posterior. |
capture_policy_total_execution_cpu_time_ms | bigint | Opção de política CUSTOM do Modo de Captura de Consulta. Define o tempo total decorrido da CPU de execução usado por uma consulta durante o período de avaliação. O padrão é 100. Aplica-se a: SQL Server 2019 (15.x) e posterior. |
capture_policy_stale_threshold_hours | int | Opção de política CUSTOM do Modo de Captura de Consulta. Define o período de intervalo de avaliação para determinar se uma consulta deve ser capturada. O padrão é 24 horas. Aplica-se a: SQL Server 2019 (15.x) e posterior. |
size_based_cleanup_mode | smallint | Controla se a limpeza será ativada automaticamente quando a quantidade total de dados se aproximar do tamanho máximo: 0 = OFF - a limpeza baseada em tamanho não será ativada automaticamente. 1 = AUTO – a limpeza baseada em tamanho será ativada automaticamente quando o tamanho no disco atingir 90% dos max_storage_size_mb. Esse é o valor de configuração padrão. Limpeza com base no tamanho remove as consultas menos dispendiosas e mais antigas primeiro. Ele é interrompido quando aproximadamente 80% dos max_storage_size_mb são atingidos. |
size_based_cleanup_mode_desc | nvarchar(60) | Descrição textual do modo de limpeza baseado em tamanho real de Repositório de Consultas: OFF AUTO (padrão) |
wait_stats_capture_mode | smallint | Controla se Repositório de Consultas executa a captura de estatísticas de espera: 0 = OFF 1 = ON Aplica-se a: SQL Server 2017 (14.x) e posterior. |
wait_stats_capture_mode_desc | nvarchar(60) | Descrição textual do modo real de captura de estatísticas de espera: OFF ON (padrão) Aplica-se a: SQL Server 2017 (14.x) e posterior. |
actual_state_additional_info | nvarchar(8000) | Atualmente não utilizado. |
Permissões
Requer a permissão VIEW DATABASE STATE
.
Comentários
Um actual_state_desc
valor de READ_CAPTURE_SECONDARY é o estado esperado quando Repositório de Consultas para réplicas secundárias está habilitada. Para obter mais informações, consulte Repositório de Consultas para réplicas secundárias.
Próximas etapas
- sys.query_context_settings (Transact-SQL)
- sys.query_store_plan (Transact-SQL)
- sys.query_store_query (Transact-SQL)
- sys.query_store_query_text (Transact-SQL)
- sys.query_store_runtime_stats (Transact-SQL)
- sys.query_store_wait_stats (Transact-SQL)
- sys.query_store_runtime_stats_interval (Transact-SQL)
- Monitorando o desempenho com o repositório de consultas
- Exibições do Catálogo (Transact-SQL)
- sys.fn_stmt_sql_handle_from_sql_stmt (Transact-SQL)
- Procedimentos armazenados do Repositório de Consultas (Transact-SQL)
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários