sys.database_query_store_options (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Base de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsSQL database in Microsoft Fabric

Retorna as opções do Repositório de Consultas para esse banco de dados.

Nome da coluna Tipo de dados Description
desired_state smallint Indica o modo de operação desejado do 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 do Repositório de Consultas:

OFF
READ_ONLY
READ_WRITE
READ_CAPTURE_SECONDARY
actual_state smallint Indica o modo de operação do 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 = ERROR
4 = READ_CAPTURE_SECONDARY
actual_state_desc nvarchar(60) Descrição textual do modo de operação real do 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 para o modo somente leitura ou se o tamanho do Repositório de Consultas exceder sua cota configurada, o Repositório de Consultas poderá operar no modo somente leitura, mesmo que você especifique leitura-gravação.
- Em cenários extremos, o Query Store pode entrar em um estado de ERRO devido a erros internos. No SQL Server 2017 (14.x) e versões posteriores, se isso acontecer, o Repositório de Consultas poderá ser recuperado executando o sp_query_store_consistency_check procedimento armazenado no banco de dados afetado. Se a execução sp_query_store_consistency_check não funcionar ou se você estiver usando o SQL Server 2016 (13.x), será necessário limpar os dados executando ALTER 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 o Repositório de Consultas está no modo somente leitura.

1 - o banco de dados está em modo somente leitura
2 - banco de dados está em modo de usuário único
4 - banco de dados está em modo de emergência
8 - o banco de dados é uma réplica secundária (aplica-se a grupos de disponibilidade e à replicação geográfica do Banco de Dados SQL do Azure). Esse valor pode ser efetivamente observado apenas em readable réplicas secundárias
65536 - a Loja de Consultas atingiu o limite de tamanho definido pela max_storage_size_mb opção. Para mais informações sobre esta opção, consulte ALTER DATABASE SET opções.
131072 - O número de instruções diferentes no Query Store atingiu o limite de memória interna. Considere remover consultas de que não precisa ou atualizar para uma camada de serviço superior para permitir a transferência do Repositório de Consultas para o modo de leitura-gravação.
262144 - O tamanho dos itens na memória esperando para serem persistidos no disco atingiu o limite de memória interna. O Repositório de Consultas está no modo somente leitura temporariamente até que os itens na memória sejam mantidos no disco.
524288 - O banco de dados atingiu o limite de tamanho do disco. O 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 o Repositório de Consultas não poderá mais crescer.

Para alternar o modo de operações do Repositório de Consultas de volta para leitura-gravação, consulte Verificar se o Repositório de Consultas coleta dados de consulta continuamente.
current_storage_size_mb bigint Tamanho do Repositório de Consultas no disco em megabytes.
flush_interval_seconds bigint O período para liberação regular de dados do Repositório de Consultas em disco em segundos. O valor padrão é 900 (15 min).

Altere usando a ALTER DATABASE <database> SET QUERY_STORE (DATA_FLUSH_INTERVAL_SECONDS = <interval>) instrução.
interval_length_minutes bigint O intervalo de agregação estatística em minutos. Valores arbitrários não são permitidos. Use um dos seguintes valores: 1, 5, , 10, 1530, 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é o SQL Server 2017 (14.x) e 1 GB no SQL Server 2019 (15.x) e versões posteriores.

Para a edição Premium do Banco de dados SQL, o padrão é 1 GB e, para a edição Basic do Banco de dados SQL, o padrão é 10 MB.

Altere usando a ALTER DATABASE <database> SET QUERY_STORE (MAX_STORAGE_SIZE_MB = <size>) instrução.
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 predefinido é 30. Defina como 0 para desativar a política de retenção.
Para a edição Basic do Banco de dados SQL, o padrão é 7 dias.

Altere usando a ALTER DATABASE <database> SET QUERY_STORE (CLEANUP_POLICY = (STALE_QUERY_THRESHOLD_DAYS = <value>)) instrução.
max_plans_per_query bigint Limita o número máximo de planos armazenados. O valor predefinido é 200. Se o valor máximo for atingido, o Repositório de Consultas interromperá a captura de novos planos para essa consulta. Configuração para 0 remover a limitação do número de planos capturados.

Altere usando a ALTER DATABASE<database> SET QUERY_STORE (MAX_PLANS_PER_QUERY = <n>) instrução.
query_capture_mode smallint O modo de captura de consulta atualmente ativo:

1 = ALL - Todas as consultas são capturadas. Este é o valor de configuração padrão para o SQL Server 2016 (13.x) e versões posteriores.

2 = AUTO - capturar consultas relevantes com base na contagem de execução e no consumo de recursos. Este é o valor de configuração padrão para o Banco de dados SQL.

3 = NONE - Pare de capturar novas consultas. O Repositório de Consultas continua a coletar estatísticas de compilação e tempo de execução para consultas que já foram capturadas. Use essa configuração com cautela, pois você pode perder a captura de consultas importantes.

4 = CUSTOM - Permite mais controle sobre a política de captura de consultas usando as opções QUERY_CAPTURE_POLICY.

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores.
query_capture_mode_desc nvarchar(60) Descrição textual do modo de captura real do Repositório de Consultas:

ALL (padrão para SQL Server 2016 (13.x) e versões posteriores)

AUTO (padrão para o Banco de dados SQL)

NONE

CUSTOM
capture_policy_execution_count int Opção de política do modo CUSTOM de captura de consulta. Define o número de vezes que uma consulta é executada durante o período de avaliação. A predefinição é 30.

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores.
capture_policy_total_compile_cpu_time_ms bigint Opção de política do modo CUSTOM de captura de consulta. Define o tempo total de CPU de compilação decorrido usado por uma consulta durante o período de avaliação. A predefinição é 1000.

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores.
capture_policy_total_execution_cpu_time_ms bigint Opção de política do modo CUSTOM de captura de consulta. Define o tempo total de execução da CPU usado por uma consulta durante o período de avaliação. A predefinição é 100.

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores.
capture_policy_stale_threshold_hours int Opção de política do modo CUSTOM de captura de consulta. Define o período do 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 versões posteriores.
size_based_cleanup_mode smallint Controla se a limpeza é ativada automaticamente quando a quantidade total de dados se aproxima do tamanho máximo:

0 = OFF - A limpeza baseada no tamanho não é ativada automaticamente.
1 = AUTO - A limpeza baseada no tamanho é ativada automaticamente quando o tamanho no disco atinge 90% do max_storage_size_mb. Este é o valor de configuração padrão.

A limpeza baseada em tamanho remove primeiro as consultas mais antigas e mais baratas. Ele para quando aproximadamente 80 por cento é max_storage_size_mb atingido.
size_based_cleanup_mode_desc nvarchar(60) Descrição textual do modo de limpeza baseado no tamanho real do Repositório de Consultas:

OFF
AUTO (padrão)
wait_stats_capture_mode smallint Controla se o 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 versões posteriores.
wait_stats_capture_mode_desc nvarchar(60) Descrição textual do modo de captura de estatísticas de espera real:

OFF
ON (padrão)

Aplica-se a: SQL Server 2017 (14.x) e versões posteriores.
actual_state_additional_info nvarchar(4000) Atualmente não utilizado.

Permissions

Requer a VIEW DATABASE PERFORMANCE STATE permissão, ou uma permissão superior como VIEW DATABASE STATE.

No SQL Server 2016 (13.x) até SQL Server 2019 (15.x), é necessária a VIEW DATABASE STATE permissão. No SQL Server 2022 (16.x) e versões posteriores, requer a VIEW DATABASE PERFORMANCE STATE permissão sobre a base de dados, ou uma permissão superior como VIEW DATABASE STATE.

Remarks

Um actual_state_desc valor de é o estado esperado quando o Repositório de Consultas para réplicas secundárias está habilitado READ_CAPTURE_SECONDARY . Para obter mais informações, consulte Query Store para réplicas secundárias.

Conteúdo relacionado

  • Last updated on