Windows に SQL Server 2022 Machine Learning Services (Python と R) をインストールする

[アーティクル]
03/08/2024

適用対象: SQL Server 2022 (16.x)

この記事では、Windows に SQL Server 2022 Machine Learning Services をインストールする方法について説明します。 Machine Learning Services を使用して、データベース内で Python および R スクリプトを実行できます。

注意

これらの手順は、Windows の SQL Server 2022 (16.x) に固有です。 SQL Server 2016 (13.x)、SQL Server 2017 (14.x)、または SQL Server 2019 (15.x) 用に SQL Server Machine Learning Services を Windows にインストールするには、「Windows に SQL Server Machine Learning Services (Python と R) をインストールする」を参照してください。

Linux の場合は、「Linux に SQL Server Machine Learning Services (Python と R) をインストールする」を参照してください。

インストール前のチェックリスト

データベースエンジンのインスタンスが必要です。 Python または R の機能だけをインストールすることはできませんが、既存のインスタンスにそれらを段階的に追加することはできます。
事業継続のために、Machine Learning Services では Always On 可用性グループがサポートされています。各ノードに Machine Learning Services をインストールし、パッケージを構成します。
Machine Learning Services のインストールは、SQL Server 2019 以降の Always On フェールオーバークラスターインスタンスでもサポートされています。
Machine Learning Services をドメインコントローラーにインストールしないでください。セットアップの Machine Learning Services の部分が失敗します。
他のバージョンの Python および R とのサイドバイサイドインストールはサポートされていますが、お勧めしません。これがサポートされているのは、SQL Server インスタンスでは、オープンソースの R および Anaconda ディストリビューションの独自のコピーが使用されるからです。お勧めしないのは、SQL Server 外のコンピューター上で Python および R を使用するコードを実行すると、問題が発生する可能性があるためです。
- 別のライブラリと別の実行可能ファイルを使用すると、SQL Server で実行している機能とは矛盾する結果が作成されます。
- SQL Server では、外部ライブラリで実行されている R および Python スクリプトを管理できないため、リソースの競合が発生します。

重要

セットアップが完了したら、この記事で説明されている構成後の手順を必ず完了してください。この手順には、SQL Server で外部スクリプトを使用できるようにする作業が含まれる場合があります。通常、構成を変更するには、インスタンスを再起動するか、Launchpad サービスを再起動する必要があります。

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

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

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

セットアップを実行する

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

セットアップ中にインストールエラーが発生した場合は、セットアップブートストラップログフォルダーの概要ログ (たとえば、%ProgramFiles%\Microsoft SQL Server\160\Setup Bootstrap\Log\Summary.txt) を確認します。

SQL Server 2022 セットアップウィザードを起動します。
[インストール] タブで、 [SQL Server の新規スタンドアロンインストールを実行するか、既存のインストールに機能を追加します] を選択します。
[機能の選択] ページで、次のオプションを選択します。
- データベースエンジンサービス
  
  SQL Server で R または Python を使用するには、データベースエンジンのインスタンスをインストールする必要があります。既定のインスタンスまたは名前付きインスタンスを使用できます。
- Machine Learning Services および言語
  
  このオプションを選択すると、R および Python スクリプトの実行をサポートするデータベースサービスがインストールされます。
このスクリーンショットは、SQL Server 2022 (16.x) Machine Learning Services をインストールするときに確認する最小限のインスタンス機能を示しています。

ランタイムとパッケージをインストールする

SQL Server 2022 (16.x) 以降、R、Python、Java のランタイムは、SQL Server セットアップで出荷またはインストールされなくなりました。代わりに、以降のセクションを参照してカスタムランタイムとパッケージをインストールします。

R セットアップのサポート

R ランタイムのインストール

最新バージョンの R 4.2 for Windows をダウンロードしてインストールします。
CompatibilityAPI と RevoScaleR の依存関係をインストールします。インストールしたバージョンの R ターミナルから、次のコマンドを実行します。
```
# R Terminal
install.packages("iterators")
install.packages("foreach")
install.packages("R6")
install.packages("jsonlite")
```

最新バージョンの CompatibilityAPI および RevoScaleR パッケージをダウンロードしてインストールします。

