ODBC 원본ODBC Source

ODBC 원본은 데이터베이스 테이블, 뷰 또는 SQL 문을 사용하여 ODBC 지원 데이터베이스에서 데이터를 추출합니다.The ODBC source extracts data from ODBC-supported database by using a database table, a view, or an SQL statement.

ODBC 원본은 데이터 추출을 위한 다음 데이터 액세스 모드를 제공합니다.The ODBC source has the following data access modes for extracting data:

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

  • SQL 문의 결과The results of an SQL statement.

    원본은 이용할 공급자를 지정하는 ODBC 연결 관리자를 사용합니다.The source uses an ODBC connection manager, which specifies the provider to use.

    ODBC 원본에는 원본 데이터 출력 열이 포함됩니다.An ODBC source includes the source data output columns. 출력 열이 ODBC 대상에서 대상 열에 매핑될 경우 대상 열에 매핑된 출력 열이 없으면 오류가 발생할 수 있습니다.When output columns are mapped in the ODBC destination to the destination columns, errors may occur if no output columns are mapped to the destination columns. 유형이 다른 열을 매핑할 수 있지만 출력 데이터가 대상과 호환되지 않으면 런타임에 오류가 발생합니다.Columns of different types can be mapped, however if the output data is not compatible for the destination then an error occurs at runtime. 오류 동작 설정에 따라 오류가 무시되거나, 오류가 발생하거나, 오류 출력에 행이 전송됩니다.Depending on the error behavior, setting the error will be ignored, cause a failure, or the row is sent to the error output.

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

오류 처리Error Handling

ODBC 원본에는 하나의 오류 출력이 있습니다.The ODBC source has an error output. 구성 요소 오류 출력에 다음과 같은 출력 열이 포함됩니다.The component error output includes the following output columns:

  • 오류 코드: 현재 오류에 해당하는 숫자입니다.Error Code: The number that corresponds to the current error. 오류 목록은 현재 사용하고 있는 ODBC 지원 데이터베이스에 대한 설명서를 참조하십시오.See the documentation for the ODBC-supported database you are using for a list of errors. SSIS 오류 코드 목록은 SSIS 오류 코드 및 메시지 참조를 참조하십시오.For a list of SSIS error codes, see the SSIS Error Code and Message Reference.

  • 오류 열: 오류의 원인이 되는 원본 열입니다(변환 오류의 경우).Error Column: The source column causing the error (for conversion errors).

  • 표준 출력 데이터 열입니다.The standard output data columns.

    오류 동작 설정에 따라 ODBC 원본은 추출 프로세스 중 발생하는 오류(데이터 변환, 잘림)를 오류 출력에 반환하는 작업을 지원합니다.Depending on the error behavior setting, the ODBC source supports returning errors (data conversion, truncation) that occur during the extraction process in the error output. 자세한 내용은 ODBC 대상 편집기(연결 관리자 페이지)를 참조하세요.For more information, see ODBC Destination Editor (Connection Manager Page).

데이터 형식 지원Data Type Support

ODBC 원본이 지원하는 데이터 형식에 대한 자세한 내용은 Connector for ODBC(Open Database Connectivity) by Attunity를 참조하십시오.For information about the data types supported by the ODBC source, see Connector for Open Database Connectivity (ODBC) by Attunity.

추출 옵션Extract Options

ODBC 원본은 일괄 처리 또는 행 단위 모드에서 작동합니다.The ODBC source operates in either Batch or Row-by-Row mode. 사용되는 모드는 FetchMethod 속성으로 결정됩니다.The mode used is determined by the FetchMethod property. 다음 목록에서는 이러한 모드를 설명합니다.The following list describes the modes.

  • 일괄 처리: 구성 요소가 인식된 ODBC 공급자 기능을 기반으로 가장 효율적인 인출 메서드를 사용하려고 합니다.Batch: The component attempts to use the most efficient fetch method based on the perceived ODBC provider capabilities. 대부분의 최신 ODBC 공급자에게 이는 배열 바인딩을 사용한 SQLFetchScroll입니다(배열 크기는 BatchSize 속성으로 결정됨).For most modern ODBC providers, this is SQLFetchScroll with array binding (where the array size is determined by the BatchSize property). 일괄 처리 를 선택했는데 공급자가 이 메서드를 지원하지 않으면 ODBC 대상이 행 단위 모드로 자동 전환됩니다.If you select Batch and the provider does not support this method, the ODBC destination automatically switches to the Row-by-row mode.

  • 행 단위: 구성 요소가 SQLFetch를 사용하여 한 번에 하나씩 행을 검색합니다.Row-by Row: The component uses SQLFetch to retrieve the rows one at a time.

    FetchMethod 속성에 대한 자세한 내용은 ODBC Source Custom Properties을 참조하십시오.For more information about the FetchMethod property, see ODBC Source Custom Properties.

