使用 SQL 查詢您的亞馬遜 OpenSearch 服務數據

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

使用下表查找每個版本 OpenSearch 和彈性搜索版本支持的 SQL 插件的版本。

OpenSearch
OpenSearch 版本	SQL 外掛程式版本	值得注意的功能
2.11.0	2.11.0.0	添加對 PPL 語言和查詢的支持
2.9.0	2.9.0.0	添加星火連接器，並支持表和 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	視窗函數的 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 支援適用於執行彈性搜尋 6.5 OpenSearch 或更高版本的網域。SQL 插件的完整文檔可在OpenSearch文檔中找到。

範例呼叫

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

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

注意

如果您的網域正在執行彈性搜尋 OpenSearch，而非執行格式。_opendistro/_sql

備註和差異

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

如需了解搭配使用 SQL 與精細存取控制的相關安全考量，請參閱 Amazon OpenSearch 服務中的精細訪問控制。

OpenSearch SQL 外掛程式包含許多可調整的設定。在 OpenSearch 服務中，使用_cluster/settings路徑，而不是外掛程式設定 path (_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 工作台是 OpenSearch 儀表板使用者介面，可讓您執行隨選 SQL 查詢、將 SQL 翻譯成其他等效項目，以及檢視和儲存結果為文字、JSON、JDBC 或 CSV。如需詳細資訊，請參閱 Query Workbench。

SQL CLI

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

JDBC 驅動程式

Java 資料庫連線 (JDBC) 驅動程式可讓您整合 OpenSearch 服務網域與您最愛的商業智慧 (BI) 應用程式。若要下載驅動程式，請按一下這裡。如需詳細資訊，請參閱存GitHub放庫。

以下表格摘要驅動程式版本的相容性。

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

開放式資料庫連線 (ODBC) 驅動程式是 Windows 和 macOS 的唯讀 ODBC 驅動程式，可讓您將商業智慧和資料視覺化應用程式 (如 Microsoft Excel) 連接到 SQL 外掛程式。

您可以在 OpenSearch 成品頁面上下載工作驅動程式範例檔案。如需有關安裝驅動程式的詳細資訊，請參閱上的 SQL 儲存庫 GitHub。