다음을 통해 공유

OLE DB 대상

  • 아티클

적용 대상: Azure Data Factory의 SQL Server SSIS Integration Runtime

OLE DB 대상은 데이터베이스 테이블 또는 뷰 또는 SQL 명령을 사용하여 다양한 OLE DB 규격 데이터베이스에 데이터를 로드합니다. 예를 들어 OLE DB 원본은 Microsoft Office Access 및 SQL Server 데이터베이스의 테이블로 데이터를 로드할 수 있습니다.

참고 항목

데이터 원본이 Microsoft Office Excel 2007인 경우 데이터 원본에는 이전 버전의 Excel과 다른 연결 관리자가 필요합니다. 자세한 내용은 Excel 통합 문서에 연결을 참조하세요.

OLE DB 대상은 데이터를 로드하기 위한 5가지 데이터 액세스 모드를 제공합니다.

  • 테이블 또는 뷰 기존 테이블 또는 뷰를 지정하거나 새 테이블을 만들 수 있습니다.

  • 빠른 로드 옵션을 사용하는 테이블 또는 뷰. 기존 테이블을 지정하거나 새 테이블을 만들 수 있습니다.

  • 변수에 지정된 테이블 또는 뷰입니다.

  • 빠른 로드 옵션을 사용하여 변수에 지정된 테이블 또는 뷰입니다.

  • SQL 문의 결과입니다.

참고 항목

OLE DB 대상은 매개 변수를 지원하지 않습니다. 매개 변수가 있는 INSERT 문을 실행해야 하는 경우 OLE DB 명령 변환을 고려해야 합니다. 자세한 내용은 OLE DB 명령 변환을 참조하세요.

OLE DB 대상에서 DBCS(더블바이트 문자 집합)를 사용하는 문자 집합이 로드되는 경우 데이터 액세스 모드에 빠른 로드 옵션이 사용되지 않고 OLE DB 연결 관리자에서 SQLOLEDB(Microsoft OLE DB Provider for SQL Server)가 사용되는 경우 데이터가 손상될 수 있습니다. DBCS 데이터의 무결성을 보장하려면 SQL Server Native Client를 사용하도록 OLE DB 연결 관리자를 구성하거나 테이블 또는 뷰 - 빠른 로드 또는 테이블 이름 또는 뷰 이름 변수 - 빠른 로드와 같은 빠른 로드 액세스 모드 중 하나를 사용해야 합니다. 두 옵션 모두 OLE DB 대상 편집기 대화 상자에서 사용할 수 있습니다. SSIS 개체 모델을 프로그래밍하는 경우 AccessMode 속성을 FastLoad를 사용한 OpenRowset 또는 변수와 FastLoad를 사용한 OpenRowset으로 설정해야 합니다.

참고 항목

OLE DB 대상에서 데이터를 삽입할 대상 테이블을 만들기 위해 SSIS 디자이너에서 OLE DB 대상 편집기 대화 상자를 사용하는 경우에는 새로 만든 테이블을 수동으로 선택해야 할 수도 있습니다. 수동 선택의 필요성은 DB2용 OLE DB 공급자와 같은 OLE DB 공급자가 테이블 이름에 스키마 식별자를 자동으로 추가하는 경우에 발생합니다.

참고 항목

OLE DB 대상 편집기 대화 상자에서 생성하는 CREATE TABLE 문은 대상 유형에 따라 수정해야 할 수 있습니다. 예를 들어 일부 대상은 CREATE TABLE 문에서 사용하는 데이터 형식을 지원하지 않습니다.

이 대상은 OLE DB 연결 관리자를 사용하여 데이터 원본에 연결하며 연결 관리자가 사용할 OLE DB 공급자를 지정합니다. 자세한 내용은 OLE DB Connection Manager을 참조하세요.

또한 Integration Services 프로젝트는 OLE DB 연결 관리자를 만들 수 있는 데이터 원본 개체를 제공하여 OLE DB 대상에서 데이터 원본과 데이터 원본 뷰를 사용할 수 있게 합니다.

OLE DB 대상에는 대상 데이터 원본의 입력 열과 열 간의 매핑이 포함됩니다. 입력 열을 모든 대상 열에 매핑할 필요는 없지만 대상 열의 속성에 따라 입력 열이 대상 열에 매핑되지 않은 경우 오류가 발생할 수 있습니다. 예를 들어 대상 열에 Null 값이 허용되지 않는 경우에는 입력 열을 해당 열에 매핑해야 합니다. 또한 매핑된 열의 데이터 형식은 호환되어야 합니다. 예를 들어 문자열 데이터 형식의 입력 열을 숫자 데이터 형식이 있는 대상 열에 매핑할 수 없습니다.

