ALTERAR CONFIGURAÇÃO DO ESCOPO DO BANCO DE DADOS (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Banco de Dados SQL do AzureInstância Gerenciada SQL do AzureBanco de Dados SQL do Azure Synapse Analyticsno Microsoft Fabric

Este comando permite várias definições de configuração de banco de dados no nível de de banco de dados individual .

As seguintes configurações são suportadas no Banco de Dados SQL do Azure, no Banco de Dados SQL no Microsoft Fabric, na Instância Gerenciada SQL do Azure e no SQL Server, conforme indicado pela linha Aplica-se a para cada configuração na seção Argumentos:

• Limpe o cache de procedimentos.
• Defina o parâmetro MAXDOP como um valor recomendado (1,2, ...) para o banco de dados primário com base no que funciona melhor para essa carga de trabalho específica e defina um valor diferente para bancos de dados de réplica secundária usados por consultas de relatório. Para obter orientação sobre como escolher um MAXDOP, revise Configurar o grau máximo de paralelismo Opção de configuração do servidor.
• Defina o modelo de estimativa de cardinalidade do otimizador de consulta independente do banco de dados para o nível de compatibilidade.
• Habilite ou desabilite a deteção de parâmetros no nível do banco de dados.
• Habilite ou desabilite hotfixes de otimização de consulta no nível do banco de dados.
• Habilite ou desabilite o cache de identidade no nível do banco de dados.
• Habilite ou desabilite um stub de plano compilado para ser armazenado em cache quando um lote for compilado pela primeira vez.
• Habilite ou desabilite a coleta de estatísticas de execução para módulos Transact-SQL compilados nativamente.
• Habilite ou desabilite opções online por padrão para instruções DDL que suportam a sintaxe ONLINE =.
• Habilite ou desabilite opções retomáveis por padrão para instruções DDL que suportam a sintaxe RESUMABLE =.
• Habilite ou desabilite recursos de de processamento inteligente de consultas.
• Habilite ou desabilite a força acelerada do plano.
• Habilite ou desative a funcionalidade de queda automática de tabelas temporárias globais.
• Habilite ou desabilite a infraestrutura de criação de perfil de consulta leve .
• Habilite ou desabilite a nova mensagem de erro String or binary data would be truncated.
• Habilite ou desabilite a coleta do último plano de execução real no sys.dm_exec_query_plan_stats.
• Especifique o número de minutos em que uma operação de índice retomável pausada é pausada antes de ser automaticamente anulada pelo Mecanismo de Banco de Dados.
• Habilite ou desabilite a espera por bloqueios com baixa prioridade para atualização assíncrona de estatísticas.
• Habilite ou desabilite o carregamento de resumos do razão para o Armazenamento de Blobs do Azure.

Essa configuração só está disponível no Azure Synapse Analytics.

• Definir o nível de compatibilidade de um banco de dados de usuários

Transact-SQL convenções de sintaxe

Sintaxe

-- Syntax for SQL Server, Azure SQL Database and Azure SQL Managed Instance

ALTER DATABASE SCOPED CONFIGURATION
{
    { [ FOR SECONDARY] SET <set_options>}
}
| CLEAR PROCEDURE_CACHE [plan_handle]
| SET < set_options >
[;]

< set_options > ::=
{
    MAXDOP = { <value> | PRIMARY}
    | LEGACY_CARDINALITY_ESTIMATION = { ON | OFF | PRIMARY}
    | PARAMETER_SNIFFING = { ON | OFF | PRIMARY}
    | QUERY_OPTIMIZER_HOTFIXES = { ON | OFF | PRIMARY}
    | IDENTITY_CACHE = { ON | OFF }
    | INTERLEAVED_EXECUTION_TVF = { ON | OFF }
    | BATCH_MODE_MEMORY_GRANT_FEEDBACK = { ON | OFF }
    | BATCH_MODE_ADAPTIVE_JOINS = { ON | OFF }
    | TSQL_SCALAR_UDF_INLINING = { ON | OFF }
    | ELEVATE_ONLINE = { OFF | WHEN_SUPPORTED | FAIL_UNSUPPORTED }
    | ELEVATE_RESUMABLE = { OFF | WHEN_SUPPORTED | FAIL_UNSUPPORTED }
    | OPTIMIZE_FOR_AD_HOC_WORKLOADS = { ON | OFF }
    | XTP_PROCEDURE_EXECUTION_STATISTICS = { ON | OFF }
    | XTP_QUERY_EXECUTION_STATISTICS = { ON | OFF }
    | ROW_MODE_MEMORY_GRANT_FEEDBACK = { ON | OFF }
    | MEMORY_GRANT_FEEDBACK_PERCENTILE_GRANT = { ON | OFF }
    | MEMORY_GRANT_FEEDBACK_PERSISTENCE = { ON | OFF }
    | BATCH_MODE_ON_ROWSTORE = { ON | OFF }
    | DEFERRED_COMPILATION_TV = { ON | OFF }
    | ACCELERATED_PLAN_FORCING = { ON | OFF }
    | GLOBAL_TEMPORARY_TABLE_AUTO_DROP = { ON | OFF }
    | LIGHTWEIGHT_QUERY_PROFILING = { ON | OFF }
    | VERBOSE_TRUNCATION_WARNINGS = { ON | OFF }
    | LAST_QUERY_PLAN_STATS = { ON | OFF }
    | PAUSED_RESUMABLE_INDEX_ABORT_DURATION_MINUTES = <time>
    | ISOLATE_SECURITY_POLICY_CARDINALITY  = { ON | OFF }
    | EXEC_QUERY_STATS_FOR_SCALAR_FUNCTIONS = { ON | OFF }
    | ASYNC_STATS_UPDATE_WAIT_AT_LOW_PRIORITY = { ON | OFF }
    | OPTIMIZED_PLAN_FORCING = { ON | OFF }
    | DOP_FEEDBACK = { ON | OFF }
    | CE_FEEDBACK = { ON | OFF }
    | PARAMETER_SENSITIVE_PLAN_OPTIMIZATION = { ON | OFF }
    | LEDGER_DIGEST_STORAGE_ENDPOINT = { <endpoint URL string> | OFF }
    | OPTIMIZED_SP_EXECUTESQL = { ON | OFF }
}

-- Syntax for Azure Synapse Analytics

ALTER DATABASE SCOPED CONFIGURATION
{
    SET <set_options>
}
[;]

< set_options > ::=
{
    DW_COMPATIBILITY_LEVEL = { AUTO | 10 | 20 | 30 | 40 | 50 | 9000 }
}

Argumentos

PARA SECUNDÁRIO

Especifica as configurações para bancos de dados secundários (todos os bancos de dados secundários devem ter os mesmos valores).

LIMPAR PROCEDURE_CACHE [plan_handle]

Limpa o cache de procedimento (plano) para o banco de dados e pode ser executado tanto no primário quanto no secundário.

Especifique um identificador de plano de consulta para limpar um único plano de consulta do cache de plano.

Aplica-se a: A especificação de um identificador de plano de consulta está disponível a partir do SQL Server 2019 (15.x), no Banco de Dados SQL do Azure e na Instância Gerenciada SQL do Azure.

MAXDOP = {<valor> | PRIMÁRIO }

<valor>

Especifica a configuração padrão grau máximo de paralelismo (MAXDOP) que deve ser usada para instruções. 0 é o valor padrão e indica que a configuração do servidor será usada. O MAXDOP no escopo do banco de dados substitui (a menos que esteja definido como 0) o grau máximo de paralelismo definido no nível do servidor por sp_configure. As dicas de consulta ainda podem substituir o MAXDOP com escopo do banco de dados para ajustar consultas específicas que precisam de configurações diferentes. Todas essas configurações são limitadas pelo conjunto MAXDOP para o Grupo de Carga de Trabalho .

Você pode usar a opção MAXDOP para limitar o número de processadores a serem usados na execução do plano paralelo. O SQL Server considera planos de execução paralela para consultas, operações DDL (linguagem de definição de dados de índice), inserção paralela, coluna de alteração online, coleta de estatísticas paralelas e população de cursor estática e orientada por conjunto de chaves.

Para definir essa opção no nível da instância, consulte Configurar o grau máximo de paralelismo Opção de configuração do servidor.

PRIMÁRIO

Só pode ser definido para os secundários, enquanto o banco de dados no primário, e indica que a configuração será a definida para o primário. Se a configuração para o primário mudar, o valor nos secundários será alterado de acordo sem a necessidade de definir o valor secundário explicitamente. PRIMARY é a configuração padrão para os secundários.

LEGACY_CARDINALITY_ESTIMATION = { EM | DESLIGADO | PRIMÁRIO }

Permite definir o modelo de estimativa de cardinalidade do otimizador de consulta para o SQL Server 2012 e versão anterior, independentemente do nível de compatibilidade do banco de dados. O padrão é OFF, que define o modelo de estimativa de cardinalidade do otimizador de consulta com base no nível de compatibilidade do banco de dados. Definir LEGACY_CARDINALITY_ESTIMATION como ON é equivalente a habilitar Trace Flag 9481.

PRIMÁRIO

Esse valor só é válido em secundários enquanto o banco de dados está no primário e especifica que a configuração do modelo de estimativa de cardinalidade do otimizador de consulta em todos os secundários será o valor definido para o primário. Se a configuração no primário para o modelo de estimativa de cardinalidade do otimizador de consulta for alterada, o valor nos secundários será alterado de acordo. PRIMARY é a configuração padrão para os secundários.

PARAMETER_SNIFFING = { EM | DESLIGADO | PRIMÁRIO }

Habilita ou desabilita deteção de parâmetros. O padrão é ON. Definir PARAMETER_SNIFFING como OFF é equivalente a ativar Trace Flag 4136.

PRIMÁRIO

Esse valor só é válido em secundários enquanto o banco de dados está no primário e especifica que o valor para essa configuração em todos os secundários será o valor definido para o primário. Se a configuração no primário para usar parâmetro sniffing mudar, o valor nos secundários será alterado de acordo sem a necessidade de definir o valor secundário explicitamente. PRIMARY é a configuração padrão para os secundários.

QUERY_OPTIMIZER_HOTFIXES = { EM | DESLIGADO | PRIMÁRIO }

Habilita ou desabilita hotfixes de otimização de consulta, independentemente do nível de compatibilidade do banco de dados. O padrão é OFF, que desabilita hotfixes de otimização de consulta que foram lançados depois que o nível de compatibilidade mais alto disponível foi introduzido para uma versão específica (pós-RTM). Definir isso como ON é equivalente a habilitar Trace Flag 4199.

Aplica-se a: SQL Server (a partir do SQL Server 2016 (13.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

PRIMÁRIO

Esse valor só é válido em secundários enquanto o banco de dados está no primário e especifica que o valor para essa configuração em todos os secundários é o valor definido para o primário. Se a configuração para o primário mudar, o valor nos secundários muda de acordo sem a necessidade de definir o valor secundário explicitamente. PRIMARY é a configuração padrão para os secundários.

IDENTITY_CACHE = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2017 (14.x)), Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Habilita ou desabilita o cache de identidade no nível do banco de dados. O padrão é ON. O cache de identidade é usado para melhorar o desempenho INSERT em tabelas com colunas de identidade. Para evitar lacunas nos valores de uma coluna de identidade nos casos em que o servidor é reiniciado inesperadamente ou faz failover para um servidor secundário, desative a opção IDENTITY_CACHE. Essa opção é semelhante aoexistente do Trace Flag 272, exceto que ela pode ser definida no nível do banco de dados e não apenas no nível do servidor.

INTERLEAVED_EXECUTION_TVF = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar a execução Interleaved para funções com valor de tabela de várias instruções no escopo do banco de dados ou da instrução, mantendo o nível de compatibilidade do banco de dados 140 e superior. O padrão é ON. A execução intercalada é um recurso que faz parte do processamento de consulta adaptável no Banco de Dados SQL do Azure. Para obter mais informações, consulte Processamento inteligente de consultas.

BATCH_MODE_MEMORY_GRANT_FEEDBACK = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar a memória em modo batch, conceder feedback no escopo do banco de dados e, ao mesmo tempo, manter o nível de compatibilidade do banco de dados 140 e superior. O padrão é ON. O feedback de concessão de memória em modo de lote, introduzido no SQL Server 2017 (14.x), faz parte do conjunto inteligente de recursos de processamento de consultas. Para obter mais informações, consulte Comentários de concessão de memória.

BATCH_MODE_ADAPTIVE_JOINS = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar junções adaptáveis em modo de lote no escopo do banco de dados enquanto ainda mantém o nível de compatibilidade do banco de dados 140 e superior. O padrão é ON. As junções adaptáveis do modo de lote são um recurso que faz parte de de processamento inteligente de consultas introduzido no SQL Server 2017 (14.x).

TSQL_SCALAR_UDF_INLINING = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)) e Banco de Dados SQL do Azure (o recurso está em visualização)

