SharePoint の新しいビュー：Sites、AllLists、AllFiles

CData SharePoint ドライバーおよびコネクタのバージョン 24.0.9190 以降、REST スキーマに以下の新しいビューが追加されました。

• Sites: 新しい Sites ビューは、SharePoint ドメイン全体のすべてのサイトを取得します。
• AllLists: ドメイン内のすべての SharePoint サイトおよびサブサイトからリストを取得します。
• AllFiles: ドメイン内のすべての SharePoint サイトおよびサブサイトの全ライブラリからファイルとフォルダを取得します。

CData SharePoint ドライバーのこの機能は 2025年3月のドライバーリリースで追加され、SharePoint ドメイン内のすべてのサイトからファイル情報を取得できるようになりました。以前の CData SharePoint ドライバーでは、URL 接続プロパティで指定した SharePoint サイトのデータにのみアクセスできました。サブサイトや SharePoint ドメイン内の他のサイトのデータにアクセスするには、それらのサイトからファイル情報にアクセスする際に各サイトへの接続を個別に設定する必要がありました。新しく追加されたビューにより、単一の接続設定ですべてのサイトからファイル情報を取得できるようになりました。

この記事では、これらの新しく公開されたビューへのクエリ例を紹介し、カラムとそのデータ型を含むデータモデルについて説明します。

実装例

すべてのサイトからファイル情報を取得

SharePoint ドメイン内のすべてのサイトから全ファイルのファイル情報を取得するには、AllFiles ビューにクエリを実行します。以下のクエリは、SharePoint ドメイン内のすべてのファイルのファイル情報を返します。

SELECT * FROM AllFiles

結果:

特定のサイトからファイル情報を取得

特定のサイトからすべてのファイル情報を取得するには、SQL ステートメントの WHERE 句に SiteURL を指定します。サイト URL を取得する方法の1つは、Sites ビューにクエリを実行することです。以下のクエリは、すべてのサイトのサイト名、サイト URL、サイトの説明を返します。

SELECT Title, SiteURL, Description FROM Sites

結果:

ファイル情報を取得したいサイトの SiteURL を取得したら、その サイト URL を WHERE 句に含めます。例えば、以下のクエリは 'https://cdata0.sharepoint.com/sites/product' サイトのファイル情報のみを取得します。

SELECT * FROM AllFiles WHERE SiteURL = 'https://cdata0.sharepoint.com/sites/product'

結果:

特定のサイト内の特定のライブラリからファイル情報を取得

サイト内の特定のライブラリからすべてのファイル情報を取得するには、SQL ステートメントの WHERE 句に LibraryId を追加します。ライブラリの Id は AllLists ビューにクエリを実行して取得できます。AllLists ビューは、ライブラリを含むすべてのリストに関する情報を取得します。以下のクエリは、'https://cdata0.sharepoint.com/sites/product' サイト内のライブラリを含むリスト情報を返します。

SELECT Id, Title FROM AllLists WHERE SiteURL = 'https://cdata0.sharepoint.com/sites/product'

結果:

ファイル情報を取得したいライブラリの LibraryId を取得したら、その Id を WHERE 句に含めます。例えば、以下のクエリは指定した LibraryId を持つライブラリのファイル情報のみを取得します。

SELECT * FROM AllFiles WHERE SiteURL = 'https://cdata0.sharepoint.com/sites/product' AND LibraryId = '1342af2b-897b-4e84-91e4-717be4622dfd'

結果:

注意: 上記の例の一部の結果は、読みやすさのために省略および再フォーマットされています。実際のクエリ結果はより大きくなりますが、例では行とカラムの代表的なサブセットのみを表示しています。

データモデル

Sites

AllLists

AllFiles