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タグで囲まれます。 |