Configure Advanced Settings for DQS Log Files

Статья
08/21/2023

Применимо к:SQL Server

В этом разделе описывается настройка расширенных параметров для файлов журналов сервера качества данных и клиента качества данных, таких как установка ограничения размера скользящего размера файлов журнала, установка шаблона метки времени событий и т. д.

Заметка

Эти действия не могут выполняться с помощью клиента качества данных и предназначены только для расширенных пользователей.

Перед началом

Безопасность

Разрешения

Учетная запись Windows должна быть членом предопределенной роли сервера sysadmin на этом экземпляре SQL Server для изменения параметров конфигурации в таблице A_CONFIGURATION базы данных DQS_MAIN.
Необходимо войти в систему в качестве члена группы "Администраторы" на компьютере, где вы изменяете файл DQLog.Client.xml, чтобы настроить параметры ведения журнала клиента качества данных.

Настройка параметров журнала сервера DQS

Параметры журнала сервера качества данных представлены в формате XML в столбце VALUE строки ServerLogging в таблице A_CONFIGURATION в базе данных DQS_MAIN. Вы можете выполнить следующий SQL-запрос для просмотра сведений о конфигурации:

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

Необходимо обновить соответствующие сведения в столбце VALUE строки ServerLogging, чтобы изменить параметры конфигурации для ведения журнала сервера качества данных. В этом примере мы обновим параметры журнала сервера качества данных, чтобы задать размер скользящего файла до 25000 КБ (по умолчанию — 20000 КБ).

Запустите среду Microsoft SQL Server Management Studio и подключитесь к соответствующему экземпляру SQL Server.
В обозревателе объектов щелкните сервер правой кнопкой мыши и выберите команду Создать запрос.

В окно редактора запросов скопируйте следующие инструкции 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

Нажмите клавишу F5, чтобы выполнить инструкции. Откройте область Результаты , чтобы удостовериться в успешном выполнении инструкций.
Чтобы применить изменения к конфигурации ведения журнала сервера качества данных, необходимо выполнить следующие инструкции Transact-SQL. Откройте новое окно редактора запросов и вставьте следующие инструкции Transact-SQL:
```
USE [DQS_MAIN]  
GO  
DECLARE @return_value int  
EXEC @return_value = [internal_core].[RefreshLogSettings]  
SELECT 'Return Value' = @return_value  
GO  
```
Нажмите клавишу F5, чтобы выполнить инструкции. Откройте область Результаты , чтобы удостовериться в успешном выполнении инструкций.

Заметка

Конфигурация параметров ведения журнала сервера качества данных динамически создается и хранится в DQS_MAIN. Файл журнала, который обычно доступен в C:\Program Files\Microsoft SQL Server\MSSQL13. MSSQLSERVER\MSSQL\Log, если установлен экземпляр SQL Server по умолчанию. Однако изменения, внесенные непосредственно в этот файл, не сохраняются, они перезаписываются параметрами конфигурации из таблицы A_CONFIGURATION базы данных DQS_MAIN.

Настройка параметров журнала клиента DQS

Файл конфигурации конфигурации журнала клиента качества данных DQLog.Client.xml обычно доступен в C:\Program Files\Microsoft SQL Server\130\Tools\Binn\DQ\config. Содержимое XML-файла похоже на XML-файл, измененный ранее для параметров конфигурации журнала сервера качества данных. Чтобы настроить параметры журнала клиента качества данных, выполните следующие действия.

Откройте любой редактор XML-файлов или Блокнот с правами администратора.
Откройте файл DQLog.Client.xml в этом редакторе или в Блокноте.
Внесите необходимые изменения и сохраните этот файл, чтобы изменения журнала были применены.

См. также

Настройка степеней серьезности для файлов журнала DQS