SQL Server Machine Learning Services で Python および R スクリプトを実行する Launchpad サービスに関する問題のトラブルシューティング
適用対象
: SQL Server 2016 (13.x) 以降のバージョン
この記事では、Machine Learning Services で使用される SQL Server Launchpad サービスに関連する問題のトラブルシューティングのガイダンスを提供します。 Launchpad サービスでは、R および Python の外部スクリプト実行がサポートされています。 構成の問題または変更や、不足するネットワーク プロトコルなどの複数の問題により、Launchpad が起動しないことがあります。
Launchpad が実行されているかどうかを判断する
[SQL Server 構成マネージャー] を開きます。 コマンド ラインで、「SQLServerManager13.msc」、「SQLServerManager14.msc」、または SQLServerManager15.msc」と入力します。
Launchpad が実行されているサービス アカウントをメモします。 R または Python が有効になっている各インスタンスには、Launchpad サービスの独自のインスタンスが必要です。 たとえば、名前付きインスタンスのサービスは、MSSQLLaunchpad$InstanceName のようになります。
サービスが停止している場合は再起動します。 再起動時に構成に問題がある場合は、システム イベント ログにメッセージが発行され、サービスが再度停止されます。 システム イベント ログで、サービスが停止した理由の詳細を確認します。
RSetup.log の内容を確認し、セットアップでエラーが発生していないことを確認します。 たとえば、メッセージ "Exiting with code 0" (コード0 で終了します) は、サービスの開始に失敗したことを示します。
他のエラーを検索するには、rlauncher.log の内容を確認します。
Launchpad のサービス アカウントを確認する
既定のサービス アカウントは、"NT Service$SQL2016"、"NT Service$SQL2017"、または "NT Service$SQL2019" です。 最後の部分は、SQL インスタンス名によって異なる場合があります。
Launchpad サービス (Launchpad.exe) は、低い特権のサービス アカウントを使用して実行されます。 ただし、R と Python を起動してデータベース インスタンスと通信するには、Launchpad サービス アカウントに次のユーザー権限が必要です。
- サービスとしてログオン (SeServiceLogonRight)
- プロセス レベル トークンを置き換える (SeAssignPrimaryTokenPrivilege)
- スキャン チェックを行わない (SeChangeNotifyPrivilege)
- プロセスに対してメモリ クォータを調整する (SeIncreaseQuotaSizePrivilege)
これらのユーザー権限の詳細については、「Windows サービス アカウントと権限の構成」の「Windows の特権および権限」を参照してください。
ヒント
SQL Server 診断のための Support Diagnostics Platform (SDP) ツールの使用に慣れている場合は、SDP を使用して、MachineName_UserRights.txt という名前の出力ファイルを確認できます。
Launchpad のユーザー グループがローカルにログオンできない
Machine Learning Services のセットアップ中に、SQL Server は Windows ユーザー グループ SQLRUserGroup を作成し、Launchpad が SQL Server に接続して外部スクリプト ジョブを実行するために必要なすべての権限を付けてそれをプロビジョニングします。 このユーザー グループが有効になっている場合、これは Python スクリプトの実行にも使用されます。
ただし、より制限の厳しいセキュリティ ポリシーが適用されている組織では、このグループに必要な権限が手動で削除されているか、ポリシーによって自動的に失効にされている可能性があります。 権限が削除されている場合、Launchpad は SQL Server に接続できなくなり、SQL Server は外部ランタイムを呼び出せません。
問題を解決するには、グループ SQLRUserGroup にローカルのログオンを許可するシステム権限があることを確認します。
詳細については、「Windows サービス アカウントと権限の構成」を参照してください。
外部スクリプトを実行する権限
Launchpad が正しく構成されていても、ユーザーに R または Python のスクリプトを実行する権限がない場合、エラーが返されます。
データベース管理者として SQL Server をインストールした場合、またはデータベース所有者である場合は、この権限が自動的に付与されます。 ただし、他のユーザーは通常、より限定された権限を持ちます。 これらのユーザーが R スクリプトを実行しようとすると、Launchpad エラーが表示されます。
この問題を解決するには、セキュリティ管理者は SQL Server Management Studio で次のスクリプトを実行して、SQL ログインまたは Windows ユーザー アカウントを変更します。
GRANT EXECUTE ANY EXTERNAL SCRIPT TO <username>
詳細については、「GRANT (Transact-SQL)」を参照してください。
Launchpad の一般的なエラー
このセクションでは、Launchpad が返す最も一般的なエラー メッセージを示します。
"R スクリプトのランタイムを起動できません"
R ユーザーの Windows グループ (Python にも使用) が R Services を実行しているインスタンスにログオンできない場合は、次のエラーが表示されることがあります。
R スクリプトを実行しようとすると生成されるエラー:
'R' スクリプトのランタイムを起動できません。 'R' ランタイムの構成を確認してください。
外部スクリプト エラーが発生しました。 ランタイムを起動できません。
SQL Server Launchpad サービスによって生成されるエラー:
ランチャー RLauncher.dll を初期化できませんでした
ランチャー dll が登録されていません!
セキュリティ ログに、NT SERVICE アカウントがログインできなかったことが示される
このユーザー グループに必要なアクセス許可を付与する方法については、SQL Server R Services のインストールに関する記事を参照してください。
注意
SQL ログインを利用し、リモート ワークステーションから R スクリプトを実行する場合、この制限は適用されません。
"ログオン失敗: 要求された種類のログオンは、ユーザーに許可されていません"
既定では、SQL Server Launchpad は起動時に NT Service\MSSQLLaunchpad アカウントを使用します。 このアカウントは、必要なすべてのアクセス許可を持つように SQL Server セットアップによって構成されます。
Launchpad に別のアカウントを割り当てたか、SQL Server コンピューターのポリシーによって権限が削除された場合、アカウントが必要なアクセス許可を持たず、次のエラーが発生する可能性があります。
ERROR_LOGON_TYPE_NOT_GRANTED 1385 (0x569) Logon failure: the user has not been granted the requested logon type at this computer
新しいサービス アカウントに必要なアクセス許可を与えるには、 ローカル セキュリティ ポリシー アプリケーションを使用し、アカウントのアクセス許可を更新して次のアクセス許可を追加します。
- プロセスに対してメモリ クォータを調整する (SeIncreaseQuotaPrivilege)
- スキャン チェックを行わない (SeChangeNotifyPrivilege)
- サービスとしてログオン (SeServiceLogonRight)
- プロセス レベル トークンを置き換える (SeAssignPrimaryTokenPrivilege)
"Launchpad サービスと通信できません"
機械学習をインストールして有効にしたが、R または Python スクリプトを実行しようとするとこのエラーが発生する場合は、インスタンスの Launchpad サービスが実行を停止した可能性があります。
Windows コマンド プロンプトから SQL Server 構成マネージャーを開きます。 詳細については、「 SQL Server Configuration Manager」を参照してください。
インスタンスの SQL Server Launchpad を右クリックし、 [プロパティ] を選択します。
[サービス] タブを選択し、サービスが実行されていることを確認します。 実行されていない場合は、 [開始モード] を [自動] に変更し、 [適用] を選択します。
通常、サービスを再起動すると、問題が解決して、機械学習スクリプトを実行できるようになります。 再起動によって問題が解決しない場合は、 [バイナリ パス] プロパティのパスと引数を確認し、次の手順を実行します。
a. ランチャーの .config ファイルを確認し、作業ディレクトリが有効であることを確認します。
b. Launchpad によって使用される Windows グループが SQL Server インスタンスに接続できることを確認します。
c. サービス プロパティを 1 つでも変更した場合は、Launchpad サービスを再起動します。
"致命的なエラー tmpFile の作成に失敗しました"
このシナリオでは、機械学習機能が正常にインストールされ、Launchpad が実行されています。 いくつかの単純な R または Python コードを実行しようとしても、Launchpad は次のようなエラーで失敗します。
R スクリプトのランタイムと通信できませんでした。 R ランタイムの要件を確認してください。
同時に、外部スクリプト ランタイムは、STDERR メッセージの一部として次のメッセージを書き込みます。
Fatal error: creation of tmpfile failed. (致命的なエラー: tmpfile の作成に失敗しました。)
このエラーは、Launchpad が使用しようとしているアカウントに、データベースにログオンする権限がないことを示します。 この状況は、厳密なセキュリティ ポリシーが実装されている場合に発生する可能性があります。 これに該当するかどうか判断するには、SQL Server ログを確認し、ログイン時に MSSQLSERVER01 アカウントが拒否されたかどうかをチェックします。 R_SERVICES or PYTHON_SERVICES に固有のログにも、同じ情報が記載されています。 ExtLaunchError.log を探してください。
既定では、MSSQLSERVER01 から MSSQLSERVER20 という名前で 20 個のアカウントがセットアップされ、Launchpad.exe プロセスに関連付けられます。 R または Python を頻繁に使用する場合は、アカウント数を増やすことができます。
この問題を解決するには、グループに、機械学習機能がインストールされて有効になっているローカル インスタンスに対する [ローカル ログオンを許可する] アクセス許可があることを確認します。 環境によっては、このアクセス許可レベルで、ネットワーク管理者からの GPO 例外が必要になる場合があります。
"このコマンドを実行するのに十分なクォータがありません"
このエラーは、次のいずれかのことを意味します。
外部クエリを実行する外部ユーザーが Launchpad で不足している可能性があります。 たとえば、20 個を超える外部クエリを同時に実行していて、既定の 20 ユーザーしかない場合、1 つ以上のクエリが失敗する可能性があります。
R タスクを処理するのに十分なメモリがありません。 このエラーは、ほとんどの場合、既定の環境で、SQL Server がコンピューターのリソースの 70% まで使用している場合に発生します。 R によるリソースの使用の拡大をサポートするようにサーバー構成を変更する方法の詳細については、R コードの運用に関する記事を参照してください。
"パッケージが見つかりません"
SQL Server で R コードを実行してこのメッセージが表示されたが、SQL Server の外部で同じコードを実行したときにはメッセージが表示されなかった場合は、SQL Server によって使用されるライブラリの既定の場所にパッケージがインストールされなかったことを意味します。
このエラーは、さまざまな方法で発生する可能性があります。
ユーザーがサーバーに新しいパッケージをインストールしましたが、アクセスが拒否されたため、R によってユーザー ライブラリにパッケージがインストールされました。
ユーザーが R Services をインストールした後、別の R ツールまたは一連のライブラリ (RStudio など) をインストールしました。
インスタンスによって使用される R パッケージ ライブラリの場所を確認するには、SQL Server Management Studio (またはその他のデータベース クエリ ツール) を開き、インスタンスに接続して、次のストアド プロシージャを実行します。
EXEC sp_execute_external_script @language = N'R',
@script = N' print(normalizePath(R.home())); print(.libPaths());';
サンプルの結果
外部スクリプトからの STDOUT メッセージ:
[1] "C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\R_SERVICES"
[1] "C:/Program Files/Microsoft SQL Server/MSSQL13.SQL2016/R_SERVICES/library"
この問題を解決するには、パッケージを SQL Server インスタンス ライブラリに再インストールする必要があります。
注意
最新バージョンの Microsoft R を使用するために SQL Server 2016 のインスタンスをアップグレードした場合、既定のライブラリの場所は異なります。 詳細については、「R ライブラリの既定の場所」を参照してください。
DLL が一致しないために Launchpad がシャットダウンする
他の機能を使用してデータベース エンジンをインストールして、サーバーに修正プログラムを適用した後、元のメディアを使用して Machine Learning 機能を追加すると、正しくないバージョンの Machine Learning コンポーネントがインストールされることがあります。 Launchpad は、バージョンの不一致を検出すると、シャットダウンしてダンプ ファイルを作成します。
この問題を回避するには、必ず新機能をサーバー インスタンスと同じ修正レベルでインストールしてください。
誤ったアップグレード方法:
- R Services なしで SQL Server 2016 をインストールします。
- SQL Server 2016 Cumulative Update 2 をアップグレードします。
- RTM メディアを使用して、R Services (データベース内) をインストールします。
正しいアップグレード方法:
- R Services なしで SQL Server 2016 をインストールします。
- 2016 SQL Server を目的の修正レベルにアップグレードします。 たとえば、Service Pack 1 をインストールしてから、Cumulative Update 2 をインストールします。
- 適切な修正レベルで機能を追加するには、SP1 および CU2 セットアップを再度実行してから、[R Services (データベース内)] を選択します。
8dot3 表記が必要な場合に Launchpad が起動できない
注意
古いシステムでは、8dot3 表記の要件がある場合、Launchpad が起動できないことがあります。 この要件はその後のリリースで削除されました。 SQL Server 2016 R Services のユーザーは、次のいずれかをインストールする必要があります。
- SQL Server 2016 SP1 と CU1:SQL Server 用の Cumulative Update 1。
- SQL Server 2016 RTM、Cumulative Update 3、およびオンデマンドで利用可能なこちらの修正プログラム。
R との互換性を確保するために、SQL Server 2016 R Services (データベース内) には、"8dot3 表記" を使用することで短いファイル名の作成をサポートする機能がインストールされているドライブが必要でした。 8\.3 ファイル名は "短いファイル名" とも呼ばれ、以前のバージョンの Microsoft Windows との互換性のため、または長いファイル名の代替ファイル名として使用されます。
R をインストールするボリュームが短いファイル名に対応していない場合、SQL Server から R を起動するプロセスで正しい実行可能ファイルが見つからないことがあり、Launchpad が起動しません。
回避策として、SQL Server がインストールされ、R Services がインストールされているボリュームで 8dot3 表記を有効にできます。 次に、R Services 構成ファイルに作業ディレクトリの短い名前を指定する必要があります。
8dot3 表記を有効にするには、「fsutil 8dot3name」で説明されているように、8dot3name 引数を指定して fsutil ユーティリティを実行します。
8dot3 表記が有効になったら、RLauncher.config ファイルを開き、
WORKING_DIRECTORYのプロパティを確認します。 このファイルを見つける方法の詳細については、Machine Learning のトラブルシューティングのためのデータ収集に関する記事を参照してください。file 引数を指定した fsutil ユーティリティを使用して、WORKING_DIRECTORY に指定されているフォルダーに短いファイル パスを指定します。
構成ファイルを編集して、WORKING_DIRECTORY プロパティに入力した作業ディレクトリと同じものを指定します。 あるいは、別の作業ディレクトリを指定して、8dot3 表記と互換性がある既存のパスを選択することもできます。
次のステップ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示