Dataverse 向け Azure Synapse Link のトラブルシューティング ガイド

Azure Synapse Link プロファイルを開くと、メッセージとこの記事へのリンクとともにエラーが表示される場合があります。 さらに、ユーザーには、既に Azure Synapse Link プロファイルにあるテーブルの横に エラー 状態が表示される場合もあります。 このトラブルシューティング ガイドを使用して、Dataverse 向け Azure Synapse Link のエラー状態を診断して修正します。

エラーメッセージ 原因 解決策
MSI-801: Azure Synapse Link は、MSI 経由で保護されたストレージ アカウントにアクセスできません。 データの更新が一時停止されます。 この Azure Synapse Link プロファイルに対して選択されたストレージ アカウントに対してマネージド サービス識別 (MSI) を有効にしました。
Azure Synapse Link サービスは、MSI 構成の問題により、ストレージ アカウントにアクセスできず、サービスが一時停止しました。
MSI 構成を再確認して確認する
MSI ポリシーが削除されていないことを確認します。
MSI に必要なアクセス権限が付与されていることを検証します。
詳細: MSI 構成
必要なアクセスが許可されると、サービスが再開されます。
ADLS-802: Azure Synapse Link は、ストレージ アカウントにアクセスできません。 データの更新が一時停止されます。 Azure Synapse Link サービスはストレージ アカウントにアクセスできず、サービスが一時停止しました。
Azure Synapse Link プロファイルに割り当てられたストレージ アカウントに関連付けられたアクセス許可が変更されたか、ストレージ アカウントが存在しない可能性があります。
ストレージ アカウントが存在することと、Azure Synapse Link サービスにストレージ アカウントへの所有者アクセス権があることを確認します。
詳細: 前提条件
必要なアクセスが許可されると、サービスが再開されます。
CT-803: 行バージョン変更追跡構成キーがリンクされた環境で無効になっています。 一部のテーブルのデータ更新は一時停止される場合があります。 Azure Synapse Link サービスでは、リンクされた財務と運用アプリ環境で構成キー 行バージョン変更追跡の有効化 を有効にする必要があります。 この構成キーはリンク環境では無効になっており、サービスはリンク環境から財務と運用アプリ テーブルを一時停止しています。
データベースの復元操作により構成が元に戻された可能性があります。
構成キーを有効にし、財務と運用アプリ テーブルを削除して再追加して再開します。 影響を受けるテーブルは、新しいデータを反映するために初期化されます。
管理者は 財務と運用アプリの構成キーを再度有効にする必要があります。
詳細: 財務と運用アプリ環境で構成を追加する
構成キーが再度有効になると、サービスが再開されます。
DV-804: この環境は管理者モードであり、サービスは一時停止されています。 Power Platform 環境が管理モードの場合、Azure Synapse Link サービスを含むすべてのサービスが一時的に停止されます。
管理モード が 無効 の場合、サービスは再開されます。
環境 管理者 を確認し、環境が動作していることを確認します。
また、管理モード が 無効化 された後、バックグラウンド操作 環境設定が 有効 になっていることも確認します。
Azure Synapse Link サービスは、環境が操作可能になると再開されます。
SYN-805: Synapse ワークスペースにアクセスできません。 Azure Synapse Link サービスは、このプロファイルに関連付けられている Synapse ワークスペースにアクセスできません。
この問題を解決しても、シナプス テーブルがすぐに作成されない可能性があります。 Dataverse でデータが更新されると、システムは Synapse ワークスペースにテーブルを作成します。
Synapse ワークスペース ネットワーク構成で、オプション Azure サービスとリソースによるこのワークスペースへのアクセスを許可 を有効にします。
他のネットワーク構成では、Azure Synapse Link サービスがワークスペースに到達するのをブロックすることもできます。 マネージド仮想ネットワーク、IP ファイアウォール規則、またはパブリック ネットワーク アクセス制限によってワークスペースへのアクセスがブロックされていないことを管理者に確認します。 詳細情報: IP ファイアウォール規則とAzure Synapse Analytics接続設定を構成する
SYN-806: Synapse ワークスペースの既定のストレージ コンテナーにアクセスできません。 この Azure Synapse Link プロファイルに関連付けられている Synapse ワークスペースには、プライマリ Azure Data Lake Storage Gen2 ファイル システムが含まれていません。 デフォルトのストレージ コンテナーが削除されているか、デフォルトのストレージ コンテナーにアクセスできない可能性があります。
既定のストレージ コンテナーは、ファイル システムの作成時に一時ストレージとして Synapse ワークスペースによって使用されます。 Synapse ワークスペースを作成するときは、デフォルトのストレージ コンテナーを指定する必要があります。
このストレージ コンテナは削除されたか、アクセスできなくなった可能性があります。
管理者に依頼して Synapse ワークスペースを起動し、プライマリ Azure Data Lake Storage Gen2 ファイル システムの名前を確認します。
また、Azure Data Lake Storage Gen2 ストレージ コンテナーが同じサブスクリプション内にその名前で存在することも確認します。
ストレージ コンテナーが見つからない場合は、同じ名前のストレージ コンテナーを作成します。
SYN-809: Synapse ワークスペース {name} では、データ流出ポリシーが有効になっています。 別のワークスペースを選択する必要があります。 Delta 変換オプションを使用した Synapse Link プロファイルには、データ流出ポリシーのない Synapse ワークスペースが必要です。 データ流出ポリシーを備えた Synapse ワークスペースを選択した可能性がありますが、これは Synapse Link コンピューティング サービスと干渉しています。 データ流出ポリシーが有効になっていない Synapse ワークスペースを提供するように管理者に依頼してください。 また、Synapse Link の代わりにFabric リンクを使用することも検討してください。
SYN-810: Synapse ワークスペースに関連付けられている既定のストレージ コンテナーは、ネットワーク制限されています。 Delta 変換オプションを使用した Synapse Link プロファイルには、既定のストレージ コンテナがある Synapse ワークスペースが必要です。 選択した Synapse ワークスペースに関連付けられている既定のストレージ コンテナーにネットワーク制限が適用されている場合、Synapse Link コンピューティング サービスは必要な更新を実行できません。 管理者に依頼して、選択した Synapse ワークスペースの既定の ストレージ コンテナーのネットワーク制限を削除するか、別の Synapse ワークスペースを選択します。
SPARK-807: {Synapse ワークスペース} の Spark コンピューティング プール {name} は利用できなくなりました。 データの更新が一時停止されます。 Azure Synapse Link サービスは、データを delta 形式に処理するために Spark プールが必要です。 この Azure Synapse Link プロファイルで提供される Spark プールが削除されたか、使用できなくなりました。
Synapse ワークスペースへのアクセスが制限されている可能性もあります。
問題を解決すると、Azure Synapse Link サービスは、データの変更時にデータ更新を再開します。
選択した名前の Spark プールが存在することを確認します。 あなたまたは誰かがこの Spark プールを削除した場合は、同じ名前で Spark プールを作成します。
SPARK-808: {Synapse ワークスペース} の Spark コンピューティング プール {name} は充分ではありません。 1 つ以上のテーブルを更新できませんでした。 Azure Synapse Link サービスは、構成で提供される Spark プールを使用して、データの更新時にファイルを Delta Parquet 形式に変換します。
大規模なデータのバッチが更新できる場合、Azure Synapse Link プロファイルで提供される Spark プールのサイズでは、十分なコンピューティング能力が得られない可能性があります。
これは、初期化プロセスで大量のデータのバッチが作成されるため、大きなテーブルを追加する場合に特に発生する可能性があります。
これにより、容量が制限された "従量課金制" サブスクリプションを利用している場合にも発生する可能性があります。 これらのタイプのサブスクリプション内の Spark プールの容量は制限されています。
割り当てられた Spark プール内のコアの数を増やします。
システムは、ワークロードが大きくなった場合に増加した容量を消費し、必要に応じてスケールダウンします。
詳細: デルタ変換に推奨される Spark プール サイズ
CT-809: テーブルで行バージョン変更追跡プロパティが無効になっています。 データの更新が一時停止されます。 Azure Synapse Link サービスでは、行バージョン変更追跡 メタデータ プロパティを有効にする必要があります。 このプロパティはテーブルに対して無効になっており、テーブルは更新されません。
財務および運用でこのメタデータ プロパティを更新するには、開発者の介入が必要です。 Azure Synapse Link プロファイルの作成後にプロパティが無効にされた可能性があります。
このテーブルを再開するには、行バージョン変更追跡メタデータ プロパティを再度有効にします。
開発者ツールを使用してプロパティを再度有効にするには、管理者 または開発者が必要な場合があります。 詳細: テーブルの行のバージョン変更の有効化。
CT-810: このテーブルの 行バージョン変更追跡を許可する プロパティはいいえに設定されています。 Azure Synapse Link サービスでは、行バージョン変更追跡を許可する メタデータ プロパティを はい にする必要があります。
財務および運用でこのメタデータ プロパティを更新するには、開発者の介入が必要です。 Synapse Link プロファイルが作成された後にプロパティが無効になった可能性があります。
このテーブルを再開するには、行バージョン変更追跡メタデータ プロパティを再度有効にします。
開発者ツールを使用してプロパティを再度有効にするには、管理者 または開発者が必要な場合があります。 詳細: テーブルの行のバージョン変更の有効化。
FnO-810: リンクされた財務と運用環境が利用できないか、一時停止されています。 この Azure Synapse Link プロファイルにリンクされている財務と運用アプリ環境が、使用できないか、メンテナンス モードです。 Azure Synapse Link サービスは環境に接続できず、サービスは財務と運用アプリからソースされたテーブルを一時停止しました。
クラウドでホストされている環境の場合、環境が一時停止状態になっている可能性があります。
管理者 を使用して、リンクされた環境が一時停止しておらず、メンテナンス モードになっていないことを確認します。
Azure Synapse Link サービスは、環境が運用モードになると再開されます。
FnO-811: リンクされた財務と運用環境を更新する必要があります。 この Azure Synapse Link プロファイルにリンクされている財務と運用アプリ環境を最新バージョンに更新する必要があります。
現在、財務と運用バージョン PU60、PU61、または PU62 を使用している場合は、最新の累積的な更新プログラムに更新する必要があります
10.0.36 (PU 60) - 7.0.7036.133 以降
10.0.37 (PU 61) - 7.0.7068.109 以降
10.0.38 (PU 62) - 7.0.7120.59 以降
必要な更新プログラムは、累積的な更新プログラム10.0.39 (PU63) に含まれています
財務と運用アプリ管理者に連絡し、最新バージョンの更新を環境に適用してください。
FnO-812: 財務と運用環境で追加のインデックスを作成する必要があります。 財務と運用アプリ環境でテーブルを選択すると、システムはデータベースに追加のインデックスを作成し、データの初期化と更新を効率的に実行できるようにします。 このエラーは、テーブルのインデックスが足りないことを示します。 これにはいくつかの理由が考えられます。