OLE DB 대상에는 하나의 일반 입력과 하나의 오류 출력이 있습니다.

데이터 형식에 대한 자세한 내용은 Integration Services 데이터 형식을 참조하세요.

빠른 로드 옵션

OLE DB 대상에서 빠른 로드 데이터 액세스 모드를 사용하는 경우 대상에 대해 사용자 인터페이스인 OLE DB 대상 편집기에서 다음 빠른 로드 옵션을 지정할 수 있습니다.

  • 가져온 데이터 파일에서 ID 값을 유지하거나 SQL Server에서 할당된 고유 값을 사용합니다.

  • 대량 로드 작업 중에 발생한 Null 값을 유지합니다.

  • 대량 로드 작업 중에 대상 테이블 또는 뷰의 제약 조건을 검사합니다.

  • 대량 로드 작업 기간 동안 테이블 수준 잠금을 획득합니다.

  • 일괄 처리의 행 수와 커밋 크기를 지정합니다.

일부 빠른 로드 옵션은 OLE DB 대상의 특정 속성에 저장됩니다. 예를 들어 FastLoadKeepIdentity는 식별 값을 유지할지 여부를 지정하고 FastLoadKeepNull은 null 값을 유지할지 여부를 지정하고 FastLoadMaxInsertCommitSize는 일괄 처리로 커밋할 행 수를 지정합니다. 기타 빠른 로드 옵션은 쉼표로 구분된 목록으로 FastLoadOptions 속성에 저장됩니다. OLE DB 대상에서 FastLoadOptions에 저장되고 OLE DB 대상 편집기 대화 상자에 나열된 모든 빠른 로드 옵션을 사용하는 경우 속성 값은 TABLOCK, CHECK_CONSTRAINTS ROWS_PER_BATCH=1000으로 설정됩니다. 값 1000은 대상이 1000개 행의 일괄 처리를 사용하도록 구성되었음을 나타냅니다.

참고 항목

대상에서 제약 조건이 실패하면 FastLoadMaxInsertCommitSize에 정의된 행의 전체 일괄 처리가 실패합니다.

OLE DB 대상 편집기 대화 상자에 표시되는 빠른 로드 옵션 외에도 고급 편집기 대화 상자의 FastLoadOptions 속성 에 옵션을 입력하여 다음 대량 로드 옵션을 사용하도록 OLE DB 대상을 구성할 수 있습니다.

빠른 로드 옵션 설명
KILOBYTES_PER_BATCH 삽입할 크기를 킬로바이트 단위로 지정합니다. 이 옵션은 KILOBYTES_PER_BATCH = <양의 정수 값> 형식으로 입력합니다.
FIRE_TRIGGERS 삽입 테이블에서 트리거를 실행할지 여부를 지정합니다. 이 옵션에는 FIRE_TRIGGERS 양식 이 있습니다. 이 옵션이 있으면 트리거가 시작됨을 나타냅니다.
ORDER 입력 데이터 저장 방식을 지정합니다. 이 옵션은 ORDER <column name> ASC|DESC 형식으로 입력합니다. 열 수에 상관없이 나열할 수 있으며 정렬 순서를 포함할 수도 있습니다. 정렬 순서를 생략하면 삽입 작업은 데이터가 정렬되지 않은 것으로 가정합니다.

참고: ORDER 옵션을 사용하여 테이블의 클러스터형 인덱스로 입력 데이터를 정렬하면 성능이 향상될 수 있습니다.

Transact-SQL 키워드는 일반적으로 대문자를 사용하여 입력하지만 키워드는 대/소문자를 구분하지 않습니다.

빠른 로드 옵션에 대한 자세한 내용은 BULK INSERT(Transact-SQL)를 참조하세요.

OLE DB 대상 문제 해결

OLE DB 명령 대상이 외부 데이터 공급자에 대해 수행하는 호출을 로깅할 수 있습니다. 이 로깅 기능을 사용하면 OLE DB 대상이 외부 데이터 원본에서 데이터를 저장할 때 발생하는 문제를 해결할 수 있습니다. OLE DB 대상이 외부 데이터 공급자에 대해 수행하는 호출을 로깅하려면 패키지 로깅을 설정하고 패키지 수준에서 Diagnostic 이벤트를 선택합니다. 자세한 내용은 패키지 실행을 위한 문제 해결 도구를 참조하세요.

