파일 공유 데이터 처리 확장 프로그램 예제

아티클
12/15/2008

업데이트: 2005년 12월 5일

FsiDataExtension은 Windows 파일 시스템을 위한 간단한 데이터 처리 확장 프로그램입니다. 이 프로그램은 Microsoft .NET Framework 라이브러리 클래스인 DirectoryInfo 및 FileSystemInfo를 사용하여 유효한 네트워크 파일 공유의 내용을 쿼리합니다. 이 예제는 데이터 처리 확장 프로그램 인터페이스뿐만 아니라 다른 .NET Framework 클래스도 사용합니다. 예제에는 파일 공유 정보(File Share Information)에 해당하는 접두사 "Fsi"가 명명 규칙으로 사용됩니다. 이 예제는 Itanium 기반 운영 체제에서 지원되지 않습니다.

SQL Server 예제는 설치하는 동안 자동으로 설치되지 않습니다. 예제 설치 방법에 대한 지침은 예제 설치를 참조하십시오.

중요:
예제는 교육용으로만 제공되므로 프로덕션 환경에 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트를 수행하지 않았습니다. Microsoft는 이러한 예제에 대한 기술 지원을 제공하지 않습니다. 시스템 관리자의 허가 없이 예제 응용 프로그램 및 어셈블리를 프로덕션 SQL Server 데이터베이스 또는 보고서 서버에 연결하거나 이러한 데이터베이스 또는 보고서 서버에서 사용해서는 안 됩니다.

예제는 교육용으로만 제공되므로 프로덕션 환경에 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트를 수행하지 않았습니다. Microsoft는 이러한 예제에 대한 기술 지원을 제공하지 않습니다. 시스템 관리자의 허가 없이 예제 응용 프로그램 및 어셈블리를 프로덕션 SQL Server 데이터베이스 또는 보고서 서버에 연결하거나 이러한 데이터베이스 또는 보고서 서버에서 사용해서는 안 됩니다.

요구 사항

FsiDataExtension 예제를 사용하려면 Microsoft Visual Studio와 Microsoft Visual C# 또는 Microsoft Visual Basic에 대해 잘 알고 있어야 하며 다음이 설치되어 있어야 합니다.

Microsoft Visual Studio 2005 또는 호환 개발 환경(프로젝트 파일 검토용)
Microsoft SQL Server 2005(Reporting Services 포함)
Microsoft .NET Framework 버전 2.0
Reporting Services 예제. SQL Server 2005 설치 중에 예제를 설치하도록 선택할 수 있습니다. 이 릴리스에서 예제를 설치하도록 선택하면 예제의 압축을 풀어 설치할 수 있는 별도의 설치 관리자가 컴퓨터에 설치됩니다. Microsoft SQL Server 2005 프로그램 그룹의 시작 메뉴에서 이 설치 관리자를 실행할 수 있습니다.
네트워크에서 액세스할 수 있는 보고서 서버. 예제 확장 프로그램을 사용하여 추가 데이터 처리 기능을 서버에 추가하려는 경우에 필요합니다.

위치

이 예제는 Reporting Services 예제 디렉터리의 Extension Samples\FsiDataExtension Sample 하위 디렉터리에 있습니다.

예를 들면 다음과 같습니다.

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\FindRenderSave Sample

예제 빌드

다음 단계에 따라 예제를 빌드합니다.

강력한 이름 키 파일을 생성하지 않았다면 다음 지침에 따라 해당 키 파일을 생성합니다.

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

Microsoft Visual Studio 2005 명령 프롬프트를 엽니다. 시작을 클릭하고 모든 프로그램, Microsoft .NET Framework SDK 2.0을 차례로 가리킨 다음 SDK 명령 프롬프트를 클릭합니다.

-- 또는--

Microsoft .NET Framework 명령 프롬프트를 엽니다. 시작을 클릭하고 모든 프로그램, Microsoft .NET Framework SDK 2.0을 차례로 가리킨 다음 SDK 명령 프롬프트를 클릭합니다.
디렉터리 변경 명령(CD)을 사용하여 명령 프롬프트 창의 현재 디렉터리를 예제가 설치된 폴더로 변경합니다.

