結論

OpenSearchとは、文章の全文検索やログの分析を、複数のサーバーに分けて速く行うオープンソースの検索・分析エンジンです。Elasticsearch 7.10.2 から派生し、Apache License 2.0 で配布されています。AWS で動かすマネージドの形が Amazon OpenSearch Service です。

この記事でわかること

  • 仕組み(インデックス・シャード・転置インデックス)とBM25の計算
  • opensearch-py が実際に送るHTTPの中身と、つまずいたときのエラー原文
  • Elasticsearchとの違いの表と、AWSの料金を公式の単価で試算した表

2026年11月18日更新|opensearch-py 3.2.0・Python 3.13 で通信の中身を確認

この記事で実際に動かしたもの:opensearch-py 3.2.0 と elasticsearch-py 9.5.1 を、127.0.0.1 で動かした自作の模擬サーバーに向けて送り、届いたリクエストとエラーの原文を記録しました。転置インデックスと BM25 の点数、AWS の料金の試算は Python で計算しています。

flowchart TD
    A[アプリ・curl] -->|REST API 9200| C[クラスター]
    D[Dashboards 5601] --> C
    C --> N1[ノード1]
    C --> N2[ノード2]
    N1 --> P[プライマリ シャード]
    N2 --> R[レプリカ シャード]
    P --> I[インデックス = ドキュメントの集まり]
    R --> I

よく調べられることの答えを先にまとめます。

知りたいこと 答え 詳しい節
OpenSearchとは 分散型の検索・分析エンジン。Apache 2.0 のオープンソース OpenSearchとは
Elasticsearchとの違い 7.10.2 から分かれた。ライセンス・運営・クライアントが違う Elasticsearchとの違い
インデックス・ドキュメントとは ドキュメントは1件のデータ、インデックスはその集まり 仕組み
使い方(最初の一歩) Docker で起動し、9200 番に REST API を送る 使い方
Python から使う opensearch-py を入れ、OpenSearch(hosts=…) で接続 opensearch-py が送る中身
OpenSearch Dashboardsとは OpenSearch の Web の画面。検索・グラフ・API の送信 Dashboards
Amazon OpenSearch Serviceの料金 ドメインはインスタンスの時間+ストレージ、サーバーレスは OCU 時間 料金と試算
エラーが出た Connection refused・SSLError・UnsupportedProductError の原文と直し方 つまずき

確認環境:Ubuntu 24.04 の上で、Python 3.13.18 の仮想環境に opensearch-py 3.2.0(urllib3 2.8.0)と elasticsearch-py 9.5.1(elastic-transport 9.4.3)を入れ、127.0.0.1 で動かした自作の模擬サーバー(Python の http.server)へ送りました。記録したのはクライアントが送ったリクエストとクライアント側のエラーの原文で、応答は模擬サーバーが返した仮のものです。OpenSearch 本体の配布物の取得は、この環境の通信の制限で拒否されたため、本体は起動していません(別の入手先で補っていません)。本体の挙動・Docker での起動・OpenSearch Dashboards の画面は OpenSearch の公式ドキュメント(docs.opensearch.org。最新版 3.10 の文書)で、Amazon OpenSearch Service とサーバーレスの仕組み・料金は AWS の公式(開発者ガイド・料金のページ)で確かめました。AWS には接続・ログインしていません。転置インデックス・BM25・料金の試算は Python で計算し、図は mermaid で描画を確かめています(確認日 2026年11月18日)。

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「OpenSearchとは|Elasticsearchとの違い・使い方・AWS料金試算」

OpenSearchとは(意味と成り立ち)

この節では、OpenSearch が何をするソフトウェアで、どこから生まれたのかが分かります。

OpenSearch は、公式ドキュメントで「さまざまな用途を支える分散型の検索・分析エンジン(distributed search and analytics engine)」と説明されているソフトウェアです。データを複数のサーバー(ノード)に分けて持ち、文章の全文検索、ログやメトリクスの集計、ベクトル検索などを速く行います。

成り立ちは公式の FAQ に書かれています。OpenSearch は Elasticsearch 7.10.2 から、画面の OpenSearch Dashboards は Kibana 7.10.2 から派生したもので、「Apache 2.0 で配布された最後の版の Elasticsearch と Kibana から fork(派生)を作る」と決めた、と説明されています。プロジェクトは The Linux Foundation のもとにあり、支える組織として OpenSearch Software Foundation が置かれています。

1ライセンスは Apache 2.0

公式 FAQ は「OpenSearch プロジェクトのソフトウェアはすべて Apache License 2.0 で公開」と説明しています。

2REST API で操作する

登録・検索・設定の変更を HTTP の JSON で送ります。curl・各言語のクライアント・Dashboards から同じ API を呼べます。

33.x が現行の版

