SQL Server 사용자 지정 연결 관리자 예제

아티클
12/15/2008

업데이트: 2006년 4월 14일

SQL Server 사용자 지정 연결 관리자 예제에서는 사용자 지정 연결 관리자, Sql 연결 관리자 및 이에 연결된 사용자 인터페이스를 만드는 방법을 보여 줍니다. 이 예제는 Itanium 기반 운영 체제에서 지원되지 않습니다.

사용자 지정 연결 관리자를 만드는 방법은 Creating a Custom Connection Manager를 참조하십시오. Integration Services의 연결 관리자 사용에 대한 일반적인 내용은 Integration Services 연결 및 연결 관리자를 참조하십시오.

이 사용자 지정 연결 관리자는 SqlClient .NET Framework Data Provider를 사용하여 Microsoft SQL Server의 사용 가능한 인스턴스에 연결하고 해당 AcquireConnection 메서드에서 열려 있는 SqlConnection 개체를 반환합니다. 패키지에 Sql 연결 관리자의 새 인스턴스를 만들 경우 해당 사용자 지정 사용자 인터페이스에서는 서버 이름과 데이터베이스 이름을 입력하라는 메시지를 표시합니다. 예제에서는 SQL Server의 기본 인스턴스에만 연결하고 Windows 인증만 사용합니다.

이 코드 예제는 다음 기능을 구현합니다.

ConnectionManagerBase 클래스 재정의
지속성 지원

중요:
예제는 교육용으로만 제공되므로 프로덕션 환경에서 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트를 수행하지 않았습니다. Microsoft에서는 이러한 예제에 대해 기술 지원을 제공하지 않습니다.

예제 실행

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

필수 구성 요소

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

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

위치

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

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\SqlConnectionManager Sample

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

예제를 설치하는 데 필요한 두 단계의 작업에 대한 자세한 내용은 예제 설치를 참조하십시오. 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 v2.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)"을 참조하십시오.

후속 단계에서는 키 파일의 공개 키 토큰이 필요합니다. 공개 키 토큰을 가져오려면 우선 명령 프롬프트에서 다음 명령을 실행하여 키 파일에서 새 파일로 공개 키를 추출합니다.
```
sn -p SampleKey.snk SampleKeyPublic.snk
```
명령 프롬프트에서 다음 명령을 실행하여 새 파일의 공개 키 토큰을 표시합니다.
```
sn -t SampleKeyPublic.snk
```
공개 키 토큰을 클립보드에 복사하거나 나중에 사용할 수 있도록 저장합니다.

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

파일 | 열기 메뉴에서 프로젝트를 클릭하고 솔루션 파일 SqlConnMgrVB.sln 또는 SqlConnMgrCS.sln을 엽니다.
솔루션 탐색기에서 SqlConnMgrVB 또는 SqlConnMgrCS 프로젝트를 선택합니다.
SqlConnMgrCS.cs 파일 또는 SqlConnMgrVB.vb 파일의 클래스 선언 앞에서 DtsConnection 특성을 찾고 해당 특성의 UITypeName 속성에 있는 공개 키 토큰의 영숫자 값을 이전에 키 파일에서 가져온 공개 키 토큰으로 바꿉니다.
빌드 메뉴에서 솔루션 빌드를 클릭합니다.

예제 설치

이 예제는 Visual Basic과 C#의 두 버전이 모두 제공됩니다. 각 예제 버전에 대한 어셈블리를 구분하기 위해 출력 어셈블리의 이름에 CS 또는 VB가 추가됩니다. 구성 요소를 빌드한 후에는 해당 구성 요소를 다음 단계를 따라 Business Intelligence Development Studio의 패키지에 연결 관리자로 추가합니다.

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

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

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

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

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

명령 프롬프트 창을 엽니다.

다음 명령을 입력하여 C# 버전의 구성 요소와 사용자 인터페이스를 GAC에 설치합니다.

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrCS.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrUICS.dll"

- 또는 -

다음 명령을 입력하여 Visual Basic 버전의 구성 요소와 사용자 인터페이스를 GAC에 설치합니다.

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrUIVB.dll"

예제 테스트

이제 패키지에 있는 사용자 지정 연결 관리자를 테스트할 수 있습니다.

패키지에 있는 예제 연결 관리자를 사용하려면

SSIS 디자이너의 연결 관리자 영역에서 마우스 오른쪽 단추로 클릭하고 새 연결을 선택한 다음 사용 가능한 연결 유형 목록에서 SQL을 선택합니다. 확인을 클릭합니다.
새 연결 관리자를 편집합니다. Sql 연결 관리자 편집기에서 SQL Server 데이터베이스 엔진의 사용 가능한 기본 인스턴스 및 사용 가능한 데이터베이스의 이름을 입력합니다.

변경 내역

릴리스	내역
2006년 4월 14일	변경된 내용 파일 및 폴더 이름을 수정했습니다.

다음을 통해 공유