Excel 원본

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

Excel 원본은 Microsoft Excel 통합 문서의 워크시트 또는 범위에서 데이터를 추출합니다.

Important

Excel 파일 연결 및 Excel 파일에서 데이터를 로드할 때 제한 사항 및 알려진 문제에 대한 자세한 내용은 SSIS(SQL Server Integration Services)를 통해 Excel로 데이터 로드를 참조하세요.

액세스 모드

Excel 원본은 데이터를 추출하기 위한 네 가지 데이터 액세스 모드를 제공합니다.

  • 테이블 또는 뷰

  • 변수에 지정된 테이블 또는 뷰입니다.

  • SQL 문의 결과입니다. 쿼리는 매개 변수가 있는 쿼리일 수 있습니다.

  • 변수에 저장된 SQL 문의 결과

Excel 원본은 Excel 연결 관리자를 사용하여 데이터 원본에 연결하며 연결 관리자가 사용할 통합 문서 파일을 지정합니다. 자세한 내용은 Excel 연결 관리자 참조하세요.

Excel 원본에는 하나의 일반 출력 및 하나의 오류 출력이 있습니다.

Excel 원본 구성

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 모든 속성이 반영됩니다. 고급 편집기 대화 상자를 사용하거나 프로그래밍 방식으로 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하세요.

Excel 파일 그룹을 통한 루핑 방법에 대한 자세한 내용은 Foreach 루프 컨테이너를 사용하여 Excel 파일 및 테이블 루핑을 참조하세요.

Excel 원본 편집기(연결 관리자 페이지)

Excel 원본 편집기 대화 상자의 연결 관리자 노드를 사용하여 원본에 사용할 Microsoft Excel 통합 문서를 선택합니다. Excel 원본은 기존 통합 문서의 워크시트 또는 명명된 범위에서 데이터를 읽습니다.

참고 항목

Excel 원본의 CommandTimeout 속성은 Excel 원본 편집기에서 사용할 수 없지만 고급 편집기 사용하여 설정할 수 있습니다. 이 속성에 대한 자세한 내용은 Excel 사용자 지정 속성의 Excel 원본 섹션을 참조하세요.

정적 옵션

OLE DB 연결 관리자
목록에서 기존 Excel 연결 관리자를 선택하거나 새로 만들기를 클릭하여 새 연결을 만듭니다.

New
Excel 연결 관리자 대화 상자를 사용하여 새 연결 관리자를 만듭니다.

데이터 액세스 모드
원본에서 데이터를 선택하는 방법을 지정합니다.

설명
테이블 또는 뷰 Excel 파일의 워크시트 또는 명명된 범위에서 데이터를 검색합니다.
테이블 이름 또는 뷰 이름 변수 변수에 워크시트 또는 범위 이름을 지정합니다.

관련 정보:패키지에서 변수 사용
SQL 명령 SQL 쿼리를 사용하여 Excel 파일에서 데이터를 가져옵니다.
변수를 사용한 SQL 명령 변수에 SQL 쿼리 텍스트를 지정합니다.

미리 보기
데이터 뷰 대화 상자를 사용하여 결과를 미리 봅니 다. 미리 보기에는 최대 200개의 행이 표시될 수 있습니다.

데이터 액세스 모드 동적 옵션

데이터 액세스 모드 = 테이블 또는 뷰

Excel 시트의 이름
Excel 통합 문서에서 사용할 수 있는 워크시트 또는 명명된 범위의 이름을 선택합니다.

데이터 액세스 모드 = 테이블 이름 또는 뷰 이름 변수

변수 이름
워크시트 또는 명명된 범위 이름이 포함된 변수를 선택합니다.

데이터 액세스 모드 = SQL 명령

SQL 명령 텍스트
SQL 쿼리의 텍스트를 입력하거나, 쿼리 빌드를 클릭하여 쿼리를 작성하거나, 찾아보기를 클릭하여 쿼리 텍스트가 포함된 파일을 찾습니다.

매개 변수
?을 사용하여 매개 변수가 있는 쿼리를 입력한 경우 쿼리 텍스트에서 매개 변수 자리 표시자로 쿼리 매개 변수 설정 대화 상자를 사용하여 쿼리 입력 매개 변수를 패키지 변수에 매핑합니다.

빌드 쿼리
쿼리 작성기 대화 상자를 사용하여 SQL 쿼리를 시각적으로 생성합니다.

찾아보기
열기 대화 상자를 사용하여 SQL 쿼리 텍스트가 포함된 파일을 찾을 수 있습니다.

쿼리 구문 분석
쿼리 텍스트의 구문을 확인합니다.

데이터 액세스 모드 = 변수를 사용한 SQL 명령

변수 이름
SQL 쿼리 텍스트가 포함된 변수를 선택합니다.

Excel 원본 편집기(열 페이지)

Excel 원본 편집기 대화 상자의 페이지를 사용하여 출력 열을 각 외부(원본) 열에 매핑합니다.

옵션

사용 가능한 외부 열
데이터 원본에서 사용 가능한 외부 열 목록을 봅니다. 이 테이블을 사용하여 열을 추가하거나 삭제할 수 없습니다.

외부 열
외부(원본) 열을 작업에서 읽는 순서대로 봅니다. 이 순서는 먼저 위에 설명된 테이블에서 선택된 열을 지운 다음 목록에서 다른 순서로 외부 열을 선택하여 변경할 수 있습니다.

출력 열
각 출력 열에 고유한 이름을 제공합니다. 기본값은 선택한 외부(원본) 열의 이름입니다. 그러나 고유한 설명이 포함된 이름을 선택할 수 있습니다. 제공된 이름은 SSIS 디자이너 내에 표시됩니다.

Excel 원본 편집기(오류 출력 페이지)

Excel 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택하고 오류 출력 열에 속성을 설정할 수 있습니다.

옵션

입력 또는 출력
데이터 원본의 이름을 표시합니다.


Excel 원본 편집기대화 상자의 연결 관리자 페이지에서 선택한 외부(원본) 열을 봅니다.

오류
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

관련 항목:데이터 오류 처리

잘림
잘림이 발생할 때 발생하는 작업을 지정합니다. 오류를 무시하거나 행을 리디렉션하거나 구성 요소를 실패합니다.

설명
오류에 대한 설명을 표시합니다.

이 값을 선택한 셀로 설정
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

적용
선택한 셀에 오류 처리 옵션을 적용합니다.

SSIS(SQL Server Integration Services)를 사용하여 Excel에서 또는 Excel로 데이터 로드
Excel 대상
Excel 연결 관리자