SQL Server 2016 R Services のインストール

[アーティクル]
03/18/2023

適用対象: SQL Server 2016 (13.x) のみ

Windows に SQL Server 2016 R Services をインストールする方法について説明します。 R Services を使用すると、データベース内で R スクリプトを実行できます。

注意

SQL Server 2017 以降で、R は Python と共に Machine Learning Services に含まれています。 R が必要な場合、SQL Server 2017 以降をお持ちの場合は、SQL Server Machine Learning Services のインストールに関するページを参照して、この機能を追加してください。

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

データベースエンジンのインスタンスが必要です。 R だけをインストールすることはできませんが、既存のインスタンスに段階的に追加することはできます。
ビジネス継続性のために、R Services では Always On 可用性グループがサポートされています。各ノードに R Services をインストールし、パッケージを構成する必要があります。
SQL Server Always On フェールオーバークラスターインスタンス (FCI) に R Services をインストールしないでください。 R プロセスを分離に使用されるセキュリティ上のメカニズムは、SQL Server Always On フェールオーバークラスターインスタンス (FCI) 環境との互換性がありません。
R Services はドメインコントローラーにはインストールしないでください。セットアップの R Services の部分が失敗します。
共有機能>R Server (スタンドアロン) を、データベース内インスタンスを実行しているのと同じコンピューターにインストールしないでください。
R の他のバージョンとのサイドバイサイドインストールはサポートされていますが、推奨されません。これがサポートされているのは、SQL Server インスタンスでは、オープンソースの R ディストリビューションの独自のコピーが使用されるからです。しかし、SQL Server の外部の SQL Server コンピューターで R を使用するコードを実行すると、さまざまな問題が発生する可能性があります。
- SQL Server で実行しているときとは異なるライブラリと実行可能ファイルを使用すると、異なる結果になります。
- 外部ライブラリで実行されている R スクリプトは、SQL Server で管理できないため、リソースの競合が発生します。

重要

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

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

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

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

インストールのパッチ要件

SQL Server の前提条件としてインストールされる特定のバージョンの Microsoft VC++ 2013 ランタイムバイナリに問題が見つかりました。 VC ランタイムバイナリに対するこの更新プログラムをインストールしないと、特定のシナリオにおいて、SQL Server で安定性の問題が発生する可能性があります。 SQL Server をインストールする前に、「SQL Server リリースノート」にある手順に従って、ご使用のコンピューターに VC ランタイムバイナリのパッチが必要かどうかを確認してください。

セットアップを実行する

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

SQL Server 2016 のセットアップウィザードを開始します。
[インストール] タブで、 [SQL Server の新規スタンドアロンインストールを実行するか、既存のインストールに機能を追加します] を選択します。
[機能の選択] ページで、次のオプションを選択します。
- [データベースエンジンサービス] を選択します。機械学習を使用する各インスタンスには、データベースエンジンが必要です。
- [R Services (データベース内)] を選択します。 R のデータベース内での使用のサポートがインストールされます。
重要

R Server と R Services を同時にインストールしないでください。
[Microsoft R オープンのインストールに同意する] ページで、 [同意する] をクリックします。

このライセンス契約は、Microsoft R Open をダウンロードするために必要です。これには、オープンソース R 基本パッケージとツール、Microsoft 開発チームから提供された R パッケージおよび接続プロバイダーのディストリビューションが含まれています。
ライセンス契約に同意した後、インストーラーが準備されるまで少し時間がかかります。 [次へ] ボタンが使用可能になったら、クリックします。
[インストールの準備完了] ページで、次の項目が選択されていることを確認した後、 [インストール] を選択します。
- データベースエンジンサービス
- R Services (データベース内)
セットアップが完了し、コンピューターの再起動を求めるメッセージが表示されたら、再起動してください。セットアップが完了した時点で、インストールウィザードによるメッセージを確認することが重要です。詳細については、「 SQL Server セットアップログファイルの表示と読み取り」を参照してください。

環境変数の設定

R 機能の統合のみの場合、MKL_CBWR 環境変数を設定して、Intel Math Kernel Library (MKL) 計算からの一貫した出力を保証する必要があります。

コントロールパネルで、 [システムとセキュリティ]>[システム]>[システムの詳細設定]>[環境変数] の順にクリックします。
新しいユーザー変数またはシステム変数を作成します。
- 変数名を MKL_CBWR に設定する
- 変数値を AUTO に設定する

この手順では、サーバーを再起動する必要があります。すべての構成作業が完了するまで再起動を遅らせることができます。

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

SQL Server Management Studio (SSMS) または Azure Data Studio を開きます。
R Services をインストールしたインスタンスに接続し、 [新しいクエリ] をクリックしてクエリウィンドウを開き、次のコマンドを実行します。
```
sp_configure
```
プロパティ external scripts enabled の値は、この時点では 0 であることが必要です。これは、機能が既定で無効になっているためです。この機能は、R スクリプトを実行する前に、管理者が明示的に有効にする必要があります。
外部スクリプト機能を有効にするには、次のステートメントを実行します。
```
EXEC sp_configure  'external scripts enabled', 1
RECONFIGURE WITH OVERRIDE
```

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

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

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

サービスの再起動は、SSMS でインスタンスの [再起動] コマンドを右クリックするか、SQL Server 構成マネージャーを使って行うことができます。

インストールの確認

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

