Excel Add-In for Microsoft Office 365

Build 26.0.9770

SearchDriveItems

Microsoft Search APIを使用してキーワードでOneDriveおよびSharePointのファイルを検索します。一致するファイルごとにメタデータと検索抜粋を含む1行を返します。

ストアドプロシージャ固有の情報

Select

このストアドプロシージャは、Microsoft Search APIを使用してOneDriveおよびSharePointのファイルコンテンツ全体に対して全文検索を実行します。コネクタに設定されているFiles.ReadWrite.All権限で、このプロシージャを使用するには十分です。

KeywordパラメータはKQL(キーワードクエリ言語)構文をサポートし、高度なフィルタリングが可能です。例えば、

path:"https://tenant.sharepoint.com/sites/mysite"
を使用して特定のサイトに結果を絞り込んだり、
filetype:docx
を使用してファイルタイプでフィルタリングしたりできます。

IdおよびDriveId出力列を使用して、FilesテーブルからファイルのフルレコードをFilesテーブルから取得できます。

サンプルステートメント:

EXEC SearchDriveItems Keyword = 'quarterly report'

EXEC SearchDriveItems Keyword = 'budget filetype:xlsx', MaxRows = '25'

EXEC SearchDriveItems Keyword = 'project plan path:"https://tenant.sharepoint.com/sites/mysite"'

Input

Name Type Required Description
Keyword String True OneDriveおよびSharePoint内のファイル名とコンテンツ全体を検索するためのキーワードまたはフレーズ。検索は全文検索であり、SQLのLIKEパターンマッチングとは異なります。filetype:docxやpath:
MaxRows String False 全ページを通じて返す結果の最大数。すべての利用可能な結果を返すには0を設定するか未設定のままにします。例えば、結果を50ファイルに制限するには50を設定します。

Result Set Columns

Name Type Description
Id String ドライブアイテムの一意の識別子。この値を使用して、Filesテーブルから完全なファイルレコードを取得します。
Name String 拡張子を含むファイルまたはフォルダーの名前。
WebUrl String ブラウザでファイルを開くための直接URL。
Size Long ファイルサイズ(バイト単位)。
DriveId String ファイルを含むドライブの識別子。Filesテーブルに対してドライブスコープのクエリを構築するためにIdと組み合わせて使用します。
SiteId String ファイルを含むSharePointサイトの識別子。
ParentId String 親フォルダーの識別子。
ParentPath String ドライブ内の親フォルダーのパス。
MimeType String application/vnd.openxmlformats-officedocument.wordprocessingml.documentなど、ファイルのMIMEタイプ。フォルダーの場合は空です。
CreatedDateTime Datetime ファイルが作成された日時のタイムスタンプ。
LastModifiedDateTime Datetime ファイルが最後に変更された日時のタイムスタンプ。
CreatedByDisplayName String ファイルを作成したユーザーの表示名。
LastModifiedByDisplayName String ファイルを最後に変更したユーザーの表示名。
Rank Int 検索結果の関連性ランク。値が小さいほど関連性が高いことを示します。
Summary String クエリに一致したファイルコンテンツの部分を示す検索抜粋。一致した用語はc0タグで囲まれます。

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 26.0.9770