오류 및 경고 처리(XMLA)Handling Errors and Warnings (XMLA)

오류 처리는 필요한 경우 XML for Analysis (XMLA) Discover 또는 Execute 메서드 호출이 실행 되지 않습니다, 성공적으로 실행 하지만 오류 또는 경고를 생성 또는 성공적으로 실행 되지만 결과 반환 오류가 있습니다.Error handling is required when an XML for Analysis (XMLA) Discover or Execute method call does not run, runs successfully but generates errors or warnings, or runs successfully but returns results that contain errors.

오류Error 보고Reporting
XMLA 메서드 호출이 실행되지 않음The XMLA method call does not run MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services 오류의 세부 정보가 포함 된 SOAP 오류 메시지를 반환 합니다.returns a SOAP fault message that contains the details of the failure.

자세한 내용은 섹션을 참조 하십시오. SOAP 오류 해결합니다.For more information, see the section, Handling SOAP Faults.
메서드 호출이 성공적으로 실행되었으나 오류 또는 경고 발생Errors or warnings on a successful method call Analysis ServicesAnalysis Services 포함는 오류 또는 경고 각 오류 또는 경고에 대 한 요소에서 각각의 메시지 의 속성은 루트 요소 메서드 호출 결과가 들어 있는입니다.includes an error or warning element for each error or warning, respectively, in the Messages property of the root element that contains the results of the method call.

자세한 내용은 섹션을 참조 하십시오. 오류 및 경고 처리합니다.For more information, see the section, Handling Errors and Warnings.
메서드 호출이 성공적으로 실행되었으나 결과에 오류가 있음Errors in the result for a successful method call Analysis ServicesAnalysis Services 인라인 오류 또는 경고 요소 오류 또는 경고에 대 한 적절 한 내에서 각각 또는 메서드 호출의 결과의 요소입니다.includes an inline error or warning element for the error or warning, respectively, within the appropriate Cell or row element of the results of the method call.

자세한 내용은 섹션을 참조 하십시오. 인라인 오류 및 경고합니다.For more information, see the section, Handling Inline Errors and Warnings.

SOAP 오류 해결Handling SOAP Faults

Analysis ServicesAnalysis Services 다음과 같은 경우 발생 하는 경우 SOAP 오류를 반환 합니다.returns a SOAP fault when the following situations occur:

  • XMLA 메서드가 포함된 SOAP 메시지가 올바른 형식이 아니거나 Analysis ServicesAnalysis Services 인스턴스에서 해당 메시지의 유효성을 확인할 수 없는 경우The SOAP message that contains the XMLA method was not well-formed or could not be validated by the Analysis ServicesAnalysis Services instance.

  • XMLA 메서드가 포함된 SOAP 메시지와 관련된 통신 또는 기타 오류가 발생한 경우A communications or other error occurred involving the SOAP message that contains the XMLA method.

  • XMLA 메서드가 Analysis ServicesAnalysis Services 인스턴스에서 실행되지 않은 경우The XMLA method did not run on the Analysis ServicesAnalysis Services instance.

    XMLstartA에 대한 SOAP 오류 코드는 "XMLForAnalysis"로 시작하며 그 뒤에 마침표와 16진수 HRESULT 결과 코드가 붙습니다.The SOAP fault codes for XMLstartA start with "XMLForAnalysis", followed by a period and the hexadecimal HRESULT result code. 예를 들어 오류 코드 "0x80000005"는 "XMLForAnalysis.0x80000005"가 됩니다.For example, an error code of "0x80000005" is formatted as "XMLForAnalysis.0x80000005". SOAP 오류 형식에 대한 자세한 내용은 W3C SOAP(Simple Object Access Protocol) 1.1에서 Soap Fault를 참조하십시오.For more information about the SOAP fault format, see Soap Fault in the W3C Simple Object Access Protocol (SOAP) 1.1.

오류 코드 정보Fault Code Information

다음 표에서는 SOAP 응답의 세부 정보 섹션에 포함된 XMLA 오류 코드 정보를 보여 줍니다.The following table shows the XMLA fault code information that is contained in the detail section of the SOAP response. 열은 SOAP 오류의 세부 정보 섹션에 포함된 오류의 특성을 나타냅니다.The columns are the attributes of an error in the detail section of a SOAP fault.

열 이름Column name 유형Type DescriptionDescription Null 허용1Null allowed1
ErrorCodeErrorCode UnsignedIntUnsignedInt 메서드의 성공 또는 실패를 나타내는 코드를 반환합니다.Return code that indicates the success or failure of the method. 16 진수 값으로 변환 해야는 UnsignedInt 값입니다.The hexadecimal value must be converted to an UnsignedInt value. 아니요No
WarningCodeWarningCode UnsignedIntUnsignedInt 경고 조건을 나타내는 코드를 반환합니다.Return code that indicates a warning condition. 16 진수 값으로 변환 해야는 UnsignedInt 값입니다.The hexadecimal value must be converted to an UnsignedInt value. Yes
설명Description 문자열String 오류가 발생한 구성 요소에서 반환한 오류 또는 경고에 대한 텍스트와 설명입니다.Error or warning text and description returned by the component that generated the error. Yes
원본Source 문자열String 오류 또는 경고가 발생한 구성 요소의 이름입니다.Name of the component that generated the error or warning. Yes
HelpFileHelpFile 문자열String 오류 또는 경고를 설명하는 도움말 파일 또는 항목의 경로 또는 URL입니다.Path or URL to the Help file or topic that describes the error or warning. Yes

