Excel 대상Excel Destination

Excel 대상은 MicrosoftMicrosoft Excel 통합 문서의 워크시트 또는 범위로 데이터를 로드합니다.The Excel destination loads data into 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 대상은 데이터 로드를 위한 3가지 데이터 액세스 모델을 제공합니다.The Excel destination provides three different data access modes for loading 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.

Excel 대상 구성Configure the Excel Destination

Excel 대상은 Excel 연결 관리자를 사용하여 데이터 원본에 연결하며 연결 관리자가 사용할 통합 문서 파일을 지정합니다.The Excel destination 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 destination has one regular input and one error output.

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 Destination Editor (Connection Manager Page)

Excel 대상 편집기 대화 상자의 연결 관리자 페이지를 사용하여 데이터 원본 정보를 지정하고 그 결과를 미리 볼 수 있습니다.Use the Connection Manager page of the Excel Destination Editor dialog box to specify data source information, and to preview the results. Excel 대상은 데이터를 워크시트 또는 Microsoft ExcelMicrosoft Excel Excel 통합 문서의 명명된 범위로 로드합니다.The Excel destination loads data into a worksheet or a named range in a Microsoft ExcelMicrosoft Excel workbook.

참고

Excel 대상의 CommandTimeout 속성은 Excel 대상 편집기에서 사용할 수 없지만 고급 편집기를 사용하여 설정할 수 있습니다.The CommandTimeout property of the Excel destination is not available in the Excel Destination Editor, but can be set by using the Advanced Editor. 또한 특정 빠른 로드 옵션은 고급 편집기에서만 사용할 수 있습니다.In addition, certain Fast Load options are available only in the Advanced Editor. 이러한 속성에 대한 자세한 내용은 Excel Custom Properties의 Excel 대상 섹션을 참조하십시오.For more information on these properties, see the Excel Destination section of Excel Custom Properties.

정적 옵션Static Options

Excel 연결 관리자Excel 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.

옵션Option 설명Description
테이블 또는 뷰Table or view 데이터를 워크시트 또는 Excel 데이터 원본의 명명된 범위로 로드합니다.Loads data into a worksheet or named range in the Excel data source.
테이블 이름 또는 뷰 이름 변수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 대상으로 데이터를 로드합니다.Load data into the Excel destination by using an SQL query.

Excel 시트의 이름Name of the Excel sheet
드롭다운 목록에서 Excel 대상을 선택합니다.Select the excel destination from the drop-down list. 목록이 비어 있는 경우 새로 만들기를 클릭합니다.If the list is empty, click New.

새로 만들기New
새로 만들기 를 클릭하여 테이블 만들기 대화 상자를 시작합니다.Click New to launch the Create Table dialog box. 확인을 클릭하면 대화 상자에서 Excel 연결 관리자 가 가리키는 Excel 파일이 만들어집니다.When you click OK, the dialog box creates the excel file that the Excel Connection Manager points to.

기존 데이터 보기View Existing Data
쿼리 결과 미리 보기 대화 상자를 사용하여 결과를 미리 봅니다.Preview results by using the Preview Query Results 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
데이터 원본에서 사용할 수 있는 워크시트 또는 명명된 범위 목록에서 이름을 선택합니다.Select the name of the worksheet or named range from a list of those available in the data source.

데이터 액세스 모드 = 테이블 이름 또는 뷰 이름 변수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 an SQL query, build the query by clicking Build Query, or locate the file that contains the query text by clicking Browse.

쿼리 작성Build 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.

Excel 대상 편집기(매핑 페이지)Excel Destination Editor (Mappings Page)

Excel 대상 편집기 대화 상자의 매핑 페이지를 사용하여 입력 열을 대상 열에 매핑할 수 있습니다.Use the Mappings page of the Excel Destination Editor dialog box to map input columns to destination columns.

변수Options

사용 가능한 입력 열Available Input Columns
사용 가능한 입력 열 목록을 표시합니다.View the list of available input columns. 끌어서 놓기 작업을 사용하여 테이블에서 사용 가능한 입력 열을 대상 열에 매핑합니다.Use a drag-and-drop operation to map available input columns in the table to destination columns.

사용 가능한 대상 열Available Destination Columns
사용 가능한 대상 열의 목록을 표시합니다.View the list of available destination columns. 끌어서 놓기 작업을 사용하여 테이블에서 사용 가능한 대상 열을 입력 열에 매핑합니다.Use a drag-and-drop operation to map available destination columns in the table to input columns.

입력 열Input Column
위 테이블에서 선택한 입력 열을 표시합니다.View input columns selected from the table above. 사용 가능한 입력 열의 목록을 사용하여 매핑을 변경할 수 있습니다.You can change the mappings by using the list of Available Input Columns.

대상 열Destination Column
매핑 여부에 관계없이 사용 가능한 각 대상 열을 표시합니다.View each available destination column, whether it is mapped or not.

Excel 대상 편집기(오류 출력 페이지)Excel Destination Editor (Error Output Page)

Excel 대상 편집기 대화 상자의 고급 페이지를 사용하여 오류 처리 옵션을 지정할 수 있습니다.Use the Advanced page of the Excel Destination Editor dialog box to specify options for error handling.

변수Options

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

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

참고 항목See Also

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