Gestione di errori e avvisi (XMLA)

Articolo
2023-05-08

La gestione degli errori è necessaria quando una chiamata al metodo Discover o Execute XML for Analysis (XMLA) non viene eseguita, viene eseguita correttamente, ma genera errori o avvisi oppure viene eseguita correttamente, ma restituisce risultati contenenti errori.

Errore	Creazione di report
Chiamata al metodo XMLA non eseguita	Microsoft SQL Server SQL Server Analysis Services restituisce un messaggio di errore SOAP contenente i dettagli dell'errore. Per altre informazioni, vedere la sezione Gestione degli errori SOAP.
Errori o avvisi in una chiamata al metodo eseguita correttamente	SQL Server Analysis Services include rispettivamente un elemento di errore o avviso per ogni errore o avviso nella proprietà Messages dell'elemento radice che contiene i risultati della chiamata al metodo. Per altre informazioni, vedere la sezione Gestione degli errori e degli avvisi.
Errori nel risultato di una chiamata al metodo eseguita correttamente	SQL Server Analysis Services include rispettivamente un errore inline o un elemento di avviso per l'errore o l'avviso all'interno dell'elemento Cell o row appropriato dei risultati della chiamata al metodo. Per altre informazioni, vedere la sezione Gestione degli errori e degli avvisi inline.

Gestione di errori SOAP

SQL Server Analysis Services restituisce un errore SOAP quando si verificano le situazioni seguenti:

Il messaggio SOAP contenente il metodo XMLA non è stato formato correttamente o non è stato possibile convalidare dall'istanza di SQL Server Analysis Services.
Si è verificato un errore di comunicazione o di altro tipo relativo al messaggio SOAP che contiene il metodo XMLA.
Il metodo XMLA non è stato eseguito nell'istanza di SQL Server Analysis Services.

Il codice di errore SOAP per XMLstartA inizia con "XMLForAnalysis", seguito da un punto e dal codice esadecimale restituito HRESULT. Un codice di errore "0x80000005" viene formattato come "XMLForAnalysis.0x80000005". Per ulteriori informazioni sul formato degli errori SOAP, vedere l'argomento relativo nel documento Simple Object Access Protocol (SOAP) 1.1 del World Wide Web Consortium (W3C).

Informazioni sul codice di errore

Nella tabella seguente vengono elencate le informazioni sul codice di errore XMLA contenute nella sezione dei dettagli della risposta SOAP. Le colonne rappresentano gli attributi di un errore nella sezione dei dettagli di un errore SOAP.

Nome colonna	Type	Descrizione	Null consentito¹
ErrorCode	UnsignedInt	Codice restituito che indica l'esito positivo o negativo del metodo. Il valore esadecimale deve essere convertito in un valore UnsignedInt .	No
WarningCode	UnsignedInt	Codice restituito che indica una condizione di avviso. Il valore esadecimale deve essere convertito in un valore UnsignedInt .	Sì
Descrizione	Stringa	Testo o descrizione dell'errore o dell'avviso restituiti dal componente che ha generato l'errore.	Sì
Origine	Stringa	Nome del componente che ha generato l'errore o l'avviso.	Sì
Helpfile	Stringa	Percorso o URL del file o dell'argomento della Guida in cui è descritto l'errore o l'avviso.	Sì

¹ Indica se i dati sono obbligatori e devono essere restituiti oppure se i dati sono facoltativi e se è consentita una stringa Null se la colonna non è applicabile.

Di seguito viene riportato un esempio di errore SOAP che si è verificato quando una chiamata al metodo non è riuscita:

<?xml version="1.0"?>  
   <SOAP-ENV:Envelope  
   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
   SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">  
      <SOAP-ENV:Fault>  
         <faultcode>XMLAnalysisError.0x80000005</faultcode>  
         <faultstring>The XML for Analysis provider encountered an error.</faultstring>  
         <faultactor>XML for Analysis Provider</faultactor>  
         <detail>  
<Error  
ErrorCode="2147483653"  
Description="An unexpected error has occurred."  
Source="XML for Analysis Provider"  
HelpFile="" />  
         </detail>  
      </SOAP-ENV:Fault>  
</SOAP-ENV:Envelope>

Gestione di errori e avvisi

SQL Server Analysis Services restituisce la proprietà Messages nell'elemento radice di un comando se si verificano le situazioni seguenti dopo l'esecuzione di tale comando:

Il metodo stesso non ha avuto esito negativo, ma si è verificato un errore nell'istanza di SQL Server Analysis Services dopo che la chiamata al metodo è riuscita.
L'istanza di SQL Server Analysis Services restituisce un avviso quando il comando ha esito positivo.

La proprietà Messages segue tutte le altre proprietà contenute nell'elemento radice e può contenere uno o più elementi Message . A sua volta, ogni elemento Message può contenere un singolo errore o un singolo elemento di avviso che descrive rispettivamente eventuali errori o avvisi che si sono verificati per il comando specificato.

Per altre informazioni sugli errori e gli avvisi contenuti nella proprietà Messages, vedere Elemento Messages (XMLA).For more information about errors and warnings that are contained in the Messages property, see Messages Element (XMLA).

Gestione di errori durante la serializzazione

Se si verifica un errore dopo che l'istanza di SQL Server Analysis Services ha già iniziato a serializzare l'output di un comando eseguito correttamente, SQL Server Analysis Services restituisce un elemento Exception in uno spazio dei nomi diverso al momento dell'errore. L'istanza di SQL Server Analysis Services quindi chiude tutti gli elementi aperti in modo che il documento XML inviato al client sia un documento valido. L'istanza restituisce anche un elemento Messages che contiene la descrizione dell'errore.

Gestione di errori e avvisi inline

SQL Server Analysis Services restituisce un errore o un avviso inline per un comando se il metodo XMLA stesso non ha avuto esito negativo, ma un errore specifico di un elemento dati nei risultati restituiti dal metodo si è verificato nell'istanza di SQL Server Analysis Services dopo che la chiamata al metodo XMLA ha avuto esito positivo.

SQL Server Analysis Services fornisce elementi diavviso e di errore inline se si verificano problemi specifici di una cella o di altri dati contenuti all'interno di un elemento radice usando il tipo di dati MDDataSet, ad esempio un errore di sicurezza o un errore di formattazione per una cella. In questi casi, SQL Server Analysis Services restituisce un errore o un elemento di avviso nell'elemento Cell o row che contiene rispettivamente l'errore o l'avviso.

Nell'esempio seguente viene illustrato un set di risultati contenente un errore nel set di righe restituito da un metodo Execute usando il comando Statement .

<return>  
   ...  
   <root>  
      ...  
      <CellData>  
      ...  
         <Cell CellOrdinal="10">  
            <Value>  
               <Error>  
                  <ErrorCode>2148497527</ErrorCode>   
                  <Description>Security Error.</Description>   
               </Error>  
            </Value>  
         </Cell>  
      </CellData>  
      ...  
   </root>  
   ...  
</return>

Vedere anche

Sviluppo con XMLA in Analysis Services

Condividi tramite