在 Amazon OpenSearch 服務中搜索數據

在 Amazon Ser OpenSearch vice 中搜尋文件有幾種常用方法，包括URI搜尋和要求本文搜尋。 OpenSearch Service 提供額外的功能，可改善搜尋體驗，例如自訂套件、SQL支援和非同步搜尋。如需完整的 OpenSearch 搜尋API參考資料，請參閱OpenSearch 文件。

注意

下列範例請求適用於 OpenSearch APIs。部分請求可能無法與較舊的 Elasticsearch 版本搭配使用。

主題

URI搜尋

通用資源識別碼 (URI) 搜尋是最簡單的搜尋形式。在URI搜尋中，您可以將查詢指定為HTTP要求參數：


GET https://search-my-domain.us-west-1.es.amazonaws.com/_search?q=house

範例回應看起來類似如下：


{
  "took": 25,
  "timed_out": false,
  "_shards": {
    "total": 10,
    "successful": 10,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 85,
      "relation": "eq",
    },
    "max_score": 6.6137657,
    "hits": [
      {
        "_index": "movies",
        "_type": "movie",
        "_id": "tt0077975",
        "_score": 6.6137657,
        "_source": {
          "directors": [
            "John Landis"
          ],
          "release_date": "1978-07-27T00:00:00Z",
          "rating": 7.5,
          "genres": [
            "Comedy",
            "Romance"
          ],
          "image_url": "http://ia.media-imdb.com/images/M/MV5BMTY2OTQxNTc1OF5BMl5BanBnXkFtZTYwNjA3NjI5._V1_SX400_.jpg",
          "plot": "At a 1962 College, Dean Vernon Wormer is determined to expel the entire Delta Tau Chi Fraternity, but those troublemakers have other plans for him.",
          "title": "Animal House",
          "rank": 527,
          "running_time_secs": 6540,
          "actors": [
            "John Belushi",
            "Karen Allen",
            "Tom Hulce"
          ],
          "year": 1978,
          "id": "tt0077975"
        }
      },
      ...
    ]
  }
}

根據預設，此查詢在所有索引中的所有欄位裡搜尋含有 house 的詞語。若要縮小搜尋範圍，請在下列項目中指定索引 (moviestitle) 和文件欄位 ()URI：


GET https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search?q=title:house

您可以在請求中包含其他參數，但支援的參數僅提供一小部分的 OpenSearch 搜尋選項。下列請求傳回 20 個結果 (而非預設的 10 個)，並根據年份排序 (而非依據 _score)：


GET https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search?q=title:house&size=20&sort=year:desc

要求主體搜尋

若要執行更複雜的搜尋，請使用HTTP要求主體和 OpenSearch網域特定語言 (DSL) 來進行查詢。此查詢DSL可讓您指定 OpenSearch 搜尋選項的完整範圍。

注意

您不能在文字欄位值中包含 Unicode 特殊字元，否則會將值剖析為由特殊字元分隔的多個值。這種不正確的剖析可能會導致意外對文件進行篩選，並可能影響對其存取權的控制。如需詳細資訊，請參閱文 OpenSearch件中文字欄位中 Unicode 特殊字元的附註。

下列match查詢類似於最終URI搜尋範例：


POST https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search
{
  "size": 20,
  "sort": {
    "year": {
      "order": "desc"
    }
  },
  "query": {
    "query_string": {
      "default_field": "title",
      "query": "house"
    }
  }
}

注意

_searchAPI接受HTTPGET和POST用於請求主體搜索，但並非所有HTTP客戶端都支持將請求主體添加到GET請求中。 POST是比較普遍的選擇。

在許多情況下，您可能想要搜尋多個欄位，但並非所有欄位。使用 multi_match 查詢：


POST https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search
{
  "size": 20,
  "query": {
    "multi_match": {
      "query": "house",
      "fields": ["title", "plot", "actors", "directors"]
    }
  }
}

增加欄位

您可以透過「增加」特定欄位來提升搜尋相關性。增加功能為運用倍數在一個欄位中加重配對數，使之較其他欄位中的配對數更高。在下面的例子中，匹配 title 欄位中的 John 對_score 的影響是在 plot 欄位中匹配的兩倍，以及在 actors 或 directors 欄位中匹配的四倍。結果就是 John Wick 和 John Carter 之類的影片會在搜尋結果的頂部，且 John Travolta 主演的影片會出現在底部。


POST https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search
{
  "size": 20,
  "query": {
    "multi_match": {
      "query": "john",
      "fields": ["title^4", "plot^2", "actors", "directors"]
    }
  }
}

搜尋結果反白呈現

如果查詢匹配一個或多個字段，該highlight選項告訴 OpenSearch 返回hits數組內的附加對象：


POST https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search
{
  "size": 20,
  "query": {
    "multi_match": {
      "query": "house",
      "fields": ["title^4", "plot^2", "actors", "directors"]
    }
  },
  "highlight": {
    "fields": {
      "plot": {}
    }
  }
}

如果查詢符合 plot 欄位的內容，則命中看起來會如下：


