Hello World Ready 예제

업데이트: 2005년 12월 5일

Hello World Ready 예제는 간단한 World Ready CLR(공용 언어 런타임) 통합 기반 저장 프로시저의 만들기, 배포 및 테스트와 관련된 기본 작업을 보여 줍니다. World Ready 구성 요소는 구성 요소의 소스 코드를 변경할 필요 없이 세계 곳곳의 다양한 시장에서 다양한 언어로 쉽게 지역화할 수 있습니다. 이 예제는 또한 저장 프로시저에 의해 동적으로 생성되고 클라이언트로 반환되는 레코드 및 출력 매개 변수를 통해 데이터를 반환하는 방법을 보여 줍니다.

이 예제는 Hello World 예제와 거의 동일하지만 훨씬 더 쉽고 안전하게 이 응용 프로그램을 지역화할 수 있습니다. 지역화된 텍스트를 변경하려면 다음을 수행해야 합니다.

  1. 리소스 디렉터리에서 특정 culture의 XML 파일(.resx 파일) 변경
  2. resgen을 사용하여 culture의 리소스 파일 빌드
  3. 해당 culture에 대한 업데이트된 위성 DLL 빌드
  4. SQL Server에서 해당 어셈블리 삭제 및 추가

CLR 저장 프로시저 자체에 대한 소스 코드 및 어셈블리는 변경되지 않습니다. 리소스 디렉터리에 제공되는 build.cmd 스크립트는 리소스 어셈블리를 컴파일하고 연결하는 방법을 보여 줍니다.

응용 프로그램의 소스 코드는 현재 실행 중인 어셈블리에 기반하는 리소스 관리자를 만들지만 저장 프로시저를 포함하는 DLL에 culture 중립 리소스를 포함시켜야 할 필요는 없습니다. AssemblyInfo.cs 및 AssemblyInfo.vb 파일에 사용되는 System.Resources.NeutralResourcesLanguage 특성이 있으면 위성 DLL에 culture 중립 리소스가 존재할 수 있습니다. 이 경우 지역화된 텍스트를 추가 또는 변경할 때 CLR 저장 프로시저가 포함된 기본 DLL을 변경할 필요가 없도록 별도의 DLL을 사용하는 것이 좋습니다. 특히 열 및 기타 종속성을 갖고 있어 유형을 삭제하고 다시 추가하기가 어려운 CLR 사용자 정의 유형의 경우 이 방법이 유용합니다.

일반적으로 위성 DLL 버전은 주 어셈블리 버전과 동일해야 합니다. 하지만 SatelliteContractVersion 특성을 사용하여 위성 어셈블리를 업데이트하지 않고 주 어셈블리만 업데이트하도록 할 수도 있습니다. 자세한 내용은 Microsoft .NET Framework 버전 2.0 SDK 설명서의 ResourceManager 클래스를 참조하십시오.

설치 디렉터리: drive:\Program?Files\Microsoft?SQL?Server\90\Samples\Engine\Programmability\CLR\HelloWorldReady\

시나리오

Adventure Works Cycles의 개발자인 Jane은 CLR 통합 저장 프로시저 사용과 관련된 기본 사항을 잘 이해해야 하며 팀에서 사용하는 기술 리소스를 사용하여 CLR 통합 저장 프로시저를 쉽게 지역화할 수 있도록(World Ready) 만드는 방법도 습득해야 합니다.

언어

Transact-SQL, Visual C# 및 Visual Basic

기능

Hello World Ready 예제는 다음과 같은 SQL Server 기능을 사용합니다.

응용 프로그램 영역 기능

전체

CLR, 메타데이터

지역화

리소스

필수 구성 요소

이 예제를 실행하기 전에 다음 소프트웨어가 설치되어 있는지 확인하십시오.

  • Microsoft SQL Server 2005 또는 Microsoft SQL Server 2005 Express Edition(SQL Server Express). SQL Server 2005 Express Edition 설명서 및 예제 웹 사이트에서 무료로 SQL Server Express를 구할 수 있습니다.
  • AdventureWorks 데이터베이스. SQL Server 2005에 포함되어 있으며 SQL Server Developer 웹 사이트에서도 사용할 수 있습니다.
  • SQL Server 2005 데이터베이스 엔진 예제. 이 예제는 SQL Server 2005에 포함되어 있습니다. SQL Server Developer 웹 사이트에서 최신 버전의 예제를 다운로드할 수 있습니다.
  • .NET Framework SDK 2.0 또는 Microsoft Visual Studio 2005. .NET Framework SDK는 무료로 구할 수 있습니다. .NET Framework SDK 설치를 참조하십시오.