公式のリリースの一覧で 3.x は「Current」、2.x は保守の期間、1.x は提供終了(2026年11月18日時点)。

どんなときに使うか

  • サイト内検索・商品検索:言葉のゆれに強い全文検索、関連度の高い順の並べ替え、絞り込み。
  • ログ分析・可観測性:大量のログを時刻で集計し、Dashboards のグラフで見る。
  • ベクトル検索・RAG:埋め込みのベクトルで意味の近い文書を探す(AWS のサーバーレスにも「ベクトル検索」のコレクションがあります)。

なお「OpenSearch」という名前は、検索の結果を受け渡すための別の仕様の名前にも使われています。この記事で扱うのは、検索エンジンのソフトウェアのほうです。

OpenSearchの仕組み(クラスター・ノード・インデックス・シャード)

この節では、OpenSearch の用語の意味と、データがどう分けて置かれるのかが分かります。

ドキュメントがデータの1件、インデックスがその集まり、シャードがインデックスを分けた一部、ノードがそれを持つサーバー、クラスターがノードの集まりです。公式ドキュメントの定義を表にまとめます。

用語 公式の説明(要旨) データベースにたとえると
ドキュメント 情報(文章や構造化データ)を持つ単位。JSON で表す 1行(レコード)
インデックス ドキュメントの集まり テーブル
マッピング ドキュメントと項目をどう保存・索引するかの決まり テーブルの定義(列の型)
シャード インデックスのドキュメントの一部を持つ。1つ1つが Lucene のインデックス テーブルを分けた断片
プライマリ/レプリカ プライマリはデータの元、レプリカはその写し。写しは予備になり、検索も分担できる 主と複製
ノード データを持ち、検索のリクエストを処理するサーバー DB サーバー1台
クラスター ノードの集まり。選ばれたクラスター マネージャーのノードがインデックスの作成などをまとめる DB サーバーの群

たとえば「プライマリ シャード 3・レプリカ 1」のインデックスは、元のシャード3つと写し3つの計6つがノードに分かれて置かれます。1台のノードが止まっても、写しが別のノードにあれば検索を続けられる、というのがシャードとレプリカの考え方です。

プライマリ シャード

データの元。登録はまずここに入る

数はインデックスを作るときに決める

インデックスを分ける単位になる

レプリカ シャード

プライマリの写し

ノードが止まったときの予備

検索の処理を分担できる

転置インデックスと関連度(BM25)を手元で計算

この節では、OpenSearch が速く検索できる理由と、結果の並び順を決める点数の考え方が、実際の計算で分かります。

OpenSearch は「単語 → その単語を含むドキュメント」の対応表(転置インデックス)で候補を素早く見つけ、BM25 という計算で関連度の点数を付けて並べます。公式ドキュメントは、転置インデックスを「単語を、その単語が現れるドキュメントに対応づけるもの」、関連度を「ドキュメントがクエリにどれだけ合ったか」を示す点数で、BM25 のアルゴリズムで計算すると説明しています。

4件の短い文書で、転置インデックスと BM25 の点数を Python で計算しました(単語は空白で分け、k1=1.2・b=0.75 で計算。OpenSearch 本体の点数そのものではなく、式の動きを見るための計算です)。

文書1: opensearch search engine for logs
文書2: search logs and metrics with dashboards
文書3: vector search for rag
文書4: managed opensearch service pricing

## inverted index (term -> doc ids)
for          [1, 3]
logs         [1, 2]
opensearch   [1, 4]
pricing      [4]
search       [1, 2, 3]
vector       [3]
N 4 avgdl 4.75
## query: search [(3, 0.1733), (1, 0.1587), (2, 0.1464)]
## query: opensearch logs [(1, 0.6169), (4, 0.3368), (2, 0.2844)]
## query: pricing [(4, 0.5851)]

1短い文書ほど少し上に来る

「search」は3件に1回ずつ出るが、4語の文書3が 0.1733 で1位、6語の文書2が 0.1464 で3位。長さで割り引く働き(b)が出た。

2珍しい単語ほど点が高い

1件にしか出ない「pricing」は 0.5851。3件に出る「search」の約3.4倍。多くの文書に出る語は区別に役立たない、という考え方(IDF)。

3両方を含む文書が1位

「opensearch logs」は両方を含む文書1が 0.6169 で1位。片方だけの文書4・文書2が続いた。

日本語は空白で単語が分かれないため、実際には文章を単語に分けるアナライザーが要ります。OpenSearch の追加プラグインの一覧には日本語の形態素解析の analysis-kuromoji があり、bin/opensearch-plugin install analysis-kuromoji の形で入れます。kuromoji の部品や辞書の作り方は、関連記事「Elasticsearch入門|インデックスと検索クエリの書き方・日本語検索」で扱っています。データベースだけで日本語の全文検索をする方法と比べたいときは、関連記事「PostgreSQL日本語全文検索|pg_trgmとpg_bigmの速度比較と選び方」で扱っています。