OLE DB 대상 구성

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 속성이 표시됩니다. 고급 편집기 대화 상자를 사용하거나 프로그래밍 방식으로 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하세요:

속성 설정 방법을 보려면 다음 항목 중 하나를 클릭하십시오.

OLE DB 대상 편집기(연결 관리자 페이지)

OLE DB 대상 편집기 대화 상자의 연결 관리자 페이지를 사용하여 대상에 대한 OLE DB 연결 관리자를 선택할 수 있습니다. 이 페이지를 사용하면 데이터베이스에서 테이블이나 뷰를 선택할 수도 있습니다.

참고 항목

데이터 원본이 Microsoft Office Excel 2007인 경우 데이터 원본에는 이전 버전의 Excel과 다른 연결 관리자가 필요합니다. 자세한 내용은 Excel 통합 문서에 연결을 참조하세요.

참고 항목

OLE DB 대상의 CommandTimeout 속성은 OLE DB 대상 편집기에서 사용할 수 없지만 고급 편집기를 사용하여 설정할 수 있습니다. 또한 특정 빠른 로드 옵션은 고급 편집기만 사용할 수 있습니다. 이러한 속성에 대한 자세한 내용은 OLE DB 사용자 지정 속성의 OLE DB 대상 섹션을 참조하세요.

CommandTimeout 속성은 데이터 액세스 모드가 SQL 명령인 경우에만 적용됩니다.

정적 옵션

OLE DB 연결 관리자
목록에서 기존 연결 관리자를 선택하거나 새로운 만들기를 클릭하여 새로운 연결을 만들어 보세요.

New
OLE DB 연결 관리자 구성 대화 상자를 사용하여 새 연결 관리자를 만듭니다.

데이터 액세스 모드
대상으로 데이터를 로드하는 방법을 지정합니다. DBCS(더블 바이트 문자 집합) 데이터를 로드하려면 빠른 로드 옵션 중 하나를 사용해야 합니다. 대량 삽입에 최적화된 빠른 로드 데이터 액세스 모드에 대한 자세한 내용은 OLE DB Destination을 참조하십시오.

옵션 설명
테이블 또는 뷰 OLE DB 대상의 테이블 또는 뷰에 데이터를 로드합니다.
테이블 또는 뷰 - 빠른 로드 OLE DB 대상의 테이블 또는 뷰에 데이터를 로드하고 빠른 로드 옵션을 사용합니다. 대량 삽입에 최적화된 빠른 로드 데이터 액세스 모드에 대한 자세한 내용은 OLE DB Destination을 참조하십시오.
테이블 이름 또는 뷰 이름 변수 변수에서 테이블 또는 뷰 이름을 지정합니다.

관련 정보: 패키지에서 변수 사용
테이블 이름 또는 뷰 이름 변수 - 빠른 로드 변수에서 테이블 또는 뷰 이름을 지정하고 빠른 로드 옵션을 사용하여 데이터를 로드합니다. 대량 삽입에 최적화된 빠른 로드 데이터 액세스 모드에 대한 자세한 내용은 OLE DB Destination을 참조하십시오.
SQL 명령 SQL 쿼리를 사용하여 OLE DB 대상에 데이터를 로드합니다.

미리 보기
쿼리 결과 미리 보기 대화 상자를 사용하여 결과를 미리 봅니다. 미리 보기에는 최대 200개의 행이 표시될 수 있습니다.

데이터 액세스 모드 동적 옵션

데이터 액세스 모드에 대한 각 설정은 해당 설정과 관련된 동적 옵션 집합을 표시합니다. 다음 섹션에서는 각 데이터 액세스 모드 설정에 따라 사용할 수 있는 동적 옵션에 대해 설명합니다.

데이터 액세스 모드 = 테이블 또는 뷰

테이블 또는 뷰 이름
데이터 원본에서 사용할 수 있는 테이블 또는 뷰 목록에서 테이블 또는 뷰의 이름을 선택합니다.

New
테이블 만들기 대화 상자를 사용하여 새 테이블를 만듭니다.

참고 항목

새로 만들기를 클릭하면 Integration Services는 연결된 데이터 원본에 따라 기본 CREATE TABLE 문을 생성합니다. 원본 테이블에 FILESTREAM 특성이 선언된 열이 포함되어 있더라도 이 기본 CREATE TABLE 문에는 FILESTREAM 특성이 포함되지 않습니다. FILESTREAM 특성을 사용하여 Integration Services 구성 요소를 실행하려면 먼저 대상 데이터베이스에 FILESTREAM 스토리지를 구현합니다. 그런 다음 테이블 만들기 대화 상자에서 FILESTREAM 특성을 CREATE TABLE 문에 추가하십시오. 자세한 내용은 Blob(Binary Large Object) 데이터(SQL Server)를 참조하세요.

