翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
SQL を使用した Amazon OpenSearch Service データのクエリ
JSON ベースのクエリ DSL を使用するのではなく OpenSearch 、SQL を使用して Amazon Service をクエリできます。 OpenSearch
注記
このドキュメントでは、 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 |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
2.5.0 | 2.5.0.0 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
2.3.0 | 2.3.0.0 |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
データストリームのクエリをサポートする |
サンプル呼び出し
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 プラグインには、調整可能な設定が_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) アプリケーションと統合できます。ドライバーをダウンロードするには、こちら
ドライバー用のバージョン互換性の概要を、次のテーブルに示します。
ODBC ドライバー
Open Database Connectivity (ODBC) ドライバーは、Windows と macOS 用の、読み取り専用の ODBC ドライバーです。これを使用すれば、Microsoft Excel
アー OpenSearch ティファクトページ