マッピングとは(動的マッピングと明示的なマッピング)

この節では、OpenSearch で項目の型をどう決めるのか、自動に任せるときと自分で決めるときの違いが分かります。

マッピングは「ドキュメントと項目をどう保存し、どう索引するか」を OpenSearch に伝える決まりです。型を決めずに登録すると、OpenSearch が最初に見た値から型を決めます(動的マッピング)。公式ドキュメントは、明示的なマッピングで構造と型を先に決める形を勧めています。

登録した値 動的マッピングで付く型(公式の説明) 気をつけること
文字列 "pc" text と、その下の keyword の項目 完全一致や並べ替えは keyword 側を使う
日付の形の文字列 "2026-10-01" date(日付の検出が有効なとき) 形が揃っていないと text になる
整数 98000 long(64ビットの整数) 小さい値でも long になる
小数 1.5 float 最初に整数が来ると long になる
true / false boolean —

型の決め方

避けたい最初の1件を登録して型を自動で決めさせ、あとから「価格が文字列になっていた」と気づく
→
代わりにインデックスを作るときに mappings で text・keyword・integer・date を決めておく

型をあとから変えたいときの扱いは、公式の Mappings の文書で確かめる

明示的なマッピングの例です。この記事の検証では、次の設定で products というインデックスを作るリクエストを送りました。

PUT /products
{
  "settings": {"index": {"number_of_shards": 1, "number_of_replicas": 0}},
  "mappings": {
    "properties": {
      "title":    {"type": "text"},
      "category": {"type": "keyword"},
      "price":    {"type": "integer"},
      "released": {"type": "date"}
    }
  }
}

OpenSearchの使い方(起動からREST APIまで)

この節では、OpenSearch を手元で起動し、最初のリクエストを送るまでの流れが、公式のクイックスタートの手順で分かります。

公式のクイックスタートは Docker Compose で OpenSearch と OpenSearch Dashboards を起動し、9200 番に curl で接続を確かめる流れです。この記事の環境では本体の取得が拒否されたため、次の手順は公式ドキュメント(3.10 の文書)の記載です。

1

Linux のカーネルの設定を確かめる

公式の手順では /etc/sysctl.conf に vm.max_map_count=262144 を書き、sudo sysctl -p で読み込みます(Linux のホストで動かす場合)。

ホストの設定

2

docker-compose.yml を取得する

公式ドキュメントのリポジトリにある docker-compose.yml を curl -O で取得します。

ファイルの準備

3

管理者のパスワードを .env に書く

同じフォルダーの .env に OPENSEARCH_INITIAL_ADMIN_PASSWORD=<任意のパスワード> を書きます。ユーザー名は admin です。

セキュリティ プラグインが有効な構成

4

起動する

docker-compose.yml のあるフォルダーで docker compose up -d を実行します。

起動

5

接続を確かめる

curl https://localhost:9200 -ku admin:<パスワード> で応答を見ます。デモの証明書がホスト名と合わないため -k を付ける、と公式は説明しています。

OpenSearch は 9200 番

6

Dashboards を開く

同じ PC のブラウザーで http://localhost:5601/ を開きます。

Dashboards は 5601 番

起動のあとは REST API でインデックスを作り、ドキュメントを登録して検索します。次の curl は、後の節で opensearch-py が実際に送った中身を curl の形に直したものです(セキュリティ プラグインが有効な構成を想定)。

# クラスターの状態
curl -ku admin:<パスワード> "https://localhost:9200/_cluster/health"

# 1件登録(refresh=true ですぐ検索に出す)
curl -ku admin:<パスワード> -X PUT "https://localhost:9200/products/_doc/1?refresh=true" \
  -H 'Content-Type: application/json' \
  -d '{"title":"ノートPC 軽量モデル","category":"pc","price":98000,"released":"2026-10-01"}'

# 検索
curl -ku admin:<パスワード> -X POST "https://localhost:9200/products/_search" \
  -H 'Content-Type: application/json' \
  -d '{"query":{"match":{"title":"軽量"}}}'

curl のオプション(-k・-u・-H・-d)の意味は、関連記事「curlコマンドの使い方|オプション一覧110個と早見表・組み立てツール付き」で扱っています。

Pythonクライアント(opensearch-py)が送る中身

この節では、Python から OpenSearch を使うときのコードと、そのコードが実際にどんな HTTP リクエストになるのかが分かります。

opensearch-py は pip install opensearch-py で入れ、OpenSearch(hosts=[...]) で接続します。次のコードを 127.0.0.1 の模擬サーバーに向けて動かしました(本番の構成では use_ssl=True・http_auth・verify_certs=True を付けます)。

from opensearchpy import OpenSearch, helpers

