Windows 上に SQL Server の .NET 言語拡張をインストールする

[アーティクル]
05/02/2024

適用対象: SQL Server 2019 (15.x) 以降のバージョン

SQL Server の (C# で使用される) .NET 言語拡張コンポーネントを Windows にインストールする方法について説明します。 .NET 言語拡張は、SQL Server 言語拡張の一部です。

Note

この記事は、Windows への SQL Server の .NET 言語拡張のインストールに関するものです。 Linux はサポートされていません。

前提条件

Note

機能とインストールオプションは、SQL Server のバージョンによって異なります。バージョンセレクターのドロップダウンリストを使用して適切なバージョンの SQL Server を選択します。

.NET 言語拡張のサポートをインストールする場合は、SQL Server セットアップが必要です。
.NET 言語拡張は .NET 6 以降のランタイムをサポートしており、Windows でのみサポートされます。
データベースエンジンのインスタンスが必要です。 .NET 言語拡張機能のみをインストールすることはできませんが、既存のインスタンスに段階的に追加することはできます。
ビジネス継続性のために、言語拡張では Always On 可用性グループがサポートされています。各ノードに言語拡張をインストールし、パッケージを構成する必要があります。また、.NET 言語拡張のインストールが、SQL Server のフェールオーバークラスターインスタンスでサポートされています。
SQL Server 言語拡張機能または .NET 言語拡張機能をドメインコントローラーにインストールしないでください。セットアップの言語拡張部分が失敗します。
言語拡張と Machine Learning Services は、SQL Server ビッグデータクラスターには既定でインストールされます。ビッグデータクラスターを使用する場合、この記事の手順を行う必要はありません。詳細は、「SQL Server 2019 のビッグデータクラスターで Machine Learning Services を使用して Python と R のスクリプトを実行する」を参照してください。

重要

セットアップが完了したら、この記事で説明されている構成後の手順を必ず完了してください。これらの手順には、SQL Server で外部コードを使用できるようにすることや、ユーザーに代わって SQL Server が C# コードを実行するために必要なアカウントを追加することが含まれます。通常、構成を変更するには、インスタンスを再起動するか、Launchpad サービスを再起動する必要があります。

.NET ランタイム

.NET 6 長期サポート (LTS) は、最も早くサポートされるランタイムです。 Windows 用 .NET ランタイムをダウンロードできます。 Linux はサポートされていません。

.NET ランタイムの最新の LTS リリースを使用する場合は、.NET 言語拡張を再コンパイルする必要があります。

インストールメディアを入手する

SQL Server のダウンロード場所は、エディションによって異なります。

SQL Server Enterprise、Standard、Express の各エディション。これらのエディションには、運用環境で使用するためのライセンスが付与されます。 Enterprise および Standard エディションのインストールメディアについては、ソフトウェア販売元に問い合わせてください。購入に関する情報および Microsoft パートナーのディレクトリについては、マイクロソフトの購入 Web サイトをご覧ください。
最新の無償版。

セットアップの実行

ローカルインストールの場合は、セットアップを管理者として実行する必要があります。 SQL Server をリモート共有からインストールする場合は、そのリモート共有に対する読み取り権限と実行権限を持つドメインアカウントを使用する必要があります。

SQL Server のセットアップウィザードを開始します。
[インストール] タブで、 [SQL Server の新規スタンドアロンインストールを実行するか、既存のインストールに機能を追加します] を選択します。
[機能の選択] ページで、次のオプションを選択します。

データベースエンジンサービス: SQL Server で言語拡張を使用するには、データベースエンジンのインスタンスをインストールする必要があります。既定のインスタンスまたは名前付きインスタンスを使用できます。

Machine Learning Services と言語拡張機能: このオプションを選択すると、C# コードの実行をサポートする言語拡張機能コンポーネントがインストールされます。
[インストールの準備完了] ページで、以下が選択されていることを確認した後、 [インストール] を選択します。
- データベースエンジンサービス
- Machine Learning Services および言語の拡張
構成ファイルが格納されている ..\Setup Bootstrap\Log パスの下にあるフォルダーの場所をメモしておきます。セットアップが完了したら、インストールされたコンポーネントを概要ファイルで確認できます。
セットアップが完了し、コンピューターの再起動を求めるメッセージが表示されたら、再起動してください。セットアップが完了したら、インストールウィザードからのメッセージを読むことが重要です。詳細については、「 SQL Server セットアップログファイルの表示と読み取り」を参照してください。

言語拡張機能を登録する

次の手順に従って、C# コードの実行に使用される .NET 言語拡張機能をダウンロードして登録します。
1. SQL Server GitHub リポジトリの .NET 言語拡張機能から dotnet-core-CSharp-lang-extension-windows-release.zip ファイルをダウンロードします。最新の Windows dotnet-core-CSharp-lang-extension-windows-release.zip ファイルをダウンロードします。より新しい .NET ランタイムを使用する場合は、GitHub ソースコードから dotnet-core-CSharp-lang-extension をコンパイルする必要があります。
2. SQL Server Management Studio (SSMS) または Azure Data Studio を使用してお使いの SQL Server インスタンスに接続し、次の Transact-SQL (T-SQL) コマンドを実行して、CREATE EXTERNAL LANGUAGE で .NET 言語拡張機能を登録します。
3. このステートメントのパスを変更して、ダウンロードした言語拡張機能の zip ファイル (dotnet-core-CSharp-lang-extension-windows-release.zip) の場所を反映します。
```
CREATE EXTERNAL LANGUAGE [dotnet]
FROM (CONTENT = N'C:\path\to\dotnet-core-CSharp-lang-extension-windows-release.zip',
    FILE_NAME = 'dotnetextension.dll');
GO
```
Launchpad を開始し直します。
1. [SQL Server 構成マネージャー] を開きます。
2. [SQL Server サービス] で [SQL Server スタートパッド] を右クリックして、 [再起動] を選択します。

サービスを再起動します。

インストールが完了したら、スクリプトの実行を有効にする次の手順に進む前に、データベースエンジンを再起動します。

サービスを再起動すると、関連する SQL Server Launchpad サービスも自動的に再起動されます。

サービスを再起動するには、SSMS でインスタンスを右クリックして [再起動] コマンドを使用するか、コントロールパネルの [サービス] パネルを使用するか、SQL Server 構成マネージャーを使用します。

スクリプトの実行を有効にする

SQL Server Management Studioを開きます。言語拡張をインストールしたインスタンスに接続し、[新しいクエリ] を選択してクエリウィンドウを開き、次のコマンドを実行します。
```
EXEC sp_configure;
```
この機能は既定ではオフになっており (value は 0)、C# コードを実行する前に管理者が明示的に有効にする必要があります。
外部スクリプト機能を有効にするには、次のステートメントを実行します。
```
EXEC sp_configure 'external scripts enabled', 1;
GO
RECONFIGURE WITH OVERRIDE
```
Machine Learning Services の機能をすでに有効にしている場合は、言語拡張機能に対して reconfigure を再度実行しないでください。基になる拡張機能プラットフォームでは、両方がサポートされています。

外部言語を登録する

言語拡張を利用する各データベースには、CREATE EXTERNAL LANGUAGE を使って外部言語を登録する必要があります。

次の例では、Windows 上の SQL Server のデータベースに、dotnet という名前の外部言語を追加します。

CREATE EXTERNAL LANGUAGE [dotnet]
FROM (CONTENT = N'<path-to-zip>', FILE_NAME = 'dotnetextension.dll');
GO

詳しくは、「CREATE EXTERNAL LANGUAGE」をご覧ください。

インストールの確認

セットアップログで、インスタンスのインストール状態を確認します。

次の手順に従って、外部スクリプトの起動に使用されるすべてのコンポーネントが実行されていることを確認します。

SQL Server Management Studio または Azure Data Studio で、新しいクエリウィンドウを開き、次のステートメントを実行します。
```
EXEC sp_configure 'external scripts enabled';
```
現在 run_value は 1 に設定されています。
[サービス] パネルまたは SQL Server 構成マネージャーを開き、SQL Server Launchpad サービスが実行されていることを確認します。言語拡張がインストールされているすべてのデータベースエンジンのインスタンスに対して、1 つのサービスが存在する必要があります。サービスの詳細については、「SQL Server 言語拡張機能の拡張アーキテクチャ」を参照してください。

追加の設定

検証手順が成功した場合は、SQL Server Management Studio、Azure Data Studio、Visual Studio Code、または T-SQL ステートメントをサーバーに送信できる他の任意のクライアントから、C# コードを実行できます。

コマンドの実行中にエラーが発生した場合は、このセクションの追加の構成手順を確認してください。サービスまたはデータベースに対して追加の適切な構成を行う必要がある場合があります。

インスタンスレベルでは、追加の構成には次のものが含まれる場合があります。

データベースでは、次の構成の更新が必要になる場合があります。

注意

追加の構成が必要かどうかは、SQL Server をインストールしたセキュリティスキーマと、ユーザーをどのようにデータベースに接続して外部スクリプトを実行させるかによって異なります。

推奨される最適化

すべてが機能するようになったので、.NET 言語拡張をサポートするようにサーバーを最適化することもできます。

.NET 言語拡張用にサーバーを最適化する

SQL Server セットアップの既定の設定は、抽出、変換、読み込み (ETL) プロセス、レポート、監査、SQL を使用するアプリケーションなど、データベースエンジンでサポートされるさまざまなサービスに対するサーバーのバランスを最適化することを目的としています。サーバーデータ。そのため、既定の設定では、場合によって言語拡張用のリソースが制限または調整されることがあります (特に、メモリを大量に使用する操作の場合)。

言語拡張ジョブが適切に優先順位を設定されて、リソースを提供されるようにするため、SQL Server Resource Governor を使って外部リソースプールを構成することをお勧めします。データベースエンジンに割り当てられるメモリ量を変更したり、SQL Server Launchpad サービスで実行するアカウントの数を増やしたりすることもできます。

外部リソースを管理するためのリソースプールを構成するには、「CREATE EXTERNAL RESOURCE POOL (Transact-SQL)」を参照してください。
データベース用に予約されているメモリの量を変更するには、「サーバーメモリの構成オプション」を参照してください。

Standard エディションを使用しており、リソースガバナーがない場合は、動的管理ビュー (DMV) と拡張イベント、および Windows イベント監視を使用して、サーバーリソースの管理を支援できます。

次のステップ

C# 開発者はいくつかの簡単な例を試して、SQL Server での C# の動作方法の基本を確認できます。次の手順については、以下のリンクを参照してください。

チュートリアル: C# での正規表現

次の方法で共有

Windows 上に SQL Server の .NET 言語拡張をインストールする

前提条件

.NET ランタイム

インストールメディアを入手する

セットアップの実行

言語拡張機能を登録する

サービスを再起動します。

スクリプトの実行を有効にする

外部言語を登録する

インストールの確認

追加の設定

推奨される最適化

.NET 言語拡張用にサーバーを最適化する

次のステップ

フィードバック

その他のリソース

次の方法で共有

Windows 上に SQL Server の .NET 言語拡張をインストールする

前提条件

.NET ランタイム

インストール メディアを入手する

セットアップの実行

言語拡張機能を登録する

サービスを再起動します。

スクリプトの実行を有効にする

外部言語を登録する

インストールの確認

追加の設定

推奨される最適化

.NET 言語拡張用にサーバーを最適化する

次のステップ

フィードバック

その他のリソース

インストールメディアを入手する