install.packages("https://aka.ms/sqlml/r4.2/windows/CompatibilityAPI_1.1.0.zip", repos=NULL)

install.packages("https://aka.ms/sqlml/r4.2/windows/RevoScaleR_10.0.1.zip", repos=NULL)

SQL Server を使用して R ランタイムを構成する

SQL Server を使用して、インストールされている R ランタイムを構成します。既定のバージョンを変更するには、RegisterRext.exe コマンドラインユーティリティを使用します。このユーティリティは、インストールに応じて異なる R アプリケーションフォルダー内にあり、通常は %ProgramFiles%\R\R-4.2.3\library\RevoScaleR\rxLibs\x64 内にあります。

次のスクリプトを使用して、RegisterRext.exe のインストールフォルダーの場所からインストールされた R ランタイムを構成できます。インスタンス名は、SQL Server の既定のインスタンスの場合は MSSQLSERVER、または SQL Server の名前付きインスタンスのインスタンス名です。
```
.\RegisterRext.exe /configure /rhome:"%ProgramFiles%\R\R-4.2.3" /instance:"MSSQLSERVER"
```
通常は「.\SQLEXPRESS」または「MACHINENAME\SQLEXPRESS」と呼ばれる SQL Server の名前付きインスタンスを構成する場合は、インスタンス名のみを含めます。次に例を示します。
```
.\RegisterRext.exe /configure /rhome:"%ProgramFiles%\R\R-4.2.3" /instance:"SQLEXPRESS"
```
SQL Server Management Studio (SSMS) または Azure Data Studio を使用して、SQL Server Machine Learning Services をインストールしたインスタンスに接続します。 [新しいクエリ] を選択してクエリウィンドウを開き、次のコマンドを実行して外部スクリプト機能を有効にします。
```
EXEC sp_configure  'external scripts enabled', 1;
RECONFIGURE WITH OVERRIDE
```
別の言語の機能を既に有効にしている場合は、R で 2 回目の RECONFIGUREを実行する必要はありません。基になる拡張性プラットフォームで両方の言語がサポートされます。確認するには、次のコマンドから config_value と run_value の 1 が返されることを確認します。
```
EXEC sp_configure  'external scripts enabled';
```
SQL Server サービスを再起動します。サービスを再起動すると、関連する SQL Server Launchpad サービスも自動的に再起動されます。

サービスを再起動するには、SSMS オブジェクトエクスプローラーでインスタンスの [再起動] コマンドを右クリックするか、コントロールパネルの [サービス] 項目または SQL Server 構成マネージャーを使用します。
R のバージョンを返す単純な T-SQL コマンドを実行してインストールを確認します。
```
EXEC sp_execute_external_script @script=N'print(R.version)',@language=N'R';
GO
```

Python サポートを設定する

Python ランタイムをインストールする

Python 3.10 for Windowsの最新バージョンをダウンロードします。次のオプションを使用してインストールします。
1. Python セットアップアプリケーションを開き、[インストールをカスタマイズする] を選択します。
2. [すべてのユーザーに対して起動ツールをインストールする (推奨)] がオンになっていることを確認します。
3. [オプション機能] で、必要な機能を選択します (またはすべてを選択します)。
4. [詳細オプション] ページで、[すべてのユーザーに対してインストールする] を選択し、他のオプションを既定値のままにし、[インストール] を選択します。
  
  1 人のユーザー固有のものではなく、すべてのユーザーがアクセスできる Python インストールパス (たとえば、C:\Program Files\Python310) を使用することをお勧めします。
