Controllo coerenza del database (DBCC) per Analysis Services

Si applica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

DBCC fornisce la convalida su richiesta dei database multidimensionali e tabulari in un'istanza di Analysis Services. È possibile eseguire DBCC in una finestra di query MDX o XMLA in SQL Server Management Studio (SSMS) e tracciare l'output di DBCC in SQL Server Profiler o in sessioni xEvent di SSMS.
Il comando accetta una definizione di oggetto e restituisce un set di risultati vuoto o informazioni dettagliate sull'errore se l'oggetto è danneggiato. In questo articolo si apprenderà come eseguire il comando, interpretare i risultati e risolvere eventuali problemi che si verificano.

Per i database tabulari, i controlli di coerenza eseguiti da DBCC sono equivalenti alla convalida predefinita che si verifica automaticamente ogni volta che si ricarica, si sincronizza o si ripristina un database. Al contrario, le verifiche di coerenza per i database multidimensionali si verificano solo quando si esegue DBCC su richiesta.

La gamma di controlli di convalida varia in base alla modalità. I database tabulari sono infatti soggetti a una gamma più ampia di controlli.
Anche le caratteristiche di un carico di lavoro DBCC variano in base alla modalità del server. Il controllo delle operazioni sui database multidimensionali comporta la lettura dei dati dal disco e la creazione di indici temporanei per il confronto con gli indici effettivi, richiedendo tempi di completamento più lunghi.

La sintassi del comando per DBCC usa metadati degli oggetti specifici del tipo di database da verificare:

• I database multidimensionali e quelli tabulari precedenti a SQL Server 2016 con livello di compatibilità 1100 o 1103 sono descritti nei costrutti di modellazione multidimensionali come cubeID, measuregroupIDe partitionID.

• Metadati per i nuovi database del modello tabulare a livello di compatibilità 1200 e superiore sono costituiti da descrittori come TableName e PartitionName.

DBCC per Analysis Services verrà eseguito in qualsiasi database di Analysis Services a qualsiasi livello di compatibilità, purché il database sia in esecuzione in un'istanza di SQL Server 2016. Assicurarsi di usare la sintassi del comando corretto per ogni tipo di database.

Requisiti relativi alle autorizzazioni

Per eseguire il comando, è necessario essere un amministratore del server o del database di Analysis Services, ovvero un membro del ruolo del server. Per istruzioni , vedere Concedere le autorizzazioni di database (Analysis Services) o Concedere i diritti di amministratore del server a un'istanza di Analysis Services .

Sintassi del comando

I database tabulari nei livelli di compatibilità 1200 e superiori usano metadati tabulari per le definizioni di oggetti. L'esempio seguente illustra la sintassi completa di DBCC per un database tabulare creato a un livello funzionale di SQL Server 2016.

Le differenze chiave tra le due sintassi includono uno spazio dei nomi XMLA più recente, nessun elemento Object> e nessun <<elemento Model> (esiste ancora un solo modello per database).

<DBCC xmlns="http://schemas.microsoft.com/analysisservices/2014/engine">  
     <DatabaseID>MyTabular1200DB_7811b5d8-c407-4203-8793-12e16c3d1b9b</DatabaseID>  
     <TableName>FactSales</TableName>  
     <PartitionName>FactSales 4</PartitionName>  
</DBCC>  

Per controllare l'intero schema, è possibile omettere gli oggetti di livello inferiore, ad esempio nomi di tabella o partizione.

È possibile ottenere i nomi degli oggetti e DatabaseID da Management Studio tramite la pagina delle proprietà di ogni oggetto.

Sintassi del comando per database multidimensionali e tabulari 110x

DBCC usa una sintassi identica per i database multidimensionali e tabulari 1100 e 1103. È possibile eseguire DBCC su oggetti di database specifici, incluso l'intero database. Per altre informazioni sulla definizione dell'oggetto, vedere Elemento object (XMLA).

<DBCC xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
     <Object>  
          <DatabaseID>AdventureWorksDW2014Multidimensional-EE</DatabaseID>  
          <CubeID>Adventure Works</CubeID>  
          <MeasureGroupID>Fact Internet Sales 1</MeasureGroupID>  
          <PartitionID>Internet_Sales_2006</PartitionID>  
     </Object>  
</DBCC>  
  

Per eseguire DBCC negli oggetti più in alto verso l'alto della catena di oggetti, eliminare eventuali elementi ID oggetto di livello inferiore non necessari:

<DBCC xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
     <Object>  
          <DatabaseID>AdventureWorksDW2014Multidimensional-EE</DatabaseID>  
          <CubeID>Adventure Works</CubeID>  
     </Object>  
</DBCC>  
  

Per i database tabulari 110x la sintassi di definizione degli oggetti viene modellata in base alla sintassi del comando Process, in particolare in base al modo in cui viene eseguito il mapping delle tabelle alle dimensioni e ai gruppi di misure.

• PerCubeID viene eseguito il mapping all'ID modello, ovvero Model.