병렬 처리Parallelism

동일한 컴퓨터 또는 서로 다른 컴퓨터에서 동일한 테이블 또는 서로 다른 테이블에 대해 병렬로 실행될 수 있는 ODBC 원본 구성 요소의 수에는 제한이 없습니다(일반적인 전역 세션 제한 제외).There is no limitation on the number of ODBC source components that can run in parallel against the same table or different tables, on the same machine or on different machines (other than normal global session limits).

그러나 이용 중인 ODBC 공급자의 제한으로 인해 공급자를 통한 동시 연결 수가 제한될 수 있습니다.However, limitations of the ODBC provider being used may restrict the number of concurrent connections through the provider. 이러한 제한으로 인해 ODBC 원본에 대해 지원 가능한 병렬 인스턴스 수가 제한됩니다.These limitations limit the number of supported parallel instances possible for the ODBC source. SSIS 개발자는 이용 중인 모든 ODBC 공급자의 제한을 이해하고 SSIS 패키지를 작성할 때 해당 제한을 고려해야 합니다.The SSIS developer must be aware of the limitations of any ODBC provider being used and take them into consideration when building SSIS packages.

ODBC 원본 문제 해결Troubleshooting the ODBC Source

ODBC 원본이 외부 데이터 공급자에 대해 수행하는 호출을 기록할 수 있습니다.You can log the calls that the ODBC source makes to external data providers. 이 로깅 기능을 사용하면 ODBC 원본이 외부 데이터 원본에서 데이터를 로드할 때 발생하는 문제를 해결할 수 있습니다.You can use this logging capability to troubleshoot the loading of data from external data sources that the ODBC source performs. ODBC 원본이 외부 데이터 공급자에 대해 수행하는 호출을 기록하려면 ODBC 드라이버 관리자 추적을 사용해야 합니다.To log the calls that the ODBC source makes to external data providers, enable the ODBC driver manager trace. 자세한 내용은 ODBC 데이터 원본 관리자를 사용하여 ODBC 추적을 생성하는 방법에 대한 Microsoft 설명서를 참조하십시오.For more information, see the Microsoft documentation on How To Generate an ODBC Trace with ODBC the Data Source Administrator.

ODBC 원본 구성Configuring the ODBC Source

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 ODBC 원본을 구성할 수 있습니다.You can configure the ODBC source programmatically or through the SSIS Designer.

고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 속성이 포함됩니다.The Advanced Editor dialog box contains the properties that can be set programmatically.

고급 편집기 대화 상자를 열려면To open the Advanced Editor dialog box:

  • 프로젝트의 데이터 흐름 SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) 화면에서 ODBC 원본을 마우스 오른쪽 단추로 클릭하고 고급 편집기 표시를 선택합니다.In the Data Flow screen of your SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) project, right click the ODBC source and select Show Advanced Editor.

    고급 편집기 대화 상자에서 설정할 수 있는 속성에 대한 자세한 내용은 ODBC Source Custom Properties을 참조하십시오.For more information about the properties that you can set in the Advanced Editor dialog box, see ODBC Source Custom Properties.

섹션 내용In This Section

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

ODBC 원본 편집기 대화 상자의 연결 관리자 페이지를 사용하여 원본의 ODBC 연결 관리자를 선택할 수 있습니다.Use the Connection Manager page of the ODBC Source Editor dialog box to select the ODBC connection manager for the source. 이 페이지를 사용하면 데이터베이스에서 테이블이나 뷰를 선택할 수도 있습니다.This page also lets you select a table or view from the database.

