次の方法で共有

データ ソースの追加に関するトラブルシューティング (プレビュー)

この記事では、PAC CLI (Power Apps コマンド ライン インターフェイス) pac コード add-data-source コマンドが失敗した場合のトラブルシューティング手順について説明します。

症状

通常、エラーは、コンピューターまたはネットワーク上の何かが接続をブロックしているか、認証を中断しているために発生します。

症状 メッセージの例
フェッチに失敗しました Fetch Failed (追加スタックなし)
タイムアウト/ネットワーク エラー ETIMEDOUT、 ENOTFOUND、 ECONNRESET
環境の不一致 データ ソースが見つからない/予期しないスキーマ

[前提条件]

  1. 最新の Power Platform CLI がインストールされていることを確認します。 不明な場合は更新してください。
  2. 正しい環境に対して認証されていることを確認します。 pac auth createコマンドとpac auth listコマンドを使用します。
  3. ネットワークで Power Platform エンドポイントへの送信 HTTPS 呼び出しが許可されていることを確認します。

トラブルシューティングの手順

根本原因を診断するには、次の手順に従います。

手順 1: 構成を検証する

ファイル power.config.json 開き、次の内容を確認します。

  • environmentId は、ターゲットにする環境と一致します。
  • region は、別のリージョンを意図的にターゲットにしない限り、 prodに設定されます。 ない場合は追加します。

手順 2: 環境コンテキストをクロスチェックする

pac env who コマンドを実行します。

出力のEnvironment IDを、environmentIdのpower.config.json値と比較します。

出力例 (注釈付き):

Connected as user@domain.com
Organization Information
  Org ID:                     00aa00aa-bb11-cc22-dd33-44ee44ee44ee
  Unique Name:                unq2889ab2be728ef118406000d3a33f
  Friendly Name:              User Name
  Org URL:                    https://myorg.crm.dynamics.com/
  User Email:                 user@domain.com
  User ID:                    aaaaaaaa-bbbb-cccc-1111-222222222222
  Environment ID:             aaaabbbb-0000-cccc-1111-dddd2222eeee  <-- Ensure this matches

対応する power.config.json スニペットの例:

{
  "environmentId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "region": "prod"
}

手順 3: コマンドを再実行する

pac code add-data-source コマンドをもう一度実行します。 例えば次が挙げられます。

pac code add-data-source -a dataverse -t account

出力で HTTP 状態コードまたはエラー メッセージを探します。

手順 4: ネットワークとセキュリティの検証

それでも失敗する場合:

  • 会社のプロキシまたはファイアウォールで CLI プロセスがブロックされていないことを確認します (ブラウザー以外のトラフィック)。
  • 必要な Power Platform エンドポイントを承認します。 Power Platform の接続要件を確認する

ブラウザーの接続を確認する

この手順は、ユーザー アカウントに適切なアクセス許可があること、およびデータ ソースにコンピューターから到達可能であることを確認するのに役立ちます。

  1. PAC CLI を使用しているのと同じコンピューターで Web ブラウザーを開きます。
  2. 追加しようとしているデータ ソースに直接移動します。 たとえば、SharePoint サイトや Dataverse 環境の URL などです。
  3. PAC CLI pac auth create コマンドによる認証に使用したのと同じ資格情報でサインインします
  4. リソースにアクセスできない場合は、ユーザー アカウントのアクセス許可の問題が原因である可能性があります。
  5. アクセスできる場合は、[ ネットワーク トラフィックの分析] に移動します。

ネットワーク トラフィックの分析

これは、PAC CLI とデータ ソース エンドポイントの間の生のネットワーク通信データを表示する最も効果的な方法です。

  1. Fiddler クラシックをダウンロードしてインストールします。 Fiddler は、ネットワーク トラフィックを監視するためのツールです。

  2. Fiddler を起動し、トラフィックをキャプチャしていることを確認します。 ファイル>キャプチャ トラフィックに移動します。

  3. コマンド プロンプトで、失敗した pac code add-data-source コマンドを実行します。

  4. Fiddler セッションの一覧で、データ ソース エンドポイントに対して行われた要求を探します。 たとえば、yourorg.crm.dynamics.com や yourtenant.sharepoint.com などです。

  5. 応答情報を分析します。

    • 200状態コードは成功を示します。
    • 401 (未承認) または403 (禁止) 状態コードは、認証またはアクセス許可の問題を指しています。
    • その他のエラー コードや完全な応答がない場合は、ファイアウォールまたはプロキシが要求をブロックしていることを示している可能性があります。

手順 5: 認証コンテキストのクリア/リセット

不一致が検出された場合は、次の PAC CLI コマンドを使用して認証コンテキストをクリアまたはリセットする必要があります。

pac auth list
pac auth select --index <n>
pac env who

正しくない場合は、再認証します。

pac auth create --environment <yourEnvironmentId>

エスカレーション データ

テクニカル サポートに連絡して問題を提出する前に、次のデータを収集してください。

入力内容:

  • CLIのバージョン pac --version コマンドを使用する
  • OS とシェル (Windows cmd/PowerShell/WSL)
  • 利用されるコマンドの完全な形
  • サニタイズされたデバッグ出力の抜粋
  • power.config.json シークレットを編集した後
  • Last updated on