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

Article
08/23/2023

S’applique à :SQL Server

Cette rubrique explique comment configurer des paramètres avancés pour les fichiers journaux Data Quality Server et Data Quality Client, tels que définir la limite de taille de fichier propagée des fichiers journaux, définir le modèle d’horodatage des événements, etc.

Note

Ces activités ne peuvent pas être effectuées à l’aide du client de qualité des données et sont destinées uniquement aux utilisateurs avancés.

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 sur lequel vous modifiez le fichier DQLog.Client.xml pour configurer les paramètres de journalisation du client de qualité des données.

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

Les paramètres du journal Data Quality Server sont présents dans un format XML dans la colonne VALUE de la ligne ServerLogging dans 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 allons mettre à jour les paramètres du journal data Quality Server pour définir la limite de taille de fichier propagée sur 25 000 Ko (la valeur par défaut est de 2 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 apporté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.

Note

La configuration des paramètres de journalisation du serveur de qualité des données est générée dynamiquement et stockée dans le DQS_MAIN. Fichier journal, 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 du paramètre de journal de qualité des données, 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 au fichier XML que vous avez modifié précédemment pour les paramètres de configuration du journal Data Quality Server. Pour configurer les paramètres du journal 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