Excel 원본Excel Source

Excel 원본은 MicrosoftMicrosoft Excel 통합 문서의 워크시트 또는 범위에서 데이터를 추출합니다.The Excel source extracts data from worksheets or ranges in MicrosoftMicrosoft Excel workbooks.

중요

Excel 파일 연결 및 Excel 파일에서 데이터를 로드할 때 제한 사항 및 알려진 문제에 대한 자세한 내용은 SSIS(SQL Server Integration Services)를 통해 Excel로 데이터 로드를 참조하세요.For detailed info about connecting to Excel files, and about limitations and known issues for loading data from or to Excel files, see Load data from or to Excel with SQL Server Integration Services (SSIS).

액세스 모드Access Modes

Excel 원본은 데이터 추출을 위한 4가지 데이터 액세스 모델을 제공합니다.The Excel source provides four different data access modes for extracting data:

  • 테이블 또는 뷰A table or view.

  • 변수에 지정된 테이블 또는 뷰A table or view specified in a variable.

  • SQL 문의 결과The results of an SQL statement. 쿼리는 매개 변수가 있는 쿼리일 수 있습니다.The query can be a parameterized query.

  • 변수에 저장된 SQL 문의 결과The results of an SQL statement stored in a variable.

    Excel 원본은 Excel 연결 관리자를 사용하여 데이터 원본에 연결하며 연결 관리자가 사용할 통합 문서 파일을 지정합니다.The Excel source uses an Excel connection manager to connect to a data source, and the connection manager specifies the workbook file to use. 자세한 내용은 Excel Connection Manager를 참조하세요.For more information, see Excel Connection Manager.

    Excel 원본에는 하나의 일반 출력 및 하나의 오류 출력이 있습니다.The Excel source has one regular output and one error output.

Excel 원본 구성Excel Source Configuration

SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 모든 속성이 표시됩니다.The Advanced Editor dialog box reflects all the properties that can be set programmatically. 고급 편집기 대화 상자를 사용하거나 프로그래밍 방식으로 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하세요.For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

Excel 원본 편집기(연결 관리자 페이지)Excel Source Editor (Connection Manager Page)

Excel 원본 편집기 대화 상자의 연결 관리자 노드를 사용하여 원본으로 사용할 Microsoft ExcelMicrosoft Excel 통합 문서를 선택할 수 있습니다.Use the Connection Manager node of the Excel Source Editor dialog box to select the Microsoft ExcelMicrosoft Excel workbook for the source to use. Excel 원본에서는 워크시트 또는 기존 통합 문서의 명명된 범위에서 데이터를 읽습니다.The Excel source reads data from a worksheet or named range in an existing workbook.

참고

Excel 원본의 CommandTimeout 속성은 Excel 원본 편집기에서 사용할 수 없지만 고급 편집기를 사용하여 설정할 수 있습니다.The CommandTimeout property of the Excel source is not available in the Excel Source Editor, but can be set by using the Advanced Editor. 이 속성에 대한 자세한 내용은 Excel Custom Properties의 Excel 원본 섹션을 참조하십시오.For more information on this property, see the Excel Source section of Excel Custom Properties.

정적 옵션Static Options

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

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

데이터 액세스 모드Data access mode
원본에서 데이터를 선택하는 방법을 지정합니다.Specify the method for selecting data from the source.

Value 설명Description
테이블 또는 뷰Table or view Excel 파일의 워크시트나 명명된 범위에서 데이터를 가져옵니다.Retrieve data from a worksheet or named range in the Excel file.
테이블 이름 또는 뷰 이름 변수Table name or view name variable 변수에 워크시트 또는 범위 이름을 지정합니다.Specify the worksheet or range name in a variable.

관련 정보: 패키지에서 변수 사용Related information: Use Variables in Packages
SQL 명령SQL command SQL 쿼리를 사용하여 Excel 파일에서 데이터를 가져옵니다.Retrieve data from the Excel file by using a SQL query.
변수를 사용한 SQL 명령SQL command from variable 변수에 SQL 쿼리 텍스트를 지정합니다.Specify the SQL query text in a variable.

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