예제 빌드

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

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

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

    -- 또는--

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

  2. 디렉터리 변경 명령(CD)을 사용하여 명령 프롬프트 창의 현재 디렉터리를 예제가 설치된 폴더로 변경합니다.

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

  3. 명령 프롬프트에서 다음 명령을 실행하여 키 파일을 생성합니다.

    sn -k SampleKey.snk

    ms160899.note(ko-kr,SQL.90).gif중요:
    강력한 이름 키 쌍에 대한 자세한 내용은 MSDN의 .NET Development Center에서 "Security Briefs: Strong Names and Security in the .NET Framework"를 참조하십시오.

Hello World Ready 예제를 빌드하려면

  1. Visual Studio 2005와 제공된 Visual Studio 솔루션을 사용하거나 .NET Framework SDK 2.0에 포함되어 있는 Microsoft MSBuild를 사용하여 예제를 컴파일합니다. SDK 명령 프롬프트에서 다음과 비슷한 명령을 실행합니다.

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ HelloWorld.sln

  2. .NET Framework 또는 Visual Studio 명령 프롬프트에서 리소스 디렉터리에 제공된 build.cmd 파일을 실행하여 위성 어셈블리를 컴파일합니다. 이 파일은 Visual Studio 또는 .NET Framework SDK에 포함된 ResGen을 호출합니다.

  3. AdventureWorks 데이터베이스가 설치되어 있는지 확인합니다.

  4. SQL Server 데이터베이스 엔진 예제를 기본 위치에 설치하지 않은 경우 예제가 설치된 위치를 나타내도록 Scripts\InstallCS.sql과 Scripts\InstallVB.sql에서 스크립트의 CREATE ASSEMBLY 섹션에 포함된 경로를 수정합니다.

  5. 사용 중인 SQL Server 인스턴스의 관리자가 아닌 경우 설치를 완료하려면 관리자로부터 CreateAssembly 사용 권한을 부여 받아야 합니다.

  6. Microsoft SQL Server Management Studio에서 Visual C# 프로젝트를 컴파일했는지 또는 Visual Basic 프로젝트를 컴파일했는지에 따라 scripts\installCS.sql 또는 scripts\installVB.sql 파일을 엽니다. 파일에 포함된 스크립트를 실행하거나 명령 프롬프트에서 다음과 비슷한 명령을 실행합니다.

    sqlcmd -E -I -i Scripts\InstallCS.sql

예제 실행

Hello World Ready 예제를 실행하려면

  1. Management Studio에서 scripts\test.sql 파일을 연 다음 파일에 포함되어 있는 스크립트를 실행하거나 명령 프롬프트에서 다음 명령을 실행합니다.

    sqlcmd -E -I -i Scripts\test.sql

예제 제거

Hello World Ready 예제를 제거하려면

  1. Management Studio에서 scripts\cleanup.sql 파일을 연 다음 파일에 포함되어 있는 스크립트를 실행하거나 명령 프롬프트에서 다음 명령을 실행합니다.

    sqlcmd -E -I -i Scripts\cleanup.sql

설명

이 예제가 제대로 작동되려면 SQL Server 2005 또는 SQL Server Express의 CLR을 설정해야 합니다.

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

참고 항목

작업

Hello World 예제
달력 인식 날짜/시간 UDT

관련 자료

CREATE ASSEMBLY(Transact-SQL)
DROP ASSEMBLY(Transact-SQL)
CREATE PROCEDURE(Transact-SQL)
DROP PROCEDURE(Transact-SQL)

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스 내역

2005년 12월 5일

변경된 내용
  • 키 파일의 이름 및 위치를 포함하여 키 파일 생성 방법에 대한 정보를 변경했습니다.