client = OpenSearch(hosts=[{"host": "127.0.0.1", "port": 19261}], use_ssl=False)
client.info()
client.indices.create(index="products", body=body)          # body は前の節の settings と mappings
client.index(index="products", id="1", body=doc, refresh=True)
client.search(index="products", body={
    "query": {"bool": {
        "must":   [{"match": {"title": "軽量"}}],
        "filter": [{"term": {"category": "pc"}}, {"range": {"price": {"lte": 100000}}}]}},
    "size": 5})
helpers.bulk(client, actions)                                 # 2件をまとめて登録

模擬サーバーが受け取ったリクエストの記録です(body は長いので一部を改行)。

GET  /                              user-agent: opensearch-py/3.2.0 (Python 3.13.18)
PUT  /products                      content-type: application/json
     {"settings":{"index":{"number_of_shards":1,"number_of_replicas":0}},"mappings":{...}}
PUT  /products/_doc/1?refresh=true
     {"title":"ノートPC 軽量モデル","category":"pc","price":98000,"released":"2026-10-01"}
POST /products/_search
     {"query":{"bool":{"must":[{"match":{"title":"軽量"}}],"filter":[...]}},"size":5}
POST /_bulk                         content-type: application/json
     {"index":{"_id":"2","_index":"products"}}
     {"title":"タブレット","category":"pc","price":45000}
     {"index":{"_id":"3","_index":"products"}}
     {"title":"デスクトップ","category":"pc","price":128000}

1id を付けた登録は PUT

client.index(id="1") は PUT /products/_doc/1 になった。refresh=True はクエリ文字列の ?refresh=true として付いた。

2検索は POST の _search

body のある検索は POST /products/_search。日本語はそのまま UTF-8 の JSON で送られた。

3bulk は2行で1件

helpers.bulk は「操作の行」と「データの行」を交互に並べた形(改行区切り)で /_bulk に1回で送った。

Amazon OpenSearch Service と Amazon OpenSearch Serverless に送るときは、IAM の資格情報でリクエストに署名します。opensearch-py の公式ドキュメントでは RequestsAWSV4SignerAuth(credentials, region, service) を使い、service に Amazon OpenSearch Service なら 'es'、Serverless なら 'aoss' を渡す例が載っています(この記事では AWS には送っていません)。

ベクトル検索だけが目的なら、OpenSearch のほかにデータベースの拡張で行う方法もあります。PostgreSQL で行う手順は、関連記事「pgvectorの使い方|PostgreSQLでベクトル検索をコピペで構築」で扱っています。

OpenSearchの検索クエリの基本(match・term・range・bool)

この節では、OpenSearch の検索でよく使う4つのクエリの役割と、組み合わせ方が分かります。

文章のあいまいな検索は match、決まった値の一致は term、数値や日付の範囲は range、これらの組み合わせは bool で書きます。どれもクエリ DSL(JSON で検索の条件を書く形)の部品です。

クエリ 役割 向く型 例
match_all すべてのドキュメント — {"match_all": {}}
match 文章を単語に分けて探す。関連度の点数が付く text {"match": {"title": "軽量"}}
term 値の完全一致 keyword・数値 {"term": {"category": "pc"}}
range 以上・以下の範囲 数値・date {"range": {"price": {"lte": 100000}}}
bool must・filter・should・must_not で組み合わせる — 前の節の検索
  • 1点数に関わる条件は must、絞り込みだけなら filterカテゴリや価格の範囲は filter に置き、文章の一致だけを must に置く
  • 2text の項目に term を使わないtext は単語に分けて保存されるため、元の文字列そのままでは一致しないことがある
  • 3件数は size、何件目からかは fromsize を書かないと既定の件数だけが返る
  • 4SQL・PPL でも書けるDashboards の Query Workbench で SQL と PPL のクエリを実行できる(公式の説明)

クエリの書き方(highlight・ページング・集計)を手を動かして覚えたいときは、API の形が共通の部分が多い関連記事「Elasticsearch入門|インデックスと検索クエリの書き方・日本語検索」が手引きになります。ただし版による違いがあるため、細かい引数は OpenSearch の公式ドキュメントで確かめます。

OpenSearch Dashboardsとは(できること)

この節では、OpenSearch Dashboards が何をする画面で、主にどの機能を使うのかが分かります。

OpenSearch Dashboards は、公式ドキュメントで「OpenSearch の Web の UI」と説明されている画面です。データの検索と探索、グラフとダッシュボードの作成、クラスターの管理に使います。Kibana 7.10.2 から派生したものです。

