既知の問題と、SQL Server IaaS Agent 拡張機能のトラブルシューティング
この記事は、既知の問題の解決、およびSQL Server IaaS Agent 拡張機能の使用時に発生するエラーのトラブルシューティングに役立ちます。
拡張機能に関してよく寄せられる質問の回答については、FAQ を参照してください。
前提条件を確認する
サポートされていないオプションまたは制限事項を原因とするエラーを回避するために、拡張機能の前提条件を確認してください。
SQL IaaS Agent 拡張機能を修復または再インストールした場合、ライセンスの変更以外の設定は保持されません。 拡張機能を修復または再インストールした場合は、自動バックアップ、自動修正、および修復または再インストールの前に構成したその他のサービスを再構成する必要があります。
拡張機能の正常性を確認する
拡張機能の正常性は、Azure ポータルのSQL 仮想マシンリソースの [概要] ページ内の [拡張機能の正常性状態] でチェックできます。
Note
PowerShell スクリプトを使用して、仮想マシンの拡張機能の正常性状態をチェックすることもできます。 スクリプトの全文は GitHub の「Az PowerShell を使用して SQL IaaS Agent 拡張機能の正常性状態を取得する」を参照してください。
SQL IaaS Agent 拡張機能の状態は次のいずれかになります。
- 正常: すべてが期待どおりに動作しています。
- 失敗: メイン SQL IaaS エージェント サービスが SQL Server VM で実行されていません。
- 異常: 1 つ以上のサブサービスに問題があります。
SQL IaaS Agent 拡張機能の状態が異常または失敗の場合は、[概要] ページで通知をチェックして詳細を確認します。
このセクションの残りの部分では、各エラー条件通知の内容を説明します。
メイン SQL IaaS Agent 拡張機能サービスが実行されていません
SQL IaaS Agent 拡張機能 (Microsoft SQL Server IaaS エージェント) のメイン サービスが停止状態です。 このエラーのため、SQL IaaS Agent 拡張機能の状態は 失敗 になっています。
これを解決するには、拡張機能を修復します。
サーバーが実行されていません。
SQL Server サービスが停止しています。 SQL IaaS Agent 拡張機能の状態は、このエラーが原因で異常になっています。
さらに調査したうえで、サービスを再起動してください。
SQL IaaS Agent 拡張機能クエリ サービスが実行されていません
SQL IaaS Agent 拡張機能は、クエリ サービス (Microsoft SQL Server IaaS クエリ サービス) を使用して SQL Server と通信します。 クエリ サービスが停止状態の場合、SQL Server との通信に依存する機能は機能しません。 SQL IaaS Agent 拡張機能の状態は、このエラーが原因で異常になっています。
これを解決するには、拡張機能を修復します。
SQL IaaS Agent 拡張機能に正しいアクセス許可がない
SQL IaaS Agent 拡張機能クエリ サービス (Microsoft SQL Server IaaS Query Service) は、NT Service\SQLIaaSExtensionQueryアカウントを使用して SQL Server インスタンスのクエリを実行します。 このログインが SQL Server から削除された場合、またはユーザーまたはポリシーによってログインのアクセス許可が変更された場合メイン拡張機能に正しいアクセス許可がないというエラーが表示されます。 SQL IaaS Agent 拡張機能の状態は、このエラーが原因で異常になっています。
最小特権アクセス許可モデルを使用する SQL Server VM の場合は、NT Service\SQLIaaSExtensionQuery アカウントに有効になっている各機能に適切なアクセス許可が関連付けられていることを確認チェック。 有効化された機能がない場合、NT Service\SQLIaaSExtensionQueryログインが SQL Server 内に存在しないか、または Microsoft SQL Server IaaS クエリ サービスが NT Service\SQLIaaSExtensionQuery とは異なるユーザー名で実行されている場合にこのエラーが表示されます。
2022 年 10 月より前にデプロイされた一部の SQL Server VM では、以前の sysadmin アクセス許可モデルが引き続き使用される場合があります。 これらの古い VM では、NT Service\SQLIaaSExtensionQueryログインがSQL Server 内に存在しないかまたは sysadmin 権限がない場合、または Microsoft SQL Server IaaS Query Service が NT Service\SQLIaaSExtensionQuery とは異なるユーザー名で実行されている場合にアクセス許可エラーが表示されます。
このエラー状態を解決するには、ログインが SQL Server に存在し、有効にした機能に基づいて正しい アクセス許可 があることを確認してください。 ログインの再作成、あるいは適切なアクセス許可の割り当てが必要な場合があります。 さらに、Microsoft SQL Server IaaS クエリ サービスが正しいユーザー名で実行されていることも確認してくださいNT Service\SQLIaaSExtensionQuery。
拡張機能の修復
SQL IaaS Agent 拡張機能が失敗状態になる可能性があります。 Azure portal を使って、SQL IaaS Agent 拡張機能を修復します。
次の方法で拡張機能を修復Azure portal。
Azure portal にサインインします。
SQL 仮想マシン リソースに移動します。
一覧から SQL Server VM を選択します。 お使いの SQL Server VM がこの一覧に表示されない場合は、その SQL IaaS Agent 拡張機能に登録されていない可能性があります。
[ヘルプ] の下にある [SQL IaaS Agent Extension Settings] (SQL IaaS Agent 拡張機能の設定) を選択します。
プロビジョニングの状態が [失敗] と表示されている場合は、 [修復] を選択して拡張機能を修復します。 状態が [成功] の場合は、 [強制修復] の横にあるチェックボックスをオンにして、状態に関係なく拡張機能を修復できます。
SQL IaaS Agent 拡張機能の登録が、エラー "Power BI VM イメージ用の SQL 仮想マシン リソースの作成はサポートされていません" により失敗する
SQL IaaS Agent 拡張機能の登録はブロックされており、Azure Marketplace からデプロイされた Power BI VM、SQL Server Reporting Server、および SQL Server Analysis Service のイメージではサポートされないことに注意してください。
管理が無効な状態
次のエラー メッセージが表示された場合は、拡張機能を修復します。
The SQL virtual machines resource is not in a valid state for management
基になる仮想マシンが無効である
次のようなエラー メッセージが表示されることがあります。
SQL management operations are disabled because the state of underlying virtual machine is invalid
以下、具体例に沿って説明します。
- SQL VM が停止されている、割り当て解除されている、失敗状態にある、または検出されないことが考えられます。 基になる仮想マシンが実行されていることを検証します。
- ご利用の SQL IaaS Agent 拡張機能が失敗状態になっている可能性があります。 拡張機能を修復します。
次のいずれかの操作を行った場合は、ご利用の SQL VM を拡張機能から登録解除してから、その SQL VM をもう一度拡張機能に登録します。
- VM をサブスクリプション間で移行しました。
- SQL Server のロケールまたは照合順序を変更しました。
- SQL Server インスタンスのバージョンを変更しました。
- SQL Server インスタンスのエディションを変更しました。
"プロビジョニング失敗"
Azure portal で SQL IaaS Agent 拡張機能の状態が、プロビジョニング失敗と表示されている場合は、拡張機能を修復します。
ポータルで SQL VM リソースを使用できない
SQL IaaS Agent 拡張機能がインストールされていて、VM がオンラインになっているが、SQL VM リソースを Azure ポータル で使用できない場合は、 VM 内で SQL Server と SQL Browser サービスが開始されているか確認します。 それでも問題が解決しない場合は、拡張機能を修復します。
機能が淡色表示される
Azure portal で SQL VM リソースに移動したところ、淡色表示の機能がある場合は、SQL VM が稼働していることと、SQL IaaS Agent 拡張機能の最新バージョンをインストールしていることを確認します。
サービス アカウントが変更されている
拡張機能に関連付けられている 2 つのサービスのいずれかについてサービス アカウントを変更すると、拡張機能が失敗したり、予期しない動作が発生したりする可能性があります。
この 2 つのサービスは、次のアカウントで実行する必要があります。
- Microsoft SQL Server IaaS Agent は、SQL IaaS Agent 拡張機能のメイン サービスであり、ローカル システム アカウントで実行する必要があります。
- Microsoft SQL Server IaaS Query Service は、SQL Server 内で拡張機能がクエリを実行するのを支援するヘルパー サービスであり、NT サービス アカウント
NT Service\SqlIaaSExtensionQueryで実行する必要があります。
自動登録が失敗した
いくつかの SQL Server VM が自動登録に失敗した場合は、登録に失敗した VM 上のSQL Server のバージョンを確認してください。 既定では、SQL Server 2016 以降が存在する Azure VM は、CEIP サービスによって検出されると自動的に SQL IaaS Agent 拡張機能に登録されます。 2016 より前のバージョンが存在する SQL Server VM は、個別に、または一括で手動登録する必要があります。
リソースの消費量が大きい
SQL IaaS Agent 拡張機能による CPU またはメモリの消費量が予想外に大きくなっていることに気付いた場合は、拡張機能が最新バージョンであることを確認してください。 その場合は、services.msc から Microsoft SQL Server IaaS Agent を再起動します。
ディスクを拡張できない
次の条件では、SQL VM リソースの [ストレージ構成] ページからディスクを拡張することはできません。
- SQL IaaS Agent 拡張機能をアンインストールしてから再インストールする場合。
- SQL Server のインスタンスをアンインストールして再インストールする場合。
- Azure Marketplace から SQL Server イメージをデプロイするときに、ディスク/記憶域プール名にカスタムの名前付け規則を使用した場合。
デプロイ中にディスク構成が淡色表示される
アンマネージド ディスクを使用して SQL Server VM を作成すると、ディスク構成は設計上淡色表示されます。
自動バックアップが無効になっている
SQL VM リソースに [自動バックアップが現在無効] と表示されている場合は、SQL Server インスタンスでマネージド バックアップが有効になっているかどうかを確認します。 Azure portal から自動バックアップを使用するには、SQL Server でマネージド バックアップを無効にします。
拡張機能が移行中にスタックする
次のシナリオでは、SQL IaaS Agent 拡張機能が移行中の状態でスタックする可能性があります。
- SQL Server ログインまたはローカル管理者のグループから
NT service\SQLIaaSExtensionサービスを削除しました。 - 次の 2 つのサービスのいずれかが services.msc で停止されている
- Microsoft SQL Server IaaS Agent
- Microsoft SQL Server IaaS Query Service
ドメイン コントローラーへのインストールに失敗する
ドメイン コントローラーにインストールされている SQL Server インスタンスを SQL IaaS Agent 拡張機能に登録することはサポートされていません。 拡張機能に登録すると、ユーザー NT Service\SQLIaaSExtension が作成されます。ドメイン コントローラーではこのユーザーを作成できないため、この VM を SQL IaaS Agent に登録することはサポートされていません。
次のステップ
- SQL IaaS Agent 拡張機能が提供するベネフィットを確認します。
- 1 台の VM を手動で登録します
- サブスクリプション内のすべての VM を自動的に登録します。
- SQL IaaS Agent 拡張機能のプライバシー ステートメントを確認します。
- パフォーマンスとセキュリティを最適化するためのベスト プラクティスのチェックリストを確認します。
さらに学習するには、次の記事を参照してください。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示