작업 목록Task List

ODBC 원본 편집기의 연결 관리자 페이지를 열려면To open the ODBC Source Editor Connection Manager Page

  • SQL Server Data ToolsSQL Server Data Tools에서 ODBC 원본이 있는 SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) 패키지를 엽니다.In SQL Server Data ToolsSQL Server Data Tools, open the SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) package that has the ODBC source.

  • 데이터 흐름 탭에서 ODBC 원본을 두 번 클릭합니다.On the Data Flow tab, double-click the ODBC source.

옵션Options

ODBC 원본 편집기Connection manager

목록에서 기존 ODBC 연결 관리자를 선택하거나 새로 만들기 를 클릭하여 새 연결을 만듭니다.Select an existing ODBC connection manager from the list, or click New to create a new connection. 어느 ODBC 지원 데이터베이스에나 연결할 수 있습니다.The connection can be to any ODBC-supported database.

새로 만들기New

새로 만들기를 클릭합니다.Click New. 새 ODBC 연결 관리자를 만들 수 있는 ODBC 연결 관리자 편집기 구성 대화 상자가 열립니다.The Configure ODBC Connection Manager Editor dialog box opens where you can create a new ODBC connection manager.

데이터 액세스 모드Data Access Mode

원본에서 데이터를 선택하는 방법을 선택합니다.Select the method for selecting data from the source. 옵션은 다음 표에 표시되어 있습니다.The options are shown in the following table:

옵션Option DescriptionDescription
테이블 이름Table Name ODBC 데이터 원본에 있는 테이블이나 뷰에서 데이터를 검색합니다.Retrieve data from a table or view in the ODBC data source. 이 옵션을 선택할 경우 다음 목록에서 값을 선택합니다.When you select this option, select a value from the list for the following:
테이블 또는 뷰 이름: 목록에서 사용 가능한 테이블 또는 뷰를 선택하거나 테이블을 식별할 수 있는 정규식을 입력합니다.Name of the table or the view: Select an available table or view from the list or type a regular expression to identify the table.
이 목록에는 처음 1000개의 테이블만 포함되어 있습니다.This list contains the first 1000 tables only. 데이터베이스에 포함되어 있는 테이블이 1000개를 넘는 경우 테이블 이름의 시작 부분을 입력하거나 와일드카드()를 통해 이름의 일부를 입력하여 사용할 테이블을 표시합니다.If your database contains more than 1000 tables, you can type the beginning of a table name or use the () wild card to enter any part of the name to display the table or tables you want to use.
SQL 명령SQL command SQL 쿼리를 사용하여 ODBC 데이터 원본에서 데이터를 검색합니다.Retrieve data from the ODBC data source by using an SQL query. 사용할 원본 데이터베이스의 구문으로 쿼리를 작성해야 합니다.You should write the query in the syntax of the source database you are working with. 이 옵션을 선택할 경우 다음 중 한 가지 방법으로 쿼리를 입력합니다.When you select this option, enter a query in one of the following ways:
SQL 명령 텍스트 필드에 SQL 쿼리 텍스트를 입력합니다.Enter the text of the SQL query in the SQL command text field.
찾아보기 를 클릭하여 텍스트 파일에서 SQL 쿼리를 로드합니다.Click Browse to load the SQL query from a text file.
쿼리 구문 분석 을 클릭하여 쿼리 텍스트의 구문을 확인합니다.Click Parse query to verify the syntax of the query text.

미리 보기Preview

미리 보기 를 클릭하면 선택한 테이블 또는 뷰에서 추출된 최대 200개의 데이터 행을 볼 수 있습니다.Click Preview to view up to the first 200 rows of the data extracted from the table or view you selected.

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

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

작업 목록Task List