機能 公式の説明(要旨) 使う場面
Discover データを検索・絞り込み・確認する ログを時刻と条件で探す
Visualize グラフ・地図・表をクリックで作る 件数の推移の折れ線
Dashboards 複数のグラフを1ページにまとめ、まとめて絞り込む 運用の見える化
Query Workbench SQL と PPL のクエリをその場で実行 SQL に慣れた人の集計
Dev Tools ブラウザーから OpenSearch の API を送る 前の節の PUT・POST を試す
Index Management インデックス・データストリーム・エイリアス・テンプレート・ISM のポリシーを管理 期間を過ぎたログの自動の移動・削除の設定
Snapshot Management インデックスとクラスターの状態のバックアップと復元 移行・障害への備え

Dev Tools では、curl の URL の部分を省いた GET _cluster/health や PUT /products の形でそのまま送れます。監視のグラフを別の道具で作る方法と比べたいときは、関連記事「Prometheus Grafana入門|監視構築とPromQL一覧」で扱っています。

OpenSearchとElasticsearchの違い(比較表)

この節では、OpenSearch と Elasticsearch の違いが、それぞれの提供元の公式の説明で分かります。

OpenSearch と Elasticsearch は 7.10.2 で分かれ、その後は別々に開発されています。違いが大きいのは、ライセンス・運営・画面の名前・公式クライアントです。どちらが優れているかではなく、事実を並べます。

項目 OpenSearch Elasticsearch
成り立ち Elasticsearch 7.10.2 から派生 Elastic 社が開発を続けている本家
ライセンス(提供元の説明) Apache License 2.0 ソースは SSPL 1.0・AGPLv3・Elastic License 2.0 で提供
運営 The Linux Foundation のプロジェクト(OpenSearch Software Foundation) Elastic 社
Web の画面 OpenSearch Dashboards(Kibana 7.10.2 から派生) Kibana
REST API 7.10 向けの取り込み・検索・管理の API との後方互換を目指す 独自に機能を追加
Python の公式クライアント opensearch-py elasticsearch-py(接続先が Elasticsearch かを確かめる)
AWS のマネージド Amazon OpenSearch Service(Elasticsearch OSS 7.10 までも動かせる) —(提供元の案内を参照)

ライセンスの扱いは、それぞれの提供元の説明をそのまま紹介したものです。商用の製品に組み込むなどの判断は、最新のライセンスの文面と、所属先の決まりを先に確かめます。

Elasticsearch のクライアントを OpenSearch に向けると止まる

公式 FAQ は「クライアントやツールの中に版の確認などのコードがあると、OpenSearch で動かないことがある」と書いています。実際に elasticsearch-py 9.5.1 を 127.0.0.1 の模擬サーバー(Elasticsearch ではない応答を返す)に向けると、最初の info() で次の例外になりました。

elasticsearch-py 9.5.1
UnsupportedProductError: The client noticed that the server is not Elasticsearch and we do not support this unknown product

このとき送られたリクエストは GET / で、Accept は application/vnd.elasticsearch+json; compatible-with=9 でした。opensearch-py 3.2.0 は同じ模擬サーバーにそのまま接続できています。OpenSearch には opensearch-py など OpenSearch のクライアントを使うのが確実です。

版をまたぐときの変更(公式の breaking changes)

  • 2.0.0:すべての API から type のパラメーターが削除された。JDK 8 の対応が終わった。
  • 3.0.0:対応する JDK の最小が JDK 21 になった。Elasticsearch 向けのツールに版の番号を合わせて見せる設定 compatibility.override_main_response_version が削除された。入れ子のクエリの深さの上限 index.query.max_nested_depth(既定 20)が加わった。

Amazon OpenSearch Serviceとは(ドメインとサーバーレス)

この節では、AWS で OpenSearch を使うときの2つの形と、その違いが分かります。

Amazon OpenSearch Service は、AWS のクラウドで OpenSearch のクラスターを作り、運用し、大きくするのを簡単にするマネージド サービスです(AWS の開発者ガイドの説明)。OpenSearch と、Elasticsearch OSS(オープンソースの最後の版の 7.10 まで)を動かせます。2021年9月8日に Amazon Elasticsearch Service から今の名前に変わりました(旧名:Amazon Elasticsearch Service)。

ドメイン(マネージド クラスター)

ドメイン=OpenSearch のクラスター

インスタンスの種類・台数・ストレージを自分で決める

インスタンスの時間とストレージで課金

OpenSearch Serverless

クラスターの用意や調整が要らないサーバーレスの形

「コレクション」を作って使う

OCU(計算の単位)の時間とストレージで課金

開発者ガイドの対応版の一覧(2026年11月18日時点)は、OpenSearch が 3.5・3.3・3.1・2.19・2.17 など、以前の Elasticsearch は 7.10 から 1.5 までです。手元の OpenSearch の最新版(3.10)と、AWS で選べる版は同じではありません。

サーバーレスのコレクションの種類と制限

