ADO.NET 원본ADO NET Source

ADO.NET 원본은 .NET 공급자의 데이터를 사용하며 데이터 흐름에서 해당 데이터를 사용할 수 있도록 합니다.The ADO NET source consumes data from a .NET provider and makes the data available to the data flow.

ADO NET 원본을 사용하여 MicrosoftMicrosoft Azure SQL 데이터베이스Azure SQL Database에 연결할 수 있습니다.You can use the ADO NET source to connect to MicrosoftMicrosoft Azure SQL 데이터베이스Azure SQL Database. OLE DB를 사용하여 SQL 데이터베이스SQL Database 에 연결할 수는 없습니다.Connecting to SQL 데이터베이스SQL Database by using OLE DB is not supported. SQL 데이터베이스SQL Database에 대한 자세한 내용은 일반 보안 지침 및 제한 사항(Microsoft Azure SQL Database)을 참조하세요.For more information about SQL 데이터베이스SQL Database, see General Guidelines and Limitations (Windows Azure SQL Database).

데이터 형식 지원Data Type Support

원본은 특정 Integration ServicesIntegration Services 데이터 형식에 매핑되지 않는 모든 데이터 형식을 DT_NTEXT Integration ServicesIntegration Services 데이터 형식으로 변환합니다.The source converts any data type that does not map to a specific Integration ServicesIntegration Services data type to the DT_NTEXT Integration ServicesIntegration Services data type. 데이터 형식이 System.Object인 경우에도 이러한 변환이 발생합니다.This conversion occurs even if the data type is System.Object.

DT_NTEXT 데이터 형식을 DT_WSTR 데이터 형식으로 변경하거나 DT_WSTR을 DT_NTEXT로 변경할 수 있습니다.You can change the DT_NTEXT data type to the DT_WSTR data type, or the change DT_WSTR to DT_NTEXT. 데이터 형식을 변경하려면 ADO.NET 원본의 고급 편집기 대화 상자에서 DataType 속성을 설정하면 됩니다.You change data types by setting the DataType property in the Advanced Editor dialog box of the ADO NET source. 자세한 내용은 Common Properties을(를) 참조하세요.For more information, see Common Properties.

ADO.NET 원본 뒤에 데이터 변환을 사용하여 DT_NTEXT 데이터 형식을 DT_BYTES 또는 DT_STR 데이터 형식으로 변환할 수도 있습니다.The DT_NTEXT data type can also be converted to the DT_BYTES or DT_STR data type by using a Data Conversion transformation after the ADO NET source. 자세한 내용은 Data Conversion Transformation을 참조하세요.For more information, see Data Conversion Transformation.

Integration ServicesIntegration Services에서 날짜 데이터 형식인 DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 및 DT_DBTIMESTAMPOFFSET은 SQL ServerSQL Server의 특정 날짜 데이터 형식에 매핑됩니다.In Integration ServicesIntegration Services, the date data types, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2, and DT_DBTIMESTAMPOFFSET, map to certain date data types in SQL ServerSQL Server. ADO.NET 원본을 구성하여 SQL ServerSQL Server 에서 사용되는 날짜 데이터 형식을 Integration ServicesIntegration Services 에서 사용되는 날짜 데이터 형식으로 변환할 수 있습니다.You can configure the ADO NET source to convert the date data types from those that SQL ServerSQL Server uses to those that Integration ServicesIntegration Services uses. ADO.NET 원본을 구성하여 이러한 날짜 데이터 형식을 변환하려면 연결 관리자의 Type System Version ADO.NETADO.NET 속성을 Latest로 설정합니다.To configure the ADO NET source to convert these date data types, set the Type System Version property of the ADO.NETADO.NET connection manager to Latest. Type System Version 속성은 연결 관리자 대화 상자의 모두 페이지에 있습니다.(The Type System Version property is on the All page of the Connection Manager dialog box. 연결 관리자 대화 상자를 열려면 ADO.NETADO.NET 연결 관리자를 마우스 오른쪽 단추로 클릭한 다음 편집을 클릭합니다.To open the Connection Manager dialog box, right-click the ADO.NETADO.NET connection manager, and then click Edit.)

참고

연결 관리자의 Type System Version ADO.NETADO.NET 속성을 SQL Server 2005로 설정하면 시스템은 SQL ServerSQL Server 날짜 데이터 형식을 DT_WSTR로 변환합니다.If the Type System Version property for the ADO.NETADO.NET connection manager is set to SQL Server 2005, the system converts the SQL ServerSQL Server date data types to DT_WSTR.

