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 <column_name> 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:

ADO NET 원본 편집기(연결 관리자 페이지)ADO NET Source Editor (Connection Manager Page)

ADO NET 원본 편집기 대화 상자의 연결 관리자 페이지를 사용하여 원본의 ADO.NETADO.NET 연결 관리자를 선택할 수 있습니다.Use the Connection Manager page of the ADO NET Source Editor dialog box to select the ADO.NETADO.NET connection manager for the source. 이 페이지를 사용하면 데이터베이스에서 테이블이나 뷰를 선택할 수도 있습니다.This page also lets you select a table or view from the database.

ADO NET 원본에 대한 자세한 내용은 ADO NET Source을 참조하십시오.To learn more about the ADO NET source, see ADO NET Source.

연결 관리자 페이지를 열려면To open the Connection Manager page

  1. SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)에서 ADO NET 원본이 있는 Integration ServicesIntegration Services 패키지를 엽니다.In SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services package that has the ADO NET source.

  2. 데이터 흐름 탭에서 ADO NET 원본을 두 번 클릭합니다.On the Data Flow tab, double-click the ADO NET source.

  3. ADO NET 원본 편집기에서 연결 관리자를 클릭합니다.In the ADO NET Source Editor, click Connection Manager.

정적 옵션Static Options

ADO.NET 연결 관리자ADO.NET connection manager
목록에서 기존 연결 관리자를 선택하거나 새로 만들기를 클릭하여 새 연결을 만듭니다.Select an existing connection manager from the list, or create a new connection by clicking New.

새로 만들기New
ADO.NET 연결 관리자 구성 대화 상자를 사용하여 새 연결 관리자를 만듭니다.Create a new connection manager by using the Configure ADO.NET Connection Manager dialog box.

데이터 액세스 모드Data access mode
원본에서 데이터를 선택하는 방법을 지정합니다.Specify the method for selecting data from the source.

옵션Option DescriptionDescription
테이블 또는 뷰Table or view ADO.NETADO.NET 데이터 원본에 있는 테이블이나 뷰에서 데이터를 검색합니다.Retrieve data from a table or view in the ADO.NETADO.NET data source.
SQL 명령SQL command SQL 쿼리를 사용하여 ADO.NETADO.NET 데이터 원본에서 데이터를 검색합니다.Retrieve data from the ADO.NETADO.NET data source by using a SQL query.

미리 보기Preview
데이터 보기 대화 상자를 사용하여 결과를 미리 봅니다.Preview results by using the Data View dialog box. 미리 보기 에는 최대 200개의 행이 표시될 수 있습니다.Preview can display up to 200 rows.

참고

데이터를 미리 보면 CLR 사용자 정의 형식의 열에 데이터가 포함되지 않습니다.When you preview data, columns with a CLR user-defined type do not contain data. 대신 값 <너무 커서 표시할 값 > 또는 System.Byte 표시 합니다.Instead the values <value too big to display> or System.Byte[] display. 전자는 ADO.NETADO.NET 공급자를 사용하여 데이터 원본에 액세스하는 경우 표시되고 후자는 SQL ServerSQL Server Native Client 공급자를 사용하는 경우 표시됩니다.The former displays when the data source is accessed by using the ADO.NETADO.NET provider, the latter when using the SQL ServerSQL Server Native Client provider.

데이터 액세스 모드 동적 옵션Data Access Mode Dynamic Options

데이터 액세스 모드 = 테이블 또는 뷰Data access mode = Table or view

테이블 또는 뷰 이름Name of the table or the view
데이터 원본의 사용 가능한 테이블 또는 뷰 목록에서 테이블 또는 뷰 이름을 선택합니다.Select the name of the table or view from a list of those available in the data source.

데이터 액세스 모드 = SQL 명령Data access mode = SQL command

SQL 명령 텍스트SQL command text
SQL 쿼리 텍스트를 입력하고 쿼리 작성을 클릭하여 쿼리를 작성하거나 찾아보기를 클릭하여 쿼리 텍스트가 포함된 파일을 찾습니다.Enter the text of a SQL query, build the query by clicking Build Query, or locate the file that contains the query text by clicking Browse.