種類 向く用途(公式の説明) 主な制限
時系列(Time series) ログ分析など、機械が出す大量のデータ 独自のドキュメント ID での登録や upsert の更新は不可
検索(Search) サイト内検索・文書の全文検索 k-NN 型のインデックスは不可
ベクトル検索(Vector search) 埋め込みを使う意味検索・生成 AI のアプリ 種類は作成後に変えられない

どの種類でも、シャードの数とリフレッシュの間隔は Serverless が管理して変えられません。検索と時系列のコレクションのリフレッシュの間隔は約10秒、手動のスナップショットは非対応、ドメインからの自動の移行はなく再投入が要る、と開発者ガイドは説明しています。opensearch-py の公式ドキュメントも、Serverless は refresh のパラメーターに対応していないと書いています。RAG の検索の部分をどこに置くかを考えるときは、関連記事「RAGの作り方|Pythonで動かす最小構成と精度の上げ方」で扱っています。

Amazon OpenSearch Serviceの料金と試算

この節では、Amazon OpenSearch Service の料金の決まり方と、公式の料金ページの単価で計算した月額の目安が分かります。

ドメインは「インスタンスの時間」+「EBS ストレージの容量」+データ転送、サーバーレスは「OCU の時間」+「マネージド ストレージの容量」で決まります。料金ページ(日本語版)の説明の要点です(2026年11月18日時点)。

  • ドメインのインスタンスは、利用できる状態で動いている時間ごとに課金され、1時間未満の使用は1時間分として請求される。
  • ドメイン内のノード間のデータ転送は課金されない。サービスとの間の転送は AWS の通常の料金。
  • UltraWarm・コールド ストレージ・OR1 のリモート ストアのデータには、マネージド ストレージの料金がかかる。
  • サーバーレスの OCU は秒単位で、コレクション グループごとに時間単位で課金される。1 OCU は 6 GiB のメモリと対応する vCPU など。
  • サーバーレスの NextGen は OCU の最小の要件がなく、使わない状態が10分続くとインデックス作成と検索の OCU が0になる。Classic はアカウントの最初のコレクションで少なくとも 2 OCU(開発・テスト向けの設定では 0.5+0.5 OCU)。
  • 延長サポート(Extended Support)の版を動かすと、通常のインスタンスの費用に加えて、標準化インスタンス時間ごとの定額がかかる(例:米国東部の一部の版で 0.0065 USD、東京で 0.0081 USD)。

料金ページの料金例に載っている米国東部(バージニア北部)の単価で、月730時間として Python で計算しました。東京リージョンのインスタンスの単価は料金ページの本文に無かったため、東京で使うときは AWS Pricing Calculator で確かめます。

## monthly cost (US East example rates on the pricing page, 730h)
r8g.large.search x1 + gp3 20GB each: instance 143.08 + storage 2.44 = 145.52 USD
r8g.large.search x3 + gp3 100GB each: instance 429.24 + storage 36.60 = 465.84 USD
m7g.medium.search x1 + gp3 20GB: 52.08 USD
serverless 2 OCU x 730h: 350.40 USD
serverless 1 OCU x 730h: 175.20 USD
serverless 2 OCU x 176h: 84.48 USD
domain instance used 30 min -> billed 1 h -> 0.196 USD (r8g.large.search)
domain instance used 61 min -> billed 2 h -> 0.392 USD (r8g.large.search)
構成(米国東部の料金例の単価) 使った単価 月額の目安
ドメイン:m7g.medium.search 1台+gp3 20GB 0.068 USD/時・0.122 USD/GB-月 約52 USD
ドメイン:r8g.large.search 1台+gp3 20GB 0.196 USD/時 約146 USD
ドメイン:r8g.large.search 3台+各 gp3 100GB 同上 約466 USD
サーバーレス Classic の最小 2 OCU を常時 0.24 USD/OCU 時 約350 USD+ストレージ
サーバーレス Classic 開発・テスト向け 1 OCU を常時 同上 約175 USD+ストレージ
サーバーレス NextGen 2 OCU を平日8時間×22日だけ 同上(使わない時間は0になる前提) 約84 USD+ストレージ

1小さく試すなら台数とストレージを絞る

1台+20GB なら m7g.medium.search で約52 USD。3台にすると、台数の分だけそのまま3倍になる。

2Classic の最小は常にかかる

2 OCU の最小は使っていない夜間もかかり、月約350 USD。開発・テスト向けの設定で半分になる。

3ドメインは1時間単位に切り上げ

61分使うと2時間分。試したあとはドメインを消すまで課金が続く点に注意。

料金ページの数字は料金例で、実際の単価はリージョン・インスタンスの種類・時期で変わります。AWS の無料利用枠は、2026年11月18日時点の aws.amazon.com/free の説明では、新しいアカウントに 100 USD のクレジットと、主なサービスを試すと最大 100 USD の追加のクレジットが付く形です。OpenSearch Service の料金ページには、このサービス独自の無料枠の記載はありませんでした。

