SQL を使用した Amazon OpenSearch Service データのクエリ - Amazon OpenSearch サービス
サンプル呼び出し注意と相違点SQL WorkbenchSQL CLIJDBC ドライバーODBC ドライバー

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

SQL を使用した Amazon OpenSearch Service データのクエリ

JSON ベースのクエリ DSL を使用するのではなく OpenSearch 、SQL を使用して Amazon Service をクエリできます。 OpenSearch SQL を用いたクエリの実施は、その言語にすでに精通している場合や、それを使用するアプリケーションにドメインを統合する場合に役立ちます。SQL サポートは、 OpenSearch または Elasticsearch 6.5 以降を実行しているドメインで使用できます。

注記

このドキュメントでは、 OpenSearch サービスと SQL プラグインのさまざまなバージョン、および JDBC および ODBC ドライバーのバージョン互換性について説明します。基本および複雑なクエリ、関数、メタデータクエリ、集計関数の構文については、オープンソースのOpenSearchドキュメントを参照してください。

次の表を使用して、各 OpenSearch および Elasticsearch バージョンでサポートされている SQL プラグインのバージョンを確認します。

OpenSearch
OpenSearch バージョン SQL プラグインバージョン 注目すべき機能
2.13.0 2.13.0.0

2.11.0 2.11.0.0

PPL 言語とクエリのサポートを追加
2.9.0 2.9.0.0

Spark コネクターを追加し、テーブル関数と PromQL 関数をサポートします
2.7.0 2.7.0.0

datasource API を追加
2.5.0 2.5.0.0

2.3.0 2.3.0.0

maketime および makedate 日時関数を追加
1.3.0 1.3.0.0

デフォルトのクエリ制限サイズと、値リスト内から選択する IN 句をサポート
1.2.0 1.2.0.0

可視化応答形式の新しいプロトコルを追加

1.1.0

 1.1.0.0

SQL と PPL のフィルターとしてマッチ機能をサポートする
1.0.0 1.0.0.0 データストリームのクエリをサポートする
Open Distro for Elasticsearch
Elasticsearch バージョン SQL プラグインバージョン 注目すべき機能
7.10 1.13.0 Window 関数の NULL FIRST および LAST、CAST() 関数、SHOW、および DESCRIBE コマンド
7.9 1.11.0 追加の日付/時刻関数、ORDER BY キーワードの追加
7.8 1.9.0
7.7 1.8.0

7.3

 1.3.0 複数の文字列および数値演算子
7.1 1.1.0

サンプル呼び出し

SQL を用いてデータのクエリを行うには、次の形式を使用して _sql に HTTP リクエストを送信します。

POST domain-endpoint/_plugins/_sql
{
  "query": "SELECT * FROM my-index LIMIT 50"
}
注記

ドメインが ではなく Elasticsearch を実行している場合 OpenSearch、形式は です_opendistro/_sql。

注意と相違点

_plugins/_sql の呼び出しではリクエストボディにインデックス名が含まれるため、バルク、mget、および msearch オペレーションと同じアクセスポリシーの考慮事項が適用されます。これまでどおり、API オペレーションにアクセス許可を付与するときは、最小権限の原則に従う必要があります。

きめ細かなアクセスコントロールでの SQL の使用に関連するセキュリティ上の考慮事項については、「Amazon サービスのきめ細かいアクセス制御 OpenSearch 」を参照してください。

OpenSearch SQL プラグインには、調整可能な設定が多数含まれています。 OpenSearch サービスでは、プラグイン設定_cluster/settingsパス () ではなく パスを使用します_plugins/_query/settings。

PUT _cluster/settings
{
  "transient" : {
    "plugins.sql.enabled" : true
  }
}

従来の Elasticsearch ドメインの場合、plugins を opendistro に置き換えます。

PUT _cluster/settings
{
  "transient" : {
    "opendistro.sql.enabled" : true
  }
}

SQL Workbench

SQL Workbench は OpenSearch Dashboards ユーザーインターフェイスで、オンデマンド SQL クエリの実行、SQL を REST に相当するものへの変換、結果をテキスト、JSON、JDBC、CSV として表示および保存できます。詳細については、「クエリワークベンチ」を参照してください。

SQL CLI

SQL CLI は、opensearchsql コマンドで起動できるスタンドアロンの Python アプリケーションです。インストール、構成、および使用のステップについては、「SQL CLI」を参照してください。

JDBC ドライバー

Java Database Connectivity (JDBC) ドライバーを使用すると、 OpenSearch サービスドメインをお気に入りのビジネスインテリジェンス (BI) アプリケーションと統合できます。ドライバーをダウンロードするには、こちらをクリックしてください。詳細については、GitHub「」リポジトリを参照してください。

ドライバー用のバージョン互換性の概要を、次のテーブルに示します。

OpenSearch
OpenSearch バージョン JDBC ドライバーバージョン
2.13 1.1.0.1
2.11 1.1.0.1
2.9 1.1.0.1
2.7 1.1.0.1
2.5 1.1.0.1
2.3 1.1.0.1
1.3 1.1.0.1
1.2 1.1.0.1
1.1 1.1.0.1
1.0 1.1.0.1
Open Distro for Elasticsearch
Elasticsearch バージョン JDBC ドライバーバージョン
7.10 1.13.0
7.9 1.11.0
7.8 1.9.0
7.7 1.8.0
7.4 1.4.0
7.1 1.0.0
6.8 0.9.0
6.7 0.9.0
6.5 0.9.0

ODBC ドライバー

Open Database Connectivity (ODBC) ドライバーは、Windows と macOS 用の、読み取り専用の ODBC ドライバーです。これを使用すれば、Microsoft Excel のようなビジネスインテリジェンスやデータ可視化のアプリケーションを SQL プラグインに接続できます。

アー OpenSearch ティファクトページ で作業ドライバーファイルの例をダウンロードできます。ドライバーのインストールについては、「」の「SQL リポジトリ GitHub」を参照してください。