Power Apps CLI pa app add data-source コマンドが失敗した場合のデータ ソースの追加に関するトラブルシューティングを行います。 構成、認証、またはネットワークの問題を特定し、データ ソースを正常に追加するには、次の手順に従います。
現象
通常、エラーは、コンピューターまたはネットワーク上の何かが接続をブロックしているか、認証を中断しているために発生します。
| 現象 | メッセージ例: |
|---|---|
| フェッチに失敗しました |
Fetch Failed (追加スタックなし) |
| タイムアウトまたはネットワーク エラー |
ETIMEDOUT、 ENOTFOUND、または ECONNRESET |
| 環境の不一致 | データ ソースが見つからないか、スキーマが想定外です |
必要条件
最新のPower Apps CLI がインストールされていることを確認します。 不明な場合は更新してください。
pa auth loginを使用してサインインし、pa auth statusしてアクティブなアカウントを確認します。pa auth login pa auth statusネットワークで Power Platform エンドポイントへの送信 HTTPS 呼び出しが許可されていることを確認します。
データ ソース エラーのトラブルシューティング手順
根本原因を診断するには、次の手順に従います。
手順 1: 構成を検証する
power.config.json ファイルを開き、次の手順を確認します。
-
environmentIdは、対象とする環境と一致します。 -
regionは、別のリージョンをターゲットにする場合を除き、prodに設定されます。 不足している場合は追加します。
手順 2: 環境コンテキストをクロスチェックする
pa auth statusを使用して、正しいアカウントがアクティブであることを確認します。
pa auth status
power.config.jsonのenvironmentIdと、Power Apps環境 URL に表示されている環境 ID を比較します。
サンプルの power.config.json スニペット:
{
"environmentId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"region": "prod"
}
手順 3: コマンドを再実行する
pa app add data-source をもう一度実行します。 例:
pa app add data-source --connector dataverse --table account
出力で HTTP 状態コードまたはエラー メッセージを探します。
手順 4: ネットワークとセキュリティの検証
それでもコマンドが失敗する場合:
- 企業プロキシまたはファイアウォールが CLI プロセスまたはその他の非ブラウザー トラフィックをブロックされていないことを確認します。
- 必要な Power Platform エンドポイントを承認します。 Power Platform の接続要件を参照してください。
ブラウザーの接続を確認する
この手順は、ユーザー アカウントに適切なアクセス許可があること、およびデータ ソースにコンピューターから到達可能であることを確認するのに役立ちます。
- Power Apps CLI を使用しているのと同じコンピューターで Web ブラウザーを開きます。
- SharePoint サイトや Dataverse 環境 URL など、追加しようとしているデータ ソースに直接移動します。
-
pa auth statusに表示されているのと同じアカウントでサインインします。 - リソースにアクセスできない場合は、ユーザー アカウントのアクセス許可の問題が原因である可能性があります。
- アクセスできる場合は、 ネットワーク トラフィックの分析に進みます。
ネットワーク トラフィックの分析
ネットワーク監視ツールを使用して、Power Apps CLI とデータ ソース エンドポイント間の通信を検査します。
Fiddler クラシックをダウンロードしてインストールします。
Fiddler を起動し、トラフィックがキャプチャされていることを確認します。 ファイル>キャプチャ トラフィックに移動します。
コマンド プロンプトで、失敗した
pa app add data-sourceコマンドを実行します。Fiddler セッションの一覧で、
yourorg.crm.dynamics.comやyourtenant.sharepoint.comなど、データ ソース エンドポイントに対して行われた要求を探します。応答を分析します。
-
200状態コードは成功を示します。 -
401(未承認) または403(禁止) 状態コードは、認証またはアクセス許可の問題を指しています。 - その他のエラー コードや完全な応答がない場合は、ファイアウォールまたはプロキシが要求をブロックしていることを示している可能性があります。
-
手順 5: 認証コンテキストをクリアまたはリセットする
間違ったアカウントがアクティブな場合は、 pa auth switchを使用します。
pa auth switch
アカウントが一覧にない場合は、 pa auth loginを使用します。
pa auth login
保存されているすべての認証情報をクリアしてもう一度サインインするには、 pa auth logoutを使用してから、 pa auth loginを使用します。
pa auth logout
pa auth login
エスカレーション データ
テクニカル サポートに連絡して問題を提出する前に、次の情報を入力してください。
-
pa --versionからの CLI バージョン - Windows コマンド プロンプト、PowerShell、WSL などのオペレーティング システムとシェル
- 利用されるコマンドの完全な形
- サニタイズされたデバッグ出力
-
power.config.json機密情報をマスキングした後