新しい管理者特権でのコマンドプロンプトから、最新バージョンの revoscalepy パッケージとその依存関係をダウンロードしてインストールします。
```
cd "C:\Program Files\Python310\"
python -m pip install -t "C:\Program Files\Python310\Lib\site-packages" dill numpy==1.22.0 pandas patsy python-dateutil
python -m pip install -t "C:\Program Files\Python310\Lib\site-packages" https://aka.ms/sqlml/python3.10/windows/revoscalepy-10.0.1-py3-none-any.whl
```
次の icacls コマンドを実行して、インストールされているライブラリに対する読み取りと実行のアクセス権を SQL Server Launchpad Service と SID S-1-15-2-1 (ALL_APPLICATION_PACKAGES) に付与します。 SQL Server 構成マネージャーにチェック、Launchpad サービスに関連付けられているサービスアカウントにアクセス許可を付与する必要があります。
```
icacls "C:\Program Files\Python310\Lib\site-packages" /grant "NT Service\MSSQLLAUNCHPAD":(OI)(CI)RX /T
icacls "C:\Program Files\Python310\Lib\site-packages" /grant *S-1-15-2-1:(OI)(CI)RX /T
```
SQL Server を名前付きインスタンスとしてインストールした場合、サービスアカウントの中央に次のように $ が含まれる場合があります。
```
icacls "C:\Program Files\Python310\Lib\site-packages" /grant "NT Service\MSSQLLAUNCHPAD$SQLEXPRESS":(OI)(CI)RX /T
icacls "C:\Program Files\Python310\Lib\site-packages" /grant *S-1-15-2-1:(OI)(CI)RX /T
```

SQL Server を使用して Python ランタイムを構成する

SQL Server を使用して、インストールされている Python ランタイムを構成します。既定のバージョンを変更するには、RegisterRext.exe コマンドラインユーティリティを使用します。ユーティリティは、カスタムインストールの場所 (例: C:\Program Files\Python310\Lib\site-packages\revoscalepy\rxLibs) にあります。

管理者特権でのコマンドプロンプトから、次のスクリプトを使用して、RegisterRext.exe のインストールフォルダーの場所からインストールされた Python ランタイムを構成できます。インスタンス名は、SQL Server の既定のインスタンスの場合は MSSQLSERVER、または SQL Server の名前付きインスタンスのインスタンス名です。
```
cd "C:\Program Files\Python310\Lib\site-packages\revoscalepy\rxLibs"
.\RegisterRext.exe /configure /pythonhome:"C:\Program Files\Python310" /instance:"MSSQLSERVER"
```
通常は「.\SQLEXPRESS」または「MACHINENAME\SQLEXPRESS」と呼ばれる SQL Server の名前付きインスタンスを構成する場合は、インスタンス名のみを含めます。次に例を示します。
```
cd "C:\Program Files\Python310\Lib\site-packages\revoscalepy\rxLibs"
.\RegisterRext.exe /configure /pythonhome:"C:\Program Files\Python310" /instance:"SQLEXPRESS"
```
SQL Server Management Studio または Azure Data Studio を使用して、SQL Server Machine Learning Services をインストールしたインスタンスに接続します。 [新しいクエリ] を選択してクエリウィンドウを開き、次のコマンドを実行して外部スクリプト機能を有効にします。
```
EXEC sp_configure  'external scripts enabled', 1;
RECONFIGURE WITH OVERRIDE
```
別の言語の機能を既に有効にしている場合は、R で 2 回目の RECONFIGUREを実行する必要はありません。基になる拡張性プラットフォームで両方の言語がサポートされます。確認するには、次のコマンドから config_value と run_value の 1 が返されることを確認します。
```
EXEC sp_configure  'external scripts enabled';
```
SQL Server サービスを再起動します。サービスを再起動すると、関連する SQL Server Launchpad サービスも自動的に再起動されます。

サービスを再起動するには、SSMS オブジェクトエクスプローラーでインスタンスの [再起動] コマンドを右クリックするか、コントロールパネルの [サービス] 項目または SQL Server 構成マネージャーを使用します。
Python のバージョンを返す単純な T-SQL コマンドを実行してインストールを確認します。
```
EXEC sp_execute_external_script @script=N'import sys;print(sys.version)',@language=N'Python'
GO
```

Java のインストール

Java のインストールと使用の詳細については、「Windows 上に SQL Server の Java 言語拡張をインストールする」を参照してください。

追加構成

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

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

コマンドを実行したときにエラーが発生した場合、サービスまたはデータベースに追加の構成を行うことが必要な場合があります。インスタンスレベルでは、追加の構成に次のものが含まれます。

SQL Server Machine Learning Services のファイアウォールの構成
追加のネットワークプロトコルの有効化
リモート接続の有効化
SQLRUserGroup のログインを作成する
ディスククォータを管理して、ディスク領域を消費するタスクが外部スクリプトによって実行されるのを防止する

