edit-icon download-icon

フィルタリング

最終更新日: Jul 07, 2020

概要

この機能では、画像を検索するときにフィルターを設定できます。たとえば、所有者 ID が 1000、会社名が “alibaba” の画像のみを返すようにフィルターを設定できます。

サポートされているバージョン

フィルタリング機能は、2018 年 3 月 27 日以降に作成されたインスタンスに対してのみ使用可能です。それ以前のバージョンのインスタンスをアップグレードするには、チケットを起票し、サポートセンターへお問い合わせください。

フィルタリングの使用方法

  • この機能は int_attr と str_attr フィールドによるフィルタリングをサポートしています。int_attr フィールドは組み込み整数属性、str_attr フィールドは組み込み文字列属性です。

  • 画像を挿入するときに、int_attr フィールドと str_attr フィールドを指定できます。

    • 次の表記は、OSS インポートモードで画像をアップロードするときに使用できる例です。
      1. {"OperationType":"ADD","ProductId":"1000", "CategoryId":0, "IntAttr":0, "StrAttr":"value1", "CustomContent":"k1:v1,k2:v2,k3:v3", "PicName":"girl_cloth1.jpg"}
    • 別の方法として、SDK の最新バージョン (1.0.3 以降) を使用してこれらのフィールドを設定できます。具体的には、AddItemRequest オブジェクトの setIntAttr メソッドと setStrAttr メソッドを使用して、それぞれ int_attr フィールドと str_attr フィールドを設定できます。
  • 検索時にフィルターを指定できます。int_attr フィールドは、>、>=、<、<=、= の演算子をサポートしています。str_attr フィールドは、=、!、= の演算子をサポートしています。また、AND および OR 演算子を使用して、複数のフィルター条件を組み合わせることができます。
    例:

    1. int_attr>=100
    2. str_attr!="value1"
    3. int_attr=1000 AND str_attr="value1"
    • API を使用して検索を実行するときは、filter パラメーターをこの値に設定できます。

    • SDK を使用して検索を実行するときは、SearchItemRequest オブジェクトの setFilterClause 関数を呼び出すことができます。

カテゴリのアイテム数

この機能を使用するときは、各カテゴリに含まれる画像が 200 万未満であることを確認してください。カテゴリに 200 万を超える画像が含まれていても、OSS 全量インポートを実行していない場合は、検索リクエストは処理されます。ただし、検索リクエストがタイムアウトする可能性があります。