Permite habilitar ou desabilitar a inserção do T-SQL Scalar UDF no escopo do banco de dados, mantendo o nível de compatibilidade do banco de dados 150 e superior. O padrão é ON. T-SQL Scalar UDF inlining faz parte da família de recursos processamento inteligente de consultas .

ELEVATE_ONLINE = { DESLIGADO | WHEN_SUPPORTED | FAIL_UNSUPPORTED }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite selecionar opções para fazer com que o mecanismo eleve automaticamente as operações suportadas para online. O padrão é OFF, o que significa que as operações não serão elevadas para online, a menos que especificado na instrução. sys.database_scoped_configurations reflete o valor atual do ELEVATE_ONLINE. Estas opções só se aplicarão a operações suportadas online.

FAIL_UNSUPPORTED

Este valor eleva todas as operações DDL suportadas para ONLINE. As operações que não suportam a execução online falham e geram um erro.

WHEN_SUPPORTED

Este valor eleva as operações que suportam ONLINE. As operações que não suportam online serão executadas offline.

ELEVATE_RESUMABLE= { DESLIGADO | WHEN_SUPPORTED | FAIL_UNSUPPORTED }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite selecionar opções para fazer com que o mecanismo eleve automaticamente as operações suportadas para retomáveis. O padrão é OFF, o que significa que as operações não são elevadas a retomáveis, a menos que especificado na instrução. sys.database_scoped_configurations reflete o valor atual do ELEVATE_RESUMABLE. Essas opções só se aplicam a operações que são suportadas para retomable.

