다음을 통해 공유

런타임에 OData 원본 쿼리 제공

  • 아티클

적용 대상: SQL Server Azure Data Factory의 SSIS Integration Runtime

데이터 흐름 태스크의 [OData Source].[Query] 속성에 식을 추가하여 런타임에 OData 원본 쿼리를 수정할 수 있습니다.

반환되는 열은 디자인 타임에 반환된 열과 동일해야 합니다. 그렇지 않으면 패키지가 실행될 때 오류가 발생합니다. $select 쿼리 옵션을 사용할 때 동일한 열(동일한 순서)을 지정해야 합니다. $select 옵션을 사용하는 것보다 안전한 방법은 원본 구성 요소 UI에서 직접 원하지 않는 열의 선택을 취소하는 것입니다.

런타임에 쿼리 값을 동적으로 설정하는 몇 가지 다른 방법이 있습니다. 다음은 몇 가지 일반적인 방법입니다.

쿼리를 매개 변수로 제공

다음 절차에서는 OData 원본 구성 요소에서 사용하는 쿼리를 패키지의 매개 변수로 노출하는 방법을 보여줍니다.

  1. 데이터 흐름 태스크를 마우스 오른쪽 단추로 클릭하고 매개 변수화…옵션을 선택합니다.

  2. 매개 변수화 대화 상자에서 속성에 대한 [<OData 원본 구성 요소 이름>].[Query]를 선택합니다.

  3. 새 매개 변수를 생성하거나 기존 매개 변수를 사용할지 선택합니다.

  4. 새 매개 변수 만들기를 선택하는 경우:

    1. 매개 변수의 이름과 설명을 입력합니다.

    2. 매개 변수의 기본값을 지정합니다.

    3. 매개 변수의 범위 (패키지 또는 프로젝트)를 지정합니다.

    4. 매개 변수가 필요한지 여부를 지정합니다.

  5. 확인 을 클릭하여 대화 상자를 닫습니다.

쿼리에 식 제공

이 방법은 런타임에 쿼리 문자열을 동적으로 생성하려는 경우에 유용합니다.

  1. OData 원본이 포함된 데이터 흐름 태스크를 선택합니다.

  2. 속성 창에서 식 속성을 강조 표시합니다.

  3. ...(줄임표) 버튼을 클릭하여 속성 식 편집기를 불러옵니다.

  4. [OData Source].[Query] 속성을 선택하세요.

  5. 식의 ...(줄임표) 버튼을 클릭합니다.

  6. 식을 입력합니다.

  7. 확인을 클릭합니다.

참고 항목

이 접근 방식을 사용할 때는 설정한 값이 올바르게 URL 인코딩되었는지 확인해야 합니다. 사용자 입력에서 값을 받을 때(예: 매개 변수에서 개별 쿼리 옵션 값 설정) 잠재적인 SQL 삽입 형식 공격을 방지하기 위해 값의 유효성을 검사해야 합니다.