ADO.NET 원본

  • 아티클

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

ADO NET 원본은 .NET 공급자의 데이터를 사용하고 데이터 흐름에서 데이터를 사용할 수 있도록 합니다.

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

데이터 형식 지원

원본은 특정 Integration Services 데이터 형식에 매핑되지 않는 모든 데이터 형식을 DT_NTEXT Integration Services 데이터 형식으로 변환합니다. 데이터 형식이 System.Object인 경우에도 이러한 변환이 발생합니다.

DT_NTEXT 데이터 형식을 DT_WSTR 데이터 형식으로 변경하거나 DT_NTEXT DT_WSTR 변경할 수 있습니다. 데이터 형식을 변경하려면 ADO.NET 원본의 고급 편집기 대화 상자에서 DataType 속성을 설정하면 됩니다. 자세한 내용은 공통 속성을 참조 하세요.

ADO.NET 원본 뒤에 데이터 변환을 사용하여 DT_NTEXT 데이터 형식을 DT_BYTES 또는 DT_STR 데이터 형식으로 변환할 수도 있습니다. 자세한 내용은 데이터 변환을 참조하세요.

Integration Services에서 날짜 데이터 형식(DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 및 DT_DBTIMESTAMPOFFSET)은 SQL Server의 특정 날짜 데이터 형식에 매핑됩니다. SQL Server에서 사용하는 날짜 데이터 형식을 Integration Services에서 사용하는 데이터 형식으로 변환하도록 ADO NET 원본을 구성할 수 있습니다. 이러한 날짜 데이터 형식을 변환하도록 ADO NET 원본을 구성하려면 ADO.NET 연결 관리자의 Type System Version 속성을 Latest로 설정합니다. (Type System Version 속성은 연결 관리자 대화 상자의 모든 페이지에 있습니다. 연결 관리자 대화 상자를 열려면 ADO.NET 연결 관리자를 마우스 오른쪽 단추로 클릭한 다음, 편집을 클릭합니다.)

참고 항목

ADO.NET 연결 관리자의 Type System Version 속성이 SQL Server 2005로 설정된 경우 시스템은 SQL Server 날짜 데이터 형식을 DT_WSTR 변환합니다.

ADO.NET 연결 관리자가 공급자를 SQL Server용 .NET 데이터 공급자(SqlClient)로 지정하면 시스템은 UDT(사용자 정의 데이터 형식)를 Integration Services BLOB(Binary Large Objects)로 변환합니다. 시스템은 UDT 데이터 형식을 변환할 때 다음 규칙을 적용합니다.

  • 데이터가 대규모가 아닌 UDT인 경우 시스템은 데이터를 DT_BYTES 변환합니다.

  • 데이터가 크지 않은 UDT이고 데이터베이스 열의 Length 속성이 -1 또는 8,000바이트보다 큰 값으로 설정된 경우 시스템은 데이터를 DT_IMAGE 변환합니다.

  • 데이터가 큰 UDT인 경우 시스템은 데이터를 DT_IMAGE 변환합니다.

    참고 항목

    ADO NET 원본이 오류 출력을 사용하도록 구성되지 않은 경우 시스템은 데이터를 8,000바이트의 청크로 DT_IMAGE 열로 스트리밍합니다. ADO.NET 원본이 오류 출력을 사용하도록 구성된 경우에는 시스템이 전체 바이트 배열을 DT_IMAGE 열로 전달합니다. 오류 출력을 사용할 구성 요소를 구성하는 방법에 대한 자세한 내용은 데이터의 오류 처리를 참조하세요.

Integration Services 데이터 형식, 지원되는 데이터 형식 변환 및 SQL Server를 포함한 특정 데이터베이스의 데이터 형식 매핑에 대한 자세한 내용은 Integration Services 데이터 형식을 참조 하세요.

Integration Services 데이터 형식을 관리되는 데이터 형식에 매핑하는 방법에 대한 자세한 내용은 데이터 흐름의 데이터 형식 작업을 참조하세요.

ADO.NET 원본 문제 해결

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

ADO.NET 원본 구성

