Configurare le impostazioni avanzate per i file di log DQS

Articolo
03/19/2024

Si applica a:SQL Server

In questo argomento viene descritto come configurare le impostazioni avanzate per i file di log del Data Quality Server e del Data Quality Client, ad esempio come impostare il limite delle dimensioni dei file mobili per i file di log, i criteri dell’indicatore orario degli eventi e così via.

Nota

Queste attività non possono essere eseguite mediante il Data Quality Client e sono destinate solo agli utenti Advanced.

Prima di iniziare

Sicurezza

Autorizzazioni

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.
Per configurare le impostazioni di registrazione del Data Quality Client è necessario avere eseguito l'accesso come membro del gruppo Administrators al computer in cui si modifica il file DQLog.Client.xml.

Configurare le impostazioni di log del server Data Quality

Le impostazioni di log del Data Quality Server sono presenti in formato XML nella colonna VALUE della riga ServerLogging nella tabella A_CONFIGURATION del database DQS_MAIN. Per visualizzare le informazioni di configurazione, è possibile eseguire la query SQL seguente:

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

È necessario aggiornare le informazioni appropriate nella colonna VALUE della riga ServerLogging per modificare il set di configurazione per la registrazione del Data Quality Server. In questo esempio verranno aggiornate le impostazioni di log del Data Quality Server per impostare il limite delle dimensioni dei file mobili su 25.000 KB (il valore predefinito è 20.000 KB).

Avviare Microsoft SQL Server Management Studio e connettersi all'istanza di SQL Server appropriata.
In Esplora oggetti fare clic con il pulsante destro del mouse sul server, quindi fare clic su Nuova query.

Nella finestra dell'editor di query copiare le istruzioni SQL seguenti:

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

Premere F5 per eseguire le istruzioni. Esaminare il riquadro Risultati per verificare che le istruzioni siano state eseguite correttamente.
Per applicare le modifiche apportate alla configurazione della registrazione del Data Quality Server, è necessario eseguire le istruzioni Transact-SQL seguenti. Aprire una nuova finestra dell'editor di query e incollare le istruzioni Transact-SQL seguenti:
```
USE [DQS_MAIN]  
GO  
DECLARE @return_value int  
EXEC @return_value = [internal_core].[RefreshLogSettings]  
SELECT 'Return Value' = @return_value  
GO  
```
Premere F5 per eseguire le istruzioni. Esaminare il riquadro Risultati per verificare che le istruzioni siano state eseguite correttamente.

Nota

La configurazione delle impostazioni di registrazione del Data 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. 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.

Configurare le impostazioni di log del client Data Quality

Il file di configurazione dell'impostazione del log del Data Quality Client DQLog.Client.xml, è in genere disponibile in C:\Programmi\Microsoft SQL Server\130\Tools\Strumenti\DQ\config. Il contenuto del file XML è simile al file XML modificato in precedenza per il set di configurazione del log di Data Quality Server. Configurare le impostazioni di log del Data Quality Client

Eseguire un qualsiasi strumento di modifica dei file XML o Blocco note come amministratore.
Aprire il file DQLog.Client.xml nello strumento o in Blocco note.
Apportare le modifiche necessarie e salvare il file per applicare le nuove modifiche di registrazione.

Vedi anche

Configurare livelli di gravità per i file di log DQS