パイプ処理言語を使用した Amazon OpenSearch Service データのクエリ - Amazon OpenSearch サービス

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

パイプ処理言語を使用した Amazon OpenSearch Service データのクエリ

Piped Processing Language (PPL) は、パイプ (|) 構文を使用して Amazon OpenSearch Service に保存されているデータをクエリできるクエリ言語です。PPL には、 OpenSearch または Elasticsearch 7.9 以降が必要です。

注記

このドキュメントでは、Amazon OpenSearch Service の PPL の概要を説明します。詳細な手順と完全なコマンドリファレンスについては、オープンソース OpenSearch ドキュメントの「PPL」を参照してください。

PPL 構文は、パイプ文字 (|) で区切られているコマンドで構成されており、データは各パイプラインを左から右に流れます。例えば、HTTP 403 または 503 エラーのあるホストの数を調べ、ホストごとに集計し、影響順に並べ替える PPL 構文は、次のとおりです。

source = dashboards_sample_data_logs | where response='403' or response='503' | stats count(request) as request_count by host, response | sort -request_count

開始するには、 OpenSearch Dashboards で Query Workbench を選択し、PPL を選択します。bulk オペレーションを使用して、いくつかのサンプルデータのインデックスを作成します。

PUT accounts/_bulk?refresh {"index":{"_id":"1"}} {"account_number":1,"balance":39225,"firstname":"Amber","lastname":"Duke","age":32,"gender":"M","address":"880 Holmes Lane","employer":"Pyrami","email":"amberduke@pyrami.com","city":"Brogan","state":"IL"} {"index":{"_id":"6"}} {"account_number":6,"balance":5686,"firstname":"Hattie","lastname":"Bond","age":36,"gender":"M","address":"671 Bristol Street","employer":"Netagy","email":"hattiebond@netagy.com","city":"Dante","state":"TN"} {"index":{"_id":"13"}} {"account_number":13,"balance":32838,"firstname":"Nanette","lastname":"Bates","age":28,"gender":"F","address":"789 Mady Street","employer":"Quility","city":"Nogal","state":"VA"} {"index":{"_id":"18"}} {"account_number":18,"balance":4180,"firstname":"Dale","lastname":"Adams","age":33,"gender":"M","address":"467 Hutchinson Court","email":"daleadams@boink.com","city":"Orick","state":"MD"}

次の例は、18 より大きい age を持つアカウントインデックス内のドキュメントの firstname および lastname フィールドを返します。

search source=accounts | where age > 18 | fields firstname, lastname
レスポンス例
id firstname lastname
0 Amber Duke
1 Hattie Bond
2 Nanette Bates
3 Dale Adams

searchwherefieldsrenamededupstatssortevalheadtop、および rare のような読み取り専用コマンドの完全なセットを使用することができます。PPL プラグインは、数学、三角法、日付時刻、文字列、集計、アドバンスト演算子および式を含むすべての SQL 関数をサポートします。詳細については、OpenSearch PPL リファレンスマニュアル を参照してください。