Build queryBuild query
쿼리 작성기 대화 상자를 사용하여 시각적으로 SQL 쿼리를 생성할 수 있습니다.Use the Query Builder dialog box to construct the SQL query visually.

찾아보기Browse
열기 대화 상자를 사용하여 SQL 쿼리 텍스트가 포함된 파일을 찾을 수 있습니다.Use the Open dialog box to locate the file that contains the text of the SQL query.

ADO NET 원본 편집기(열 페이지)ADO NET Source Editor (Columns Page)

ADO NET 원본 편집기 대화 상자의 페이지를 사용하여 출력 열을 각 외부(원본) 열에 매핑할 수 있습니다.Use the Columns page of the ADO NET Source Editor dialog box to map an output column to each external (source) column.

ADO NET 원본에 대한 자세한 내용은 ADO NET Source을 참조하십시오.To learn more about the ADO NET source, see ADO NET Source.

열 페이지를 열려면To open the Columns page

  1. SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)에서 ADO NET 원본이 있는 Integration ServicesIntegration Services 패키지를 엽니다.In SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services package that has the ADO NET source.

  2. 데이터 흐름 탭에서 ADO NET 원본을 두 번 클릭합니다.On the Data Flow tab, double-click the ADO NET source.

  3. ADO NET 원본 편집기에서 을 클릭합니다.In the ADO NET Source Editor, click Columns.

옵션Options

사용 가능한 외부 열Available External Columns
데이터 원본에서 사용 가능한 외부 열의 목록을 표시합니다.View the list of available external columns in the data source. 이 테이블을 사용하여 열을 추가하거나 삭제할 수 없습니다.You cannot use this table to add or delete columns.

외부 열External Column
이 원본의 데이터를 사용하는 구성 요소를 구성할 때 표시되는 순서로 외부(원본) 열을 표시합니다.View external (source) columns in the order in which you will see them when configuring components that consume data from this source.

출력 열Output Column
각 출력 열에 고유한 이름을 지정합니다.Provide a unique name for each output column. 기본값은 선택한 외부(원본) 열의 이름이지만 설명이 포함된 고유 이름을 임의로 선택할 수 있습니다.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name. 제공한 이름은 SSISSSIS 디자이너에 표시됩니다.The name provided will be displayed within the SSISSSIS Designer.

ADO NET 원본 편집기(오류 출력 페이지)ADO NET Source Editor (Error Output Page)

ADO NET 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택하고 오류 출력 열에 속성을 설정할 수 있습니다.Use the Error Output page of the ADO NET Source Editor dialog box to select error handling options and to set properties on error output columns.

ADO NET 원본에 대한 자세한 내용은 ADO NET Source을 참조하십시오.To learn more about the ADO NET source, see ADO NET Source.

오류 출력 페이지를 열려면To open the Error Output page

  1. SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)에서 ADO NET 원본이 있는 Integration ServicesIntegration Services 패키지를 엽니다.In SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services package that has the ADO NET source.

  2. 데이터 흐름 탭에서 ADO NET 원본을 두 번 클릭합니다.On the Data Flow tab, double-click the ADO NET source.

  3. ADO NET 원본 편집기에서 오류 출력을 클릭합니다.In the ADO NET Source Editor, click Error Output.

옵션Options

입/출력Input/Output
데이터 원본의 이름을 표시합니다.View the name of the data source.

Column
ADO NET 원본 편집기 대화 상자의 연결 관리자 페이지에서 선택한 외부(원본) 열을 표시합니다.View the external (source) columns that you selected on the Connection Manager page of the ADO NET Source Editor dialog box.

오류Error
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

관련 항목: 데이터 오류 처리Related Topics: Error Handling in Data

잘림Truncation
잘림이 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescriptionDescription
오류에 대한 설명을 표시합니다.View the description of the error.

이 값을 선택한 셀에 설정Set this value to selected cells
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

적용Apply
선택한 셀에 오류 처리 옵션을 적용합니다.Apply the error handling option to the selected cells.

참고 항목See Also

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