使用 SQL 查詢您的 Amazon OpenSearch Service 資料 - Amazon OpenSearch Service

使用 SQL 查詢您的 Amazon OpenSearch Service 資料

您可以使用 SQL 來查詢您的 Amazon OpenSearch Service,而不是使用基於 JSON 的 OpenSearch 查詢 DSL。如果您已熟悉 SQL,或想要透過使用它的應用程式來整合您的網域,則使用 SQL 進行查詢非常實用。

請使用下表來查找每個 OpenSearch 和 Elasticsearch 版本所支援的 SQL 外掛程式版本。

OpenSearch
OpenSearch 版本 SQL 外掛程式版本 值得注意的功能
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 視窗函數的 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

執行 OpenSearch 或 Elasticsearch 6.5 或更高版本的網域支援 SQL。如需 SQL 外掛程式的完整文件,請參閱 OpenSearch 文件

範例呼叫

若要使用 SQL 查詢資料,請使用以下格式傳送 HTTP 請求到 _sql

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

如果您的網域正在執行 Elasticsearch 而不是 OpenSearch,則格式為 _opendistro/_sql

備註和差異

_plugins/_sql 的呼叫會在請求內文中包含索引名稱,因此有相同的大量、mget、和 msearch 操作的存取政策考量。一如以往,授權許可到 API 操作時請遵循最低權限的原則。

如需了解搭配使用 SQL 與精細存取控制的相關安全考量,請參閱 Amazon OpenSearch Service 中的精細存取控制

OpenSearch SQL 外掛程式包含許多可調整設定。在 OpenSearch Service 中,使用 _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。如需詳細資訊,請參閱 Query Workbench

SQL CLI

SQL CLI 是可透過 opensearchsql 命令啟動的獨立 Python 應用程式。如需安裝、設定和使用的步驟,請參閱 SQL CLI

JDBC 驅動程式

Java 資料庫連接 (JDBC) 驅動程式可讓您整合 OpenSearch Service 網域與您喜好的商業智慧 (BI) 應用程式。若要開始使用,請參閱 GitHub 儲存庫。以下表格摘要驅動程式版本的相容性。可於此處下載 Open Distro for Elasticsearch 驅動程式。OpenSearch 驅動程式尚不可供下載。

OpenSearch
OpenSearch 版本 JDBC 驅動程式版本
1.2 1.0.0.0
1.1 1.0.0.0
1.0 1.0.0.0
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 驅動程式

開放資料庫連線 (ODBC) 驅動程式是適用於 Windows 和 macOS 的唯讀 ODBC 驅動程式,可讓您將商業智慧和資料視覺化應用程式 (例如,TableauMicrosoft ExcelPower BI) 連線至 SQL 外掛程式。可於此處下載 Open Distro for Elasticsearch 驅動程式。OpenSearch 驅動程式尚不可供下載。如需安裝驅動程式的詳細資訊,請參閱 GitHub 上的 SQL 儲存庫