OpenSearchのよくあるエラー・つまずき

この節では、OpenSearch を使い始めたときに出やすいエラーの原文と、原因・直し方が分かります。

接続のエラーは「起動しているか」「http と https が合っているか」「OpenSearch のクライアントか」の順に確かめます。opensearch-py 3.2.0 で 127.0.0.1 に対して実際に出したエラーの原文です。

# 何も起動していないポート(19299)に接続
ConnectionError: ConnectionError(HTTPConnection(host='127.0.0.1', port=19299): Failed to establish a new connection: [Errno 111] Connection refused) caused by: NewConnectionError(...)

# http で動いているサーバーに use_ssl=True で接続
SSLError: ConnectionError([SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1035)) caused by: SSLError([SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1035))
症状・原文 原因 確かめ方 直し方
[Errno 111] Connection refused OpenSearch が起動していない・ポート違い curl で 9200 番に送る・docker compose ps 起動する・ポートを合わせる
SSL: WRONG_VERSION_NUMBER http のサーバーに https で接続した URL の http・https と use_ssl を見比べる サーバーの設定に合わせる
https の URL に http で送って応答がおかしい セキュリティ プラグインが有効で https が必要 公式の例どおり https と -ku admin で送る https・認証・証明書の設定に合わせる
401 が返る ユーザー名・パスワードが無い・違う .env の OPENSEARCH_INITIAL_ADMIN_PASSWORD を見る 正しい資格情報を渡す
UnsupportedProductError Elasticsearch のクライアントで接続した import しているパッケージ名を見る opensearch-py などに替える
登録した直後に検索に出ない リフレッシュ(検索に反映)の前 少し待って同じ検索を送る テストでは refresh=True。Serverless は約10秒待つ
type を含むリクエストが通らない 2.0.0 で type のパラメーターが削除 URL や body に _doc 以外の型名があるか 型名を外した API に直す
Elasticsearch 向けのツールが版の確認で止まる ツール側の版の確認。3.0 で互換の設定が削除 ツールの対応表を見る OpenSearch 対応の版・プラグインに替える
Docker で起動してもすぐ止まる ホストの vm.max_map_count が足りないことがある docker compose logs で起動のログを見る 公式の手順の 262144 に設定

どのエラーでも、まず curl -v で 9200 番に送り、応答が返るか・http と https のどちらで返るか・ステータスコードは何かを見ると、クライアントの問題かサーバーの問題かを分けられます。

OpenSearchを使うかの判断表

この節では、目的ごとに OpenSearch・Amazon OpenSearch Service のどの形を選ぶか、別の方法が合うのはどんなときかが分かります。

  1. 1数万件までの検索で、すでに PostgreSQL がある → まず DB の全文検索・pgvector新しいサーバーを増やさずに済む
  2. 2手元で学ぶ・試す → Docker で OpenSearch+Dashboards公式のクイックスタート。料金はかからない
  3. 3AWS で、使う時間に波がある → サーバーレス(NextGen)使わない時間は OCU が0になる
  4. 4AWS で、シャードやプラグインを細かく決めたい → ドメインインスタンスの種類・台数・ストレージを選べる
  5. 5大量のログを長く持つ → ドメイン+UltraWarm・コールドマネージド ストレージの単価で持てる
  6. 6自社のサーバーで Apache 2.0 のソフトを動かしたい → OpenSearch を自分で運用運用・更新の手間は自分たちで持つ
やりたいこと 合う形 決め手
サイト内検索・商品検索 OpenSearch(検索のコレクション・ドメイン) 関連度の並べ替え・絞り込み・日本語のアナライザー
ログの集計とグラフ OpenSearch+Dashboards(時系列のコレクション・ドメイン) 時刻での集計・Discover・ダッシュボード
RAG のベクトル検索 ベクトル検索のコレクション、または pgvector データの量・既存の DB・全文検索との組み合わせ
Elasticsearch からの移行 OpenSearch(7.10 系の API に近い) クライアントを OpenSearch のものに替える・再投入
少ない費用で AWS で試す 小さいドメイン1台、または NextGen 試算の表と、終わったら消す運用

よくある質問

この節では、OpenSearch について検索されることの多い疑問に短く答えます。

Q. OpenSearchとは何ですか?

A. 分散型の検索・分析エンジンです。全文検索・ログ分析・ベクトル検索に使い、Apache License 2.0 で配布されています。

Q. OpenSearch と Elasticsearch の違いは何ですか?

A. OpenSearch は Elasticsearch 7.10.2 から派生したソフトウェアです。ライセンス(Apache 2.0 と、SSPL・AGPLv3・Elastic License 2.0)、運営(The Linux Foundation のプロジェクトと Elastic 社)、画面(Dashboards と Kibana)、公式クライアントが違います。

Q. OpenSearch は無料で使えますか?