FAIL_UNSUPPORTED

Esse valor eleva todas as operações DDL suportadas para RESUMABLE. As operações que não suportam a execução retomável falham e geram um erro.

WHEN_SUPPORTED

Esse valor eleva as operações que suportam RESUMABLE. As operações que não oferecem suporte a retomada são executadas de forma não retomável.

OTIMIZE_FOR_AD_HOC_WORKLOADS = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Habilita ou desabilita um stub de plano compilado para ser armazenado em cache quando um lote é compilado pela primeira vez. O padrão é OFF. Quando o OTIMIZE_FOR_AD_HOC_WORKLOADS de configuração do escopo do banco de dados estiver habilitado para um banco de dados, um stub de plano compilado será armazenado em cache quando um lote for compilado pela primeira vez. Os stubs de plano têm um espaço de memória menor em comparação com o tamanho do plano compilado completo. Se um lote for compilado ou executado novamente, o stub de plano compilado será removido e substituído por um plano compilado completo.

XTP_PROCEDURE_EXECUTION_STATISTICS = { EM | DESLIGADO }

Aplica-se a: Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Habilita ou desabilita a coleta de estatísticas de execução no nível do módulo para módulos T-SQL compilados nativamente no banco de dados atual. O padrão é OFF. As estatísticas de execução refletem-se em sys.dm_exec_procedure_stats.

