ODBC 대상
적용 대상: 
SQL Server Azure Data Factory의 SSIS Integration Runtime
ODBC 대상은 ODBC 지원 데이터베이스 테이블에 데이터를 대량 로드합니다. 이 ODBC 대상은 ODBC 연결 관리자를 사용하여 데이터 원본에 연결합니다.
ODBC 데이터베이스 대상에는 입력 열과 대상 데이터 원본의 열 간 매핑이 포함됩니다. 입력 열을 모든 대상 열에 매핑할 필요는 없지만 대상 열의 속성에 따라 입력 열이 대상 열에 매핑되지 않은 경우 오류가 발생할 수 있습니다. 예를 들어 대상 열에 Null 값이 허용되지 않는 경우에는 입력 열을 해당 열에 매핑해야 합니다. 또한 서로 다른 유형의 열을 매핑할 수 있지만 입력 데이터가 대상 열 유형과 호환되지 않는 경우 런타임에 오류가 발생합니다. 오류 동작 설정에 따라 오류가 무시되거나, 오류가 발생하거나, 행이 오류 출력으로 전송됩니다.
ODBC 대상에는 하나의 일반 출력과 하나의 오류 출력이 있습니다.
로드 옵션
ODBC 대상은 두 개의 액세스 로드 모듈 중 하나를 사용할 수 있습니다. ODBC 원본 편집기(연결 관리자 페이지)에서 모드를 설정합니다. 두 모드는 다음과 같습니다.
일괄 처리: 이 모드에서는 ODBC 대상이 인식된 ODBC 공급자 기능을 기반으로 가장 효율적인 삽입 메서드를 사용하려고 합니다. 대부분의 최신 ODBC 공급자의 경우 매개 변수를 사용하여 INSERT 문을 준비한 다음 행 단위 배열 매개 변수 바인딩(배열 크기는 BatchSize 속성에 의해 제어됨)을 사용하는 것을 의미합니다. Batch를 선택하고 공급자가 이 메서드를 지원하지 않는 경우 ODBC 대상은 자동으로 행 단위 모드로 전환됩니다.
행 단위: 이 모드에서 ODBC 대상은 매개 변수가 있는 INSERT 문을 준비하고 SQL Execute를 사용하여 행을 한 번에 하나씩 삽입합니다.
오류 처리
ODBC 대상에는 하나의 오류 출력이 있습니다. 구성 요소 오류 출력에 다음과 같은 출력 열이 포함됩니다.
오류 코드: 현재 오류에 해당하는 숫자입니다. 오류 목록은 원본 데이터베이스에 대한 설명서를 참조하십시오. SSIS 오류 코드 목록은 SSIS 오류 코드 및 메시지 참조를 참조하세요.
오류 열: 오류를 일으키는 원본 열입니다(변환 오류의 경우).
표준 출력 데이터 열입니다.
오류 동작 설정에 따라 ODBC 대상은 추출 프로세스 중 발생하는 오류(데이터 변환, 잘림)를 오류 출력에 반환하는 작업을 지원합니다. 자세한 내용은 ODBC 원본 편집기(오류 출력 페이지)를 참조하세요.
병렬 처리
동일한 테이블 또는 다른 테이블, 동일한 컴퓨터 또는 다른 컴퓨터(일반 전역 세션 제한 이외의)에 대해 병렬로 실행할 수 있는 ODBC 대상 구성 요소 수에는 제한이 없습니다.
그러나 사용 중인 ODBC 공급자의 제한으로 인해 공급자를 통한 동시 연결 수가 제한될 수 있습니다. 이러한 제한은 ODBC 대상에 대해 지원되는 병렬 인스턴스의 수를 제한합니다. SSIS 개발자는 이용 중인 모든 ODBC 공급자의 제한을 이해하고 SSIS 패키지를 작성할 때 해당 제한을 고려해야 합니다.
또한 동일한 테이블로 동시에 로드할 경우 표준 레코드 잠금 때문에 성능이 저하될 수 있다는 사실을 알고 있어야 합니다. 이는 로드되는 데이터와 테이블 조직에 따라 달라집니다.
ODBC 대상 문제 해결
ODBC 원본이 외부 데이터 공급자에 대해 수행하는 호출을 로깅할 수 있습니다. 이 로깅 기능을 사용하면 ODBC 대상이 외부 데이터 원본에서 데이터를 저장할 때 발생하는 문제를 해결할 수 있습니다. ODBC 대상이 외부 데이터 공급자에 대해 수행하는 호출을 기록하려면 ODBC 드라이버 관리자 추적을 사용해야 합니다. 자세한 내용은 ODBC 데이터 원본 관리자를 사용하여 ODBC 추적을 생성하는 방법에 대한 Microsoft 설명서를 참조하십시오.
ODBC 대상 구성
프로그래밍 방식으로 또는 SSIS 디자이너를 통해 ODBC 대상을 구성할 수 있습니다.
자세한 내용은 다음 항목 중 하나를 참조하십시오.
고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 속성이 포함됩니다.
고급 편집기 대화 상자를 열려면
- SQL Server 2019 Integration Services(SSIS) 프로젝트의 데이터 흐름 화면에서 ODBC 대상을 마우스 오른쪽 단추로 클릭하고 고급 편집기 표시를 선택합니다.
고급 편집기 대화 상자에서 설정할 수 있는 속성에 대한 자세한 내용은 ODBC Destination Custom Properties을 참조하십시오.
섹션 내용
ODBC 대상 편집기(연결 관리자 페이지)
ODBC 대상 편집기 대화 상자의 연결 관리자 페이지를 사용하여 대상에 대한 ODBC 연결 관리자를 선택할 수 있습니다. 이 페이지를 사용하면 데이터베이스에서 테이블이나 뷰를 선택할 수도 있습니다.
ODBC 대상 편집기 연결 관리자 페이지를 열려면
작업 목록
SQL Server Data Tools에서 ODBC 대상이 있는 SSIS(SQL Server 2019 Integration Services) 패키지를 엽니다.
데이터 흐름 탭에서 ODBC 대상을 두 번 클릭합니다.
ODBC 대상 편집기에서 연결 관리자를 클릭합니다.
옵션
Connection manager
목록에서 기존 ODBC 연결 관리자를 선택하거나 새로 만들기를 클릭하여 새 연결을 만듭니다. 연결은 ODBC가 지원되는 모든 데이터베이스에 연결할 수 있습니다.
새로 만들기
새로 만들기를 클릭합니다. 새 연결 관리자를 만들 수 있는 ODBC 연결 관리자 편집기 구성 대화 상자가 열립니다.
데이터 액세스 모드
대상으로 데이터를 로드하는 방법을 선택합니다. 옵션은 다음 표에 표시되어 있습니다.
| 옵션 | 설명 |
|---|---|
| 테이블 이름 - 일괄 처리 | 일괄 처리 모드에서 작업하도록 ODBC 대상을 구성하려면 이 옵션을 선택합니다. 이 옵션을 선택하면 다음 옵션을 사용할 수 있습니다. |
| 테이블 또는 뷰 이름: 목록에서 사용 가능한 테이블 또는 뷰를 선택합니다. 이 목록에는 처음 1000개 테이블만 표시됩니다. 데이터베이스에 1000개 이상의 테이블이 포함된 경우 테이블 이름의 시작 부분을 입력하거나 (*) 와일드카드를 사용하여 이름 일부를 입력하여 사용할 테이블 또는 테이블을 표시할 수 있습니다. 일괄 처리 크기: 대량 로드를 위해 일괄 처리의 크기를 입력합니다. 일괄 처리로 로드되는 행의 개수입니다. |
|
| 테이블 이름 - 행 단위 | 각 행을 한 번에 하나씩 대상 테이블에 삽입하도록 ODBC 대상을 구성하려면 이 옵션을 선택합니다. 이 옵션을 선택하면 다음 옵션을 사용할 수 있습니다. |
| 테이블 또는 뷰 이름: 목록에서 데이터베이스에서 사용 가능한 테이블 또는 뷰를 선택합니다. 이 목록에는 처음 1000개 테이블만 표시됩니다. 데이터베이스에 1000개 이상의 테이블이 포함된 경우 테이블 이름의 시작 부분을 입력하거나 (*) 와일드카드를 사용하여 이름 일부를 입력하여 사용할 테이블 또는 테이블을 표시할 수 있습니다. |
프리뷰
미리 보기를 클릭하면 선택한 테이블의 데이터 행을 최대 200개까지 볼 수 있습니다.
ODBC 대상 편집기(매핑 페이지)
ODBC 대상 편집기 대화 상자의 매핑 페이지를 사용하여 입력 열을 대상 열에 매핑할 수 있습니다.
옵션
사용 가능한 입력 열
사용 가능한 입력 열 목록입니다. 입력 열을 사용 가능한 대상 열에 끌어 놓아 열을 매핑할 수 있습니다.
사용 가능한 대상 열
사용 가능한 대상 열 목록입니다. 대상 열을 사용 가능한 입력 열에 끌어 놓아 열을 매핑할 수 있습니다.
입력 열
선택한 입력 열을 표시합니다. <ignore>를 선택하여 매핑을 제거하면 출력에서 열을 제외할 수 있습니다.
대상 열
사용 가능한 모든 대상 열(매핑되거나 매핑되지 않음)을 표시합니다.
ODBC 대상 편집기(오류 출력 페이지)
ODBC 대상 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택할 수 있습니다.
ODBC 대상 편집기 오류 출력 페이지를 열려면
작업 목록
SQL Server Data Tools에서 ODBC 대상이 있는 SSIS(SQL Server 2019 Integration Services) 패키지를 엽니다.
데이터 흐름 탭에서 ODBC 대상을 두 번 클릭합니다.
ODBC 대상 편집기에서 오류 출력을 클릭합니다.
옵션
입/출력
데이터 원본의 이름을 표시합니다.
Column
사용되지 않습니다.
Error
ODBC 대상에서 흐름 오류를 처리하는 방법을 선택합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.
잘림
ODBC 대상에서 흐름 잘림을 처리하는 방법을 선택합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.
설명
오류에 대한 설명을 표시합니다.
이 값을 선택한 셀로 설정
오류나 잘림 발생 시 ODBC 대상에서 선택한 모든 셀을 처리하는 방법을 선택합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.
적용
선택된 셀에 오류 처리 옵션을 적용합니다.
오류 처리 옵션
다음 옵션을 사용하여 ODBC 대상이 오류 및 잘림을 처리하는 방법을 구성합니다.
구성 요소 실패
오류 또는 잘림이 발생하면 데이터 흐름 태스크가 실패합니다. 이 옵션은 기본 동작입니다.
오류 무시
오류 또는 잘림이 무시됩니다.
흐름 리디렉션
오류 또는 잘림을 발생시키는 행이 ODBC 대상의 오류 출력으로 전송됩니다. 자세한 내용은 ODBC 대상을 참조하십시오.