クラウド ホスト環境 (CHE) からこのエラーを受信した場合は、ドキュメントに記載されているように、特定のフライトとインデックスを有効にする必要があります。

サンドボックスまたは運用環境でこのエラーが発生した場合は、データベース操作の規模が大きすぎるためインデックスの作成が遅れている可能性があります。
CHE 環境の場合は、環境の所有者に問い合わせてください。

サンドボックスまたは運用環境の場合は、アクションは必要はありません。 システムにより、財務と運用におけるピーク ワークロードの完了に関するインデックスが有効になります。
FnO-813: フィールド <...> に予期しない NULL 値があります。 テーブル内のデータを確認し、必要に応じて値を修正します。 このエラーは、財務と運用アプリからデータを転送するときにサービスによって検出されたデータの問題の結果です。 財務と運用サービスでは、データ フィールドに NULL 値を許可しません。 したがって、NULL 値はサービスでは予期されません。 スペース文字は、財務と運用アプリで値が存在しないことを表します。 ただし、特に外部ツールを使用したデータ移行中に、データ フィールドに NULL 値が入力される可能性があります。 財務と運用アプリのユーザー インターフェイスを使用するか、ツールを使用してテーブルを調べ、問題を解決できます。

データの問題が解決されると、システムは再開されます。 テーブルを再初期化する必要はありません。
次のアプリはテナントに存在しませんでした:...: Azure Synapse Link は、プロファイルを作成するために必要なすべてのアプリのアクセス許可を取得できません。 アプリ ID が欠落していることが UI エラー メッセージに表示されました。 必要なアプリ権限の完全なリストは次のとおりです。
  • データ レイクへのエクスポート: 7f15f9d9-cad0-44f1-bbba-d36650e07765
  • Common Data Service - Azure Data Lake Storage:546068c3-99b1-4890-8e93-c8aeadcfe56a
  • Insights Apps Platform Prod: 99ff962b-6252-4b98-8478-0c65a3ea1925
次の手順に従って、管理者に Azure テナントに不足しているアクセス許可を追加するよう依頼してください:
  • PowerShell を開き、次のコマンドを使用して認証されたアカウントで Azure に接続します: Connect-AzAccount
  • アプリ ID に対して次のコマンドを実行して、プリンシパルを追加します: New-AzADServicePrincipal -ApplicationId ‘7f15f9d9-cad0-44f1-bbba-d36650e07765’