SQL Server Management Studio で、新しい [クエリ] ウィンドウを開き、次のコマンドを実行します。
```
EXEC sp_configure 'external scripts enabled'
```
この時点で、run_value が 1 に設定されている必要があります。
SQL Server 構成マネージャーを開き、SQL Server Launchpad サービスが実行されていることを確認します。 R がインストールされているすべてのデータベースエンジンのインスタンスに対して 1 つのサービスがある必要があります。サービスの詳細については、機能拡張フレームワークに関するページを参照してください。
Launchpad が実行されている場合は、外部スクリプトランタイムが SQL Server と通信できることを確認するため、単純な R を実行できる必要があります。

SQL Server Management Studio または Azure Data Studio で新しい [クエリ] ウィンドウを開き、次のようなスクリプトを実行します。
```
EXEC sp_execute_external_script  @language =N'R',
@script=N'
OutputDataSet <- InputDataSet;
',
@input_data_1 =N'SELECT 1 AS hello'
WITH RESULT SETS (([hello] int not null));
GO
```
スクリプトの実行には、最初に外部スクリプトランタイムが読み込まれるときに少し時間がかかります。結果は次のようになります。

hello

1

hello
1

更新プログラムの適用

最新の Service Pack と累積的な更新プログラムをデータベースエンジンと機械学習コンポーネントの両方に適用することが推奨されます。

インターネットに接続されているデバイスでは、通常、累積的な更新プログラムは Windows Update によって適用されますが、管理された更新には、次の手順を使用することもできます。データベースエンジンに更新プログラムを適用すると、同じインスタンスにインストールした R ライブラリの累積更新プログラムがセットアップによってプルされます。

接続されていないサーバーでは、追加の手順が必要です。詳細については、インターネットアクセスなしでコンピューターにインストールする > 累積的な更新プログラムを適用するを参照してください。

既にインストールされているベースラインインスタンスを使用して開始します: SQL Server 2016 初回リリース、SQL Server 2016 SP 1、または SQL Server 2016 SP 2。
累積的な更新プログラムの一覧に移動します: Microsoft SQL Server の最新の更新プログラム
最新の Service Pack (ベースラインインスタンスとしてまだインストールされていない) と累積更新プログラムを選択します。実行可能ファイルがダウンロードされ、自動的に抽出されます。
セットアップを実行します。ライセンス条項に同意し、[機能の選択] ページで、累積的な更新プログラムが適用される機能を確認します。 R Services を含む、現在のインスタンスにインストールされているすべての機能が表示されます。セットアップにより、すべての機能を更新するために必要な CAB ファイルがダウンロードされます。
ウィザードを続行し、R ディストリビューションのライセンス条項に同意します。

注意

SQL Server 2016 SP2 の累積的な更新プログラム (CU) 14 以降には、より新しいバージョンの R ランタイムが含まれています。詳細については、既定の言語ランタイムバージョンの変更に関するページを参照してください。

追加構成

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

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

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

SQL Server Machine Learning Services のファイアウォール構成。
追加のネットワークプロトコルの有効化。
リモート接続の有効化。
ディスク領域を消費するタスクを外部スクリプトで実行しないようにするためのディスククォータの管理。

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

Note

リストされたすべての変更が必要となるとは限りません。すべて不必要な場合もあります。必要となるかどうかは、SQL Server をインストールしたセキュリティスキーマと、ユーザーをどのようにデータベースに接続して外部スクリプトを実行させるかによって異なります。インストールに関するその他のガイダンスについては、次を参照してください。SQL Server Machine Learning Services のインストール

推奨される最適化

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

ワーカーアカウントを追加する

R を多く使うと思われる場合、または多くのユーザーが同時にスクリプトを実行する場合は、スタートパッドサービスに割り当てられるワーカーアカウントの数を増やすことができます。詳細については、「SQL Server Machine Learning Services での外部スクリプトの同時実行のスケーリング」を参照してください。

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

SQL Server のセットアップの既定の設定は、データベースエンジンによってサポートされているさまざまなサービスに対してサーバーのバランスを最適化することを目的としています。サービスには、抽出、変換、および読み込み (ETL) プロセス、レポート、監査、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 がない場合は、動的管理ビュー (DMV) と拡張イベントに加え、Windows イベント監視を使用して、R によって使用されるサーバーリソースを管理できます。

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

SQL Server 用に作成する R ソリューションでは、基本 R 関数、SQL Server と共にインストールされた専用パッケージの関数、SQL Server によってインストールされたオープンソースの R のバージョンと互換性のあるサードパーティ製の R パッケージを呼び出すことができます。

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

R パッケージのインストールと管理のプロセスは、SQL Server 2016 と SQL Server 2017 で異なります。 SQL Server 2016 では、データベース管理者は、ユーザーが必要とする R パッケージをインストールする必要があります。 SQL Server 2017 では、ユーザーグループを設定してデータベースレベルでパッケージを共有するか、ユーザーが独自のパッケージをインストールできるようにデータベースロールを構成します。詳細については、「R ツールを使用してパッケージをインストールする」をご覧ください。

次のステップ

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

SQL Server 2016 R Services のインストール

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

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

インストールのパッチ要件

セットアップを実行する

環境変数の設定

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

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

インストールの確認

更新プログラムの適用

追加構成

推奨される最適化

ワーカーアカウントを追加する

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

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

次のステップ

フィードバック

フィードバック

その他のリソース

SQL Server 2016 R Services のインストール

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

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

インストールのパッチ要件

セットアップを実行する

環境変数の設定

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

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

インストールの確認

更新プログラムの適用

追加構成

推奨される最適化

ワーカー アカウントを追加する

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

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

次のステップ

フィードバック

フィードバック

その他のリソース

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

ワーカーアカウントを追加する