PowerShell を使用した Synapse Studio 接続のトラブルシューティング
Azure Synapse Studio の正常な動作は、一連の Web API エンドポイントに依存しています。 このガイドは、次のときに接続の問題の原因を特定するのに役立ちます。
- Azure Synapse Studio にアクセスするためのローカル ネットワーク (企業のファイアウォールの内側にあるネットワークなど) を構成しようとしている。
- Azure Synapse Studio を使用した接続の問題が発生している。
前提条件
- PowerShell 5.0 以降のバージョン (Windows の場合)、または
- PowerShell Core 6.0 以降のバージョン (Windows の場合)。
トラブルシューティングの手順
リンクを開き、開いたスクリプト ファイルを保存します。 今後変更される可能性があるため、リンクのアドレスは保存しないでください。
エクスプローラーで、ダウンロードしたスクリプト ファイルを右クリックし、[PowerShell で実行] を選択します。
プロンプトが表示されたら、現在問題が発生している、または接続をテストする Azure Synapse ワークスペースの名前を入力し、Enter キーを押します。
診断セッションが開始されます。 完了するまで待ちます。
最後に、診断の概要が表示されます。 PC から 1 つ以上のエンドポイントに接続できない場合は、[Summary] セクションにいくつかの提案が表示されます。
さらに、このセッションの診断ログ ファイルが、トラブルシューティング スクリプトと同じフォルダーに生成されます。 その場所は、"General tips" (一般的なヒント) セクション (D:\TestAzureSynapse_2020....log
) に示されています。 必要に応じて、このファイルをサポート チームに送信できます。
ネットワーク管理者が Azure Synapse Studio のファイアウォール構成を調整している場合は、[Summary] セクションの上に表示されている技術的な詳細が役に立つことがあります。
- "Passed" (成功) とマークされたすべてのテスト項目 (要求) は、HTTP 状態コードに関係なく、接続テストに合格したことを意味します。
失敗した要求については、
NamedResolutionFailure
やConnectFailure
などの理由が黄色で表示されます。 これらの理由は、ネットワーク環境に誤った構成があるかどうかを判断するのに役立ちます。
次のステップ
前の手順で問題が解決しない場合は、サポート チケットを作成してください。