데이터 액세스 모드 동적 옵션Data Access Mode Dynamic Options

데이터 액세스 모드 = 테이블 또는 뷰Data access mode = Table or view

Excel 시트의 이름Name of the Excel sheet
Excel 통합 문서에서 사용할 수 있는 워크시트 또는 명명된 범위 목록에서 이름을 선택합니다.Select the name of the worksheet or named range from a list of those available in the Excel workbook.

데이터 액세스 모드 = 테이블 이름 또는 뷰 이름 변수Data access mode = Table name or view name variable

변수 이름Variable name
워크시트 또는 명명된 범위 이름이 포함된 변수를 선택합니다.Select the variable that contains the name of the worksheet or named range.

데이터 액세스 모드 = SQL 명령Data access mode = SQL command

SQL 명령 텍스트SQL command text
SQL 쿼리 텍스트를 입력하고 쿼리 작성을 클릭하여 쿼리를 작성하거나 찾아보기를 클릭하여 쿼리 텍스트가 포함된 파일을 찾습니다.Enter the text of a SQL query, build the query by clicking Build Query, or browse to the file that contains the query text by clicking Browse.

매개 변수Parameters
쿼리 텍스트에 ?를If you have entered a parameterized query by using ? 매개 변수 자리 표시자로 사용하여 매개 변수가 있는 쿼리를 입력한 경우 쿼리 매개 변수 설정 대화 상자를 사용하여 쿼리 입력 매개 변수를 패키지 변수에 매핑합니다.as a parameter placeholder in the query text, use the Set Query Parameters dialog box to map query input parameters to package variables.

Build queryBuild query
쿼리 작성기 대화 상자를 사용하여 시각적으로 SQL 쿼리를 생성할 수 있습니다.Use the Query Builder dialog box to construct the SQL query visually.

찾아보기Browse
열기 대화 상자를 사용하여 SQL 쿼리 텍스트가 포함된 파일을 찾을 수 있습니다.Use the Open dialog box to locate the file that contains the text of the SQL query.

쿼리 구문 분석Parse query
쿼리 텍스트의 구문을 확인합니다.Verify the syntax of the query text.

데이터 액세스 모드 = 변수를 사용한 SQL 명령Data access mode = SQL command from variable

변수 이름Variable name
SQL 쿼리 텍스트가 포함된 변수를 선택합니다.Select the variable that contains the text of the SQL query.

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

Excel 원본 편집기 대화 상자의 페이지를 사용하여 출력 열을 각 외부(원본) 열에 매핑할 수 있습니다.Use the Columns page of the Excel Source Editor dialog box to map an output column to each external (source) column.

변수Options

사용 가능한 외부 열Available External Columns
데이터 원본에서 사용 가능한 외부 열의 목록을 표시합니다.View the list of available external columns in the data source. 이 테이블을 사용하여 열을 추가하거나 삭제할 수 없습니다.You cannot use this table to add or delete columns.

외부 열External Column
태스크에서 읽는 순서대로 외부(원본) 열을 표시합니다.View external (source) columns in the order in which the task will read them. 이 순서는 먼저 위에 설명된 테이블에서 선택된 열을 지운 다음 목록에서 다른 순서로 외부 열을 선택하여 변경할 수 있습니다.You can change this order by first clearing the selected columns in the table discussed above, and then selecting external columns from the list in a different order.

출력 열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. 제공한 이름은 SSISSSIS 디자이너에 표시됩니다.The name provided will be displayed within SSISSSIS Designer.

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

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

변수Options

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

Column
Excel 원본 편집기 대화 상자의 연결 관리자페이지에서 선택한 외부(원본) 열을 표시합니다.View the external (source) columns that you selected on the Connection Manager page of the Excel Source Editordialog 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.

설명Description
오류에 대한 설명을 표시합니다.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.

SSIS(SQL Server Integration Services)를 통해 Excel에서 데이터 로드Load data from or to Excel with SQL Server Integration Services (SSIS)
Excel 대상Excel Destination
Excel 연결 관리자Excel Connection Manager