As estatísticas de execução no nível do módulo para módulos T-SQL compilados nativamente são coletadas se essa opção estiver ATIVADA ou se a coleta de estatísticas estiver habilitada por meio sp_xtp_control_proc_exec_stats.

XTP_QUERY_EXECUTION_STATISTICS = { EM | DESLIGADO }

Aplica-se a: Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Habilita ou desabilita a coleta de estatísticas de execução no nível da instrução para módulos T-SQL compilados nativamente no banco de dados atual. O padrão é OFF. As estatísticas de execução são refletidas no sys.dm_exec_query_stats e no Query Store.

As estatísticas de execução em nível de instrução para módulos T-SQL compilados nativamente são coletadas se essa opção estiver ATIVADA ou se a coleta de estatísticas estiver habilitada por meio sp_xtp_control_query_exec_stats.

Para obter mais informações sobre o monitoramento de desempenho de módulos Transact-SQL compilados nativamente, consulte Monitoring Performance of Natively Compiled Stored Procedures.

ROW_MODE_MEMORY_GRANT_FEEDBACK = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar a memória do modo de linha conceder feedback no escopo do banco de dados enquanto ainda mantém o nível de compatibilidade do banco de dados 150 e superior. O padrão é ON. A memória do modo de linha concede feedback, um recurso que faz parte do de processamento inteligente de consultas introduzido no SQL Server 2017 (14.x). O modo de linha tem suporte no SQL Server 2019 (15.x) e no Banco de Dados SQL do Azure. Para obter mais informações sobre comentários de concessão de memória, consulte Comentários de concessão de memória.

MEMORY_GRANT_FEEDBACK_PERCENTILE_GRANT = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure

Permite desabilitar o percentil de feedback de concessão de memória para todas as execuções de consulta originadas do banco de dados. O padrão é ON. Para obter informações completas, consulte Percentil e modo de persistência memória conceder feedback.

MEMORY_GRANT_FEEDBACK_PERSISTENCE = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Permite desabilitar a persistência de feedback de concessão de memória para todas as execuções de consulta originadas do banco de dados. O padrão é ON. Para obter informações completas, consulte Percentil e modo de persistência memória conceder feedback.

BATCH_MODE_ON_ROWSTORE = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar o modo em lote no armazenamento de linhas no escopo do banco de dados, mantendo o nível de compatibilidade do banco de dados 150 e superior. O padrão é ON. O modo de lote no armazenamento de linhas é um recurso que faz parte de família de recursos processamento inteligente de consultas.