A. ソフトウェアは Apache 2.0 で、自分のサーバーや Docker で動かせます。AWS の Amazon OpenSearch Service はインスタンスの時間や OCU の時間で料金がかかります。

Q. Elasticsearch のクライアントで OpenSearch に接続できますか?

A. elasticsearch-py 9.5.1 では UnsupportedProductError で止まりました。opensearch-py など OpenSearch のクライアントを使います。

Q. インデックスとは何ですか?

A. ドキュメント(JSON の1件のデータ)の集まりです。データベースのテーブルに近いものです。

Q. OpenSearch Dashboards とは何ですか?

A. OpenSearch の Web の画面です。Discover での検索、Visualize のグラフ、Dev Tools での API の送信などができます。公式のクイックスタートでは 5601 番で開きます。

Q. 日本語の全文検索はできますか?

A. 追加プラグインの analysis-kuromoji を入れると、日本語を単語に分けるアナライザーを使えます。

Q. Amazon OpenSearch Service と Amazon Elasticsearch Service は同じですか?

A. 同じサービスで、2021年9月8日に名前が Amazon OpenSearch Service に変わりました。OpenSearch と Elasticsearch OSS 7.10 までを動かせます。

Q. サーバーレスとドメインはどちらが安いですか?

A. 使い方で変わります。Classic の最小 2 OCU を常時なら月約350 USD、小さいドメイン1台なら約52 USD(米国東部の料金例の単価で計算)。使わない時間が長いなら NextGen が安くなることがあります。

Q. 登録したデータがすぐ検索に出ないのはなぜですか?

A. 検索に反映するリフレッシュの前だからです。テストでは refresh=True を付けます。Serverless は refresh に対応せず、間隔は約10秒です。

まとめ

この節では、記事の要点を5つにまとめます。

  • OpenSearch は分散型の検索・分析エンジンで、Elasticsearch 7.10.2 から派生し、Apache License 2.0 で配布されている。
  • ドキュメント・インデックス・シャード・ノード・クラスターの関係を押さえ、型はマッピングで先に決める。
  • 検索は転置インデックスで候補を探し、BM25 の点数で並べる。手元の計算でも、珍しい語・短い文書・両方を含む文書が上に来た。
  • Python からは opensearch-py を使う。elasticsearch-py は UnsupportedProductError で止まった。
  • Amazon OpenSearch Service は、ドメイン(インスタンスの時間+ストレージ)とサーバーレス(OCU の時間)で料金の形が違う。単価は確認日つきで、Pricing Calculator で確かめる。

参考・出典

この節では、記事で確かめた公式の情報の出どころが分かります(確認日 2026年11月18日)。

  • OpenSearch Documentation「Introduction to OpenSearch」:https://docs.opensearch.org/latest/getting-started/intro/
  • OpenSearch Documentation「Quickstart」:https://docs.opensearch.org/latest/getting-started/quickstart/
  • OpenSearch Documentation「Communicate with OpenSearch」:https://docs.opensearch.org/latest/getting-started/communicate/
  • OpenSearch Documentation「Mappings」:https://docs.opensearch.org/latest/mappings/
  • OpenSearch Documentation「OpenSearch Dashboards」:https://docs.opensearch.org/latest/dashboards/
  • OpenSearch Documentation「Low-level Python client」:https://docs.opensearch.org/latest/clients/python-low-level/
  • OpenSearch Documentation「Breaking changes」:https://docs.opensearch.org/latest/breaking-changes/
  • OpenSearch Documentation「Additional plugins」:https://docs.opensearch.org/latest/install-and-configure/additional-plugins/index/
  • OpenSearch「FAQ」:https://opensearch.org/faq/
  • OpenSearch「Releases」:https://opensearch.org/releases/
  • OpenSearch「OpenSearch Software Foundation」:https://opensearch.org/foundation/
  • AWS「What is Amazon OpenSearch Service?」:https://docs.aws.amazon.com/opensearch-service/latest/developerguide/what-is.html
  • AWS「Amazon OpenSearch Serverless」:https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html
  • AWS「Amazon OpenSearch Service の料金」:https://aws.amazon.com/jp/opensearch-service/pricing/
  • AWS「AWS 無料利用枠」:https://aws.amazon.com/free/
  • AWS「Amazon Elasticsearch Service is now Amazon OpenSearch Service」(2021年9月8日):https://amazonaws.cn/en/new/2021/amazon-elasticsearch-service-amazon-opensearch-service-opensearch-1-0
  • Elastic「Licensing FAQ」:https://www.elastic.co/pricing/faq/licensing

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「OpenSearchとは|Elasticsearchとの違い・使い方・AWS料金試算」

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。

WE ARE HIRING

RJCで一緒に開発しながら、
成長を楽しみませんか?

RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!

  • 127日年間休日
  • 12時間平均残業時間
  • 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!

ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり