오류 및 경고 처리(XMLA)

 

적용 대상: SQL Server 2016 Preview

오류 처리는 경우 XML for Analysis (XMLA) 필요 Discover 또는 Execute 메서드 호출이 실행 되지 않습니다, 성공적으로 실행 하지만 오류 또는 경고가 생성 또는 성공적으로 실행 되었으나 오류가 포함 된 결과 반환 합니다.

오류보고
XMLA 메서드 호출이 실행되지 않음MicrosoftSQL Server Analysis Services 오류의 세부 정보가 포함 된 SOAP 오류 메시지를 반환 합니다.

자세한 내용은 섹션을 참조 SOAP 오류 해결합니다.
메서드 호출이 성공적으로 실행되었으나 오류 또는 경고 발생Analysis Services포함는 오류 또는 경고 각 오류 또는 경고에 대 한 요소에서 각각의 메시지 속성은 루트 메서드 호출의 결과 포함 하는 요소입니다.

자세한 내용은 섹션을 참조 오류 및 경고 처리합니다.
메서드 호출이 성공적으로 실행되었으나 결과에 오류가 있음Analysis Services인라인 오류 또는 경고 요소 오류 또는 경고에 대 한 적절 한 내에서 각각 또는 메서드 호출의 결과의 요소입니다.

자세한 내용은 섹션을 참조 인라인 오류 및 경고합니다.

Analysis Services에서 SOAP 오류가 반환되는 경우는 다음과 같습니다.

  • XMLA 메서드가 포함된 SOAP 메시지가 올바른 형식이 아니거나 Analysis Services 인스턴스에서 해당 메시지의 유효성을 확인할 수 없는 경우

  • XMLA 메서드가 포함된 SOAP 메시지와 관련된 통신 또는 기타 오류가 발생한 경우

  • XMLA 메서드가 Analysis Services 인스턴스에서 실행되지 않은 경우

XMLstartA에 대한 SOAP 오류 코드는 "XMLForAnalysis"로 시작하며 그 뒤에 마침표와&16;진수 HRESULT 결과 코드가 붙습니다. 예를 들어 오류 코드 "0x80000005"는 "XMLForAnalysis.0x80000005"가 됩니다. SOAP 오류 형식에 대한 자세한 내용은 W3C SOAP(Simple Object Access Protocol) 1.1에서 Soap Fault를 참조하십시오.

오류 코드 정보

다음 표에서는 SOAP 응답의 세부 정보 섹션에 포함된 XMLA 오류 코드 정보를 보여 줍니다. 열은 SOAP 오류의 세부 정보 섹션에 포함된 오류의 특성을 나타냅니다.

열 이름유형DescriptionNull 허용 여부1
오류 코드UnsignedInt메서드의 성공 또는 실패를 나타내는 코드를 반환합니다. 16 진수 값으로 변환 해야는 UnsignedInt 값입니다.아니오
WarningCodeUnsignedInt경고 조건을 나타내는 코드를 반환합니다. 16 진수 값으로 변환 해야는 UnsignedInt 값입니다.
설명문자열오류가 발생한 구성 요소에서 반환한 오류 또는 경고에 대한 텍스트와 설명입니다.
소스문자열오류 또는 경고가 발생한 구성 요소의 이름입니다.
도움말 파일문자열오류 또는 경고를 설명하는 도움말 파일 또는 항목의 경로 또는 URL입니다.

1 있는지 여부를 반환 해야 하는 데이터가 필요 또는 데이터는 선택 사항 하 고 열에 적용 되지 않는 경우 null 문자열이 허용 되 나타냅니다.

다음은 메서드 호출이 실패했을 때 발생하는 SOAP 오류 예입니다.

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

Analysis Services반환 된 메시지 속성에는 루트 명령 실행 후 다음과 같은 상황에서 발생할 경우 명령에 대 한 요소:

  • 메서드 자체는 실패하지 않았지만 메서드가 성공적으로 호출된 후 Analysis Services 인스턴스에서 오류가 발생한 경우

  • 명령을 성공적으로 실행했지만 Analysis Services 인스턴스에서 경고를 반환한 경우

메시지 속성에 포함 된 다른 모든 속성을 따릅니다는 루트 요소를 하나 이상 포함 될 수 있습니다 메시지 요소입니다. 각 메시지 는 단일 요소를 포함할 수 오류 또는 경고 지정된 된 명령에 대해 발생 한 오류 또는 경고를 각각 설명 하는 요소입니다.

에 포함 되어 있는 오류 및 경고에 대 한 자세한 내용은 메시지 속성 참조 메시지 요소 (XMLA)합니다.

직렬화 중 오류 해결

한 후 오류가 발생 하는 경우는 Analysis Services 인스턴스가 이미 시작 된 성공적으로 실행 한 명령의 출력을 직렬화 Analysis Services 반환는 예외 오류 지점에서 다른 네임 스페이스의 요소입니다. 그러면 Analysis Services 인스턴스는 클라이언트에 보낸 XML 문서가 유효한 문서가 되도록 열려 있는 요소를 모두 닫습니다. 인스턴스는 또한 반환는 메시지 오류에 대 한 설명을 포함 하는 요소입니다.

Analysis Services인라인 반환 오류 또는 경고 XMLA 메서드 자체는 실패 하지 않았지만 하지만 메서드에 의해 반환 된 결과의 데이터 요소에 특정 오류가 발생 하는 경우 명령에 대 한는 Analysis Services XMLA 메서드 호출이 성공적으로 실행 한 후 인스턴스.

Analysis Services인라인 제공 오류경고 요소는 다른 데이터 또는 셀과 관련 문제 내에 포함 된는 루트 요소를 사용 하는 MDDataSet 보안 오류 또는 셀 형식 지정 오류와 같은 데이터 형식에 발생 합니다. 이러한 경우 Analysis Services 반환는 오류 또는 경고 요소에는 또는 오류 또는 경고를 각각 포함 된 요소입니다.

다음 예제에서는 결과 집합에서 반환 된 행 집합의 오류를 포함 하는 Execute 메서드를 사용 하 여는 문을 명령 합니다.

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

Analysis Services에서 XMLA를 사용 하 여 개발

커뮤니티 추가 항목

표시: