ADO.NET 대상ADO NET Destination

ADO.NET 대상은 데이터베이스 테이블이나 뷰를 사용하는 다양한 ADO.NETADO.NET호환 데이터베이스로 데이터를 로드합니다.The ADO NET destination loads data into a variety of ADO.NETADO.NET-compliant databases that use a database table or view. 이 데이터를 기존 테이블이나 뷰에 로드하는 옵션이 제공되거나 새 테이블을 만들고 데이터를 새 테이블에 로드할 수 있습니다.You have the option of loading this data into an existing table or view, or you can create a new table and load the data into the new table.

ADO NET 대상을 사용하여 MicrosoftMicrosoft Azure SQL 데이터베이스Azure SQL Database에 연결할 수 있습니다.You can use the ADO NET destination 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).

ADO.NET 대상 문제 해결Troubleshooting the ADO NET Destination

ADO.NET 대상이 외부 데이터 공급자에 대해 수행하는 호출을 로깅할 수 있습니다.You can log the calls that the ADO NET destination makes to external data providers. 이 로깅 기능을 사용하여 ADO.NET 대상이 수행하는 외부 데이터 원본에 대한 데이터 저장 문제를 해결할 수 있습니다.You can use this logging capability to troubleshoot the saving of data to external data sources that the ADO NET destination performs. ADO.NET 대상이 외부 데이터 공급자에 대해 수행하는 호출을 로깅하려면 패키지 로깅을 설정하고 패키지 수준에서 Diagnostic 이벤트를 선택합니다.To log the calls that the ADO NET destination 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 대상 구성Configuring the ADO NET Destination

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

ADO.NET 대상에는 입력 열과 대상 데이터 원본 열 사이의 매핑이 포함되므로An ADO NET destination includes mappings between input columns and columns in the destination data source. 입력 열을 모든 대상 열에 매핑하지 않아도 됩니다.You do not have to map input columns to all destination columns. 그러나 일부 대상 열의 속성에서 입력 열을 매핑해야 할 수도 있습니다.However, the properties of some destination columns can require the mapping of input columns. 그렇지 않으면 오류가 발생할 수 있습니다.Otherwise, errors might occur. 예를 들어 대상 열에 Null 값이 허용되지 않는 경우에는 입력 열을 해당 대상 열로 매핑해야 합니다.For example, if a destination column does not allow for null values, you must map an input column to that destination column. 또한 매핑된 열의 데이터 형식이 호환되어야 합니다.In addition, the data types of mapped columns must be compatible. 예를 들어 ADO.NETADO.NET 공급자에서 지원하지 않을 경우 문자열 데이터 형식의 입력 열을 숫자 데이터 형식의 대상 열에 매핑할 수 없습니다.For example, you cannot map an input column with a string data type to a destination column with a numeric data type if the ADO.NETADO.NET provider does not support this mapping.

참고

SQL ServerSQL Server데이터 형식이 이미지로 설정 된 열에 텍스트 삽입을 지원 하지 않습니다. does not support inserting text into columns whose data type is set to image. SQL ServerSQL Server 데이터 형식에 대한 자세한 내용은 데이터 형식(Transact-SQL)을 참조하세요.For more information about SQL ServerSQL Server data types, see Data Types (Transact-SQL).

참고

ADO.NET 대상은 DT_DBTIME 유형으로 설정된 입력 열을 datetime 유형으로 설정된 데이터베이스 열에 매핑하는 작업을 지원하지 않습니다.The ADO NET destination does not support mapping an input column whose type is set to DT_DBTIME to a database column whose type is set to datetime. Integration ServicesIntegration Services 데이터 형식에 대한 자세한 내용은 Integration Services 데이터 형식을 참조하세요.For more information about Integration ServicesIntegration Services data types, see Integration Services Data Types.

ADO.NET 대상에는 하나의 일반 입력과 하나의 오류 출력이 있습니다.The ADO NET destination has one regular input and one error output.

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

고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 속성이 표시됩니다.The Advanced Editor dialog box reflects the properties that can be set 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 Destination Editor (Connection Manager Page)

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

연결 관리자 페이지를 열려면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 destination.

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

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

