OData 원본OData Source

SSIS 패키지의 OData 원본 구성 요소를 사용하여 Open Data Protocol(OData) 서비스에서 데이터를 사용할 수 있습니다.Use the OData Source component in an SSIS package to consume data from an Open Data Protocol (OData) service. 구성 요소는 OData v3 및 v4 프로토콜을 지원합니다.The component supports the OData v3 and v4 protocols.

  • OData V3 프로토콜의 경우 구성 요소는 ATOM 및 JSON 데이터 형식을 지원합니다.For OData V3 protocol, the component supports the ATOM and JSON data formats.

  • OData V4 프로토콜의 경우 구성 요소는 JSON 데이터 형식을 지원합니다.For OData V4 protocol, the component supports the JSON data format.

OData 원본에는 다음 데이터 원본에 대한 지원이 포함됩니다.The OData source includes support for the following data sources:

  • Microsoft Dynamics AX Online 및 Microsoft Dynamics CRM OnlineMicrosoft Dynamics AX Online and Microsoft Dynamics CRM Online
  • SharePoint 목록SharePoint lists. SharePoint 서버의 모든 목록을 보려면 다음 URL을 사용합니다. http://<server>/_vti_bin/ListData.svcTo see all the lists on a SharePoint server, use the following URL: http://<server>/_vti_bin/ListData.svc. SharePoint URL 규칙에 대한 자세한 내용은 SharePoint Foundation REST 인터페이스를 참조하십시오.For more information about SharePoint URL conventions, see SharePoint Foundation REST Interface.

OData 형식 및 성능OData Format and Performance

대부분의 OData 서비스는 여러 형식으로 결과를 반환할 수 있습니다.Most OData services can return results in multiple formats. $format 쿼리 옵션을 사용하여 결과 집합의 형식을 지정할 수 있습니다.You can specify the format of the result set by using the $format query option. JSON 및 JSON Light와 같은 형식은 ATOM 또는 XML보다 효율적이며 많은 양의 데이터를 전송하는 경우 더 나은 성능을 제공할 수 있습니다.Formats such as JSON and JSON Light are more efficient than ATOM or XML, and may give you better performance when transferring large amounts of data. 다음 표에서는 샘플 테스트의 결과를 제공합니다.The following table provides results from sample tests. 표에 나와 있듯이 ATOM에서 JSON으로 전환하는 경우 성능이 30-53% 향상되었고, ATOM에서 새로운 JSON Light 형식(WCF Data Services 5.1에서 사용 가능)으로 전환하는 경우에는 성능이 67% 향상되었습니다.As you can see, there was a 30-53% performance gain when switching from ATOM to JSON and a 67% performance gain when switching from ATOM to the new JSON light format (available in WCF Data Services 5.1).

Rows ATOMATOM JSONJSON JSON(Light)JSON (Light)
1000010000 113초113 seconds 74초74 seconds 68초68 seconds
10000001000000 1110초1110 seconds 853초853 seconds 665초665 seconds

OData 원본 편집기(연결 페이지)OData Source Editor (Connection Page)

OData 원본 편집기 대화 상자의 연결 페이지를 사용하여 OData 원본의 OData 연결 관리자를 선택할 수 있습니다.Use the Connection page of the OData Source Editor dialog box to select the OData connection manager for the OData source. 또한 이 페이지에서 컬렉션 또는 리소스 경로와 쿼리 옵션을 지정하여 OData 원본에서 검색해야 하는 데이터를 나타낼 수 있습니다.This page also lets you specify a collection or a resource path and any query options to indicate what data needs to be retrieved from the OData source.

정적 옵션Static Options

OData 연결 관리자OData connection manager
목록에서 기존 연결 관리자를 선택하거나 새로 만들기를 클릭하여 새 연결을 만듭니다.Select an existing connection manager from the list, or create a new connection by clicking New.

연결 관리자를 선택하거나 만든 후 대화 상자는 연결 관리자가 사용하는 OData 프로토콜 버전을 표시합니다.After you select or create a connection manager, the dialog box displays the OData protocol version that the connection manager is using.

