Web

まとめ

項目 説明
リリース状態 一般提供
製品 Excel
Power BI (セマンティック モデル)
Power BI (データフロー)
Fabric (Dataflow Gen2)
Power Apps (データフロー)
Dynamics 365 Customer Insights
サポートされている認証の種類 Web.Contents:
匿名
Windows
Basic
Web API
組織アカウント
サービス プリンシパル

Web.BrowserContents:
匿名
Windows
Basic
Web API

Web.Page:
匿名
Windows (現在のユーザーの資格情報のみ)
Web API
関数リファレンス ドキュメント Web.Contents
Web.BrowserContents
Web.Page

注

オンプレミス データ ゲートウェイまたは仮想ネットワーク (VNet) データ ゲートウェイを使用する際には、サービス プリンシパル認証のタイプはサポートされません。

注

Web.Contents を使用している場合、POST 要求は匿名でのみ実行できます。

注

一部の機能は 1 つの製品に存在する可能性がありますが、展開スケジュールとホスト固有の機能のため、他の製品には存在しない場合があります。

前提条件

  • Web.PageにはInternet Explorer 10 が必要です。
  • Web.BrowserContents にはMicrosoft Edgeの WebView2 ランタイムが必要です。

サポートされている機能

  • URLに接続する
  • 詳細設定
    • テキスト定数とパラメータの組み合わせを使用して URL を構築する
    • コマンド タイムアウトの指定
    • HTTP リクエスト ヘッダー パラメーターの定義 (Web.Contents のみ)

Power Query Desktop を使用して Web データを読み込む

