Configurare le impostazioni avanzate per i file di log DQSConfigure Advanced Settings for DQS Log Files

In questo argomento viene descritto come configurare le impostazioni avanzate per i file di log del Data Quality ServerData Quality Server e del Client Data QualityData Quality Client , ad esempio come impostare il limite delle dimensioni dei file mobili per i file di log, il modello del timestamp degli eventi e così via.This topic describes how to configure advanced settings for Data Quality ServerData Quality Server and Client Data QualityData Quality Client log files, such as set the rolling file size limit of the log files, set the time stamp pattern of the events, and so on.

Nota

Queste attività non possono essere eseguite mediante il Client Data QualityData Quality Cliente sono destinate solo agli utenti avanzati.These activities cannot be performed using Client Data QualityData Quality Client, and is intended for advanced users only.

Prima di iniziare Before You Begin

Sicurezza Security

Autorizzazioni Permissions

  • Per modificare le impostazioni di configurazione nella tabella A_CONFIGURATION del database DQS_MAIN, è necessario che l'account utente di Windows sia membro del ruolo predefinito del server sysadmin nell'istanza di SQL Server.Your Windows user account must be a member of the sysadmin fixed server role in the SQL Server instance to modify configuration settings in the A_CONFIGURATION table in the DQS_MAIN database.

  • Per configurare le impostazioni di registrazione del Client Data QualityData Quality Client , è necessario avere eseguito l'accesso come membro del gruppo Administrators al computer in cui si modifica il file DQLog.Client.xml.You must be logged on as a member of the Administrators group on the computer where you are modifying the DQLog.Client.xml file to configure the Client Data QualityData Quality Client logging settings.

Configurare le impostazioni di log del server Data Quality Configure Data Quality Server Log Settings

Le impostazioni di log del Data Quality ServerData Quality Server sono presenti in formato XML nella colonna VALUE della riga ServerLogging nella tabella A_CONFIGURATION del database DQS_MAIN.The Data Quality ServerData Quality Server log settings are present in an XML format in the VALUE column of the ServerLogging row in the A_CONFIGURATION table in the DQS_MAIN database. Per visualizzare le informazioni di configurazione, è possibile eseguire la query SQL seguente:You can run the following SQL query to view the configuration information:

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

È necessario aggiornare le informazioni appropriate nella colonna VALUE della riga ServerLogging per modificare le impostazioni di configurazione per la registrazione del Data Quality ServerData Quality Server .You must update the appropriate information in the VALUE column of the ServerLogging row to change the configuration settings for Data Quality ServerData Quality Server logging. In questo esempio verranno aggiornate le impostazioni di log del Data Quality ServerData Quality Server per impostare il limite delle dimensioni dei file mobili su 25000 KB (il valore predefinito è 20000 KB).In this example, we will update the Data Quality ServerData Quality Server log settings to set the rolling file size limit to 25000 KB (the default is 20000 KB).

  1. Avviare Microsoft SQL Server Management Studio e connettersi all'istanza di SQL Server appropriata.Start Microsoft SQL Server Management Studio, and connect to the appropriate SQL Server instance.

  2. In Esplora oggetti fare clic con il pulsante destro del mouse sul server, quindi fare clic su Nuova query.In Object Explorer, right-click the server, and then click New Query.

  3. Nella finestra dell'editor di query copiare le istruzioni SQL seguenti:In the Query Editor window, copy the following SQL statements:

    -- 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. Premere F5 per eseguire le istruzioni.Press F5 to execute the statements. Esaminare il riquadro Risultati per verificare che le istruzioni siano state eseguite correttamente.Check the Results pane to verify that the statements have executed successfully.

  5. Per applicare le modifiche apportate alla configurazione della registrazione del Data Quality ServerData Quality Server , è necessario eseguire le istruzioni Transact-SQL seguenti.To apply changes done to the Data Quality ServerData Quality Server logging configuration, you must run the following Transact-SQL statements. Aprire una nuova finestra dell'editor di query e incollare le istruzioni Transact-SQL seguenti:Open a new Query Editor window, and paste the following Transact-SQL statements:

    USE [DQS_MAIN]  
    GO  
    DECLARE @return_value int  
    EXEC @return_value = [internal_core].[RefreshLogSettings]  
    SELECT 'Return Value' = @return_value  
    GO  
    
  6. Premere F5 per eseguire le istruzioni.Press F5 to execute the statements. Esaminare il riquadro Risultati per verificare che le istruzioni siano state eseguite correttamente.Check the Results pane to verify that the statements have executed successfully.

Nota

La configurazione delle impostazioni di registrazione del Data Quality ServerData Quality Server viene generata dinamicamente e viene archiviata nel file DQS_MAIN.Log, disponibile in genere in C:\Programmi\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Log se è stata installata l'istanza predefinita di SQL Server.The Data Quality ServerData Quality Server logging settings configuration is dynamically generated and stored in the DQS_MAIN.Log file, which is typically available at C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Log if you installed the default instance of SQL Server. Tuttavia, le modifiche effettuate direttamente in questo file non vengono conservate e vengono sovrascritte dalle impostazioni di configurazione nella tabella A_CONFIGURATION del database DQS_MAIN.However, changes done directly in this file do not hold, and are overwritten by the configuration settings in the A_CONFIGURATION table in the DQS_MAIN database.

Configurare le impostazioni di log del client Data Quality Configure Data Quality Client Log Settings

Il file di configurazione delle impostazioni di log del Client Data QualityData Quality Client , DQLog.Client.xml, è disponibile in genere in C:\Programmi\Microsoft SQL Server\130\Tools\Binn\DQ\config. Il contenuto del file XML è simile al file XML modificato precedentemente per le impostazioni di configurazione di log del Data Quality ServerData Quality Server .The Client Data QualityData Quality Client log setting configuration file, DQLog.Client.xml, is typically available at C:\Program Files\Microsoft SQL Server\130\Tools\Binn\DQ\config. The contents of the XML file is similar to the XML file that you modified earlier for the Data Quality ServerData Quality Server log configuration settings. Per configurare le impostazioni di log del Client Data QualityData Quality Client :To configure the Client Data QualityData Quality Client log settings:

  1. Eseguire un qualsiasi strumento di modifica dei file XML o Blocco note come amministratore.Run any XML editing tool or notepad as an administrator.

  2. Aprire il file DQLog.Client.xml nello strumento o in Blocco note.Open the DQLog.Client.xml file in the tool or notepad.

  3. Apportare le modifiche necessarie e salvare il file per applicare le nuove modifiche di registrazione.Make the required changes, and save the file to apply the new logging changes.

Vedere ancheSee Also

Configurare livelli di gravità per i file di log DQSConfigure Severity Levels for DQS Log Files