Excel 대상Excel Destination

Excel 대상은 MicrosoftMicrosoft Excel 통합 문서의 워크시트 또는 범위로 데이터를 로드합니다.The Excel destination loads data into worksheets or ranges in MicrosoftMicrosoft Excel workbooks.

액세스 모드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에서 워크시트나 범위는 테이블 또는 뷰에 해당합니다.In Excel, a worksheet or range is the equivalent of a table or view. Excel 원본 및 대상 편집기의 사용 가능한 테이블 목록은 기존 워크시트(Sheet1$와 같이 워크시트 이름에 $ 기호가 붙음)와 명명된 범위(MyRange와 같이 $ 기호가 없음)만 표시합니다.The lists of available tables in the Excel Source and Destination editors display only existing worksheets (identified by the $ sign appended to the worksheet name, such as Sheet1$) and named ranges (identified by the absence of the $ sign, such as MyRange).

사용 시 고려 사항Usage Considerations

Excel 연결 관리자는 Jet 4.0용 MicrosoftMicrosoft OLE DB Provider와 공급자에서 지원하는 Excel ISAM(Indexed Sequential Access Method) 드라이버를 사용하여 Excel 데이터 원본에 연결하고 데이터를 읽고 씁니다.The Excel Connection Manager uses the MicrosoftMicrosoft OLE DB Provider for Jet 4.0 and its supporting Excel ISAM (Indexed Sequential Access Method) driver to connect and read and write data to Excel data sources.

이 공급자와 드라이버의 동작에 대해 다루는 MicrosoftMicrosoft 기술 자료 문서가 많이 있습니다. 이러한 문서가 Integration ServicesIntegration Services 또는 이전 기능인 데이터 변환 서비스와 반드시 관련된 것은 아니지만 예기치 않은 결과를 발생시킬 수 있는 특정 동작에 대해 살펴보는 것이 좋습니다.Many existing MicrosoftMicrosoft Knowledge Base articles document the behavior of this provider and driver, and although these articles are not specific to Integration ServicesIntegration Services or its predecessor Data Transformation Services, you may want to know about certain behaviors that can lead to unexpected results. Excel 드라이버의 사용 방법과 동작에 대한 일반 정보는 Visual Basic 또는 VBA에서 Excel 데이터에 ADO를 사용하는 방법을 참조하십시오.For general information on the use and behavior of the Excel driver, see HOWTO: Use ADO with Excel Data from Visual Basic or VBA.