결과 집합을 정의하는 SQL 문을 제공하여 ADO NET 원본을 구성합니다. 예를 들어 데이터베이스에 AdventureWorks2022 연결하고 SQL 문을 SELECT * FROM Production.Product 사용하는 ADO NET 원본은 Production.Product 테이블에서 모든 행을 추출하고 다운스트림 구성 요소에 데이터 세트를 제공합니다.

참고 항목

SQL 문을 사용하여 임시 테이블의 결과를 반환하는 저장 프로시저를 호출하는 경우 WITH RESULT SETS 옵션을 사용하여 결과 집합에 대한 메타데이터를 정의합니다.

참고 항목

SQL 문을 사용하여 저장 프로시저를 실행했는데 다음 오류 메시지와 함께 작업이 실패할 경우 Exec 문 앞에 SET FMTONLY OFF 문을 추가하여 오류를 해결할 수 있습니다.

열 <column_name>을 데이터 원본에서 찾을 수 없습니다.

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

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

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

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

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

ADO NET 원본 편집기(연결 관리자 페이지)

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

ADO NET 원본에 대한 자세한 내용은 ADO NET Source을 참조하십시오.

연결 관리자 페이지를 열려면

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

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

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

정적 옵션

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

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

데이터 액세스 모드
원본에서 데이터를 선택하는 방법을 지정합니다.

옵션 설명
테이블 또는 뷰 ADO.NET 데이터 원본의 테이블 또는 뷰에서 데이터를 검색합니다.
SQL 명령 SQL 쿼리를 사용하여 ADO.NET 데이터 원본에서 데이터를 검색합니다.

미리 보기
데이터 뷰 대화 상자를 사용하여 결과를 미리 봅니 다. 미리 보기 는 최대 200개의 행을 표시할 수 있습니다.

참고 항목

데이터를 미리 보면 CLR 사용자 정의 형식의 열에 데이터가 포함되지 않습니다. 대신 <값이 너무 커서 표시할 수 없습니다> 또는 System.Byte[] 값이 표시됩니다. 전자는 ADO.NET 공급자를 사용하여 데이터 원본에 액세스할 때 표시되고, 후자는 SQL Server Native Client 공급자를 사용할 때 표시됩니다.

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

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

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

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

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

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

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

ADO NET 원본 편집기(열 페이지)

ADO NET 원본 편집기 대화 상자의 열 페이지를 사용하여 출력 열을 각 외부(원본) 열에 매핑할 수 있습니다.

ADO NET 원본에 대한 자세한 내용은 ADO NET Source을 참조하십시오.

열 페이지를 열려면

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

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

  3. ADO NET 원본 편집기에서 열을 클릭합니다.

옵션

사용 가능한 외부 열
데이터 원본에서 사용 가능한 외부 열 목록을 봅니다. 이 테이블을 사용하여 열을 추가하거나 삭제할 수 없습니다.

외부 열
외부(원본) 열을 이 원본의 데이터를 사용하는 구성 요소를 구성할 때 표시되는 순서대로 봅니다.

출력 열
각 출력 열에 고유한 이름을 제공합니다. 기본값은 선택한 외부(원본) 열의 이름입니다. 그러나 고유한 설명이 포함된 이름을 선택할 수 있습니다. 제공한 이름은 SSIS 디자이너에 표시됩니다.

ADO NET 원본 편집기(오류 출력 페이지)

ADO NET 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택하고 오류 출력 열에 속성을 설정할 수 있습니다.

ADO NET 원본에 대한 자세한 내용은 ADO NET Source을 참조하십시오.

오류 출력 페이지를 열려면

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

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

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

옵션

입/출력
데이터 원본의 이름을 표시합니다.

세로 막대형
ADO NET 원본 편집기 대화 상자의 연결 관리자 페이지에서 선택한 외부(원본) 열을 봅니다.

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

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

잘림
잘림이 발생할 때 발생하는 작업을 지정합니다. 오류를 무시하거나 행을 리디렉션하거나 구성 요소를 실패합니다.

Description
오류에 대한 설명을 표시합니다.

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

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

참고 항목

DataReader 대상
ADO.NET 대상
데이터 흐름