DEFERRED_COMPILATION_TV = { ATIVADO | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar a compilação adiada de variáveis de tabela no escopo do banco de dados, mantendo o nível de compatibilidade do banco de dados 150 e superior. O padrão é ON. A compilação adiada da variável de tabela é um recurso que faz parte de família de recursos processamento inteligente de consultas.

ACCELERATED_PLAN_FORCING = { LIGADO | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Permite um mecanismo otimizado para a imposição de planos de consulta, aplicável a todas as formas de imposição de planos, como Query Store Force Plan, Automatic Tuningou a dica de consulta USE PLAN. O padrão é ON.

GLOBAL_TEMPORARY_TABLE_AUTO_DROP = { EM | DESLIGADO }

Aplica-se a: Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Permite definir a funcionalidade de queda automática para tabelas temporárias globais. O padrão é ON, o que significa que as tabelas temporárias globais são automaticamente descartadas quando não estão em uso por nenhuma sessão. Quando definidas como OFF, as tabelas temporárias globais precisam ser explicitamente descartadas usando uma instrução DROP TABLE ou serão automaticamente descartadas na reinicialização do servidor.

• Com bancos de dados únicos e pools elásticos do Banco de Dados SQL do Azure, essa opção pode ser definida nos bancos de dados de usuários individuais do servidor do Banco de Dados SQL.
• No SQL Server e na Instância Gerenciada SQL do Azure, essa opção é definida em tempdb e a configuração dos bancos de dados de usuários individuais não tem efeito.

LIGHTWEIGHT_QUERY_PROFILING = { LIGADO | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar a infraestrutura de criação de perfil de consulta leve . A infraestrutura leve de criação de perfil de consulta (LWP) fornece dados de desempenho de consulta de forma mais eficiente do que os mecanismos de criação de perfil padrão e é habilitada por padrão. O padrão é ON.

VERBOSE_TRUNCATION_WARNINGS = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite ativar ou desativar a nova mensagem de erro String or binary data would be truncated. O padrão é ON. O SQL Server 2019 (15.x) apresenta uma nova mensagem de erro mais específica (2628) para este cenário:

String or binary data would be truncated in table '%.*ls', column '%.*ls'. Truncated value: '%.*ls'.

Quando definido como ON no nível de compatibilidade do banco de dados 150, os erros de truncamento geram a nova mensagem de erro 2628 para fornecer mais contexto e simplificar o processo de solução de problemas.

Quando definido como OFF no nível de compatibilidade de banco de dados 150, erros de truncamento geram a mensagem de erro anterior 8152.

Para o nível de compatibilidade de banco de dados 140 ou inferior, a mensagem de erro 2628 permanece uma mensagem de erro de aceitação que requer sinalizador de rastreamento 460 para ser habilitado, e essa configuração de escopo de banco de dados não tem efeito.

LAST_QUERY_PLAN_STATS = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite habilitar ou desabilitar a coleta das estatísticas do último plano de consulta (equivalente a um plano de execução real) no sys.dm_exec_query_plan_stats. O padrão é OFF.

PAUSED_RESUMABLE_INDEX_ABORT_DURATION_MINUTES

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

A opção PAUSED_RESUMABLE_INDEX_ABORT_DURATION_MINUTES determina por quanto tempo (em minutos) o índice retomável está sendo pausado antes de ser automaticamente abortado pelo mecanismo.

• O valor padrão é definido como um dia (1440 minutos)
• A duração mínima é definida como 1 minuto
• A duração máxima é de 71.582 minutos
• Quando definido como 0, uma operação pausada nunca será automaticamente anulada

O valor atual dessa opção é exibido em sys.database_scoped_configurations.

ISOLATE_SECURITY_POLICY_CARDINALITY = { EM | DESLIGADO}

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Permite controlar se um predicado do Row-Level Security (RLS) afeta a cardinalidade do plano de execução da consulta geral do usuário. O padrão é OFF. Quando ISOLATE_SECURITY_POLICY_CARDINALITY está ON, um predicado RLS não afeta a cardinalidade de um plano de execução. Por exemplo, considere uma tabela contendo 1 milhão de linhas e um predicado RLS que restringe o resultado a 10 linhas para um usuário específico que emite a consulta. Com essa configuração de escopo de banco de dados definida como OFF, a estimativa de cardinalidade desse predicado será 10. Quando essa configuração de escopo do banco de dados está ATIVADA, a otimização de consulta estima 1 milhão de linhas. Recomenda-se usar o valor padrão para a maioria das cargas de trabalho.

DW_COMPATIBILITY_LEVEL = { AUTO | 10 | 20 | 30 | 40 | 50 | 9000 }

Aplica-se a: apenas o Azure Synapse Analytics

Define Transact-SQL e comportamentos de processamento de consulta para serem compatíveis com a versão especificada do mecanismo de banco de dados. Uma vez definido, quando uma consulta é executada nesse banco de dados, apenas os recursos compatíveis são exercidos. Em cada nível de compatibilidade, vários aprimoramentos de processamento de consulta são suportados. Cada nível absorve a funcionalidade do nível anterior. O nível de compatibilidade de um banco de dados é definido como AUTO por padrão quando ele é criado pela primeira vez e essa é a configuração recomendada. O nível de compatibilidade é preservado mesmo após as operações de pausa/retomada do banco de dados, backup/restauração. O padrão é AUTO.

Nível de compatibilidade	Observações
AUTO	Inadimplência. Seu valor é atualizado automaticamente pelo mecanismo Synapse Analytics e é representado por 0 em sys.database_scoped_configurations. AUTO atualmente mapeia para o nível de compatibilidade 30 funcionalidade.
10	Exercita os comportamentos de Transact-SQL e mecanismo de consulta antes da introdução do suporte de nível de compatibilidade.
20	Primeiro nível de compatibilidade que inclui Transact-SQL fechado e comportamentos do mecanismo de consulta. O sp_describe_undeclared_parameters de procedimento armazenado do sistema é suportado neste nível.
30	Inclui novos comportamentos do mecanismo de consulta.
40	Inclui novos comportamentos do mecanismo de consulta.
50	A distribuição de várias colunas é suportada neste nível. Para saber mais, consulte CREATE TABLECREATE TABLE AS SELECT e CREATE MATERIALIZED VIEW.
9000	Nível de compatibilidade de visualização. Os recursos de visualização fechados abaixo desse nível são destacados na documentação específica do recurso. Este nível também inclui habilidades do mais alto nível não-9000.

EXEC_QUERY_STATS_FOR_SCALAR_FUNCTIONS = { LIGADO | DESLIGADO }

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores, Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Permite controlar se as estatísticas de execução para funções escalares definidas pelo usuário (UDF) aparecem na visualização do sistema sys.dm_exec_function_stats. Para algumas cargas de trabalho intensivas que são escalares pesadas em UDF, a coleta de estatísticas de execução de função pode causar uma sobrecarga de desempenho percetível. Isso pode ser evitado definindo a configuração de escopo de banco de dados EXEC_QUERY_STATS_FOR_SCALAR_FUNCTIONS como OFF. O padrão é ON.

ASYNC_STATS_UPDATE_WAIT_AT_LOW_PRIORITY = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Se a atualização assíncrona de estatísticas estiver habilitada, habilitar essa configuração fará com que as estatísticas de atualização de solicitação em segundo plano aguarde um bloqueio de Sch-M em uma fila de baixa prioridade, para evitar o bloqueio de outras sessões em cenários de alta simultaneidade. Para obter mais informações, consulte AUTO_UPDATE_STATISTICS_ASYNC. O padrão é OFF.

OPTIMIZED_PLAN_FORCING = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure

O esforço de plano otimizado reduz a sobrecarga de compilação para a repetição de consultas forçadas. O padrão é ON. Depois que o plano de execução da consulta é gerado, etapas específicas de compilação são armazenadas para reutilização como um script de repetição de otimização. Um script de repetição de otimização é armazenado como parte do XML de plano de execução compactado em Query Store, em um atributo OptimizationReplay oculto. Saiba mais em Imposição de plano otimizado com o Repositório de Consultas.

DOP_FEEDBACK = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure

Identifica ineficiências de paralelismo para consultas repetidas, com base no tempo decorrido e nas esperas. Se o uso de paralelismo for considerado ineficiente, o feedback do DOP reduzirá o DOP para a próxima execução da consulta, seja qual for o DOP configurado, e verificará se isso ajuda. Requer o Repositório de Consultas habilitado e no modo READ_WRITE. Para obter mais informações, consulte Degrees of Parallelism (DOP) feedback. O padrão é OFF.

CE_FEEDBACK = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

O feedback do CE aborda problemas de regressão percebidos resultantes de pressupostos incorretos do modelo CE ao usar o CE padrão (CE120 ou superior) e pode usar seletivamente diferentes pressupostos do modelo. Requer o Repositório de Consultas habilitado e no modo READ_WRITE. Para obter mais informações, consulte Feedback da estimativa de cardinalidade (CE). O padrão é ON no nível de compatibilidade de banco de dados 160 e superior.

PARAMETER_SENSITIVE_PLAN_OPTIMIZATION = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

A otimização do plano de sensibilidade a parâmetros (PSP) aborda o cenário em que um único plano armazenado em cache para uma consulta parametrizada não é ideal para todos os possíveis valores de parâmetros de entrada. É o caso das distribuições de dados não uniformes. O padrão é ON a partir do nível de compatibilidade de banco de dados 160. Para obter mais informações, consulte otimização do plano sensível a parâmetros.

LEDGER_DIGEST_STORAGE_ENDPOINT = { <cadeia de caracteres de URL do ponto de extremidade> | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x))

Habilita ou desabilita o carregamento de resumos contábeis no Armazenamento de Blobs do Azure. Para habilitar o carregamento de resumos do livro-razão, especifique o ponto de extremidade de uma conta de armazenamento de Blob do Azure. Para desativar o carregamento de resumos do livro-razão, defina o valor da opção como OFF. O padrão é OFF.

FORCE_SHOWPLAN_RUNTIME_PARAMETER_COLLECTION = { EM | DESLIGADO }

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Faz com que o SQL Server gere um fragmento XML Showplan com o ParameterRuntimeValue ao usar a infraestrutura de criação de perfil de estatísticas de execução de consulta leve ou ao executar o sys.dm_exec_query_statistics_xml DMV ao solucionar problemas de consultas de longa execução.

OPTIMIZED_SP_EXECUTESQL = { EM | DESLIGADO }

Aplica-se a: Banco de Dados SQL do Azure

Habilita ou desabilita o comportamento de serialização de compilação de sp_executesql quando um lote é compilado. O padrão é OFF. Permitir lotes que usam sp_executesql serializar o processo de compilação reduz o impacto de tempestades de compilação. Uma tempestade de compilação refere-se a uma situação em que um grande número de consultas está sendo compilado simultaneamente, levando a problemas de desempenho e contenção de recursos.

Quando OPTIMIZED_SP_EXECUTESQL estiver ON, a primeira execução do sp_executesql compilará e inserirá seu plano compilado no cache do plano. Outras sessões abortam a espera no bloqueio de compilação e reutilizam o plano assim que ele estiver disponível. Isso permite que sp_executesql se comportem como objetos, como procedimentos armazenados e gatilhos, de uma perspetiva de compilação.

Permissões

Requer ALTER ANY DATABASE SCOPED CONFIGURATION no banco de dados. Essa permissão pode ser concedida por um usuário com permissão CONTROL em um banco de dados.

Comentários

Embora você possa configurar bancos de dados secundários para ter definições de configuração de escopo diferentes de seus primários, todos os bancos de dados secundários usam a mesma configuração. Não é possível definir configurações diferentes para secundários individuais.

A execução dessa instrução limpa o cache de procedimento no banco de dados atual, o que significa que todas as consultas precisam ser recompiladas.

Para consultas de nome de três partes, as configurações da conexão de banco de dados atual para a consulta são respeitadas, exceto para módulos SQL (como procedimentos, funções e gatilhos) que são compilados em outro contexto de banco de dados e, portanto, usam as opções do banco de dados no qual residem. Da mesma forma, ao atualizar estatísticas de forma assíncrona, a configuração de ASYNC_STATS_UPDATE_WAIT_AT_LOW_PRIORITY para o banco de dados onde as estatísticas residem é honrada.

O evento ALTER_DATABASE_SCOPED_CONFIGURATION é adicionado como um evento DDL que pode ser usado para disparar um gatilho DDL e é filho do grupo de gatilho ALTER_DATABASE_EVENTS.

Quando um determinado banco de dados é restaurado ou anexado, as definições de configuração do escopo do banco de dados são transferidas e permanecem com o banco de dados.

A partir do SQL Server 2019 (15.x), no Banco de Dados SQL do Azure e na Instância Gerenciada SQL do Azure, alguns nomes de opção foram alterados:

• DISABLE_INTERLEAVED_EXECUTION_TVF alterado para INTERLEAVED_EXECUTION_TVF
• DISABLE_BATCH_MODE_MEMORY_GRANT_FEEDBACK alterado para BATCH_MODE_MEMORY_GRANT_FEEDBACK
• DISABLE_BATCH_MODE_ADAPTIVE_JOINS alterado para BATCH_MODE_ADAPTIVE_JOINS

No banco de dados SQL no Microsoft Fabric, a autenticação é feita por meio da passagem de ID do Microsoft Entra, usando 'IDENTIDADE DO USUÁRIO'.

Limitações

MAXDOP

As configurações granulares podem substituir as globais e esse administrador de recursos pode limitar todas as outras configurações MAXDOP. A lógica para a configuração MAXDOP é a seguinte:

• A dica de consulta substitui a configuração de escopo do sp_configure e do banco de dados. Se o grupo de recursos MAXDOP estiver definido para o grupo de carga de trabalho:

  • Se a dica de consulta estiver definida como zero (0), ela será substituída pela configuração do administrador de recursos.

  • Se a dica de consulta não for zero (0), ela será limitada pela configuração do administrador de recursos.

• A configuração com escopo do banco de dados (a menos que seja zero) substitui a configuração sp_configure, a menos que haja uma dica de consulta e seja limitada pela configuração do administrador de recursos.

• A configuração sp_configure é substituída pela configuração do administrador de recursos.

QUERY_OPTIMIZER_HOTFIXES

Quando QUERYTRACEON dica é usada para habilitar o Otimizador de Consulta padrão do SQL Server 7.0 por meio de versões do SQL Server 2012 (11.x) ou hotfixes do Otimizador de Consulta, seria uma condição OU entre a dica de consulta e a definição de configuração com escopo do banco de dados, ou seja, se qualquer uma delas estiver habilitada, as configurações com escopo do banco de dados serão aplicadas.

Geo DR

Os bancos de dados secundários legíveis (Grupos de Disponibilidade Always On, Banco de Dados SQL do Azure e bancos de dados replicados geograficamente da Instância Gerenciada SQL do Azure) usam o valor secundário verificando o estado do banco de dados. Embora a recompilação não ocorra no failover e, tecnicamente, o novo primário tenha consultas que estão usando as configurações secundárias, a ideia é que a configuração entre primário e secundário só varie quando a carga de trabalho é diferente e, portanto, as consultas em cache estão usando as configurações ideais, enquanto as novas consultas escolhem as novas configurações apropriadas para elas.

DacFx

Como ALTER DATABASE SCOPED CONFIGURATION é um novo recurso no Banco de Dados SQL do Azure, na Instância Gerenciada SQL do Azure e no SQL Server (começando com o SQL Server 2016 (13.x)) que afeta o esquema do banco de dados, as exportações do esquema (com ou sem dados) não podem ser importadas para uma versão mais antiga do SQL Server, como o SQL Server 2012 (11.x) ou o SQL Server 2014 (12.x). Por exemplo, uma exportação para um DACPAC ou um BACPAC de um banco de dados SQL ou banco de dados SQL Server 2016 (13.x) que usasse esse novo recurso não poderia ser importado para um servidor de nível inferior.

ELEVATE_ONLINE

Esta opção só se aplica a instruções DDL que suportam o WITH (ONLINE = <syntax>). Os índices XML não são afetados.

ELEVATE_RESUMABLE

Esta opção só se aplica a instruções DDL que suportam o WITH (RESUMABLE = <syntax>). Os índices XML não são afetados.

Metadados

A sys.database_scoped_configurations (Transact-SQL) visualização do sistema fornece informações sobre configurações de escopo em um banco de dados. As opções de configuração com escopo de banco de dados só aparecem em sys.database_scoped_configurations pois são substituídas por configurações padrão em todo o servidor. O sys.configurations (Transact-SQL) visualização do sistema mostra apenas as configurações de todo o servidor.

Exemplos

Estes exemplos demonstram o uso de ALTER DATABASE SCOPED CONFIGURATION

Um. Conceder permissão

Este exemplo concede a permissão necessária para executar ALTER DATABASE SCOPED CONFIGURATION ao usuário Joe.

GRANT ALTER ANY DATABASE SCOPED CONFIGURATION to [Joe] ;

B. Definir MAXDOP

Este exemplo define MAXDOP = 1 para um banco de dados primário e MAXDOP = 4 para um banco de dados secundário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION SET MAXDOP = 1 ;
ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET MAXDOP = 4 ;

Este exemplo define MAXDOP para um banco de dados secundário como o mesmo definido para seu banco de dados primário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET MAXDOP = PRIMARY ;

C. Definir LEGACY_CARDINALITY_ESTIMATION

Este exemplo define LEGACY_CARDINALITY_ESTIMATION como ON para um banco de dados secundário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET LEGACY_CARDINALITY_ESTIMATION = ON ;

Este exemplo define LEGACY_CARDINALITY_ESTIMATION para um banco de dados secundário como para seu banco de dados primário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET LEGACY_CARDINALITY_ESTIMATION = PRIMARY ;

D. Definir PARAMETER_SNIFFING

Este exemplo define PARAMETER_SNIFFING como OFF para um banco de dados primário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = OFF ;

Este exemplo define PARAMETER_SNIFFING como OFF para um banco de dados secundário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET PARAMETER_SNIFFING = OFF ;

Este exemplo define PARAMETER_SNIFFING para o banco de dados secundário como ele está no banco de dados primário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET PARAMETER_SNIFFING = PRIMARY ;

E. Definir QUERY_OPTIMIZER_HOTFIXES

Defina QUERY_OPTIMIZER_HOTFIXES como ON para um banco de dados primário em um cenário de replicação geográfica.

ALTER DATABASE SCOPED CONFIGURATION SET QUERY_OPTIMIZER_HOTFIXES = ON ;

F. Limpar cache de procedimento

Este exemplo limpa o cache de procedimento (possível apenas para um banco de dados primário).

ALTER DATABASE SCOPED CONFIGURATION CLEAR PROCEDURE_CACHE;

G. Definir IDENTITY_CACHE

Aplica-se a: SQL Server (a partir do SQL Server 2017 (14.x)), Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Este exemplo desabilita o cache de identidade.

ALTER DATABASE SCOPED CONFIGURATION SET IDENTITY_CACHE = OFF ;

H. Definir OTIMIZE_FOR_AD_HOC_WORKLOADS

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Este exemplo permite que um stub de plano compilado seja armazenado em cache quando um lote é compilado pela primeira vez.

ALTER DATABASE SCOPED CONFIGURATION SET OPTIMIZE_FOR_AD_HOC_WORKLOADS = ON;

Eu. Definir ELEVATE_ONLINE

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Este exemplo define ELEVATE_ONLINE como FAIL_UNSUPPORTED.

ALTER DATABASE SCOPED CONFIGURATION SET ELEVATE_ONLINE = FAIL_UNSUPPORTED ;

J. Definir ELEVATE_RESUMABLE

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Este exemplo define ELEVATE_RESUMABLE como WHEN_SUPPORTED.

ALTER DATABASE SCOPED CONFIGURATION SET ELEVATE_RESUMABLE = WHEN_SUPPORTED ;

K. Limpar um plano de consulta do cache de planos

Aplica-se a: SQL Server (a partir do SQL Server 2019 (15.x)), Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure

Este exemplo limpa um plano específico do cache de procedimento

ALTER DATABASE SCOPED CONFIGURATION CLEAR PROCEDURE_CACHE 0x06000500F443610F003B7CD12C02000001000000000000000000000000000000000000000000000000000000;

L. Definir duração pausada

Aplica-se a: Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure

Este exemplo define a duração pausada do índice retomável como 60 minutos.

ALTER DATABASE SCOPED CONFIGURATION
SET PAUSED_RESUMABLE_INDEX_ABORT_DURATION_MINUTES = 60

M. Ativar e desativar o carregamento de resumos contábeis

Aplica-se a: SQL Server (a partir do SQL Server 2022 (16.x))

Este exemplo permite carregar resumos do razão para uma conta de armazenamento do Azure.

ALTER DATABASE SCOPED CONFIGURATION
SET LEDGER_DIGEST_STORAGE_ENDPOINT = 'https://mystorage.blob.core.windows.net'

Este exemplo desativa o carregamento de resumos contábeis.

ALTER DATABASE SCOPED CONFIGURATION
SET LEDGER_DIGEST_STORAGE_ENDPOINT = OFF

Recursos adicionais

Recursos MAXDOP

• Grau de paralelismo
• Recomendações e diretrizes para a opção de configuração "grau máximo de paralelismo" no SQL Server

Recursos LEGACY_CARDINALITY_ESTIMATION

• Estimativa de cardinalidade (SQL Server)
• otimizando seus planos de consulta com o do SQL Server 2014 Cardinality Estimator

Recursos PARAMETER_SNIFFING

• Parameter Sniffing
• "Eu cheiro um parâmetro!"

Recursos QUERY_OPTIMIZER_HOTFIXES

• Rastreio de Sinalizadores
• sinalizador de rastreamento de hotfix do otimizador de consulta do SQL Server 4199 modelo de serviço

Recursos ELEVATE_ONLINE

Diretrizes para operações de índice on-line

Recursos ELEVATE_RESUMABLE

Diretrizes para operações de índice on-line

Conteúdo relacionado

• sys.database_scoped_configurations
• sys.configurations
• Bases de Dados e Vistas do Catálogo de Ficheiros (Transact-SQL)
• Opções de configuração do Server (SQL Server)
• ÍNDICE ALTER (Transact-SQL)
• CRIAR ÍNDICE (Transact-SQL)
• Recomendações e diretrizes para a opção de configuração "grau máximo de paralelismo" no SQL Server
• Como funcionam as operações de índice on-line
• Executar operações de índice on-line
• Processamento inteligente de consultas em bancos de dados SQL
• Feedback de concessão de memória
• Feedback da estimativa de cardinalidade (CE)
• Grau de paralelismo (DOP) feedback