1 고 여부를 나타내는 데이터 필수 항목이 며 반환 되어야 합니다 또는 여부는 데이터는 없어도 열 적용 되지 않는 경우 null 문자열은 사용할 수 있습니다.1 Indicates whether the data is required and must be returned, or whether the data is optional and a null string is allowed if the column does not apply.

다음은 메서드 호출이 실패했을 때 발생하는 SOAP 오류 예입니다.The following is an example of a SOAP fault that occurred when a method call failed:

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

오류 및 경고 처리Handling Errors and Warnings

Analysis ServicesAnalysis Services 반환 된 메시지 속성에는 루트 명령 실행 후 다음과 같은 경우 발생 하는 경우 명령에 대 한 요소:returns the Messages property in the root element for a command if the following situations occur after that command runs:

  • 메서드 자체는 실패하지 않았지만 메서드가 성공적으로 호출된 후 Analysis ServicesAnalysis Services 인스턴스에서 오류가 발생한 경우The method itself did not fail, but a failure occurred on the Analysis ServicesAnalysis Services instance after the method call succeeded.

  • 명령을 성공적으로 실행했지만 Analysis ServicesAnalysis Services 인스턴스에서 경고를 반환한 경우The Analysis ServicesAnalysis Services instance returns a warning when the command is successful.

    메시지 속성 뒤에 포함 된 다른 모든 속성의 루트 요소를 하나 이상 포함 될 수 있습니다 및 메시지 요소.The Messages property follows all other properties that are contained by the root element, and can contain one or more Message elements. 메시지 요소는 단일을 포함할 수 있습니다 오류 또는 경고 동안 발생 한 오류 또는 경고를 각각 설명 하는 요소는 지정 된 명령입니다.In turn, each Message element can contain either a single error or warning element describing any errors or warnings, respectively, that occurred for the specified command.

    오류 및에 포함 된 경고에 대 한 자세한 내용은 메시지 속성 참조 메시지 요소 ( XMLA ) .For more information about errors and warnings that are contained in the Messages property, see Messages Element (XMLA).

직렬화 중 오류 해결Handling Errors During Serialization

한 후 오류가 발생 하는 경우는 Analysis ServicesAnalysis Services 인스턴스가 이미 성공적으로 실행된 된 명령의 출력을 직렬화 하는 작업 시작 Analysis ServicesAnalysis Services 반환는 예외 오류 지점에서 다른 네임 스페이스의 요소입니다.If an error occurs after the Analysis ServicesAnalysis Services instance has already begun serializing the output of a successfully run command, Analysis ServicesAnalysis Services returns an Exception element in a different namespace at the point of the error. 그러면 Analysis ServicesAnalysis Services 인스턴스는 클라이언트에 보낸 XML 문서가 유효한 문서가 되도록 열려 있는 요소를 모두 닫습니다.The Analysis ServicesAnalysis Services instance then closes all open elements so that the XML document sent to the client is a valid document. 인스턴스도 반환 합니다.는 메시지 의 오류 설명을 포함 하는 요소입니다.The instance also returns a Messages element that contains the description of the error.

인라인 오류 및 경고 처리Handling Inline Errors and Warnings

Analysis ServicesAnalysis Services 인라인 반환 오류 또는 경고 XMLA 메서드 자체는 실패 하지 않았지만 하지만에서 메서드에 의해 반환 된 결과의 데이터 요소에 특정 오류가 발생 하는 경우 명령에 대 한는 Analysis ServicesAnalysis Services XMLA 메서드 호출에 성공 후 인스턴스입니다.returns an inline error or warning for a command if the XMLA method itself did not fail, but an error specific to a data element in the results returned by the method occurred on the Analysis ServicesAnalysis Services instance after the XMLA method call succeeded.

Analysis ServicesAnalysis Services 인라인 제공 오류경고 는 문제 관련 하 여 셀 또는 다른 데이터 요소 내에 포함 된 한 루트 사용 하 여 요소는 MDDataSet 보안 오류 또는 셀 형식 지정 오류와 같은 데이터 형식 발생 합니다.supplies inline error and warning elements if issues specific to a cell or to other data that are contained within a root element using the MDDataSet data type occur, such as a security error or formatting error for a cell. 이러한 경우 Analysis ServicesAnalysis Services 반환는 오류 또는 경고 요소에는 또는 오류를 포함 하는 요소 또는 경고, 각각.In these cases, Analysis ServicesAnalysis Services returns an error or warning element in the Cell or row element that contains the error or warning, respectively.

다음 예제에서는 결과 집합에서 반환 된 행 집합의 오류를 포함 하는 Execute 메서드를 사용 하 여는 문을 명령입니다.The following example illustrates a result set that contains an error in the rowset returned from an Execute method using the Statement command.

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

관련 항목:See Also

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