[!참고] 예제가 있는 폴더를 확인하려면 시작 단추를 클릭하고 모든 프로그램, Microsoft SQL Server, 설명서 및 자습서를 차례로 가리킨 다음 예제 디렉터리를 클릭하십시오. 기본 설치 위치가 사용된 경우 예제는 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples에 있습니다.
명령 프롬프트에서 다음 명령을 실행하여 키 파일을 생성합니다.

sn -k SampleKey.snk

중요:

강력한 이름 키 쌍에 대한 자세한 내용은 MSDN의 .NET Development Center에서 "Security Briefs: Strong Names and Security in the .NET Framework"를 참조하십시오.

중요:
강력한 이름 키 쌍에 대한 자세한 내용은 MSDN의 .NET Development Center에서 "Security Briefs: Strong Names and Security in the .NET Framework"를 참조하십시오.

.NET Framework SDK를 사용하여 예제를 컴파일하려면

보고서 서버 \bin 디렉터리의 Microsoft.ReportingServices.Interfaces.dll을 예제 폴더에 복사합니다.

다음 명령을 실행하여 예제 데이터 처리 확장 프로그램인 Microsoft.Samples.ReportingServices.FsiDataExtension.dll을 만듭니다.

csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll

Visual Studio .NET을 사용하여 예제를 컴파일하려면

Visual Studio 2005의 FsiDataExtension 솔루션 파일(FsiDataExtensionCS.sln 또는 FsiDataExtensionVB.sln)을 엽니다.
솔루션 탐색기에서 FsiDataExtension 프로젝트를 선택합니다.
프로젝트 메뉴에서 참조 추가를 클릭합니다.

참조 추가 대화 상자가 열립니다.
.NET 탭을 클릭합니다.
찾아보기를 클릭하여 로컬 드라이브에서 Microsoft.ReportingServices.Interfaces를 찾습니다. 기본적으로 어셈블리는 ReportServer\bin 디렉터리에 있습니다. 확인을 클릭합니다.

선택한 참조가 프로젝트에 추가됩니다.
빌드 메뉴에서 솔루션 빌드를 클릭합니다.

예제 배포

위의 단계를 완료하고 나면 Microsoft.Samples.ReportingServices.FsiDataExtension.dll을 보고서 서버나 보고서 디자이너에 배포하여 사용자 지정 데이터 원본에 대해 실행 중인 보고서에서 사용할 수 있습니다.

예제를 배포하려면

Microsoft.Samples.ReportingServices.FsiDataExtension.dll을 보고서 서버에 복사합니다. 보고서 서버 확장 프로그램의 기본 위치는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin입니다.
어셈블리를 보고서 디자이너에 복사합니다. 보고서 디자이너에 대한 확장 프로그램의 기본 위치는 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies입니다.
다음 항목을 Data 요소 아래 RSReportServer.config 및 RSReportDesigner.config 파일에 모두 추가합니다(RSReportDesigner.config 파일의 기본 위치는 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies이며 RSReportServer.config 파일의 기본 위치는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer임).
```
<Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
```
예제 데이터 처리 확장 프로그램에 대한 일반 쿼리 디자이너를 활성화하려면 다음 항목을 RSReportDesigner.config 파일의 <Designer> 요소 아래에 추가합니다.
```
<Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
```

데이터 처리 확장 프로그램 배포에 대한 내용은 Deploying a Data Processing Extension를 참조하십시오.

예제에 대한 코드 액세스 보안을 구성하려면

보고서 서버 정책 구성 파일(rssrvpolicy.config)을 엽니다. 이 파일의 기본 위치는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer입니다.

데이터 처리 확장 프로그램에는 완전 신뢰 수준을 부여해야 합니다. 그렇게 하려면 다음 코드 그룹 정보를 구성 파일의 코드 그룹 섹션 마지막에 추가합니다.

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

보고서 디자이너에서 예제 데이터 처리 확장 프로그램을 사용하는 경우 보고서 디자이너 미리 보기 정책 구성 파일(rspreviewpolicy.config) 및 다음 코드 그룹을 사용하여 1단계와 2단계를 반복합니다.
```
<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>
```
rspreviewpolicy.config 파일의 기본 위치는 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies입니다.

.NET Framework 보안 및 Reporting Services에 대한 자세한 내용은 Understanding Code Access Security in Reporting Services를 참조하십시오.

