SharePoint Online リスト
まとめ
| Item | 説明 |
|---|---|
| リリース状態 | 一般公開 |
| 製品 | Power BI (データセット) Power BI (データフロー) Power Apps (データフロー) Excel Dynamics 365 Customer Insights |
| サポートされている認証の種類 | Anonymous Windows Microsoft アカウント |
| 関数リファレンス ドキュメント | SharePoint.Contents SharePoint.Files SharePoint.Tables |
注意
一部の機能については、ある製品には含まれるが、デプロイ スケジュールやホスト固有の機能であることが理由で他の製品には含まれない場合があります。
サポートされる機能
- サイトの URL
サイトの URL を確認する
SharePoint サイトへの接続時には、そのサイト URL を入力するように求められます。 ご利用の SharePoint Online リストを含むサイト URL を見つけるには、最初に SharePoint でページを開きます。 SharePoint のページから、該当するサイト アドレスを取得するには、通常、ナビゲーション ペイン内の [ホーム] を選択するか、または上部にあるサイトのアイコンを選択します。 ご利用の Web ブラウザーのアドレス バーからアドレスをコピーし、後で使用するために保存します。
![ナビゲーション ペイン内の [ホーム] の場所、サイトの上部にあるアイコン、結果として表示される URL アドレスを示す図。](media/sharepoint-list/sharepoint-address.png)
Power Query Desktop から SharePoint Online リストに接続する
SharePoint Online リストに接続するには、次のようにします。
[データを取得] で [SharePoint Online リスト] を選択します。
「サイトの URL を確認する」でコピーした SharePoint サイト URL を、開いているダイアログ ボックス内の [サイトの URL] フィールドに貼り付けます。

入力した URL アドレスが無効である場合は、
が表示されます。 警告アイコンは [サイトの URL] テキスト ボックスの横に表示されます。また、このコネクタの実装 1.0 またはベータ実装 2.0 のいずれでも選択することができます。 詳細については、「SharePoint Online リスト v2.0 (ベータ) に接続する」を参照してください。
[OK] を選択して続行します。
今回初めてこのサイト アドレスにアクセスした場合は、適切な認証方法を選択します。 自分の資格情報を入力し、これらの設定の適用先とするレベルを選択します。 次に、 [接続](Connect) を選択します。

認証の方法およびレベル設定の詳細については、「データ ソースを使用した認証」を参照してください。
ナビゲーター で場所を選択すると、Power Query エディターで [データの変換] を選択してデータを変換することも、 [読み込み] を選択してデータを読み込むこともできます。

Power Query Online から SharePoint Online リストに接続する
SharePoint Online リストに接続するには、次のようにします。
[データ ソース] ページで、 [SharePoint Online リスト] を選択します。
「サイトの URL を確認する」でコピーした SharePoint サイト URL を、開いているダイアログ ボックス内の [サイトの URL] フィールドに貼り付けます。

必要に応じて、オンプレミス データ ゲートウェイの名前を入力します。
認証の種類を選択し、必要とされる資格情報を入力します。
[次へ] を選択します。
ナビゲーター で場所を選択すると、Power Query エディターで [データの変換] を選択してデータを変換することができます。

SharePoint Online リスト v2.0 (ベータ) に接続する
Power BI Desktop の 2020 年 10 月のリリースで、Microsoft は SharePoint Online リスト コネクタの更新済みバージョンを導入しました。 このコネクタは、API が改良され、使いやすさが向上していますが、1.0 コネクタ バージョンと使用上の下位互換性がありません。
それにアクセスするには、「Power Query Desktop から SharePoint Online リストに接続する」の手順 2 で同じコネクタ画面にアクセスします。 ただし、 [実装] で [2.0 (ベータ)] がまだ選択されていない場合は、それを確実に選択してください。

この更新プログラムをコネクタに適用すると、同じデータに対して 2 種類のビューが使用できるようになります。
- すべて
- [Default]
[すべて] ビューには、ユーザーが作成した列とシステムによって定義されている列のすべてが含まれます。 どのような列が含まれているかを、次の画面で確認できます。

既定のビューとは、ご利用の設定で 既定値 として設定されているビューでリストをオンラインで見たときに表示される内容です。 このビューを編集してユーザー作成の列またはシステム定義の列を追加または削除する場合、あるいは新しいビューを作成し、それを既定値として設定する場合、それらの変更はコネクタを介して反映されます。
トラブルシューティング
SharePoint のルート アドレスを使用する
サブフォルダーまたはドキュメントを含めずに、SharePoint サイトのルート アドレスを指定していることを確認します。 たとえば、https://contoso.sharepoint.com/teams/ObjectModel/ のようなリンクを使用します。
タイムゾーンの問題
SharePoint Online リスト (v1.0) コネクタを使用している場合、タイムゾーン データはお客様がブラウザーに期待するものと一致しない場合があるので注意してください。 SharePoint Web ベースのクライアントでは、ユーザーのタイムゾーンに関するブラウザーの知識に基づいて、ローカル タイムゾーン変換を実行します。
SharePoint 用のバックエンド API では、UTC 時刻を使用し、この UTC 時刻を Power BI に直接送信します。 Power BI によって、この UTC 時刻は変換されませんが、ユーザーには報告されます。
時刻をローカル時刻にするには、ユーザー側で SharePoint クライアントと同じ変換を行う必要があります。 これを行う列操作の例を次に示します。
#"Changed Type" = Table.TransformColumnTypes(#"Renamed Columns",{{"Datewithtime", type datetimezone}}),
#"Timezone Shifted" = Table.TransformColumns(#"Changed Type", {"Datewithtime", DateTimeZone.ToLocal})
最初の操作で、型を datetimezone に変更し、2 番目の操作でそれをコンピューターのローカル時刻に変換します。
SharePoint の結合に関する制限
この問題は、SharePoint Online リスト v2.0 コネクタに限定されています
SharePoint Online リスト v2.0 コネクタでは、v1.0 コネクタとは異なる API が使用されます。そのため、クエリごとの結合操作は最大で 12 回となっています。詳細については、SharePoint Online のドキュメントの リスト ビューの検索しきい値 に関するページを参照してください。 この問題は、SharePoint リストから 12 を超える列が同時にアクセスされると、SharePoint クエリが失敗するので、明らかになります。
OData を使用して SharePoint Online リストにアクセスする
OData フィードを使用して SharePoint Online リストにアクセスする場合、接続に使用する URL には約 2100 文字の制限があります。 詳細については、「URL の最大長」を参照してください。