Konfigurieren der erweiterten Einstellungen für DQS-Protokolldateien

Artikel
07/12/2024

Gilt für: SQL Server

In diesem Thema wird beschrieben, wie erweiterte Einstellungen für Data Quality Server- und Data Quality-Client-Protokolldateien konfiguriert werden, z. B. das Festlegen der maximalen Rolldateigröße für Protokolldateien, das Festlegen des Zeitstempelschemas von Ereignissen usw.

Hinweis

Diese Aktivitäten können nicht mit Data Quality-Client ausgeführt werden und sind nur für erfahrene Benutzer vorgesehen.

Vorbereitungen

Sicherheit

Berechtigungen

Das Windows-Benutzerkonto muss ein Mitglied der festen Serverrolle "sysadmin" in der SQL Server-Instanz sein, damit Konfigurationseinstellungen in der A_CONFIGURATION-Tabelle in der DQS_MAIN-Datenbank geändert werden können.
Sie müssen als Mitglied der Gruppe „Administratoren“ auf dem Computer angemeldet sein, auf dem Sie die Datei „DQLog.Client.xml“ ändern, um die Data Quality-Client-Protokollierungseinstellungen konfigurieren zu können.

Konfigurieren von Data Quality Server-Protokolleinstellungen

Die Data Quality Server-Protokolleinstellungen sind in einem XML-Format in der Spalte VALUE der Zeile ServerLogging in der A_CONFIGURATION-Tabelle in der DQS_MAIN-Datenbank vorhanden. Sie können die folgende SQL-Abfrage ausführen, um die Konfigurationsinformationen anzuzeigen:

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

Sie müssen die entsprechenden Informationen in der Spalte VALUE der Zeile ServerLogging aktualisieren, um die Konfigurationseinstellungen für die Protokollierung zu ändern. In diesem Beispiel aktualisieren wir die Data Quality Server-Protokolleinstellungen, um die maximale Rolldateigröße auf 25.000 KB festzulegen (der Standard beträgt 20.000 KB).

Starten Sie Microsoft SQL Server Management Studio, und stellen Sie eine Verbindung mit der entsprechenden SQL Server-Instanz her.
Klicken Sie im Objekt-Explorer mit der rechten Maustaste auf den Server, und klicken Sie dann auf Neue Abfrage.

Geben Sie im Fenster Abfrage-Editor die folgenden SQL-Anweisungen ein:

-- 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

Drücken Sie F5, um die Anweisungen auszuführen. Überprüfen Sie im Bereich Ergebnisse , ob die Anweisungen erfolgreich ausgeführt wurden.
Um Änderungen an der Konfiguration der Data Quality Server-Protokollierung zu übernehmen, müssen Sie die folgenden Transact-SQL-Anweisungen ausführen. Öffnen Sie ein neues Abfrage-Editor-Fenster, und fügen Sie die folgenden Transact-SQL-Anweisungen ein:
```
USE [DQS_MAIN]  
GO  
DECLARE @return_value int  
EXEC @return_value = [internal_core].[RefreshLogSettings]  
SELECT 'Return Value' = @return_value  
GO  
```
Drücken Sie F5, um die Anweisungen auszuführen. Überprüfen Sie im Bereich Ergebnisse , ob die Anweisungen erfolgreich ausgeführt wurden.

Hinweis

Die Konfiguration der Data Quality Server-Protokolleinstellungen wird dynamisch generiert und in der Datei „DQS_MAIN.Log“ gespeichert, die sich in der Regel unter „C:\Programme\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Log“ befindet, wenn Sie die Standardinstanz von SQL Server installiert haben. In dieser Datei direkt ausgeführte Änderungen sind jedoch nicht dauerhaft und werden von den Konfigurationseinstellungen in der A_CONFIGURATION-Tabelle in der DQS_MAIN-Datenbank überschrieben.

Konfigurieren von Data Quality Client-Protokolleinstellungen

Die Konfigurationsdatei für die Data Quality-Client Protokolleinstellung, DQLog.Client.xml, ist in der Regel unter „C:\Programme\Microsoft SQL Server\130\Tools\Binn\DQ\config“ verfügbar. Der Inhalt der XML-Datei ähnelt der XML-Datei, die Sie zuvor für die Konfigurationseinstellungen des Data Quality Server geändert haben. So konfigurieren Sie Data Quality-Client-Protokolleinstellungen

Führen Sie ein beliebiges XML-Bearbeitungstool oder den Editor als Administrator aus.
Öffnen Sie die Datei "DQLog.Client.xml" im Tool oder Editor.
Nehmen Sie die erforderlichen Änderungen vor, und speichern Sie die Datei, um die geänderten Protokollierungseinstellungen zu übernehmen.

Weitere Informationen

Konfigurieren von Schweregraden für DQS-Protokolldateien

Freigeben über