다음을 통해 공유


ADO.NET 대상

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

ADO NET 대상은 다양한 ADO에 데이터를 로드합니다. 데이터베이스 테이블 또는 뷰를 사용하는 NET 규격 데이터베이스입니다. 이 데이터를 기존 테이블 또는 뷰에 로드하는 옵션이 있거나 새 테이블을 만들고 새 테이블에 데이터를 로드할 수 있습니다.

ADO NET 대상을 사용하여 Microsoft Azure SQL Database에 연결할 수 있습니다. OLE DB를 사용하여 SQL Database에 연결할 수는 없습니다. SQL Database에 대한 자세한 내용은 일반 보안 지침 및 제한 사항(Azure SQL Database)을 참조하세요.

ADO.NET 대상 문제 해결

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

ADO NET 대상 구성

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

ADO NET 데이터베이스 대상에는 입력 열과 대상 데이터 원본의 열 간 매핑이 포함됩니다. 입력 열을 모든 대상 열에 매핑하지 않아도 됩니다. 그러나 일부 대상 열의 속성에는 입력 열의 매핑이 필요할 수 있습니다. 그렇지 않으면 오류가 발생할 수 있습니다. 예를 들어 대상 열이 null 값을 허용하지 않는 경우 입력 열을 해당 대상 열에 매핑해야 합니다. 또한 매핑된 열의 데이터 형식은 호환되어야 합니다. 예를 들어 ADO.NET 공급자가 이 매핑을 지원하지 않는 경우 문자열 데이터 형식의 입력 열을 숫자 데이터 형식이 있는 대상 열에 매핑할 수 없습니다.

참고 항목

SQL Server는 데이터 형식이 이미지로 설정된 열에 텍스트 삽입을 지원하지 않습니다. SQL Server 데이터 형식에 대한 자세한 내용은 데이터 형식(Transact-SQL)을 참조하세요.

참고 항목

ADO.NET 대상은 DT_DBTIME 유형으로 설정된 입력 열을 datetime 유형으로 설정된 데이터베이스 열에 매핑하는 작업을 지원하지 않습니다. Integration Services 데이터 형식에 대한 자세한 내용은 Integration Services 데이터 형식을 참조하세요.

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

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

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

속성을 설정하는 방법에 대한 자세한 내용은 데이터 흐름 구성 요소의 속성 설정을 참조하세요.

ADO NET 대상 편집기(연결 관리자 페이지)

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

연결 관리자 페이지 열기

  1. SSDT(SQL Server Data Tools)에서 ADO NET 대상이 있는 Integration Services 패키지를 엽니다.

  2. 데이터 흐름 탭에서 ADO NET 대상을 두 번 클릭합니다.

  3. ADO NET 대상 편집기에서 연결 관리자를 클릭합니다.

정적 옵션

연결 관리자
목록에서 기존 연결 관리자를 선택하거나 새로 만들기를 클릭하여 새 연결을 만듭니다.

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

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

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

참고 항목

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

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

사용 가능한 경우 대량 삽입 사용
SqlBulkCopy 인터페이스를 사용하여 대량 삽입 작업의 성능을 향상시킬지 여부를 지정합니다.

SqlConnection 개체를 반환하는 ADO.NET 공급자만 SqlBulkCopy 인터페이스 사용을 지원합니다. .NET Data Provider for SQL Server(SqlClient)는 SqlConnection 개체를 반환하고, 사용자 지정 공급자는 SqlConnection 개체를 반환할 수 있습니다.

.NET Data Provider for SQL Server(SqlClient)를 사용하여 Microsoft Azure SQL 데이터베이스에 연결할 수 있습니다.

사용 가능한 경우 대량 삽입 사용을 선택하고 행을 리디렉션하는 오류 옵션을 설정하는 경우 대상에서 오류 출력으로 리디렉션하는 데이터 일괄 처리에 좋은 행이 포함될 수 있습니다. 대량 작업의 오류 처리에 대한 자세한 내용은 데이터에서 오류 처리를 참조하세요. 오류 옵션에 대한 자세한 내용은 ADO NET 대상 편집기(오류 출력 페이지)를 참조하세요.

참고 항목

SQL Server 또는 Sybase 원본 테이블에 ID 열이 포함된 경우 SQL 작업 실행을 사용하여 ADO NET 대상 앞에 IDENTITY_INSERT를 사용하도록 설정하고 나중에 다시 비활성화해야 합니다. (ID 열 속성은 열에 대한 증분 값을 지정합니다. SET IDENTITY_INSERT 문을 사용하면 원본 테이블의 명시적 값을 대상 테이블의 ID 열에 삽입할 수 있습니다.)

SET IDENTITY_INSERT 문 및 데이터 로드를 성공적으로 실행하려면 다음 작업을 수행해야 합니다.
1. SQL 실행 태스크 및 ADO.NET 대상에 대해 동일한 ADO.NET 연결 관리자를 사용합니다.
2. 연결 관리자에서 RetainSameConnection 속성 및 MultipleActiveResultSets 속성을 True로 설정합니다.
3. ADO.NET 대상에서 UseBulkInsertWhenPossible 속성을 False로 설정합니다.

자세한 내용은 SET IDENTITY_INSERT(Transact-SQL)IDENTITY(속성)(Transact-SQL)를 참조하세요.

외부 리소스

기술 문서, Azure SQL Database에 빠른 데이터 로드, sqlcat.com

ADO NET 대상 편집기(매핑 페이지)

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

매핑 페이지를 열려면

  1. SSDT(SQL Server Data Tools)에서 ADO NET 대상이 있는 Integration Services 패키지를 엽니다.

  2. 데이터 흐름 탭에서 ADO NET 대상을 두 번 클릭합니다.

  3. ADO NET 대상 편집기에서 매핑을 클릭합니다.

옵션

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

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

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

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

ADO NET 대상 편집기(오류 출력 페이지)

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

오류 출력 페이지를 열려면

  1. SSDT(SQL Server Data Tools)에서 ADO NET 대상이 있는 Integration Services 패키지를 엽니다.

  2. 데이터 흐름 탭에서 ADO NET 대상을 두 번 클릭합니다.

  3. ADO NET 대상 편집기에서 오류 출력을 클릭합니다.

옵션

입력 또는 출력
입력의 이름을 봅니다.


사용되지 않습니다.

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

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

잘림
사용되지 않습니다.

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

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

적용
선택된 셀에 오류 처리 옵션을 적용해 주세요.