Menanyakan data OpenSearch Layanan Amazon Anda dengan SQL - OpenSearch Layanan Amazon
Sampel panggilanCatatan dan perbedaanSQL WorkbenchSQL CLIDriver JDBCDriver ODBC

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 . 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 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.13.0 2.13.0.0

2.11.0 2.11.0.0

Tambahkan dukungan untuk bahasa dan kueri PPL
2.9.0 2.9.0.0

Tambahkan konektor Spark, dan meja dukungan dan fungsi PromQL
2.7.0 2.7.0.0

Tambahkan datasource API
2.5.0 2.5.0.0

2.3.0 2.3.0.0

Tambah maketime dan fungsi makedate datetime
1.3.0 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

Tambahkan protokol baru untuk format respons visualisasi

1.1.0

 1.1.0.0

Mendukung fungsi pencocokan sebagai filter di SQL dan PPL
1.0.0 1.0.0.0 Support kueri aliran data
Buka Distro untuk Elasticsearch
Versi Elasticsearch Versi plugin SQL Fitur penting
7.10 1.13.0 NULL PERTAMA dan TERAKHIR untuk fungsi window, fungsi CAST(), perintah TAMPILKAN dan DESKRIPSIKAN
7.9 1.11.0 Menambahkan fungsi tanggal/waktu tambahan, URUTKAN BERDASARKAN kata kunci
7.8 1.9.0
7.7 1.8.0

7.3

 1.3.0 Beberapa operator string dan nomor
7.1 1.1.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 yang sama seperti operasi bulk, mget, dan msearch. Seperti biasa, ikuti prinsip hak istimewa paling rendah ketika Anda memberikan izin ke operasi API.

Untuk pertimbangan keamanan terkait penggunaan SQL dengan kontrol akses berbutir halus, lihat. Kontrol akses berbutir halus di Layanan Amazon OpenSearch

Plugin OpenSearch SQL mencakup banyak pengaturan yang dapat disetel. 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.

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.

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. Untuk informasi lebih lanjut, lihat GitHubrepositori.

Tabel berikut merangkum kompatibilitas versi untuk driver.

OpenSearch
OpenSearch versi Versi driver JDBC
2.13 1.1.0.1
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
Buka Distro untuk Elasticsearch
Versi Elasticsearch Versi driver 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

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.

Anda dapat mengunduh contoh file driver yang berfungsi di halaman OpenSearch artefak. Untuk informasi tentang menginstal driver, lihat repositori SQL pada. GitHub