Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menanyakan data OpenSearch Layanan Amazon Anda dengan SQL
[Anda dapat menggunakan SQL untuk menanyakan OpenSearch Layanan Amazon Anda, daripada menggunakan DSL kueri berbasis JSONOpenSearch .](https://docs.opensearch.org/latest/opensearch/query-dsl/full-text/) Mengkuerikan dengan SQL berguna jika Anda sudah terbiasa dengan bahasa tersebut atau ingin mengintegrasikan domain Anda dengan aplikasi yang menggunakannya. Dukungan SQL tersedia di domain yang berjalan OpenSearch atau Elasticsearch 6.5 atau lebih tinggi.
**catatan**
Dokumentasi ini menjelaskan kompatibilitas versi antara OpenSearch Layanan dan berbagai versi plugin SQL, serta driver JDBC dan ODBC. Lihat [OpenSearchdokumentasi](https://opensearch.org/docs/latest/search-plugins/sql/sql/index/) open source untuk informasi tentang sintaks untuk kueri dasar dan kompleks, fungsi, kueri metadata, dan fungsi agregat.
Gunakan tabel berikut untuk menemukan versi plugin SQL yang didukung oleh masing-masing OpenSearch dan versi Elasticsearch.
**OpenSearch**
| OpenSearch versi | Versi plugin SQL | Fitur penting |
| --- | --- | --- |
| 2.19.0 | [2.19.0.0](https://github.com/opensearch-project/sql/releases/tag/2.19.0.0) | |
| 2.18.0 | [2.18.0.0](https://github.com/opensearch-project/sql/releases/tag/2.18.0.0) | |
| 2.17.0 | [2.17.0.0](https://github.com/opensearch-project/sql/releases/tag/2.17.0.0) | |
| 2.15.0 | [2.15.0.0](https://github.com/opensearch-project/sql/releases/tag/2.15.0.0) | |
| 2.13.0 | [2.13.0.0](https://github.com/opensearch-project/sql/releases/tag/2.13.0.0) | |
| 2.11.0 | [2.11.0.0](https://github.com/opensearch-project/sql/releases/tag/2.11.0.0) | Tambahkan dukungan untuk bahasa dan kueri PPL |
| 2.9.0 | [2.9.0.0](https://github.com/opensearch-project/sql/releases/tag/2.9.0.0) | Tambahkan konektor Spark, dan meja dukungan dan fungsi PromQL |
| 2.7.0 | [2.7.0.0](https://github.com/opensearch-project/sql/releases/tag/2.7.0.0) | Tambahkan `datasource` API |
| 2.5.0 | [2.5.0.0](https://github.com/opensearch-project/sql/releases/tag/2.5.0.0) | |
| 2.3.0 | [2.3.0.0](https://github.com/opensearch-project/sql/releases/tag/2.3.0.0) | Tambah `maketime` dan fungsi `makedate` datetime |
| 1.3.0 | [1.3.0.0](https://github.com/opensearch-project/sql/releases/tag/1.3.0.0) | Support ukuran batas kueri default, dan klausa IN untuk memilih dari dalam daftar nilai |
| 1.2.0 | [1.2.0.0](https://github.com/opensearch-project/sql/releases/tag/1.2.0.0) | Tambahkan protokol baru untuk format respons visualisasi |
| 1.1.0 | [1.1.0.0](https://github.com/opensearch-project/sql/releases/tag/1.1.0.0) | Mendukung fungsi pencocokan sebagai filter di SQL dan PPL |
| 1.0.0 | [1.0.0.0](https://github.com/opensearch-project/sql/releases/tag/1.0.0.0) | Support kueri aliran data |
**Buka Distro untuk Elasticsearch**
| Versi Elasticsearch | Versi plugin SQL | Fitur penting |
| --- | --- | --- |
| 7.10 | [1.13.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.13.0.0) | NULL PERTAMA dan TERAKHIR untuk fungsi window, fungsi CAST(), perintah TAMPILKAN dan DESKRIPSIKAN |
| 7.9 | [1.11.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.11.0.0) | Tambahkan date/time fungsi tambahan, ORDER BY kata kunci |
| 7.8 | [1.9.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.9.0.0) | |
| 7.7 | [1.8.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.8.0.0) | |
| 7.3 | [1.3.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.3.0.0) | Beberapa operator string dan nomor |
| 7.1 | [1.1.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.1.0.0) | |
## Sampel panggilan
Untuk mengkueri data Anda dengan SQL, kirim permintaan HTTP ke `_sql` menggunakan format berikut:
```
POST domain-endpoint/_plugins/_sql
{
"query": "SELECT * FROM my-index LIMIT 50"
}
```
**catatan**
Jika domain Anda menjalankan Elasticsearch daripada OpenSearch, formatnya adalah. `_opendistro/_sql`
## Catatan dan perbedaan
Panggilan ke `_plugins/_sql` menyertakan nama indeks dalam isi permintaan, sehingga mereka memiliki [pertimbangan kebijakan akses](ac.md#ac-advanced) yang sama seperti operasi bulk, mget, dan msearch. Seperti biasa, ikuti prinsip [hak istimewa paling rendah](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) ketika Anda memberikan izin ke operasi API.
Untuk pertimbangan keamanan yang terkait dengan penggunaan SQL dengan kontrol akses berbutir halus, lihat. [Kontrol akses berbutir halus di Layanan Amazon OpenSearch](fgac.md)
Plugin OpenSearch SQL mencakup banyak pengaturan yang [dapat disetel](https://docs.opensearch.org/latest/search-plugins/sql/settings/). Di OpenSearch Layanan, gunakan `_cluster/settings` jalur, bukan jalur pengaturan plugin (`_plugins/_query/settings`):
```
PUT _cluster/settings
{
"transient" : {
"plugins.sql.enabled" : true
}
}
```
Untuk domain Elasticsearch lama, ganti dengan: `plugins` `opendistro`
```
PUT _cluster/settings
{
"transient" : {
"opendistro.sql.enabled" : true
}
}
```
## SQL Workbench
SQL Workbench adalah antarmuka pengguna OpenSearch Dasbor yang memungkinkan Anda menjalankan kueri SQL sesuai permintaan, menerjemahkan SQL ke dalam setara REST, dan melihat dan menyimpan hasil sebagai teks, JSON, JDBC, atau CSV. Untuk informasi selengkapnya, lihat [Query Workbench](https://docs.opensearch.org/latest/search-plugins/sql/workbench/).
## SQL CLI
SQL CLI adalah aplikasi Python mandiri yang dapat Anda luncurkan dengan perintah `opensearchsql`. Untuk langkah-langkah menginstal, mengkonfigurasi, dan menggunakan, lihat [SQL CLI](https://docs.opensearch.org/latest/search-plugins/sql/cli/).
## Driver JDBC
Driver Java Database Connectivity (JDBC) memungkinkan Anda mengintegrasikan domain OpenSearch Layanan dengan aplikasi Business Intelligence (BI) favorit Anda. Untuk mengunduh driver, klik [di sini](https://artifacts.opensearch.org/opensearch-clients/jdbc/opensearch-sql-jdbc-1.1.0.1.jar). Untuk informasi lebih lanjut, lihat [GitHub repositori](https://github.com/opensearch-project/sql-jdbc).
## Driver ODBC
[Driver Open Database Connectivity (ODBC) adalah driver ODBC read-only untuk Windows dan macOS yang memungkinkan Anda menghubungkan intelijen bisnis dan aplikasi visualisasi data seperti Microsoft Excel ke plugin SQL.](https://github.com/opensearch-project/sql-odbc/blob/main/docs/user/microsoft_excel_support.md)
Untuk informasi tentang menginstal driver, lihat [repositori SQL](https://github.com/opensearch-project/sql-odbc) pada. GitHub