• PerMeasureGroupID viene eseguito il mapping a un ID tabella.

• PerPartitionID viene eseguito il mapping a un ID partizione.

Utilizzo

In SQL Server Management Studio è possibile richiamare DBCC tramite una finestra di query MDX o XMLA. È inoltre possibile usare SQL Server 2017 Profiler o Analysis Services xEvents per visualizzare l'output DBCC. Si noti che i messaggi di DBCC SSAS non vengono segnalati nel registro eventi applicazioni di Windows o nel file msmdsrv.log.

DBCC verifica l'eventuale danneggiamento dei dati fisici, nonché il danneggiamento dei dati logici che si verificano quando un segmento include membri orfani. Prima di poter eseguire DBCC, il database deve essere elaborato, perché le partizioni remote, vuote o non elaborate vengono ignorate.

Il comando viene eseguito in una transazione di lettura e può quindi essere interrotto da timeout con commit forzato. Le verifiche delle partizioni vengono eseguite in parallelo.

Per rilevare gli eventuali errori di danneggiamento che si sono verificati dopo l'ultimo riavvio del servizio, potrebbe essere necessario un nuovo riavvio. La riconnessione al server non è sufficiente per rendere effettive le modifiche.

Eseguire i comandi DBCC in Management Studio

Per le query ad hoc, aprire una finestra di query MDX o XMLA in SQL Server Management Studio. A tale scopo, fare clic con il pulsante destro del mouse sul database | Nuova query | XMLA) per eseguire il comando e leggere l'output.

Se non sono stati rilevati problemi, la scheda Risultati visualizza un set di risultati vuoto, come illustrato nella schermata.

La scheda Messaggi fornisce informazioni dettagliate, ma non è sempre affidabile per i database più piccoli. I messaggi di stato vengono a volte rimossi, a indicare che il comando è stato completato, ma senza messaggi di verifica dello stato per ogni oggetto. Un tipico report del messaggio può essere simile al seguente.

Messaggi segnalati da DBCC per il controllo di convalida del cubo

Executing the query ...  
READS, 0  
READ_KB, 0  
WRITES, 0  
WRITE_KB, 0  
CPU_TIME_MS, 0  
ROWS_SCANNED, 0  
ROWS_RETURNED, 0  
  
<DBCC xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
<Object>  
<DatabaseID>AdventureWorksDW2014Multidimensional-EE</DatabaseID>  
<CubeID>Adventure Works</CubeID>  
</Object>  
</DBCC>  
Started checking segment indexes for the 'Internet_Sales_2011' partition.  
Started checking segment indexes for the 'Internet_Sales_2012' partition.  
Finished checking segment indexes for the 'Internet_Sales_2011' partition.  
Started checking segment indexes for the 'Internet_Sales_2013' partition.  
Finished checking segment indexes for the 'Internet_Sales_2012' partition.  
Started checking segment indexes for the 'Internet_Sales_2014' partition.  
Started checking segment indexes for the 'Internet_Orders_2011' partition.  
Finished checking segment indexes for the 'Internet_Sales_2014' partition.  
Started checking segment indexes for the 'Internet_Orders_2012' partition.  
Started checking segment indexes for the 'Internet_Orders_2013' partition.  
Finished checking segment indexes for the 'Internet_Orders_2012' partition.  
...   
Run complete  
  

Output generato dall'esecuzione di DBCC in una versione precedente di Analysis Services

DBCC è supportato solo nei database in esecuzione in un'istanza di SQL Server 2017. L'esecuzione del comando in sistemi precedenti restituirà questo errore.

