カレンダー対応の日付/時刻 UDT サンプルの Readme

  • [アーティクル]

[このトピックはプレリリース版のドキュメントであり、今後のリリースでは変更される場合があります。空のトピックがプレースホルダーとして含まれています。ご注意 : マイクロソフトでは、より多くのコンテンツを日本語で提供できるよう、機械翻訳などの方法によってローカライズされたドキュメントを提供する場合があります。このプレリリース版の一部のコンテンツはそのような方法によってローカライズされたものです。私たちマイクロソフトは、このような方法でローカライズされたものが必ずしも最適ではなく、語彙、構文、文法における誤りを含む可能性を認識しています。このコンテンツの最終版は、従来の方法によるローカライズで行われ、その品質は旧版と同等のものになります。]

このサンプルは、SQL Server 2005 および SQL Server 2008 でのみ動作します。SQL Server 2005 より前のバージョンでは動作しません。

どのカレンダー システムが使用されているかを理解していないと日付は意味を持たないため、日付を文字列として格納すると混乱する場合があります。

CADatetime サンプルでは、日付と時刻にカレンダー対応処理を行う、CADatetime と CADate という 2 つのユーザー定義データ型を定義しています。

インストール ディレクトリ :

C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\

CLR\CADateTime\

SQL Server のサンプルやサンプル データベースを表示したり使用したりするには、まずそれをダウンロードしてインストールする必要があります。詳細については、「SQL Server のサンプルとサンプル データベースのインストールに関する注意点」を参照してください。

シナリオ

Jane は Adventure Works Cycles の開発者です。世界中の日付と時刻を処理するソフトウェアを作成する必要があります。特定のカレンダー システムでの日付表現を支援する CADatetime および CADate UDT を使用します。

言語

Transact-SQL、Visual C#、および Visual Basic。

機能

CADatetime サンプルは、Microsoft SQL Server の次の機能を使用します。

アプリケーション エリア 機能

UDT 実装

CLR (CLR)

国際化対応

サテライト アセンブリ

前提条件

このサンプルを実行する前に、次のソフトウェアがインストールされていることを確認してください。

  • SQL Server または SQL Server Express。SQL Server Express は、SQL Server Express ドキュメントとサンプルの Web サイトから無償で入手できます。
  • AdventureWorks2008R2 データベース。SQL Server デベロッパー Web サイトから入手できます。
  • SQL Server データベース エンジン サンプル。SQL Server デベロッパー Web サイトから入手できます。
  • .NET Framework SDK 2.0 または Microsoft Visual Studio 2005。.NET Framework SDK は無償で入手できます。詳細については、「.NET Framework ドキュメントのインストール」を参照してください。

サンプルのビルド

強力な名前のキー ファイルをまだ作成していない場合は、次の指示に従ってキー ファイルを生成してください。

厳密な名前のキー ファイルを生成するには

  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

    注意

    厳密な名前のキー ペアの詳細については、MSDN の .NET Development Center にある「Security Briefs: Strong Names and Security in the .NET Framework」を参照してください。

CADatetime サンプルをビルドするには

  1. SDK のコマンド プロンプト ウィンドウまたは Visual Studio のコマンド プロンプト ウィンドウのどちらかを使用して次のコマンドを実行し、サンプルのリソース ファイルをビルドします。

    cd CS\CADateTime\resources

    build.cmd

    cd ..\..\..

  2. Visual Studio 2005 および提供されている Visual Studio ソリューションを使用するか、.NET Framework SDK 2.0 に含まれている Microsoft MSBuild を使用して、サンプルをコンパイルします。コマンド プロンプトで、次のようなコマンドを実行します。

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

  3. AdventureWorks データベースがインストールされていることを確認します。

  4. 既定の場所に SQL Server データベース エンジン サンプルをインストールしていない場合、サンプルがインストールされている場所が参照されるように、Scripts\InstallCS.sql スクリプトおよび Scripts\InstallVB.sql スクリプトの CREATE ASSEMBLY 部のパスを変更します。

  5. 使用している SQL Server インスタンスの管理者でない場合は、インストールを完了するために CreateAssembly 権限が管理者から付与されている必要があります。

  6. Visual C# プロジェクトと Visual Basic プロジェクトのどちらをコンパイルしたかに応じて、Management Studio でファイル scripts\installCS.sql または scripts\installVB.sql を開きます。ファイルに含まれているスクリプトを実行するか、コマンド プロンプト ウィンドウで次のようなコマンドを実行します。

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

サンプルの実行

CADatetime サンプルを実行するには

  1. Management Studio で scripts\test.sql ファイルを開き、ファイルに含まれているスクリプトを実行します。または、コマンド プロンプト ウィンドウで次のコマンドを実行します。

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

サンプルの削除

CADatetime サンプルを削除するには

  1. SQL Server Management Studio で scripts\cleanup.sql ファイルを開き、ファイルに含まれているスクリプトを実行します。または、コマンド プロンプト ウィンドウで次のコマンドを実行します。

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

備考

このサンプルを正しく機能させるためには、SQL Server または SQL Server Express の CLR を有効にする必要があります。

サンプルは、演習目的で利用するためにのみ提供されています。サンプルを運用環境で使用することは想定されていないため、運用環境でのサンプルのテストは行われていません。Microsoft では、これらのサンプルに関する製品サポート サービスを提供していません。システム管理者の承認を得ることなく、サンプル アプリケーションやサンプル アセンブリを、運用中の SQL Server データベースやレポート サーバーに接続したり、これらのデータと共に使用することは避けてください。

参照

処理手順

AdventureWorks Cycles CLR レイヤ サンプルの Readme

ヘルプおよび情報

SQL Server 2008 R2 の参考資料の入手