FsiDataExtension을 사용하는 보고서 만들기

이 섹션에서는 예제 데이터 확장 프로그램을 사용하는 예제 보고서를 만드는 간단한 방법을 보여 줍니다.

[!참고] 보고서를 만들기 전에 예제 파일 공유 데이터 확장 프로그램을 보고서 디자이너와 보고서 서버에 배포해야 합니다. 또한 확장 프로그램용의 일반 쿼리 디자이너를 설정해야 합니다. 자세한 내용은 이 항목의 앞부분에 나오는 "FsiDataExtension 배포"를 참조하십시오.

보고서 프로젝트를 만들려면

시작을 클릭하고 프로그램, Microsoft SQL Server 2005를 차례로 가리킨 다음 Business Intelligence Development Studio를 클릭합니다.
파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다.
프로젝트 형식 목록에서 비즈니스 인텔리전스 프로젝트를 클릭합니다.
템플릿 목록에서 보고서 서버 프로젝트를 클릭합니다.
이름에 FsiReportProject를 입력합니다.
확인을 클릭하여 보고서 프로젝트를 만듭니다.

보고서를 만들려면

프로젝트 메뉴에서 새 항목 추가를 클릭합니다.
범주 목록에서 보고서 프로젝트를 클릭합니다.
템플릿 목록에서 보고서를 클릭합니다.
이름 입력란에 FsiReport를 입력한 다음 열기를 클릭합니다.

예제 데이터 확장 프로그램을 사용하는 데이터 원본을 추가하려면

데이터 보기의 데이터 집합에서 **<새 데이터 집합...>**을 선택합니다.

데이터 원본 대화 상자가 열립니다.
일반 탭의 이름 텍스트 상자에 FsiDataSource를 입력합니다.
유형 목록에서 파일 공유 정보를 선택합니다.
연결 문자열을 비워둡니다. 이 예제 데이터 확장 프로그램은 연결 문자열을 사용하지 않습니다.

자격 증명 탭에서 서버 로그온 유형 중 하나를 클릭합니다. 예제 데이터 확장 프로그램이 액세스할 파일 공유에 대한 사용자 이름과 암호를 입력할 수 있습니다. **Windows 인증 사용(통합 보안)**을 클릭하거나 특정 사용자 이름 및 암호 사용을 클릭한 다음 자격 증명을 입력하거나 자격 증명 확인을 클릭하고 프롬프트 문자열을 입력합니다.

보안 정보:
가능하면 Windows 인증을 사용하십시오. 네트워크 자격 증명이 캐시되어 있는 경우를 제외하고 네트워크 파일 공유에 액세스하려고 할 때마다 해당 자격 증명을 묻는 메시지가 표시됩니다.

확인을 클릭하여 데이터 원본을 저장합니다.

데이터 집합을 보려면

데이터 보기에 일반 쿼리 디자이너가 표시됩니다. 명령 유형에서 Text를 선택합니다.
일반 쿼리 디자이너의 도구 모음 바로 아래에 있는 쿼리 창에서 네트워크에서 사용할 수 있는 네트워크 파일 공유의 경로를 입력합니다. 예를 들어 \\Computer1\Public을 입력합니다.
일반 쿼리 디자이너의 도구 모음에서 실행(!) 단추를 클릭합니다.

파일 공유 데이터가 아래의 결과 창에 나타나야 합니다.

보고서 레이아웃을 디자인하려면

레이아웃 보기의 도구 상자에서 테이블을 클릭합니다.
테이블 컨트롤을 디자인 화면으로 끌어 옵니다.
필드 창에서 이름 입력란을 정보 행의 첫 번째 셀로 끌어 옵니다. 원하는 대로 다른 필드를 테이블에 추가합니다.

보고서를 미리 보려면

미리 보기 탭을 클릭하여 보고서를 미리 확인합니다. FsiDataSource에 대한 자격 증명 설정에 따라 사용자 이름과 암호를 입력해야 할 수 있습니다.

참고 항목

작업

코드 예제 컴파일 및 실행
SQL Server Reporting Services 예제

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스	내역
2005년 12월 5일	변경된 내용 키 파일의 이름 및 위치를 포함하여 키 파일 생성 방법에 대한 정보를 변경했습니다.