새로 만들기New
OData 연결 관리자 편집기 대화 상자를 사용하여 새 연결 관리자를 만듭니다.Create a new connection manager by using the OData Connection Manager Editor dialog box.

컬렉션 또는 리소스 경로 사용Use collection or resource path
원본에서 데이터를 선택하는 방법을 지정합니다.Specify the method for selecting data from the source.

옵션Option DescriptionDescription
컬렉션Collection 컬렉션 이름을 사용하여 OData 원본에서 데이터를 검색합니다.Retrieve data from the OData source by using a collection name.
리소스 경로Resource Path 리소스 경로를 사용하여 OData 원본에서 데이터를 검색합니다.Retrieve data from the OData source by using a resource path.

쿼리 옵션Query options
쿼리에 대한 옵션을 지정합니다.Specify options for the query. 예: $top=5For example: $top=5

피드 URLFeed url
이 대화 상자에서 선택한 옵션에 따라 읽기 전용 피드 URL을 표시합니다.Displays the read-only feed URL based on options you selected on this dialog box.

미리 보기Preview
미리 보기 대화 상자를 사용하여 결과를 미리 봅니다.Preview results by using the Preview dialog box. 미리 보기 에는 최대 20개의 행이 표시될 수 있습니다.Preview can display up to 20 rows.

동적 옵션Dynamic Options

컬렉션 또는 리소스 경로 사용 = 컬렉션Use collection or resource path = Collection

컬렉션Collection
드롭다운 목록에서 컬렉션을 선택합니다.Select a collection from the drop-down list.

컬렉션 또는 리소스 경로 사용 = 리소스 경로Use collection or resource path = Resource Path

Resource pathResource path
리소스 경로를 입력합니다.Type a resource path. 예: EmployeesFor example: Employees

OData 원본 편집기(열 페이지)OData Source Editor (Columns Page)

OData 원본 편집기 대화 상자의 페이지를 사용하여 출력에 포함될 외부(원본) 열을 선택하고 출력 열에 매핑할 수 있습니다.Use the Columns page of the OData Source Editor dialog box to select external (source) columns to be included in the output and map them to output columns.

옵션Options

사용 가능한 외부 열Available External Columns
데이터 원본에서 사용 가능한 원본 열의 목록을 표시합니다.View the list of available source columns in the data source. 목록의 확인란을 사용하여 페이지의 아래쪽에 있는 테이블에 열을 추가하거나 제거할 수 있습니다.Use check boxes in the list to add to or remove columns to the table at the bottom of the page. 선택한 열이 출력에 추가됩니다.The selected columns are added to the output.

외부 열External Column
출력에 포함되도록 선택한 원본 열을 표시합니다.View source columns that you chose to be included in the output.

출력 열Output Column
각 출력 열에 고유한 이름을 지정합니다.Provide a unique name for each output column. 기본값은 선택한 외부(원본) 열의 이름이지만 설명이 포함된 고유 이름을 임의로 선택할 수 있습니다.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name.

OData 원본 편집기(오류 출력 페이지)OData Source Editor (Error Output Page)

OData 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택하고 오류 출력 열에 속성을 설정할 수 있습니다.Use the Error Output page of the OData Source Editor dialog box to select error handling options and to set properties on error output columns.

옵션Options

입/출력Input/Output
데이터 원본의 이름을 표시합니다.View the name of the data source.

Column
OData 원본 편집기 대화 상자의 연결 관리자 페이지에서 선택한 외부(원본) 열을 표시합니다.View the external (source) columns that you selected on the Connection Manager page of the OData Source Editor dialog box.

오류Error
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

관련 항목: 데이터 오류 처리Related Topics: Error Handling in Data

잘림Truncation
잘림이 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescriptionDescription
오류에 대한 설명을 표시합니다.View the description of the error.

이 값을 선택한 셀에 설정Set this value to selected cells
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

적용Apply
선택한 셀에 오류 처리 옵션을 적용합니다.Apply the error handling option to the selected cells.

관련 항목:See Also

OData 연결 관리자OData Connection Manager