{
  "_index": "movies",
  "_type": "movie",
  "_id": "tt0091541",
  "_score": 11.276199,
  "_source": {
    "directors": [
      "Richard Benjamin"
    ],
    "release_date": "1986-03-26T00:00:00Z",
    "rating": 6,
    "genres": [
      "Comedy",
      "Music"
    ],
    "image_url": "http://ia.media-imdb.com/images/M/MV5BMTIzODEzODE2OF5BMl5BanBnXkFtZTcwNjQ3ODcyMQ@@._V1_SX400_.jpg",
    "plot": "A young couple struggles to repair a hopelessly dilapidated house.",
    "title": "The Money Pit",
    "rank": 4095,
    "running_time_secs": 5460,
    "actors": [
      "Tom Hanks",
      "Shelley Long",
      "Alexander Godunov"
    ],
    "year": 1986,
    "id": "tt0091541"
  },
  "highlight": {
    "plot": [
      "A young couple struggles to repair a hopelessly dilapidated <em>house</em>."
    ]
  }
}

根據預設，會將相符字串 OpenSearch 包裝在<em>標籤中，在相符項目周圍提供最多 100 個字元的環境，並透過識別標點符號、空格、定位鍵和換行符號，將內容分成句子。所有設定皆可自訂：


POST https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search
{
  "size": 20,
  "query": {
    "multi_match": {
      "query": "house",
      "fields": ["title^4", "plot^2", "actors", "directors"]
    }
  },
  "highlight": {
    "fields": {
      "plot": {}
    },
    "pre_tags": "<strong>",
    "post_tags": "</strong>",
    "fragment_size": 200,
    "boundary_chars": ".,!? "
  }
}

伯爵 API

如果您對文件的內容不感興趣，只想知道相符項目的數目，可以使用_countAPI代替 _searchAPI. 下列請求使用 query_string 查詢來識別浪漫喜劇：


POST https://search-my-domain.us-west-1.es.amazonaws.com/movies/_count
{
  "query": {
    "query_string": {
      "default_field": "genres",
      "query": "romance AND comedy"
    }
  }
}

範例回應看起來類似如下：


{
  "count": 564,
  "_shards": {
    "total": 5,
    "successful": 5,
    "skipped": 0,
    "failed": 0
  }
}

對搜尋結果進行分頁

如果您需要顯示大量的搜索結果，您可以使用幾種不同的方法來實現分頁。

時間點

時間點 (PIT) 功能是一種搜尋類型，可讓您針對固定時間的資料集執行不同的查詢。這是中首選的分頁方法 OpenSearch，特別是對於深分頁。您可以搭PIT配 OpenSearch 服務 2.5 版及更新版本使用。如需有關 PIT 的詳細資訊，請參閱在 Amazon OpenSearch 服務中的時間點搜索。

`from`和`size`參數

最簡單的分頁方式是使用from和size參數。以下請求傳回結果 20-39 項以零為索引的搜尋結果清單：


POST https://search-my-domain.us-west-1.es.amazonaws.com/movies/_search
{
  "from": 20,
  "size": 20,
  "query": {
    "multi_match": {
      "query": "house",
      "fields": ["title^4", "plot^2", "actors", "directors"]
    }
  }
}

如需搜尋分頁的詳細資訊，請參閱 OpenSearch 文件中的分頁結果。

儀表板查詢語言

您可以使用儀表板查詢語言 (DQL) 來搜尋儀 OpenSearch 表板中的資料和視覺效果。DQL使用四種主要查詢類型：字詞、布林值、日期和範圍，以及巢狀欄位。

術語查詢

術語查詢要求您指定要搜尋的術語。

若要執行術語查詢，請輸入下列內容：


host:www.example.com

布林值查詢

您可以使用布林運算子 AND、or 以及 not 以合併多個查詢。

要執行布林值查詢，請貼上以下內容：


host.keyword:www.example.com and response.keyword:200

日期和範圍查詢

您可以使用日期和範圍查詢來尋找查詢之前或之後的日期。

> 表示搜尋指定日期之後的日期。
< 表示搜尋指定日期之前的日期。

@timestamp > "2020-12-14T09:35:33"

巢狀欄位查詢

如果您擁有一個帶巢狀欄位的文件，則必須指定要擷取文件的哪些部分。以下是包含巢狀欄位的範例文件：


{"NBA players":[
    {"player-name": "Lebron James",
      "player-position": "Power forward",
      "points-per-game": "30.3"
    },
    {"player-name": "Kevin Durant",
      "player-position": "Power forward",
      "points-per-game": "27.1"
    },
    {"player-name": "Anthony Davis",
      "player-position": "Power forward",
      "points-per-game": "23.2"
    },
    {"player-name": "Giannis Antetokounmpo",
      "player-position": "Power forward",
      "points-per-game":"29.9"
    }
  ]
}

若要使用擷取特定欄位DQL，請貼上下列內容：


NBA players: {player-name: Lebron James}

若要從巢狀文件中擷取多個物件，請貼入下列內容：


NBA players: {player-name: Lebron James} and NBA players: {player-name: Giannis Antetokounmpo}

若要在某個範圍內搜尋，請貼上以下內容：


NBA players: {player-name: Lebron James} and NBA players: {player-name: Giannis Antetokounmpo and < 30}

如果您的文件在另一個物件中有巢狀物件，您仍然可以透過指定所有層級來擷取資料。如要執行此操作，請貼上以下內容：


Top-Power-forwards.NBA players: {player-name:Lebron James}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用 Logstash 載入資料

自訂套件