为 DQS 日志文件配置高级设置

适用于: SQL Server

本主题介绍如何为 Data Quality Server 和 Data Quality Client 日志文件配置高级设置,例如设置日志文件的滚动文件大小限制、设置事件的时间戳模式等。

注意

这些活动不能使用 Data Quality Client 执行,并且仅面向高级用户。

开始之前

安全性

权限

  • 您的 Windows 用户帐户必须是 SQL Server 实例中 sysadmin 固定服务器角色的成员,才能修改 DQS_MAIN 中 A_CONFIGURATION 表的配置设置。

  • 你必须以正在修改 DQLog.Client.xml 文件以便配置 Data Quality Client 日志记录的计算机上 Administrators 组成员的身份登录。

配置 Data Quality Server 日志设置

Data Quality Server 日志设置在 DQS_MAIN 数据库的 A_CONFIGURATION 表中 ServerLogging 行的 VALUE 列中以 XML 格式提供。 您可以运行以下 SQL 查询以便查看配置信息:

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

若要更改 Data Quality Server 日志记录的配置设置,你必须在 ServerLogging 行的 VALUE 列中更新相应信息。 在此示例中,我们将更新 Data Quality Server 日志设置,以便将滚动文件大小限制设置为 25000 KB(默认值为 20000 KB)。

  1. 启动 Microsoft SQL Server Management Studio 并连接到适当的 SQL Server 实例。

  2. 在“对象资源管理器”中,右键单击服务器,再单击 “新建查询”

  3. 在“查询编辑器”窗口中,复制以下 SQL 语句:

    -- 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  
    
    
  4. 按 F5 执行这些语句。 检查 “结果” 窗格以验证是否已成功执行这些语句。

  5. 若要应用对 Data Quality Server 日志记录配置进行的更改,你必须运行以下 Transact-SQL 语句。 打开新的“查询编辑器”窗口,然后粘贴以下 Transact-SQL 语句:

    USE [DQS_MAIN]  
    GO  
    DECLARE @return_value int  
    EXEC @return_value = [internal_core].[RefreshLogSettings]  
    SELECT 'Return Value' = @return_value  
    GO  
    
    
  6. 按 F5 执行这些语句。 检查 “结果” 窗格以验证是否已成功执行这些语句。

注意

Data Quality Server 日志记录设置配置动态生成并且存储于 DQS_MAIN.Log 文件中,该文件通常位于 C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Log 下(如果你安装了 SQL Server 的默认实例)。 但是,将不会保存在此文件中直接进行的更改,它们将会被 DQS_MAIN 数据库中 A_CONFIGURATION 表的配置设置覆盖。

配置数据质量客户端日志设置

Data Quality Client 日志设置配置文件 DQLog.Client.xml 通常保存在 C:\Program Files\Microsoft SQL Server\130\Tools\Binn\DQ\config 中。XML 文件的内容类似于之前为 Data Quality Server 日志配置设置修改的 XML 文件。 要配置 Data Quality Client 日志设置:

  1. 以管理员身份运行任何 XML 编辑工具或记事本。

  2. 在工具或记事本中打开 DQLog.Client.xml 文件。

  3. 进行所需更改,然后保存该文件以便应用新的日志记录更改。

另请参阅

为 DQS 日志文件配置严重级别