DatasetDestination 구성 요소 예제

아티클
12/15/2008

DatasetDestination 예제는 Business Intelligence Development Studio에 통합되고 데이터 흐름 작업에 추가될 수 있는 사용자 지정 대상 구성 요소를 구현하는 방법을 보여 줍니다. 구성 요소는 실행하는 동안 데이터 집합에 받은 행을 저장합니다. 구성 요소의 구성에 따라 실행의 끝부분에서 데이터 집합이 런타임 변수에 할당되고 XML 파일에 저장될 수도 있습니다. 데이터 집합에서 만들어진 XML 파일은 XML 원본에 대한 XML 원본으로 사용될 수 있습니다. 그러면 한 데이터 흐름 실행 결과를 외부에 저장하고 이를 다른 구성 요소의 원본으로 사용할 수 있습니다. 이 예제는 Itanium 기반 운영 체제에서 지원되지 않습니다.

중요:
Integration Services 데이터 흐름 프로그래밍 코드 예제는 사용자 지정 데이터 흐름 구성 요소를 만들기 위해 구현해야 하는 핵심 기능을 보여 주기 위해 작성되었습니다. 이 예제에서 고급 편집기를 통한 사용자 지정 작업이 완전히 지원되는 것은 아닙니다. 예를 들어 입/출력을 추가 또는 제거하거나 열을 구성하는 데는 고급 편집기를 사용할 수 없습니다. 예제는 교육용으로만 제공되므로 프로덕션 환경에서 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트를 수행하지 않았습니다. Microsoft에서는 이러한 예제에 대해 기술 지원을 제공하지 않습니다.

Integration Services 데이터 흐름 프로그래밍 코드 예제는 사용자 지정 데이터 흐름 구성 요소를 만들기 위해 구현해야 하는 핵심 기능을 보여 주기 위해 작성되었습니다. 이 예제에서 고급 편집기를 통한 사용자 지정 작업이 완전히 지원되는 것은 아닙니다. 예를 들어 입/출력을 추가 또는 제거하거나 열을 구성하는 데는 고급 편집기를 사용할 수 없습니다. 예제는 교육용으로만 제공되므로 프로덕션 환경에서 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트를 수행하지 않았습니다. Microsoft에서는 이러한 예제에 대해 기술 지원을 제공하지 않습니다.

예제 실행

코드 예제를 찾고, 빌드하고, 설치하는 방법을 이미 알고 있는 경우 예제 테스트 섹션으로 직접 이동하여 코드 예제를 구성하고 실행하는 방법을 참조할 수 있습니다.

필수 구성 요소

이 예제를 실행하려면 다음 구성 요소가 설치되어 있어야 합니다.

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

위치

코드 예제가 기본 위치에 설치되었으면 예제는 다음 디렉터리에 있습니다.

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\ DataSetDestination Component Sample\

코드 예제에 대한 C# 솔루션은 CS 디렉터리에 있으며 Visual Basic 솔루션은 VB 디렉터리에 있습니다.

예제를 설치하는 데 필요한 두 단계의 작업에 대한 자세한 내용은 예제 설치를 참조하십시오. SQL Server 2005 첫 릴리스 이후에 릴리스된 새 예제를 포함하여 최신 버전의 예제를 얻으려면 SQL Server 2005 예제 및 예제 데이터베이스(2006년 4월)를 참조하십시오.

예제 빌드

Samples 폴더에 아직 강력한 이름의 키 파일을 생성하지 않은 경우 다음 절차를 사용하여 해당 키 파일을 생성합니다. 예제 프로젝트는 빌드 시 이 키 파일을 사용하여 어셈블리를 서명하도록 구성됩니다. 프로젝트 속성 대화 상자의 서명 탭에서 서명 속성을 볼 수 있습니다.

강력한 이름의 키 파일을 생성하려면

Microsoft Visual Studio 2005 명령 프롬프트를 열려면 시작을 클릭하고 모든 프로그램, Microsoft Visual Studio 2005, Visual Studio 도구를 차례로 가리킨 다음 Visual Studio 2005 명령 프롬프트를 클릭합니다.

- 또는 -

Microsoft .NET Framework 명령 프롬프트를 열려면 시작을 클릭하고 모든 프로그램, Microsoft .NET Framework SDK 2.0을 차례로 가리킨 다음 SDK 명령 프롬프트를 클릭합니다.
명령 프롬프트에서 CD(디렉터리 변경) 명령을 사용하여 명령 프롬프트 창의 현재 폴더를 Samples 폴더로 변경합니다. 이 폴더에 만드는 키 파일은 모든 SQL Server 2005 코드 예제에서 사용됩니다.