정적 옵션Static Options

Connection managerConnection 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.

테이블 또는 뷰 사용Use a table or view
목록에서 기존 테이블 또는 뷰를 선택하거나 새로 만들기를 클릭하여 새 테이블을 만듭니다.Select an existing table or view from the list, or create a new table by clicking New..

새로 만들기New
테이블 만들기 대화 상자를 사용하여 새 테이블 또는 뷰를 만듭니다.Create a new table or view by using the Create Table dialog box.

참고

새로 만들기를 클릭하면 Integration ServicesIntegration Services 에서 연결된 데이터 원본에 따라 기본 CREATE TABLE 문을 생성합니다.When you click New, Integration ServicesIntegration Services generates a default CREATE TABLE statement based on the connected data source. 원본 테이블에 선언된 FILESTREAM 특성이 포함된 열이 있어도 기본 CREATE TABLE 문은 FILESTREAM 특성을 포함하지 않습니다.This default CREATE TABLE statement will not include the FILESTREAM attribute even if the source table includes a column with the FILESTREAM attribute declared. FILESTREAM 특성이 포함된 Integration ServicesIntegration Services 구성 요소를 실행하려면 먼저 대상 데이터베이스에서 FILESTREAM 저장소를 구현하십시오.To run an Integration ServicesIntegration Services component with the FILESTREAM attribute, first implement FILESTREAM storage on the destination database. 그런 다음 테이블 만들기 대화 상자에서 FILESTREAM 특성을 CREATE TABLE 문에 추가하십시오.Then, add the FILESTREAM attribute to the CREATE TABLE statement in the Create Table dialog box. 자세한 내용은 Blob(Binary Large Object) 데이터(SQL Server)를 참조하세요.For more information, see Binary Large Object (Blob) Data (SQL Server).

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

사용 가능한 경우 대량 삽입 사용Use bulk insert when available
SqlBulkCopy 인터페이스를 사용하여 대량 삽입 작업의 성능을 향상시킬지 여부를 지정합니다.Specify whether to use the SqlBulkCopy interface to improve the performance of bulk insert operations.

반환 하는 ADO.NET 공급자만 한 SqlConnection 개체의 사용을 지원는 SqlBulkCopy 인터페이스입니다.Only ADO.NET providers that return a SqlConnection object support the use of the SqlBulkCopy interface. .NET Data Provider for SQL Server(SqlClient)는 SqlConnection 개체를 반환하고, 사용자 지정 공급자는 SqlConnection 개체를 반환할 수 있습니다.The .NET Data Provider for SQL Server (SqlClient) returns a SqlConnection object, and a custom provider may return a SqlConnection object.

.NET Data Provider for SQL Server(SqlClient)를 사용하여 MicrosoftMicrosoft Azure SQL 데이터베이스Azure SQL Database에 연결할 수 있습니다.You can use the .NET Data Provider for SQL Server (SqlClient) to connect to MicrosoftMicrosoft Azure SQL 데이터베이스Azure SQL Database.

사용 가능한 경우 대량 삽입 사용을 선택하고 오류 옵션을 행 리디렉션으로 설정하면 대상에서 오류 출력으로 리디렉션하는 일괄 처리 데이터에 올바른 행이 포함될 수 있습니다. 대량 작업에서 오류 처리에 대한 자세한 내용은 데이터 오류 처리를 참조하세요.If you select Use bulk insert when available, and set the Error option to Redirect the row, the batch of data that the destination redirects to the error output may include good rows.For more information about handling errors in bulk operations, see Error Handling in Data. 에 대 한 자세한 내용은 오류 옵션 ADO NET 대상 편집기 ( 오류 출력 페이지 ) .For more information about the Error option, see ADO NET Destination Editor (Error Output Page).

참고

