PolarDB:PolarSearch ユーザーガイド

クラスター構成要件

• 製品バージョン: Enterprise Edition。

• データベースエンジン: MySQL 8.0.1、MySQL 8.0.2。

  説明

  • データベースエンジンに特定のマイナーバージョンは必要ありません。

  • 詳細については、「エンジンバージョンのクエリ」をご参照ください。

• シリーズ: Cluster Edition。

• PolarSearch はサーバーレスクラスターではサポートされていません。詳細については、「サーバーレス」をご参照ください。

サポートされるリージョンとゾーン

PolarSearch は、次のゾーンでサポートされています:

インデックスの作成

検索ノード上のインデックスは、リレーショナルデータベースのテーブルに似ています。次の例に示すように、Elasticsearch 互換の REST API を使用してインデックスを作成できます:

curl -X PUT "http://<endpoint>:<port>/articles" -H "Content-Type:application/json" -d '
{
  "settings": {
    "number_of_shards": 1,
    "number_of_replicas": 1
  },
  "mappings": {
    "properties": {
      "title": {
        "type": "text"  // 全文検索フィールド (説明コメント。テスト前に削除してください。)
      },
      "content": {
        "type": "text"
      },
      "author": {
        "type": "keyword"  // 完全一致フィールド (説明コメント。テスト前に削除してください。)
      }
    }
  }
}
'

データのインポート

curl -X POST "http://<endpoint>:<port>/articles/_bulk" -H "Content-Type:application/json" -d '
{"index": {}}
{"title": "Introduction to PolarSearch", "content": "PolarSearch is a powerful search engine.", "author": "Allen"}
{"index": {}}
{"title": "Advanced Search Techniques", "content": "Learn how to use full-text search and filters in PolarDB.", "author": "Lang"}
{"index": {}}
{"title": "Elasticsearch vs PolarSearch", "content": "A comparison of Elasticsearch and PolarSearch features.", "author": "Zhao"}
'

検索クエリの実行

データがインポートされた後、次の例に示すように、SDK または REST API を使用して全文検索を実行できます:

curl -X GET "http://<endpoint>:<port>/articles/_search" -H "Content-Type:application/json" -d '
{
  "query": {
    "match": {
      "content": "PolarSearch"
    }
  }
}'

ベクトルインデックスの作成

curl -X PUT "http://<endpoint>:<port>/my-vector-index" -H "Content-Type:application/json" -d '
{
  "settings": {
    "index": {
      "knn": true
    }
  },
  "mappings": {
    "properties": {
      "vector_field": {
        "type": "knn_vector",
        "dimension": 4
      },
      "metadata": {
        "type": "text"
      }
    }
  }
}
'

ベクトルデータの挿入

curl -X POST "http://<endpoint>:<port>/my-vector-index/_bulk" -H "Content-Type:application/json" -d '
{"index": {}}
{"vector_field": [0.1, 0.5, -0.3, 0.8], "metadata": "Document 1"}
{"index": {}}
{"vector_field": [-0.2, 0.7, 0.4, -0.1], "metadata": "Document 2"}
'

ベクトル検索の実行

curl -X GET "http://<endpoint>:<port>/my-vector-index/_search" -H "Content-Type:application/json" -d '
{
  "size": 2,
  "query": {
    "knn": {
      "vector_field": {
        "vector": [0.1, 0.5, -0.3, 0.8],
        "k": 2
      }
    }
  }
}
'