데이터 액세스 모드 = 테이블 또는 뷰 - 빠른 로드

테이블 또는 뷰 이름
이 목록을 사용하여 데이터베이스에서 테이블 또는 뷰를 선택하거나 새로 만들기를 클릭하여 새 테이블을 만듭니다.

New
테이블 만들기 대화 상자를 사용하여 새 테이블를 만듭니다.

참고 항목

새로 만들기를 클릭하면 Integration Services는 연결된 데이터 원본에 따라 기본 CREATE TABLE 문을 생성합니다. 원본 테이블에 FILESTREAM 특성이 선언된 열이 포함되어 있더라도 이 기본 CREATE TABLE 문에는 FILESTREAM 특성이 포함되지 않습니다. FILESTREAM 특성을 사용하여 Integration Services 구성 요소를 실행하려면 먼저 대상 데이터베이스에 FILESTREAM 스토리지를 구현합니다. 그런 다음 테이블 만들기 대화 상자에서 FILESTREAM 특성을 CREATE TABLE 문에 추가하십시오. 자세한 내용은 Blob(Binary Large Object) 데이터(SQL Server)를 참조하세요.

ID 유지
데이터를 로드할 때 ID 값을 복사할지 여부를 지정합니다. 이 속성은 빠른 로드 옵션을 사용할 때만 사용할 수 있습니다. 이 속성의 기본값은 false입니다.

Null 유지
데이터를 로드할 때 null 값을 복사할지 여부를 지정합니다. 이 속성은 빠른 로드 옵션을 사용할 때만 사용할 수 있습니다. 이 속성의 기본값은 false입니다.

테이블 잠금
로드하는 동안 테이블 잠금을 설정할지 여부를 지정합니다. 이 속성의 기본값은 True입니다.

CHECK 제약 조건
대상에서 데이터를 로드할 때 제약 조건을 검사할지 여부를 지정합니다. 이 속성의 기본값은 True입니다.

배치당 행 수
각 배치의 행 수를 지정합니다. 이 속성의 기본값은 값이 할당되지 않음을 나타내는 -1입니다.

참고 항목

이 속성에 사용자 지정 값을 할당하지 않으려면 OLE DB 대상 편집기에서 해당 입력란의 내용을 지우십시오.

최대 삽입 커밋 크기
빠른 로드 작업 중에 OLE DB 대상이 커밋하려고 하는 배치 크기를 지정합니다. 값 0 은 모든 행이 처리된 후 모든 데이터가 단일 배치로 커밋됨을 나타냅니다.

참고 항목

값 이 0 이면 OLE DB 대상 및 다른 데이터 흐름 구성 요소가 동일한 원본 테이블을 업데이트하는 경우 실행 중인 패키지의 응답이 중지될 수 있습니다. 패키지가 중지되지 않도록 하려면 최대 삽입 커밋 크기 옵션을 2147483647로 설정합니다.

이 속성에 값을 지정하면 대상에서 (1) 최대 삽입 커밋 크기보다 작은 일괄 처리의 행이나 (2) 현재 처리 중인 버퍼에 남아 있는 행이 커밋됩니다.

참고 항목

대상에서 제약 조건이 실패하면 최대 삽입 커밋 크기로 정의된 행의 전체 일괄 처리가 실패합니다.

데이터 액세스 모드 = 테이블 이름 또는 뷰 이름 변수

변수 이름
테이블 또는 뷰가 포함된 변수를 선택합니다.

데이터 액세스 모드 = 테이블 이름 또는 뷰 이름 변수 - 빠른 로드

변수 이름
테이블 또는 뷰가 포함된 변수를 선택합니다.

New
테이블 만들기 대화 상자를 사용하여 새 테이블를 만듭니다.

참고 항목

새로 만들기를 클릭하면 Integration Services는 연결된 데이터 원본에 따라 기본 CREATE TABLE 문을 생성합니다. 원본 테이블에 FILESTREAM 특성이 선언된 열이 포함되어 있더라도 이 기본 CREATE TABLE 문에는 FILESTREAM 특성이 포함되지 않습니다. FILESTREAM 특성을 사용하여 Integration Services 구성 요소를 실행하려면 먼저 대상 데이터베이스에 FILESTREAM 스토리지를 구현합니다. 그런 다음 테이블 만들기 대화 상자에서 FILESTREAM 특성을 CREATE TABLE 문에 추가하십시오. 자세한 내용은 Blob(Binary Large Object) 데이터(SQL Server)를 참조하세요.