SQL Server 또는 Sybase 원본 테이블에서 id 열을 포함 하는 경우 ADO NET 대상 전에 IDENTITY_INSERT를 사용 하도록 설정 하 고 나중에 다시 사용할 수 없도록 SQL 실행 태스크를 사용 해야 합니다.If a SQL Server or Sybase source table includes an identity column, you must use Execute SQL tasks to enable IDENTITY_INSERT before the ADO NET destination and to disable it again afterward. (Identity column 속성 열에 대 한 증분 값을 지정합니다.(The identity column property specifies an incremental value for the column. SET IDENTITY_INSERT 문을 사용 하면 대상 테이블에 id 열에 삽입할 원본 테이블에서 명시적 값.)The SET IDENTITY_INSERT statement lets explicit values from the source table be inserted into the identity column in the destination table.)

SET IDENTITY_INSERT 문 및 데이터를 성공적으로 로드를 실행 하려면 다음을 수행 해야 합니다.To run the SET IDENTITY_INSERT statements and the data loading successfully, you have to do the following things. 1.1. ADO.NET 대상 및 SQL 실행 태스크에 대 한 동일한 ADO.NET 연결 관리자를 사용 합니다.Use the same ADO.NET connection manager for the Execute SQL tasks and for the ADO.NET destination. 2.2. 연결 관리자에서 설정 된 RetainSameConnection 속성 및 MultipleActiveResultSets 속성을 True로 합니다.On the connection manager, set the RetainSameConnection property and the MultipleActiveResultSets property to True. 3.3. ADO.NET 대상에서 설정 된 UseBulkInsertWhenPossible 속성을 false로 합니다.On the ADO.NET destination, set the UseBulkInsertWhenPossible property to False.

자세한 내용은 SET IDENTITY_INSERT(Transact-SQL)IDENTITY(속성)(Transact-SQL)를 참조하세요.For more information, see SET IDENTITY_INSERT (Transact-SQL) and IDENTITY (Property) (Transact-SQL).

외부 리소스External Resources

sqlcat.com의 기술 문서 - Windows Azure SQL Database에 빨리 데이터 로드Technical article, Loading data to Windows Azure SQL Database the fast way, on sqlcat.com

ADO NET 대상 편집기(매핑 페이지)ADO NET Destination Editor (Mappings Page)

ADO NET 대상 편집기 대화 상자의 매핑 페이지를 사용하여 입력 열을 대상 열에 매핑할 수 있습니다.Use the Mappings page of the ADO NET Destination Editor dialog box to map input columns to destination columns.

매핑 페이지를 열려면To open the Mappings 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 destination.

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

  3. ADO NET 대상 편집기에서 매핑을 클릭합니다.In the ADO NET Destination Editor, click Mappings.

옵션Options

사용 가능한 입력 열Available Input Columns
사용 가능한 입력 열 목록을 표시합니다.View the list of available input columns. 끌어서 놓기 작업을 사용하여 테이블에서 사용 가능한 입력 열을 대상 열에 매핑합니다.Use a drag-and-drop operation to map available input columns in the table to destination columns.

사용 가능한 대상 열Available Destination Columns
사용 가능한 대상 열의 목록을 표시합니다.View the list of available destination columns. 끌어서 놓기 작업을 사용하여 테이블에서 사용 가능한 대상 열을 입력 열에 매핑합니다.Use a drag-and-drop operation to map available destination columns in the table to input columns.

입력 열Input Column
선택한 입력 열을 표시합니다.View the input columns that you selected. 선택 하 여 매핑을 제거할 수 있습니다 <무시 > 출력에서 열을 제외 합니다.You can remove mappings by selecting <ignore> to exclude columns from the output.

대상 열Destination Column
매핑 여부에 관계없이 사용 가능한 각 대상 열을 표시합니다.View each available destination column, regardless of whether it is mapped or not.

ADO NET 대상 편집기(오류 출력 페이지)ADO NET Destination Editor (Error Output Page)

ADO NET 대상 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 지정할 수 있습니다.Use the Error Output page of the ADO NET Destination Editor dialog box to specify error handling options.

오류 출력 페이지를 열려면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 destination.

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

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

옵션Options

입력 또는 출력Input or Output
입력 이름을 표시합니다.View the name of the input.

Column
사용되지 않습니다.Not used.

오류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
사용되지 않습니다.Not used.

DescriptionDescription
작업에 대한 설명을 표시합니다.View the description of the operation.

이 값을 선택한 셀에 설정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.