PowerShell を使用した Synapse Studio 接続のトラブルシューティング

  • [アーティクル]

Azure Synapse Studio の正常な動作は、一連の Web API エンドポイントに依存しています。 このガイドは、次のときに接続の問題の原因を特定するのに役立ちます。

  • Azure Synapse Studio にアクセスするためのローカル ネットワーク (企業のファイアウォールの内側にあるネットワークなど) を構成しようとしている。
  • Azure Synapse Studio を使用した接続の問題が発生している。

前提条件

  • PowerShell 5.0 以降のバージョン (Windows の場合)、または
  • PowerShell Core 6.0 以降のバージョン (Windows の場合)。

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

次のリンクを右クリックし、[対象をファイルに保存] を選択します。

別の方法として、リンクを直接開いて、開いたスクリプト ファイルを保存することもできます。 今後変更される可能性があるため、リンクのアドレスは保存しないでください。

エクスプローラーで、ダウンロードしたスクリプト ファイルを右クリックし、[PowerShell で実行] を選択します。

ダウンロードしたスクリプト ファイルを PowerShell で実行する

プロンプトが表示されたら、現在問題が発生している、または接続をテストする Azure Synapse ワークスペースの名前を入力し、Enter キーを押します。

ワークスペース名を入力する

診断セッションが開始されます。 完了するまで待ちます。

診断の完了を待機する

最後に、診断の概要が表示されます。 PC から 1 つ以上のエンドポイントに接続できない場合は、[Summary] セクションにいくつかの提案が表示されます。

診断ログを確認する

さらに、このセッションの診断ログ ファイルが、トラブルシューティング スクリプトと同じフォルダーに生成されます。 その場所は、"General tips" (一般的なヒント) セクション (D:\TestAzureSynapse_2020....log) に示されています。 必要に応じて、このファイルをサポート チームに送信できます。

ネットワーク管理者が Azure Synapse Studio のファイアウォール構成を調整している場合は、[Summary] セクションの上に表示されている技術的な詳細が役に立つことがあります。

  • "Passed" (成功) とマークされたすべてのテスト項目 (要求) は、HTTP 状態コードに関係なく、接続テストに合格したことを意味します。 失敗した要求については、NamedResolutionFailure や ConnectFailure などの理由が黄色で表示されます。 これらの理由は、ネットワーク環境に誤った構成があるかどうかを判断するのに役立ちます。

次のステップ

前の手順で問題が解決しない場合は、サポート チケットを作成してください。