Windows の SQL Server 2019 以降では、分離メカニズムが変更されています。このメカニズムは、SQLRUserGroup、ファイアウォール規則、ファイルのアクセス許可、および暗黙の認証に影響します。詳細については、Machine Learning Services の分離の変更に関するページを参照してください。

データベースで構成の更新が必要になる場合があります。詳細については、「SQL Server Machine Learning Services にユーザーアクセス許可を付与する」を参照してください。

推奨される最適化

これですべてが機能するようになったので、機械学習をサポートするようにサーバーを最適化したり、事前トレーニング済みの機械学習モデルをインストールしたりすることもできます。

スクリプトの実行用にサーバーを最適化する

SQL Server セットアップの既定の設定は、さまざまな他のサービスおよびアプリケーションに対してサーバーのバランスを最適化することを目的としています。

既定の設定では、特にメモリを集中的に使用する操作では、機械学習のリソースが制限または調整されることがあります。

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

外部リソースを管理するためのリソースプールを構成するには、CREATE EXTERNAL RESOURCE POOL に関するページを参照してください。
データベース用に予約されているメモリの量を変更するには、「サーバーメモリの構成オプション」を参照してください。
SQL Server Launchpad で開始できる R アカウントの数を変更するには、「SQL Server Machine Learning Services での外部スクリプトの同時実行のスケーリング」を参照してください。

Standard Edition を使用していて、Resource Governor がない場合は、動的管理ビュー、SQL Server 拡張イベント、Windows イベント監視を使用してサーバーリソースを管理できます。

Python と R の追加パッケージをインストールする

SQL Server 用に作成する Python および R ソリューションでは、次のものを呼び出すことができます。

基本関数。
SQL Server と共にインストールされた専用パッケージの関数。
SQL Server によってインストールされたオープンソースの Python および R のバージョンと互換性のあるサードパーティ製のパッケージ。

SQL Server で使用するパッケージは、インスタンスで使用される既定のライブラリにインストールする必要があります。コンピューター上に Python または R の別のインストールがある場合、またはパッケージをユーザーライブラリにインストールした場合は、これらのパッケージが T-SQL から使用できなくなります。

追加のパッケージをインストールして管理するには、ユーザーグループを設定してデータベースレベルでパッケージを共有できます。または、ユーザーが独自のパッケージをインストールできるようにデータベースロールを構成することができます。詳細については、Python パッケージのインストールと新しい R パッケージのインストールに関するページを参照してください。

Python および R ランタイム用のスタンドアロン RevoScale パッケージ

RevoScale パッケージは、Python および R ランタイムを使用したスタンドアロンパッケージとしてもサポートされています。スタンドアロンシナリオ用に Python または R ランタイムをセットアップするには、それぞれ「Python ランタイムのインストール」セクションと「R ランタイムのインストール」セクションの手順に従います。

Python 開発者は、次のチュートリアルに従って、SQL Server で Python を使用する方法を学習できます。

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

次の方法で共有

Windows に SQL Server 2022 Machine Learning Services (Python と R) をインストールする

インストール前のチェックリスト

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

セットアップを実行する

ランタイムとパッケージをインストールする

R セットアップのサポート

R ランタイムのインストール

SQL Server を使用して R ランタイムを構成する

Python サポートを設定する

Python ランタイムをインストールする

SQL Server を使用して Python ランタイムを構成する

Java のインストール

追加構成

推奨される最適化

スクリプトの実行用にサーバーを最適化する

Python と R の追加パッケージをインストールする

Python および R ランタイム用のスタンドアロン RevoScale パッケージ

フィードバック

その他のリソース

次の方法で共有

Windows に SQL Server 2022 Machine Learning Services (Python と R) をインストールする

インストール前のチェックリスト

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

セットアップを実行する

ランタイムとパッケージをインストールする

R セットアップのサポート

R ランタイムのインストール

SQL Server を使用して R ランタイムを構成する

Python サポートを設定する

Python ランタイムをインストールする

SQL Server を使用して Python ランタイムを構成する

Java のインストール

追加構成

推奨される最適化

スクリプトの実行用にサーバーを最適化する

Python と R の追加パッケージをインストールする

Python および R ランタイム用のスタンドアロン RevoScale パッケージ

関連するコンテンツ

フィードバック

その他のリソース

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