sys.dm_os_cluster_properties (Transact-SQL)

Aplica-se:SQL Server

Retorna uma linha com as configurações atuais para as propriedades de recurso de cluster SQL Server identificadas neste artigo. Se você executar essa exibição em uma instância autônoma de SQL Server, ela não retornará dados.

Você pode usar essas propriedades para definir valores que afetam a detecção de falhas, o tempo de resposta de falha e o registro em log para monitorar o status de integridade da instância do cluster de failover SQL Server.

Nome da Coluna Tipo de dados Anulável Descrição
VerboseLogging bigint Yes O nível de log para o cluster de failover do SQL Server. Ative o log detalhado para fornecer detalhes extras nos logs de erros para solução de problemas. Um dos seguintes valores:

- 0: o registro em log está desativado (padrão)
- 1: somente erros
- 2: erros e avisos

Para obter mais informações, consulte ALTER SERVER CONFIGURATION.
SqlDumperDumpFlags bigint Yes Os sinalizadores de despejo do SQLDumper determinam o tipo de arquivos de despejo gerados pelo SQL Server. A configuração padrão é 0.
SqlDumperDumpPath nvarchar(260) Não O local onde o utilitário SQLDumper gera os arquivos de despejo.
SqlDumperDumpTimeOut bigint Yes O valor do tempo limite em milissegundos para o utilitário SQLDumper gerar um despejo se SQL Server falhar. O valor padrão é 0.
FailureConditionLevel bigint Yes Define as condições sob as quais o cluster de failover do SQL Server deve falhar ou reiniciar. O valor padrão é 3. Para obter uma explicação detalhada ou para alterar as configurações de propriedade, consulte Definir configurações de propriedade FailureConditionLevel.
HealthCheckTimeout bigint Yes O valor de tempo limite por quanto tempo a DLL do recurso de Mecanismo de Banco de Dados do SQL Server deve aguardar as informações de integridade do servidor antes de considerar a instância de SQL Server como sem resposta. O valor do tempo limite é expresso em milissegundos. O padrão é 60000 (60.000).

Para obter mais informações ou alterar essa configuração de propriedade, consulte Definir configurações de propriedade HealthCheckTimeout.
ClusterConnectionOptions nvarchar(4000) Yes Para obter mais informações sobre essas opções, consulte a seção Opções de conexão de cluster .

Opções de conexão de cluster

Key Valores com suporte Descrição
Encrypt Mandatory, , StrictOptional Especifica como a criptografia para o grupo de disponibilidade é imposta. Se o servidor não der suporte à criptografia, a conexão falhará. Se você definir a criptografia como Mandatory, deverá TrustServerCertificate ser definido como sim. Se você definir a criptografia como Strict, será TrustServerCertificate ignorada.

Observação: esse par de valores de chave é necessário.
HostNameInCertificate Nome da réplica ou nome do ouvinte do AG Especifica o nome da réplica ou o nome do ouvinte do grupo de disponibilidade no certificado usado para criptografia. Esse valor deve corresponder ao valor no Nome Alternativo da Entidade do certificado. Se o nome do servidor estiver listado no certificado, você poderá omitir o HostNameInCertificate par chave-valor. Se o nome do servidor não estiver listado no certificado, você deverá especificar o HostNameInCertificate par chave-valor com o nome do servidor.

Observação: esse par de valores de chave é opcional.
TrustServerCertificate Yes, No Defina para yes especificar que o driver não valida o certificado TLS/SSL do servidor. Se noo driver validar o certificado. Para obter mais informações, examine o TDS 8.0.

Observação: esse par de valores de chave é opcional.
ServerCertificate Caminho para seu certificado Se você não quiser usar HostNameInCertificate, poderá passar o caminho para o certificado. A conta de serviço do cluster deve ter permissão para ler o certificado do local determinado.

Observação: esse par de valores de chave é opcional.
CLUSTER_CONNECTION_OPTIONS Cadeia de caracteres vazia ('') Limpa a configuração existente e reverte para as configurações de criptografia padrão de Encrypt=Mandatory e TrustServerCertificate=Yes.

Para obter mais informações, consulte CREATE AVAILABILITY GROUP e ALTER AVAILABILITY GROUP.

Permissões

SQL Server 2019 (15.x) e versões anteriores exigem permissões VIEW SERVER STATE na instância do cluster de failover SQL Server.

O SQL Server 2022 (16.x) e versões posteriores exigem VIEW SERVER PERFORMANCE STATE permissão no servidor.

Exemplos

O exemplo a seguir usa sys.dm_os_cluster_properties para retornar as configurações de propriedade para o recurso de cluster de failover SQL Server.

SELECT VerboseLogging,
       SqlDumperDumpFlags,
       SqlDumperDumpPath,
       SqlDumperDumpTimeOut,
       FailureConditionLevel,
       HealthCheckTimeout
FROM sys.dm_os_cluster_properties;

Veja aqui o conjunto de resultados.

VerboseLogging SqlDumperDumpFlags SqlDumperDumpPath SqlDumperDumpTimeOut FailureConditionLevel HealthCheckTimeout
0 0 NULO 0 3 60000