Configurer les paramètres avancés pour les fichiers journaux DQS

Article
07/12/2024

S'applique à : SQL Server

Cette rubrique explique comment configurer les paramètres avancés pour les fichiers journaux Data Quality Server et Data Quality Client, tels que la définition de la limite de la taille des fichiers par progression des fichiers journaux, la définition du modèle d'horodatage les événements, etc.

Remarque

Ces activités ne peuvent pas être effectuées à l'aide de Data Quality Client et sont réservées aux utilisateurs expérimentés uniquement.

Avant de commencer

Sécurité

autorisations

Votre compte d'utilisateur Windows doit être membre du rôle serveur fixe sysadmin dans l'instance SQL Server afin de pouvoir modifier les paramètres de configuration dans la table A_CONFIGURATION de la base de données DQS_MAIN.
Vous devez être connecté en tant que membre du groupe Administrateurs sur l'ordinateur où vous modifiez le fichier DQLog.Client.xml pour configurer les paramètres de journalisation Data Quality Client.

Configurer les paramètres des journaux du serveur de qualité des données

Les paramètres des journaux Data Quality Server sont présents au format XML dans la colonne VALUE de la ligne ServerLogging de la table A_CONFIGURATION de la base de données DQS_MAIN. Vous pouvez exécuter la requête SQL suivante pour afficher les informations de configuration :

select * from DQS_MAIN.dbo.A_CONFIGURATION where NAME='ServerLogging'

Vous devez mettre à jour les informations appropriées dans la colonne VALUE de la ligne ServerLogging pour modifier les paramètres de configuration de la journalisation Data Quality Server. Dans cet exemple, nous mettrons à jour les paramètres des journaux Data Quality Server pour définir la limite de la taille des fichiers par progression à 25 000 Ko (valeur par défaut 20 000 Ko).

Démarrez Microsoft SQL Server Management Studio et connectez-vous à l'instance de SQL Server appropriée.
Dans l'Explorateur d'objets, cliquez avec le bouton droit sur le serveur, puis cliquez sur Nouvelle requête.

Dans la fenêtre Éditeur de requête, copiez les instructions SQL suivantes :

-- Begin the transaction.  
BEGIN TRAN  
GO  
-- set the XML value field for the row with name=ServerLogging  
update DQS_MAIN.dbo.A_CONFIGURATION   
set VALUE='<configuration>  
  <configSections>  
    <section name="loggingConfiguration" type="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.LoggingSettings, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" />  
  </configSections>  
  <loggingConfiguration name="Logging Application Block" tracingEnabled="true" defaultCategory="" logWarningsWhenNoCategoriesMatch="true">  
    <listeners>  
      <add fileName="###REPLACE_THIS_WITH_SQL_SERVER_INSTANCE_LOG_FOLDER_NAME###DQServerLog.###REPLACE_THIS_WITH_SQL_CATALOG_NAME###.log" footer="" formatter="Custom Text Formatter" header="" rollFileExistsBehavior="Increment" rollInterval="None" rollSizeKB="25000" timeStampPattern="yyyy-MM-dd" listenerDataType="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.RollingFlatFileTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" traceOutputOptions="None" filter="All" type="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.RollingFlatFileTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" name="Rolling Flat File Trace Listener" />  
    </listeners>  
    <formatters>  
      <add template="{timestamp(local)}|[{threadName}]|{dictionary({value}|)}{message}" type="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.TextFormatter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" name="Custom Text Formatter" />  
    </formatters>  
    <logFilters>  
      <add enabled="true" type="Microsoft.Practices.EnterpriseLibrary.Logging.Filters.LogEnabledFilter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" name="LogEnabled Filter" />  
    </logFilters>  
    <categorySources />  
    <specialSources>  
      <allEvents switchValue="All" name="All Events" />  
      <notProcessed switchValue="All" name="Unprocessed Category" />  
      <errors switchValue="All" name="Logging Errors & Warnings">  
        <listeners>  
          <add name="Rolling Flat File Trace Listener" />  
        </listeners>  
      </errors>  
    </specialSources>  
  </loggingConfiguration>  
</configuration>'  
WHERE NAME='ServerLogging'  
GO  
-- check the result  
select * from DQS_MAIN.dbo.A_CONFIGURATION where NAME='ServerLogging'  

-- Commit the transaction.  
COMMIT TRAN

Appuyez sur F5 pour exécuter les instructions. Consultez le volet de résultats pour vérifier que les instructions ont été correctement exécutées.
Pour appliquer les modifications effectuées à la configuration de journalisation Data Quality Server, vous devez exécuter les instructions Transact-SQL suivantes. Ouvrez une nouvelle fenêtre de l'Éditeur de requête, puis collez les instructions Transact-SQL suivantes :
```
USE [DQS_MAIN]  
GO  
DECLARE @return_value int  
EXEC @return_value = [internal_core].[RefreshLogSettings]  
SELECT 'Return Value' = @return_value  
GO  
```
Appuyez sur F5 pour exécuter les instructions. Consultez le volet de résultats pour vérifier que les instructions ont été correctement exécutées.

Remarque

La configuration des paramètres de journalisation Data Quality Server est générée dynamiquement et stockée dans le fichier DQS_MAIN.Log, généralement disponible dans C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Log si vous avez installé l’instance par défaut de SQL Server. Toutefois, les modifications apportées directement dans ce fichier ne se conservent pas et sont remplacées par les paramètres de configuration de la table A_CONFIGURATION de la base de données DQS_MAIN.

Configurer les paramètres des journaux du client de qualité des données

Le fichier de configuration des paramètres du journal de Data Quality Client, DQLog.Client.xml, est généralement disponible dans C:\Program Files\Microsoft SQL Server\130\Tools\Binn\DQ\config. Le contenu du fichier XML est similaire à celui du fichier XML que vous avez modifié précédemment pour les paramètres de configuration du journal de Data Quality Server. Pour configurer les paramètres des journaux de Data Quality Client :

Exécutez l'outil d'édition XML ou le Bloc-notes en tant qu'administrateur.
Ouvrez le fichier DQLog.Client.xml dans l'outil ou le Bloc-notes.
Apportez les modifications requises et enregistrez le fichier pour appliquer les nouvelles modifications de journalisation.

Voir aussi

Configurer les niveaux de gravité pour les fichiers journaux DQS

Partager via