기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
SQL을 사용하여 아마존 OpenSearch 서비스 데이터 쿼리
JSON 기반 OpenSearch 쿼리 DSL을 사용하는 대신 SQL을 사용하여 Amazon OpenSearch 서비스를 쿼리할 수 있습니다.
참고
이 설명서에서는 OpenSearch 서비스와 다양한 버전의 SQL 플러그인, JDBC 및 ODBC 드라이버 간의 버전 호환성에 대해 설명합니다. 기본 및 복합 쿼리, 함수, 메타데이터 쿼리, 집계 함수의 구문에 대한 자세한 내용은 오픈 소스 OpenSearch설명서를
다음 표를 사용하여 각 OpenSearch 버전과 Elasticsearch 버전에서 지원하는 SQL 플러그인 버전을 찾아보세요.
OpenSearch 버전 | SQL 플러그인 버전 | 주목할 만한 기능 |
---|---|---|
2.13.0 | 2.13.0.0 |
|
2.11.0 | 2.11.0.0 |
PPL 언어 및 쿼리에 대한 지원 추가 |
2.9.0 | 2.9.0.0 |
Spark 커넥터 추가, 표 및 PromQL 함수 지원 |
2.7.0 | 2.7.0.0 |
|
2.5.0 | 2.5.0.0 |
|
2.3.0 | 2.3.0.0 |
|
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 |
데이터 스트림 쿼리 지원 |
샘플 호출
SQL을 사용하여 데이터를 쿼리하려면 다음 형식을 사용하여 _sql
에 HTTP 요청을 전송합니다.
POST
domain-endpoint
/_plugins/_sql { "query": "SELECT * FROM my-index LIMIT 50" }
참고
도메인에서 Elasticsearch가 아닌 OpenSearch Elasticsearch를 실행하는 경우 형식은 다음과 같습니다. _opendistro/_sql
참고 사항 및 차이점
_plugins/_sql
에 대한 호출은 인덱스 이름을 요청 본문에 포함하므로 대량, mget 및 msearch 작업과 동일한 액세스 정책 고려 사항을 갖습니다. 항상 그렇듯이, API 작업에 권한을 부여할 때는 최소 권한의 원칙을 따릅니다.
세분화된 액세스 제어와 함께 SQL을 사용하는 것과 관련된 보안 고려 사항은 Amazon 서비스의 세밀한 액세스 제어 OpenSearch 를 참조하세요.
OpenSearch SQL 플러그인에는 조정_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 워크벤치는 온디맨드 SQL 쿼리를 실행하고, SQL을 해당 REST로 변환하고, 결과를 텍스트, JSON, JDBC 또는 CSV로 보고 저장할 수 있는 OpenSearch 대시보드 사용자 인터페이스입니다. 자세한 내용은 쿼리 워크벤치
SQL CLI
SQL CLI는 opensearchsql
명령을 사용하여 시작할 수 있는 독립형 Python 애플리케이션입니다. 설치, 구성 및 사용 단계는 SQL CLI
JDBC 드라이버
Java 데이터베이스 연결 (JDBC) 드라이버를 사용하면 OpenSearch 서비스 도메인을 즐겨 사용하는 BI (비즈니스 인텔리전스) 응용 프로그램과 통합할 수 있습니다. 드라이버를 다운로드하려면 여기
다음 표에는 드라이버의 버전 호환성이 요약되어 있습니다.
ODBC 드라이버
오픈 데이터베이스 연결(ODBC) 드라이버는 Microsoft Excel
OpenSearch 아티팩트