Excel 드라이버에 포함된 Jet 공급자의 다음 동작은 데이터를 Excel 대상에 저장할 때 예기치 않은 결과를 초래할 수 있습니다.The following behaviors of the Jet provider that is included with the Excel driver can lead to unexpected results when saving data to an Excel destination.

  • 텍스트 데이터 저장.Saving text data. Excel 드라이버가 텍스트 데이터 값을 Excel 대상에 저장하면 드라이버는 각 셀에서 작은따옴표(')가 있는 텍스트 앞에 오므로 저장된 값이 텍스트 값으로 해석됩니다.When the Excel driver saves text data values to an Excel destination, the driver precedes the text in each cell with the single quote character (') to ensure that the saved values will be interpreted as text values. 저장된 데이터를 읽거나 처리하는 다른 응용 프로그램을 갖고 있거나 개발한 경우 각 텍스트 값을 처리하는 작은따옴표에 대한 특별한 처리 방식을 포함해야 합니다.If you have or develop other applications that read or process the saved data, you may need to include special handling for the single quote character that precedes each text value.

    작은따옴표가 포함되지 않도록 하는 방법에 대한 내용은 msdn.com의 블로그 게시물 중 SSIS 패키지에서 Excel 대상 데이터 흐름 구성 요소를 사용하여 Excel로 데이터를 변환할 때 모든 문자열에 추가되는 작은따옴표(영문)를 참조하세요.For information on how to avoid including the single quote, see this blog post, Single quote is appended to all strings when data is transformed to excel when using Excel destination data flow component in SSIS package, on msdn.com.

  • 메모(ntext) 데이터 저장.Saving memo (ntext) data. 255자보다 긴 문자열을 Excel 열에 저장하려면 드라이버에서 대상 열의 데이터 형식을 string 이 아닌 memo로 인식해야 합니다.Before you can successfully save strings longer than 255 characters to an Excel column, the driver must recognize the data type of the destination column as memo and not string. 대상 테이블에 이미 데이터 행이 포함된 경우 드라이버에서 샘플링하는 처음 몇 개 행의 메모 열에 값이 255자보다 긴 인스턴스가 하나 이상 들어 있어야 합니다.If the destination table already contains rows of data, then the first few rows that are sampled by the driver must contain at least one instance of a value longer than 255 characters in the memo column. 패키지 디자인 타임 또는 런타임에 대상 테이블을 만드는 경우 CREATE TABLE 문은 메모 열의 데이터 형식으로 LONGTEXT(또는 해당 동의어 중 하나)를 사용해야 합니다.If the destination table is created during package design or at run time, then the CREATE TABLE statement must use LONGTEXT (or one of its synonyms) as the data type of the the memo column.

  • 데이터 형식.Data types. Excel 드라이버는 제한된 데이터 형식 집합만 인식합니다.The Excel driver recognizes only a limited set of data types. 예를 들어 모든 숫자 열은 double(DT_R8)로 해석되고 모든 문자열 열(메모 열 제외)은 255자 유니코드 문자열(DT_WSTR)로 해석됩니다.For example, all numeric columns are interpreted as doubles (DT_R8), and all string columns (other than memo columns) are interpreted as 255-character Unicode strings (DT_WSTR). Integration ServicesIntegration Services 에서는 Excel 데이터 형식을 다음과 같이 매핑합니다. maps the Excel data types as follows:

    • 숫자 배정밀도 부동 소수점 수(DT_R8)Numeric double-precision float (DT_R8)

    • 통화 currency(DT_CY)Currency currency (DT_CY)

    • 부울 Boolean(DT_BOOL)Boolean Boolean (DT_BOOL)

    • 날짜/시간 datetime (DT_DATE)Date/time datetime (DT_DATE)

    • 문자열 길이가 255인 유니코드 문자열(DT_WSTR)String Unicode string, length 255 (DT_WSTR)

    • 메모 유니코드 텍스트 스트림(DT_NTEXT)Memo Unicode text stream (DT_NTEXT)

  • 데이터 형식 및 길이 변환.Data type and length conversions. Integration ServicesIntegration Services 에서는 데이터 형식을 암시적으로 변환하지 않습니다. does not implicitly convert data types. 따라서 파생 열 변환이나 데이터 변환을 사용하여 Excel 데이터를 비 Excel 대상으로 로드하기 전에 명시적으로 변환하거나 비 Excel 데이터를 Excel 대상으로 로드하기 전에 변환해야 할 수 있습니다.As a result, you may need to use the Derived Column or Data Conversion transformations to convert Excel data explicitly before loading it into a non-Excel destination, or to convert non-Excel data before loading it into an Excel destination. 이 경우 필요한 변환을 구성해 주는 가져오기 및 내보내기 마법사를 사용하여 초기 패키지를 만들면 유용할 수 있습니다.In this case, it may be useful to create the initial package by using the Import and Export Wizard, which configures the necessary conversions for you. 필요할 수 있는 일부 변환 예는 다음과 같습니다.Some examples of the conversions that may be required include the following:

    • 유니코드 Excel 문자열 열과 특정 코드 페이지가 있는 비유니코드 문자열 열 간 변환Conversion between Unicode Excel string columns and non-Unicode string columns with specific codepages.

    • 255자 Excel 문자열 열과 길이가 다른 문자열 열 간 변환Conversion between 255-character Excel string columns and string columns of different lengths.

    • 배정밀도 Excel 숫자 열과 다른 유형의 숫자 열 간 변환Conversion between double-precision Excel numeric columns and numeric columns of other types.

Excel 집합 대상 구성Configuration of 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 DescriptionDescription
테이블 또는 뷰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.

경고

선택한 Excel 연결 관리자 가 존재하지 않는 Excel 파일을 가리키는 경우 이 단추를 클릭하면 오류 메시지가 표시됩니다.If the Excel connection manager you selected points to an excel file that does not exist, you will see an error message when you click this button.

데이터 액세스 모드 동적 옵션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.

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

Excel 원본 Excel Source
Integration Services(SSIS) 변수 Integration Services (SSIS) Variables
데이터 흐름 Data Flow
스크립트 태스크를 사용한 Excel 파일 작업Working with Excel Files with the Script Task