sys.dm_os_cluster_properties (Transact-SQL)

S'applique à :SQL Server

Retourne une ligne avec les paramètres actuels des propriétés de ressource de cluster SQL Server identifiées dans cet article. Si vous exécutez cette vue sur une instance autonome de SQL Server, elle ne retourne aucune donnée.

Vous pouvez utiliser ces propriétés pour définir des valeurs qui affectent la détection des défaillances, le temps de réponse des défaillances et la journalisation pour surveiller l’état d’intégrité de l’instance de cluster de basculement SQL Server.

Nom de colonne Type de données Pouvant être nul Description
VerboseLogging bigint Oui Niveau de journalisation pour le cluster de basculement SQL Server. Activez la journalisation détaillée pour fournir des détails supplémentaires dans les journaux d’erreurs pour la résolution des problèmes. Une des valeurs suivantes :

- 0: la journalisation est désactivée (par défaut)
- 1: Erreurs uniquement
- 2: Erreurs et avertissements

Pour plus d’informations, consultez ALTER SERVER CONFIGURATION.
SqlDumperDumpFlags bigint Oui Les indicateurs de vidage SQLDumper déterminent le type de fichiers de vidage générés par SQL Server. La valeur par défaut est 0.
SqlDumperDumpPath nvarchar(260) Non Emplacement où l'utilitaire SQLDumper génère les fichiers dump.
SqlDumperDumpTimeOut bigint Oui Valeur de délai d’expiration en millisecondes pour l’utilitaire SQLDumper afin de générer un vidage si SQL Server échoue. La valeur par défaut est 0.
FailureConditionLevel bigint Oui Définit les conditions dans lesquelles le cluster de basculement SQL Server doit échouer ou redémarrer. La valeur par défaut est 3. Pour obtenir une explication détaillée ou modifier les paramètres de propriété, consultez Configurer les paramètres de propriété FailureConditionLevel.
HealthCheckTimeout bigint Oui Valeur de délai d’expiration pour la durée pendant laquelle la DLL de ressource Moteur de base de données SQL Server doit attendre les informations d’intégrité du serveur avant de considérer l’instance de SQL Server comme non réponse. La valeur du délai d’expiration est exprimée en millisecondes. La valeur par défaut est 60000 (60 000).

Pour plus d’informations ou pour modifier ce paramètre de propriété, consultez Configurer les paramètres de propriété HealthCheckTimeout.
ClusterConnectionOptions nvarchar(4000) Oui Pour plus d’informations sur ces options, consultez la section Options de connexion de cluster .

Options de connexion de cluster

Clé Valeurs prises en charge Description
Encrypt Mandatory, , StrictOptional Spécifie comment le chiffrement du groupe de disponibilité est appliqué. Si le serveur ne prend pas en charge le chiffrement, la connexion échoue. Si vous définissez le chiffrement Mandatorysur , vous TrustServerCertificate devez définir la valeur Oui. Si vous définissez le chiffrement Strictsur , il TrustServerCertificate est ignoré.

Remarque : cette paire clé-valeur est requise.
HostNameInCertificate Nom du réplica ou nom de l’écouteur du groupe de disponibilité Spécifie le nom du réplica ou le nom de l’écouteur du groupe de disponibilité dans le certificat utilisé pour le chiffrement. Cette valeur doit correspondre à la valeur dans l’autre nom de l’objet du certificat. Si le nom du serveur est répertorié dans le certificat, vous pouvez omettre la HostNameInCertificate paire clé-valeur. Si le nom du serveur n’est pas répertorié dans le certificat, vous devez spécifier la HostNameInCertificate paire clé-valeur avec le nom du serveur.

Remarque : cette paire clé-valeur est facultative.
TrustServerCertificate Yes, No Défini pour yes spécifier que le pilote ne valide pas le certificat TLS/SSL du serveur. Si no, le pilote valide le certificat. Pour plus d’informations, consultez TDS 8.0.

Remarque : cette paire clé-valeur est facultative.
ServerCertificate Chemin d’accès à votre certificat Si vous ne souhaitez pas utiliser HostNameInCertificate, vous pouvez passer le chemin d’accès à votre certificat. Le compte de service de cluster doit avoir l’autorisation de lire le certificat à partir de l’emplacement donné.

Remarque : cette paire clé-valeur est facultative.
CLUSTER_CONNECTION_OPTIONS Chaîne vide ('') Efface la configuration existante et rétablit les paramètres de chiffrement par défaut de Encrypt=Mandatory et TrustServerCertificate=Yes.

Pour plus d’informations, consultez CREATE AVAILABILITY GROUP et ALTER AVAILABILITY GROUP.

autorisations

SQL Server 2019 (15.x) et les versions antérieures nécessitent des autorisations VIEW SERVER STATE sur l’instance de cluster de basculement SQL Server.

SQL Server 2022 (16.x) et versions ultérieures nécessitent VIEW SERVER PERFORMANCE STATE une autorisation sur le serveur.

Exemples

L’exemple suivant utilise sys.dm_os_cluster_properties pour retourner les paramètres de propriété de la ressource de cluster de basculement SQL Server.

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

Voici l'ensemble des résultats.

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