Executing the query ...  
The DBCC element at line 7, column 87 (namespace http://schemas.microsoft.com/analysisservices/2003/engine) cannot appear under Envelope/Body/Execute/Command.  
Execution complete  
  

Output DBCC di traccia in SQL Server Profiler

È possibile visualizzare l'output di DBCC in una traccia di Profiler che include gli eventi Progress Report, ovvero Progress Report Begin, Progress Report Current, Progress Report End e Progress Report Error.

1. Avviare una traccia. Per informazioni su come usare SQL Server Profiler con Analysis Services, vedere Use SQL Server Profiler to Monitor Analysis Services .

2. Scegliere Command Begin e Command End più alcuni o tutti gli eventi Progress Report .

3. Eseguire il comando DBCC in Management Studio in una finestra di query XMLA o MDX usando la sintassi fornita nella sezione precedente.

4. In SQL Server Profiler l'attività di DBCC è indicata tramite gli eventi Command che hanno una sottoclasse di evento DBCC:

   

   Il codice evento 32 indica l'esecuzione di DBCC.

   Il codice evento 64 è un report di stato di DBCC per singoli oggetti.

   Il codice evento 63 indica un controllo di segmento per gli oggetti multidimensionali.

   Per entrambe le sottoclassi di evento esaminare i valori TextData per i messaggi restituiti da DBCC.

   I messaggi di stato iniziano con "Verifica coerenza dell'oggetto<" , "Inizio controllo dell'oggetto>" o "Oggetto>> controllo <<completato".

   Nota

   Nella versione CTP 3.0 gli oggetti vengono identificati da nomi interni. Ad esempio, una gerarchia categorie è articolata come H$Categories-objectID<>. In una futura versione di CTP i nomi interni verranno sostituiti da nomi descrittivi.

   I messaggi di errore sono elencati di seguito.

Tracciare l'output di DBCC in una sessione xEvent in SSMS

Le sessioni di eventi estesi possono usare sia eventi del profiler che XEvent. Vedere la sezione precedente per istruzioni sull'aggiunta degli eventi Command e Progress Report .

1. Avviare una sessione facendo clic con il pulsante destro delmouse su una sessionedi eventi>> estesi di gestione> del database> Nuova sessione. Per altre informazioni, vedere Monitorare Analysis Services con eventi estesi SQL Server.

2. Scegliere uno o tutti gli eventi Progress Report per la categoria di eventi del profiler o eventi RequestProgress per la categoria PureXevent.

3. Eseguire il comando DBCC in Management Studio in una finestra di query XMLA o MDX usando la sintassi fornita nella sezione precedente.

4. In SSMS aggiornare la cartella Sessioni. Fare clic con il pulsante destro del mouse sul nome > della sessione Watch Live Data (Controlla dati live).

5. Esaminare i valori TextData per i messaggi restituiti da DBCC. TextData è una proprietà di un campo evento e mostra i messaggi di errore e di stato restituiti dall'evento.

   I messaggi di stato iniziano con "Verifica coerenza dell'oggetto<" , "Inizio controllo dell'oggetto>" o "Oggetto>> controllo <<completato".

   I messaggi di errore sono elencati di seguito.

Riferimento: Verifiche di coerenza ed errori per i database multidimensionali

Per i database multidimensionali, vengono convalidati solo gli indici di partizione. Durante l'esecuzione DBCC crea un indice temporaneo per ogni partizione e lo confronta con l'indice persistente su disco. La creazione di un indice temporaneo richiede la lettura di tutti i dati dalle partizioni su disco e quindi il mantenimento dell'indice temporaneo in memoria per il confronto. Dato il carico di lavoro aggiuntivo, nel server potrebbe verificarsi una quantità di I/O su disco e un consumo di memoria significativi durante un'esecuzione di DBCC.

Il rilevamento del danneggiamento dell'indice multidimensionale include i controlli seguenti. Gli errori in questa tabella sono visualizzati nelle tracce xEvent o di Profiler per gli errori a livello di oggetto.

Riferimento: Verifiche di coerenza ed errori per i database tabulari

Nella tabella seguente sono elencati tutti i controlli di coerenza eseguiti su oggetti tabulari, insieme agli errori generati se il controllo indica il danneggiamento. Gli errori in questa tabella sono visualizzati nelle tracce xEvent o di Profiler per gli errori a livello di oggetto.

Risoluzioni comuni per le condizioni di errore

Gli errori seguenti vengono visualizzati in SQL Server Management Studio o nei file msmdsrv.log. Questi errori vengono visualizzati quando uno o più controlli non riescono. A seconda dell'errore, la soluzione consigliata consiste nel rielaborare un oggetto, eliminare e ridistribuire una soluzione o ripristinare il database.

Disabilitare i controlli automatici di coerenza sulle operazioni di caricamento del database

Anche se non è consigliabile, è possibile disabilitare le verifiche di coerenza del database predefinite eseguite automaticamente in presenza di eventi di caricamento del database (solo nei database tabulari). A questo scopo, è necessario modificare un'impostazione di configurazione nel file msmdsrv.ini:

<ConfigurationSettings>  
     <Vertipaq />  
          <DisableConsistencyChecks />  

Questa impostazione non è presente nel file di configurazione e deve essere aggiunta manualmente.

I valori validi sono i seguenti:

• -2 (impostazione predefinita) DBCC è abilitato. Se il server può risolvere logicamente l'errore con un livello elevato di certezza, verrà applicata automaticamente una correzione. In caso contrario, verrà registrato un errore.

• -1 DBCC è parzialmente abilitato. Viene abilitato per RESTORE e per le convalide pre-commit che controllano lo stato del database alla fine di una transazione.

• 0 DBCC è parzialmente abilitato. Vengono eseguite verifiche di coerenza del database durante le operazioni RESTORE, IMAGELOAD, LOCALCUBELOAD e
  ATTACH.

• 1 DBCC è disabilitato. I controlli di integrità dei dati sono disabilitati, tuttavia continueranno a essere eseguiti i controlli di deserializzazione.

Vedi anche

Elaborare database, tabella o partizione (Analysis Services)
Elaborazione di un modello multidimensionale (Analysis Services)
Livello di compatibilità per i modelli tabulari in Analysis Services
Proprietà server in Analysis Services