[!참고] 예제가 있는 폴더를 확인하려면 시작을 클릭하고 모든 프로그램, Microsoft SQL Server 2005, 설명서 및 자습서를 차례로 가리킨 다음 예제 디렉터리를 클릭합니다. 기본 설치 위치가 사용된 경우 예제는 <system_drive>:\Program Files\Microsoft SQL Server\90\Samples에 있습니다.
명령 프롬프트에서 다음 명령을 실행하여 키 파일을 생성합니다.
```
sn -k SampleKey.snk
```
중요 강력한 이름의 키 쌍에 대한 자세한 내용은 MSDN의 .NET Development Center에서 "보안 정보: .NET Framework의 강력한 이름 및 보안(Security Briefs: Strong Names and Security in the .NET Framework)"을 참조하십시오.

Microsoft Visual Studio 2005에서 예제를 빌드하려면

파일 | 열기 메뉴에서 프로젝트를 클릭하고 원하는 프로그래밍 언어로 된 DataSetDestination.sln을 엽니다.
빌드 메뉴에서 DatasetDestination 빌드를 클릭하여 프로젝트를 빌드합니다.

예제 설치

이 예제는 Visual Basic과 C# 버전으로 제공됩니다. 각 예제 버전에 대한 어셈블리를 구분하기 위해 출력 어셈블리의 이름에 CS 또는 VB가 추가됩니다. 구성 요소를 성공적으로 빌드한 후에는 다음 단계를 따라 Business Intelligence Development Studio의 데이터 흐름 작업에 추가합니다.

PipelineComponents 폴더에 구성 요소를 복사하려면

Windows 탐색기를 열거나 파일 시스템에서 작업할 원하는 응용 프로그램을 엽니다.
어셈블리(DatasetDestinationCS.dll 또는 DatasetDestinationVB.dll)를 %system%\Program Files\Microsoft SQL Server\90\DTS에 있는 PipelineComponents 폴더로 복사합니다.

어셈블리를 끌어 오는 방식으로 GAC(전역 어셈블리 캐시)에 구성 요소를 설치하려면

Windows 탐색기를 열거나 파일 시스템에서 작업할 원하는 응용 프로그램을 엽니다.
어셈블리를 PipelineComponents 폴더에서 %system%\assembly의 GAC(전역 어셈블리 캐시)가 있는 폴더로 끕니다.

gacutil.exe를 사용하여 GAC(전역 어셈블리 캐시)에 구성 요소를 설치하려면

명령 프롬프트 창을 엽니다.
다음 명령을 입력하여 gacutil.exe를 실행하고 C# 버전의 구성 요소를 GAC에 설치합니다.

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationCS.dll "

- or -

다음 명령을 입력하여 gacutil.exe를 실행하고 Visual Basic 버전의 구성 요소를 GAC에 설치합니다.****

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationVB.dll "

도구 상자에 구성 요소를 추가하려면

Business Intelligence Development Studio를 엽니다.
도구 상자를 마우스 오른쪽 단추로 클릭한 다음 항목 선택을 클릭합니다.
도구 상자 항목 선택 대화 상자에서 SSIS 데이터 흐름 항목 탭을 클릭합니다.
구성 요소 옆의 확인란을 클릭한 다음 확인을 클릭합니다.
참고 구성 요소가 목록에 표시되지 않으면 찾아보기를 클릭하여 구성 요소를 직접 찾을 수 있습니다. 그러나 이 경우 구성 요소가 제대로 설치되지 않을 수 있습니다.

이러한 단계를 완료한 후에는 도구 상자의 데이터 흐름 항목 탭에서 구성 요소를 볼 수 있으며 SSIS 디자이너의 데이터 흐름 작업에도 추가할 수 있습니다.

예제 테스트

예제 구성 요소를 패키지의 데이터 흐름 작업에 추가한 후 SSIS 디자이너에서 이 구성 요소를 구성할 수 있습니다. DatasetDestination 구성 요소에는 실행 동작을 제어하는 3가지 사용자 지정 속성이 있습니다. 이 속성의 기본값을 변경하지 않으면 구성 요소가 성공적으로 실행됩니다. 이 경우 실행이 끝날 때 데이터 집합이 저장되지 않습니다.

속성	설명
RuntimeVariable	실행 후 데이터 집합을 쓸 런타임 변수의 이름을 지정합니다.
DataTableName	새 데이터 집합으로 생성되었거나 기존 데이터 집합에 추가된 DataTable의 이름을 지정합니다.
SaveDataSetToXml	실행의 끝부분에 이 데이터 집합을 XML 파일로 저장하는지 여부를 지정합니다. true이면 구성 요소에 대한 파일 연결 관리자를 지정해야 합니다.

다음을 통해 공유