ID 유지
데이터를 로드할 때 ID 값을 복사할지 여부를 지정합니다. 이 속성은 빠른 로드 옵션을 사용할 때만 사용할 수 있습니다. 이 속성의 기본값은 false입니다.

Null 유지
데이터를 로드할 때 null 값을 복사할지 여부를 지정합니다. 이 속성은 빠른 로드 옵션을 사용할 때만 사용할 수 있습니다. 이 속성의 기본값은 false입니다.

테이블 잠금
로드하는 동안 테이블 잠금을 설정할지 여부를 지정합니다. 이 속성의 기본값은 false입니다.

CHECK 제약 조건
태스크가 제약 조건을 검사할지 여부를 지정합니다. 이 속성의 기본값은 false입니다.

배치당 행 수
각 배치의 행 수를 지정합니다. 이 속성의 기본값은 값이 할당되지 않음을 나타내는 -1입니다.

참고 항목

이 속성에 사용자 지정 값을 할당하지 않으려면 OLE DB 대상 편집기에서 해당 입력란의 내용을 지우십시오.

최대 삽입 커밋 크기
빠른 로드 작업 중에 OLE DB 대상이 커밋하려고 하는 배치 크기를 지정합니다. 2147483647 기본값은 모든 행이 처리된 후 모든 데이터가 단일 일괄 처리로 커밋됨을 나타냅니다.

참고 항목

값 이 0 이면 OLE DB 대상 및 다른 데이터 흐름 구성 요소가 동일한 원본 테이블을 업데이트하는 경우 실행 중인 패키지의 응답이 중지될 수 있습니다. 패키지가 중지되지 않도록 하려면 최대 삽입 커밋 크기 옵션을 2147483647로 설정합니다.

데이터 액세스 모드 = SQL 명령

SQL 명령 텍스트
SQL 쿼리의 텍스트를 입력하거나, 쿼리 작성을 클릭하여 쿼리를 작성하거나, 찾아보기를 클릭하여 쿼리 텍스트가 포함된 파일을 찾습니다.

참고 항목

OLE DB 대상은 매개 변수를 지원하지 않습니다. 매개 변수가 있는 INSERT 문을 실행해야 하는 경우 OLE DB 명령 변환을 고려해야 합니다. 자세한 내용은 OLE DB 명령 변환을 참조하세요.

쿼리 작성
쿼리 작성기 대화 상자를 사용하여 SQL 쿼리를 시각적으로 생성합니다.

찾아보기
열기 대화 상자를 사용하여 SQL 쿼리 텍스트가 포함된 파일을 찾을 수 있습니다.

쿼리 구문 분석
쿼리 텍스트의 구문을 확인합니다.

OLE DB 대상 편집기(매핑 페이지)

OLE DB 대상 편집기 대화 상자의 매핑 페이지를 사용하여 입력 열을 대상 열에 매핑할 수 있습니다.

옵션

사용 가능한 입력 열
사용 가능한 입력 열 목록을 표시합니다. 끌어서 놓기 작업을 사용하여 테이블에서 사용 가능한 입력 열을 대상 열에 매핑합니다.

사용 가능한 대상 열
사용 가능한 대상 열 목록을 봅니다. 끌어서 놓기 작업을 사용하여 테이블의 사용 가능한 입력 열을 대상 열에 매핑합니다.

입력 열
선택한 입력 열을 표시합니다. <ignore>를 선택하여 매핑을 제거하면 출력에서 열을 제외할 수 있습니다.

대상 열
매핑 여부에 관계없이 사용 가능한 각 대상 열을 표시합니다.

OLE DB 대상 편집기(오류 출력 페이지)

OLE DB 대상 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 지정할 수 있습니다.

옵션

입/출력
입력의 이름을 봅니다.

열
사용되지 않습니다.

오류
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

관련 항목: 데이터 오류 처리

잘림
사용되지 않습니다.

설명
작업에 대한 설명을 살펴봐 주세요.

이 값을 선택한 셀로 설정
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

적용
선택된 셀에 오류 처리 옵션을 적용합니다.

관련 내용

OLE DB 원본

Integration Services(SSIS) 변수

데이터 흐름