Obsługa błędów i ostrzeżeń (XMLA)
Obsługa błędów jest wymagane, gdy XML for Analysis (XMLA) Discover lub Wykonywanie wywołanie metoda nie działa, zostanie wykonane pomyślnie, ale generuje błędy lub ostrzeżenia, lub zostanie wykonane pomyślnie ale zwraca wyniki zawierające błędy.
Błąd |
Zgłoszenie |
|---|---|
Wywołanie metoda XMLA nie działa. |
Microsoft SQL Server Usługi Analysis Services returns a SOAP fault message that contains the details of the failure. Aby uzyskać więcej informacji, zobacz sekcję, Obsługi błędów SOAP. |
Błędy lub ostrzeżenia na wywołanie metoda powiodło się |
Usługi Analysis Serviceszawiera Błąd lub Ostrzeżenie element dla każdego błąd lub ostrzeżenie, odpowiednio, w wiadomości właściwość głównego element zawierający wyniki wywołania metoda. Aby uzyskać więcej informacji, zobacz sekcję, obsługi błędów i ostrzeżeń. |
Błędy w wyniku wywołania metoda powiodło się |
Usługi Analysis Serviceszawiera wbudowanego error lub warning element błąd lub ostrzeżenie, odpowiednio, w odpowiednich komórki lub wiersz element wyniki wywołania metoda. Aby uzyskać więcej informacji, zobacz sekcję, obsługi wbudowanej błędy i ostrzeżenia. |
Obsługa błędów SOAP
Usługi Analysis Services Zwraca błąd protokołu SOAP, gdy występują w następujących sytuacjach:
Wiadomość protokołu SOAP, która zawiera metoda XMLA nie jest poprawnie sformowany lub nie być sprawdzone przez Usługi Analysis Services wystąpienie.
Komunikacja lub inny błąd wystąpił, obejmujących komunikatu SOAP, zawierającą metoda XMLA.
Metoda XMLA nie zostało uruchomione Usługi Analysis Services wystąpienie.
Kody błędów SOAP XMLstartA rozpoczyna się od "XMLForAnalysis", po której następuje kropka i kod szesnastkowy wynik HRESULT.Na przykład, kod błędu "0x80000005"" sformatowane jako "XMLForAnalysis.0x80000005".Aby uzyskać więcej informacji o formacie usterki protokołu SOAP Zobacz błąd protokołu Soap w formacie W3C Simple Object Access Protocol (SOAP) 1.1.
Informacje o kodzie błędu
W poniższej tabela przedstawiono informacje kod usterki XMLA zawarte w sekcji szczegółów odpowiedź protokołu SOAP.Kolumny są atrybuty błąd w sekcji szczegółów błąd protokołu SOAP.
Nazwa kolumny |
Typ |
Opis |
Dozwolone wartości null1 |
|---|---|---|---|
ErrorCode |
UnsignedInt |
Zwraca kod wskazujący, Sukces lub Niepowodzenie metoda.Wartość szesnastkowa należy przekonwertować na UnsignedInt wartości. |
Nie |
WarningCode |
UnsignedInt |
Zwraca kod, który wskazuje stan ostrzeżenia.Wartość szesnastkowa należy przekonwertować na UnsignedInt wartości. |
Tak |
Description |
String |
Błąd lub ostrzeżenie tekstu i opis zwrócony przez składnik, który wygenerował błąd. |
Tak |
Source |
String |
Nazwa składnika, który wygenerował błąd lub ostrzeżenie. |
Tak |
HelpFile |
String |
Ścieżka lub adres URL do pliku pomocy lub tematu, który opisuje błąd lub ostrzeżenie. |
Tak |
1 Wskazuje, czy dane są wymagane i muszą zostać zwrócone lub czy danych jest opcjonalny ciąg null jest dozwolone, jeśli kolumna nie ma zastosowania.
Poniżej przedstawiono przykład błąd protokołu SOAP, który wystąpił podczas wywołania metoda nie powiodło się:
<?xml version="1.0"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="https://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>
Obsługa błędów i ostrzeżeń
Usługi Analysis ServicesZwraca Messages właściwość w root elementu dla polecenia, jeśli w następujących sytuacjach wystąpić po uruchomieniu polecenia:
Samą metoda działał prawidłowo, ale wystąpił błąd w Usługi Analysis Services wystąpienie po pomyślnym wywołanie metoda.
Usługi Analysis Services Wystąpienie zwraca ostrzeżenie, kiedy zakończyło się pomyślnie.
Messages Właściwość następuje wszystkich właściwości, które są zawarte w root element i może zawierać jedną lub więcej Message elementów.Z kolei, każdy Message element może zawierać jeden albo error lub warning element opisujący wszelkie błędy lub ostrzeżenia, odpowiednio, który wystąpił dla określonego polecenia.
Aby uzyskać więcej informacji dotyczących błędów i ostrzeżeń, które są zawarte w Messages właściwość, zobacz Element wiadomości (XMLA).
Obsługa błędów podczas serializacji.
Jeżeli błąd wystąpi po Usługi Analysis Services wystąpienie już się rozpoczęło szeregowania danych wyjściowych polecenia pomyślnie uruchamiać, Usługi Analysis Services zwraca wyjątek element inny obszar nazw w punkcie uderzenia błędu. Usługi Analysis Services Następnie wystąpienie powoduje zamknięcie wszystkich otwartych elementów tak, aby dokument XML wysyłany do klient jest prawidłowy dokument.Zwraca również wystąpienie Messages element, który zawiera opis błędu.
Obsługa wbudowany błędy i ostrzeżenia
Usługi Analysis ServicesZwraca wbudowanego error lub warning polecenia samą metoda XMLA działał prawidłowo, ale wystąpił błąd określonego element danych w wyniki zwróconych przez metoda Usługi Analysis Services wystąpienie po pomyślnym wywołanie metoda XMLA.
Usługi Analysis Servicesdostarcza wbudowane error i warning elementów, jeśli szczególne problemy komórka lub inne dane, które są zawarte w root przy użyciu elementu MDDataSet typ danych występują, takie jak błąd zabezpieczeń lub formatowania komórka.W takich przypadkach Usługi Analysis Services zwraca error lub warning element Cell lub row element, który zawiera błąd lub ostrzeżenie, odpowiednio.
Poniższy przykład ilustruje zestaw wyników zawiera błąd w zestawie zestaw wierszy zwracanych z Execute za pomocą metoda Instrukcja polecenia.
<return>
...
<root>
...
<CellData>
...
<Cell CellOrdinal="10">
<Value>
<Error>
<ErrorCode>2148497527</ErrorCode>
<Description>Security Error.</Description>
</Error>
</Value>
</Cell>
</CellData>
...
</root>
...
</return>
Zobacz także