Integration ServicesIntegration Services 연결 관리자가 공급자를 .NET Data Provider for ADO.NETADO.NET (SqlClient)로 지정하면 시스템은 UDT(사용자 정의 데이터 형식)를 SQL ServerSQL Server BLOB(Binary Large Object)으로 변환합니다.The system converts user-defined data types (UDTs) to Integration ServicesIntegration Services binary large objects (BLOB) when the ADO.NETADO.NET connection manager specifies the provider as the .NET Data Provider for SQL ServerSQL Server (SqlClient). 시스템은 UDT 데이터 형식을 변환할 때 다음 규칙을 적용합니다.The system applies the following rules when it converts the UDT data type:

  • 데이터가 큰 UDT가 아니면 시스템은 데이터를 DT_BYTES로 변환합니다.If the data is a non-large UDT, the system converts the data to DT_BYTES.

  • 데이터가 큰 UDT가 아니고 데이터베이스의 열에 대한 Length 속성이 -1 또는 8,000바이트보다 큰 값으로 설정되어 있으면 시스템은 데이터를 DT_IMAGE로 변환합니다.If the data is a non-large UDT, and the Length property of the column on the database is set to -1 or a value greater than 8,000 bytes, the system converts the data to DT_IMAGE.

  • 데이터가 큰 UDT이면 시스템은 데이터를 DT_ IMAGE로 변환합니다.If the data is a large UDT, the system converts the data to DT_IMAGE.

    참고

    ADO.NET 원본이 오류 출력을 사용하도록 구성되지 않은 경우 시스템은 데이터를 8,000바이트 청크로 DT_IMAGE 열에 스트리밍합니다.If the ADO NET source is not configured to use error output, the system streams the data to the DT_IMAGE column in chunks of 8,000 bytes. ADO.NET 원본이 오류 출력을 사용하도록 구성된 경우에는 시스템이 전체 바이트 배열을 DT_IMAGE 열로 전달합니다.If the ADO NET source is configured to use error output, the system passes the whole array of bytes to the DT_IMAGE column. 오류 출력을 사용할 구성 요소를 구성하는 방법에 대한 자세한 내용은 데이터의 오류 처리를 참조하세요.For more information about how to configure components to use error output, see Error Handling in Data.

    Integration ServicesIntegration Services 데이터 형식, 지원되는 데이터 형식 변환 및 SQL ServerSQL Server를 비롯한 특정 데이터베이스에서의 데이터 형식 매핑에 대한 자세한 내용은 Integration Services 데이터 형식을 참조하세요.For more information about the Integration ServicesIntegration Services data types, supported data type conversions, and data type mapping across certain databases including SQL ServerSQL Server, see Integration Services Data Types.

    Integration ServicesIntegration Services 데이터 형식을 관리 데이터 형식에 매핑하는 방법에 대한 자세한 내용은 데이터 흐름의 데이터 형식 작업를 참조하세요.For information about mapping Integration ServicesIntegration Services data types to managed data types, see Working with Data Types in the Data Flow.

ADO.NET 원본 문제 해결ADO NET Source Troubleshooting

ADO.NET 원본이 외부 데이터 공급자에 대해 수행하는 호출을 로깅할 수 있습니다.You can log the calls that the ADO NET source makes to external data providers. 이 로깅 기능을 사용하면 ADO.NET 원본이 외부 데이터 원본에서 데이터를 로드할 때 발생하는 문제를 해결할 수 있습니다.You can use this logging capability to troubleshoot the loading of data from external data sources that the ADO NET source performs. ADO.NET 원본이 외부 데이터 공급자에 대해 수행하는 호출을 로깅하려면 패키지 로깅을 사용하고 패키지 수준에서 Diagnostic 이벤트를 선택합니다.To log the calls that the ADO NET source makes to external data providers, enable package logging and select the Diagnostic event at the package level. 자세한 내용은 패키지 실행 문제 해결 도구를 참조하세요.For more information, see Troubleshooting Tools for Package Execution.

ADO.NET 원본 구성ADO NET Source Configuration

결과 집합을 정의하는 SQL 문을 제공하여 ADO.NET 원본을 구성합니다.You configure the ADO NET source by providing the SQL statement that defines the result set. 예를 들어 AdventureWorks2012AdventureWorks2012 데이터베이스에 연결되고 SQL 문 SELECT * FROM Production.Product 를 사용하는 ADO.NET 원본은 Production.Product 테이블에서 모든 행을 추출하고 다운스트림 구성 요소에 해당 데이터 집합을 제공합니다.For example, an ADO NET source that connects to the AdventureWorks2012AdventureWorks2012 database and uses the SQL statement SELECT * FROM Production.Product extracts all the rows from the Production.Product table and provides the dataset to a downstream component.

참고

SQL 문을 사용하여 임시 테이블의 결과를 반환하는 저장 프로시저를 호출하는 경우 WITH RESULT SETS 옵션을 사용하여 결과 집합의 메타데이터를 정의합니다.When you use an SQL statement to invoke a stored procedure that returns results from a temporary table, use the WITH RESULT SETS option to define metadata for the result set.

참고

SQL 문을 사용하여 저장 프로시저를 실행했는데 다음 오류 메시지와 함께 작업이 실패할 경우 Exec 문 앞에 SET FMTONLY OFF 문을 추가하여 오류를 해결할 수 있습니다.If you use an SQL statement to execute a stored procedure and the package fails with the following error, you may be able to resolve the error by adding the SET FMTONLY OFF statement before the exec statement.

열 <열_이름>을(를) 데이터 원본에서 찾을 수 없습니다.Column cannot be found at the datasource.

ADO.NET 원본은 ADO.NETADO.NET 연결 관리자를 사용하여 데이터 원본에 연결하며 이 연결 관리자는 .NET 공급자를 지정합니다.The ADO NET source uses an ADO.NETADO.NET connection manager to connect to a data source, and the connection manager specifies the .NET provider. 자세한 내용은 ADO.NET Connection Manager을(를) 참조하세요.For more information, see ADO.NET Connection Manager.

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

SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

고급 편집기 대화 상자를 사용하거나 프로그래밍 방식으로 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하세요.For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

관련 항목:See Also

DataReader 대상 DataReader Destination
ADO NET 대상 ADO NET Destination
데이터 흐름Data Flow