ODBC 원본 편집기의 열 페이지를 열려면To open the ODBC Source Editor Columns Page

  1. SQL Server Data ToolsSQL Server Data Tools에서 ODBC 원본이 있는 SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) 패키지를 엽니다.In SQL Server Data ToolsSQL Server Data Tools, open the SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) package that has the ODBC source.

  2. 데이터 흐름 탭에서 ODBC 원본을 두 번 클릭합니다.On the Data Flow tab, double-click the ODBC source.

  3. ODBC 원본 편집기에서 을 클릭합니다.In the ODBC Source Editor, click Columns.

옵션Options

사용 가능한 외부 열Available External Columns

데이터 원본에서 사용 가능한 외부 열의 목록입니다.A list of available external columns in the data source. 이 테이블을 사용하여 열을 추가하거나 삭제할 수 없습니다.You cannot use this table to add or delete columns. 원본에서 사용할 열을 선택합니다.Select the columns to use from the source. 선택한 열이 선택 순서대로 외부 열 목록에 추가됩니다.The selected columns are added to the External Column list in the order they are selected.

모든 열을 선택하려면 모두 선택 확인란을 선택합니다.Select the Select All check box to select all of the columns.

외부 열External Column

ODBC 원본의 데이터를 사용하는 구성 요소를 구성할 때 표시되는 순서로 된 외부(원본) 열의 뷰입니다.A view of the external (source) columns in the order that you see them when configuring components that consume data from the ODBC source.

출력 열Output Column

각 출력 열의 고유 이름을 입력합니다.Enter 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. 입력한 이름은 SSIS 디자이너에 표시됩니다.The name entered is displayed in the SSIS Designer.

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

ODBC 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택할 수 있습니다.Use the Error Output page of the ODBC Source Editor dialog box to select error handling options.

작업 목록Task List

ODBC 원본 편집기 오류 출력 페이지를 열려면To open the ODBC Source Editor Error Output Page

  • SQL Server Data ToolsSQL Server Data Tools에서 ODBC 원본이 있는 SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) 패키지를 엽니다.In SQL Server Data ToolsSQL Server Data Tools, open the SQL Server 2017 Integration Services(SSIS)SQL Server 2017 Integration Services (SSIS) package that has the ODBC source.

  • 데이터 흐름 탭에서 ODBC 원본을 두 번 클릭합니다.On the Data Flow tab, double-click the ODBC source.

  • ODBC 원본 편집기에서 오류 출력을 클릭합니다.In the ODBC Source Editor, click Error Output.

옵션Options

입/출력Input/Output

데이터 원본의 이름을 표시합니다.View the name of the data source.

Column

사용되지 않습니다.Not used.

오류Error

ODBC 원본에서 흐름의 오류를 처리하는 방법을 선택합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Select how the ODBC source should handle errors in a flow: ignore the failure, redirect the row, or fail the component.

잘림Truncation

ODBC 원본에서 흐름의 잘림을 처리하는 방법을 선택합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Select how the ODBC source should handle truncation in a flow: ignore the failure, redirect the row, or fail the component.

DescriptionDescription

사용되지 않습니다.Not used.

이 값을 선택한 셀에 설정Set this value to selected cells

오류나 잘림 발생 시 ODBC 원본에서 선택한 모든 셀을 처리하는 방법을 선택합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Select how the ODBC source handles all selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

적용Apply

선택한 셀에 오류 처리 옵션을 적용합니다.Apply the error handling options to the selected cells.

오류 처리 옵션Error Handling Options

다음 옵션을 사용하여 ODBC 원본에서 오류 및 잘림을 처리하는 방법을 구성할 수 있습니다.You use the following options to configure how the ODBC source handles errors and truncations.

구성 요소 실패Fail Component

오류 또는 잘림이 발생하면 데이터 흐름 태스크가 실패합니다.The Data Flow task fails when an error or a truncation occurs. 이것이 기본 동작입니다.This is the default behavior.

오류 무시Ignore Failure

오류 또는 잘림이 무시됩니다.The error or the truncation is ignored.

흐름 리디렉션Redirect Flow

오류 또는 잘림을 발생시키는 행이 ODBC 원본의 오류 출력으로 전송됩니다.The row that is causing the error or the truncation is directed to the error output of the ODBC source.