Power Query Desktop を使用して Web サイトからデータを読み込むには:

  1. Power BI で Get Data > Web を選択するか、Excel の データ リボンで From Web を選択します。 詳細については、「データを取得する場所」を参照してください。

  2. [基本] ボタンを選び、テキスト ボックスに URL アドレスを入力します。 たとえば、「https://en.wikipedia.org/wiki/List_of_states_and_territories_of_the_United_States」を入力します。 [OK] をクリックします。

    Web サイトの URL を入力する接続ダイアログのスクリーンショット。

    入力した URL アドレスが無効な場合は、URL テキスト ボックスの横に警告アイコンが表示されます。

    Web サイトに接続する前に、より高度な URL を作成する必要がある場合は、「高度な URL を使用して Web データを読み込む」に移動します。

  3. この Web サイトに初めて接続する場合は、この Web サイトに使用する認証方法を選択します。 この例では、[匿名] を選択します。 次に、これらの設定を適用するレベルを選択します (この場合は https://en.wikipedia.org/)。 次に、 [接続](Connect) を選択します。

    Web 資格情報を選択する認証ダイアログのスクリーンショット。

    このコネクタで使用できる認証方法は次のとおりです。

    • [匿名]: Web ページに資格情報が必要ない場合は、この認証方法を選択します。

    • Windows: Web ページにWindows資格情報が必要な場合は、この認証方法を選択します。

    • [基本]: Web ページに基本的なユーザー名とパスワードが必要な場合は、この認証方法を選択します。

    • Web API: 接続している Web リソースが認証目的で API キーを使用する場合は、この方法を選択します。

    • [組織アカウント]: Web ページに組織アカウントの資格情報が必要な場合は、この認証方法を選択します。

    認証方法に対して選択するレベルによって、URL のどの部分に認証方法が適用されるかが決まります。 最上位の Web アドレスを選択した場合は、ここで選択した認証方法が、その URL アドレスまたはそのアドレス内のサブアドレスに使用されます。 ただし、サブアドレスごとに異なる認証方法が必要になる可能性があるため、最上位の URL アドレスを特定の認証方法に設定しないほうがよい場合があります。 たとえば、1 つのSharePoint サイトの 2 つの個別のフォルダーにアクセスしていて、それぞれ異なるMicrosoft アカウントを使用してアクセスする場合などです。

    特定の Web サイト アドレスの認証方法を設定したら、その URL アドレスまたはサブアドレスの認証方法を再度選択する必要はありません。 たとえば、このダイアログで https://en.wikipedia.org/ アドレスを選択した場合、このアドレスで始まる Web ページでは、認証方法をもう一度選択する必要はありません。

    注

    後で認証方法を変更する必要がある場合は、「認証方法の変更」に移動します。

  4. Navigator ダイアログでテーブルを選択し、Transform Data を選択してPower Query エディターでデータを変換するか、Load を選択してデータを読み込むことができます。

    アメリカ合衆国の州が選択されたナビゲーターのスクリーンショット。

    [ナビゲーター] ダイアログの右側には、テーブルのコンテンツが表示されます。それらを選択して変換や読み込みを行うことができます。 関心のあるデータが含まれているテーブルがわからない場合は、[ Web ビュー ] タブを選択できます。Web ビューを使用すると、Web ページのコンテンツ全体を表示でき、そのサイトで検出された各テーブルが強調表示されます。 強調表示されているテーブルの上にあるチェック ボックスをオンにすると、そのテーブルからデータを取得できます。

    [ナビゲーター] ダイアログの左下にある [例を使用してテーブルを追加] ボタンを選択することもできます。 この選択により、Web ページのコンテンツをプレビューし、抽出するデータのサンプル値を入力できる、対話型ウィンドウが表示されます。 この機能の使用について詳しくは、「例を提供して Web ページ データを取得する」をご覧ください。

Power Query Online を使用して Web データを読み込む

Power Query Online を使用して Web サイトからデータを読み込むには:

  1. [ データの取得 ] ページで、 Web ページ または Web API を選択します。 詳細については、「データを取得する場所」を参照してください。

    Web ページまたは Web API コネクタを選択する [データの取得] ページのスクリーンショット。

    ほとんどの場合、Web ページ コネクタを選択します。 セキュリティ上の理由から、このコネクタで オンプレミス データ ゲートウェイを使用する 必要があります。 Web ページ コネクタにはゲートウェイが必要です。HTML ページはブラウザー コントロールを使用して取得され、セキュリティ上の問題が発生する可能性があるためです。 Web API コネクタではブラウザー コントロールを使用しないので、この懸念はありません。

    場合によっては、API または Web に格納されているファイルを指し示す URL を使用したほうがよい場合があります。 このようなシナリオでは、Web API コネクタ (またはファイル固有のコネクタ) を使用すると、オンプレミスのデータ ゲートウェイを使用せずに前進できます。

    また、URL がファイルを指し示す場合は、Web ページ コネクタではなく、特定のファイル コネクタを使用してください。

  2. テキスト ボックスに URL アドレスを入力します。 この例では、https://en.wikipedia.org/wiki/List_of_states_and_territories_of_the_United_States を入力します。

    Web ページの URL を入力するオンライン サインイン ページの上半分のスクリーンショット。

  3. オンプレミス データ ゲートウェイの名前を選択します。

    オンプレミス データ ゲートウェイを入力するオンライン サインイン ページの上半分のスクリーンショット。

  4. Web ページへの接続に使用する認証方法を選択します。

    適切な認証方法を選択する認証ダイアログのスクリーンショット。

    このコネクタで使用できる認証方法は次のとおりです。

    • [匿名]: Web ページに資格情報が必要ない場合は、この認証方法を選択します。

    • Windows: Web ページにWindows資格情報が必要な場合は、この認証方法を選択します。

    • [基本]: Web ページに基本的なユーザー名とパスワードが必要な場合は、この認証方法を選択します。

    • [組織アカウント]: Web ページに組織アカウントの資格情報が必要な場合は、この認証方法を選択します。

    • サービス プリンシパル: Web ページにテナント ID、サービス プリンシパル クライアント ID、およびサービス プリンシパル キーが必要な場合は、この認証方法を選択します。

    認証方法を選択し、必要な資格情報を入力したら、[ 次へ] を選択します。

  5. Navigator ダイアログで、テーブルを選択し、Power Query エディターで Transform Data を選択してデータを変換できます。

    Web ページの状態を示す [ナビゲーター] ダイアログのスクリーンショット。

高度な URL を使用して Web データを読み込む

Power Query Desktop で Get Data>From Web を選択すると、ほとんどの場合、[基本設定] に URL を入力します。 ただし、場合によっては、別の部分から URL を組み立てたり、接続のタイムアウトを設定したり、個別の URL ヘッダー データを指定したりできます。 この場合は、[Web から] ダイアログ ボックスで [高度] オプションを選択します。

[Web 高度な URL アセンブリ] オプションが選択されている [Web 接続] ページのスクリーンショット。

ダイアログの [URL パーツ] セクションを使用して、データの取得に使用する URL を組み立てます。 [URL パーツ] セクションの URL の最初の部分は通常、その URI のスキーム、権限、パス (http://contoso.com/products/ など) で構成されます。 2 つ目のテキスト ボックスには、Web サイトに提供された情報をフィルター処理するために使用するクエリやフラグメントを含めることができます。 複数のパーツを追加する必要がある場合は、[パーツの追加] を選択して別の URL フラグメント テキスト ボックスを追加します。 URL の各部分を入力すると、[ OK] を 選択したときに使用される完全な URL が URL プレビュー ボックスに表示されます。

POST 要求がデータを処理するのにかかる時間によっては、要求が Web サイトに接続され続ける時間を長くすることが必要になる場合があります。 POST と GET の両方の既定のタイムアウトは 100 秒です。 このタイムアウトが短すぎる場合は、オプションの コマンド タイムアウトを分単位で 使用して、接続を維持する時間 (分) を延長できます。

オプションの HTTP 要求ヘッダー パラメータードロップダウン リスト ボックスを使用して、Web サイトに送信する POST に特定の 要求ヘッダー を追加することもできます。 選択できる要求ヘッダーの説明を次の表に示します。

要求ヘッダー 説明
同意する 受け入れ可能な応答メディアの種類を指定します。
Accept-Charset テキスト形式の応答コンテンツで受け入れ可能な文字セットを示します。
Accept-Encoding 応答で受け入れ可能な応答コンテンツのエンコードを示します。
Accept-Language 応答で優先される自然言語のセットを示します。
キャッシュ-コントロール クライアント要求とサーバー応答で、ディレクティブによって指定されるキャッシュ ポリシーを示します。
コンテンツタイプ コンテンツのメディアの種類を示します。
If-Modified-Since このフィールドで指定した日付以降に Web コンテンツが変更されたかどうかを条件付きで判断します。 コンテンツが変更されなかった場合、サーバーは 304 状態コードを持つヘッダーのみで応答します。 コンテンツが変更された場合、サーバーは要求されたリソースと状態コード 200 を返します。
Prefer 特定のサーバーの動作がクライアントで望まれるが、要求を正常に完了するためには必須ではないことを示します。
Range 選択された表現データの 1 つまたは複数の部分範囲を指定します。
参照元 (リファラー) ターゲット URI が取得されたリソースの URI 参照を指定します。

Web からファイルをインポートする

通常、Power Query Desktop にローカルのオンプレミス ファイルをインポートする場合は、特定のファイルの種類のコネクタを使用してそのファイルをインポートします。たとえば、JSON コネクタを使用して JSON ファイルをインポートするか、CSV コネクタを使用して CSV ファイルをインポートします。 ただし、Power Query Desktop を使用していて、インポートするファイルが Web 上にある場合は、Web コネクタを使用してそのファイルをインポートする必要があります。 ローカルの場合と同様に、コネクタが既定で読み込むテーブルが表示されます。これにより、読み込みまたは変換を実行できます。

Web コネクタでは、次のファイルの種類がサポートされています。

たとえば、次の手順を使用して、https://contoso.com/products の Web サイトに JSON ファイルをインポートできます。

  1. [データの取得] ダイアログ ボックスで、Web コネクタを選択します。

  2. [基本] ボタンを選択し、次のように [URL] ボックスにアドレスを入力します。

    http://contoso.com/products/Example_JSON.json

    Web からインポートする JSON ファイルを含む [Web 接続] ダイアログのスクリーンショット。

  3. [OK] を選択します。

  4. この URL に初めてアクセスする場合は、認証の種類として [匿名 ] を選択し、[ 接続] を選択します。

  5. Power Query エディターが開き、JSON ファイルからインポートされたデータが表示されます。 まだオンでない場合は、Power Query エディターで View タブを選択し、Formula Bar を選択してエディターの数式バーをオンにします。

    数式バーが開いた状態で強調されたPower Queryエディターのスクリーンショット

    ここで示すように、Web コネクタは指定した URL から Web コンテンツを返し、URL で指定された適切なドキュメントの種類 (この例ではJson.Document ) で Web コンテンツを自動的にラップします。

関連コンテンツ

  • Last updated on