Query Web サービスおよびクエリ オブジェクト モデルにおける絞り込み条件の仕様
Query Web サービスまたはクエリ オブジェクト モデルでの絞り込み条件の指定について説明します。
最終更新日: 2011年9月1日
適用対象: SharePoint Server 2010
FAST Search Server 2010 for SharePoint に対してクエリを実行するとき、クエリ結果を返す絞り込み条件と絞り込みデータの種類を指定できます。
適用先: Microsoft FAST Search Server 2010 for SharePoint
Query Web サービスまたはクエリ オブジェクト モデルを使用した絞り込み条件の指定
Query Web サービスを使用する場合、Microsoft.Search.Query スキーマの Refiner 要素 を使用して、要求されるクエリ絞り込み条件を指定します。詳細については、「Query Web サービスでの絞り込み条件の使用」を参照してください。
クエリ オブジェクト モデルを使用する場合、KeywordQuery クラスの Refiners プロパティを使用して、要求されるクエリ絞り込み条件を指定します。要求されるクエリ絞り込み条件を指定するときに使用する構文を次に示します。
<refiner>[,<refiner>]*
どちらの場合も、個別の絞り込み条件の仕様は、それぞれ以下の形式になります。
<refiner-name>[(parameter=value[,parameter=value]*)]?
ここで、
<refiner-name> は、絞り込み条件に関連付けられた管理プロパティの名前です。
parameter=value ペアのオプションのリストは、指定された絞り込み条件に対して既定以外の構成値を指定します。絞り込み条件のパラメーターがカッコ内に示されていない場合は、インデックス スキーマ構成は既定の設定を使用します。詳細については、「インデックス スキーマ (FAST Search Server for SharePoint)」を参照してください。
表 1 は、絞り込み条件で有効なパラメーターを示します。
表 1. 絞り込み条件で有効なパラメーター (FAST Search Server 2010 for SharePoint)
パラメーター |
説明 |
||
---|---|---|---|
deephits |
深い絞り込みの計算で、根拠として使用されるヒットの既定の数をオーバーライドします。この設定は、検索パフォーマンスを下げます。 構文 deephits=<integer value> 例 price(deephits=1000) 注意 この制限は、検索行または列内の、各検索パーティション内で適用されます。検証されるヒットの実際の数は、複数の検索パーティションでの結果の収集により、この値より大きくなります。 |
||
discretize |
数字の絞り込み条件で、ユーザー設定の間隔 (絞り込み bin) を指定します。 構文 discretize=manual/<threshold>/<threshold>[/<threshold>]* <threshold> 属性は、各絞り込み bin でしきい値を指定します。 指定された最初のしきい値以下のすべてに対して 1 つの間隔、連続する各しきい値の間に 1 つの間隔、最後のしきい値以上のすべてに対して 1 つの間隔があります。 Datetime 型の絞り込み条件については、以下の ISO 8601 互換の形式に従ってしきい値を指定します。
この形式の値は、以下の内容を指定します。
|
||
sort |
文字列絞り込み条件で、どのように bin を並べ替えるか定義します。 構文 sort=<property>/<direction> この属性は、以下の処理をします。
例 sort=frequency/descending 既定値: frequency/descending. |
||
filter |
クライアントに返される前に、String 型の絞り込み条件内の bin が抽出される方法を定義します。 構文 filter=<bins>/<freq>/<prefix>[<levels>] この属性は、以下の処理をします。
|
||
cutoff |
深い文字列絞り込み条件のために移動し処理される必要があるデータの量を制限します。この絞り込み条件は、もっとも関連性が高い値 (bin) のみを返すために設定することができます。 注意 この切り捨てフィルター処理は、各クエリ一致サーバーで行われます。これは、結果側フィルター処理のみを実行する filter パラメーターとは異なります。これら 2 つのパラメーターは組み合わせて使うことができます。 構文 cutoff=<frequency>/<minbins>/<maxbins> この属性は、以下の処理をします。
注意 <frequency> と <minbins> は注意して使用する必要があります。<maxbins> のみを使用することをお勧めします。 |
次の例では、最終変更日のクエリ絞り込み条件を指定します。
write(discretize=manual/2010-01-01/2010-08-22/2010-09-15/2010-09-21/2010-09-22)
write 絞り込み条件は、アイテムの最終変更日を含む管理プロパティに関連付けられています。この絞り込み条件では、固定サイズの日付/時刻 bin を指定します。このとき最後の bin (2010-09-22) は、クエリが発行されるときの現在の日付になります。指定された bin は、今日、昨日、先週、先月、昨年、それより前の絞り込み bin を表すときの基準として使用できます。
ユーザーのタイム ゾーンに合わせる場合は、bin を日付/時刻の完全な表現で指定できます。
注意
仕様内では、絞り込み条件の名前を小文字で指定する必要があります。