이 페이지에서는 컨테이너 배포 옵션을 사용하여 AlloyDB Omni 버전 17.5.0을 설명합니다. 다른 배포 옵션을 선택합니다.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

AlloyDB Omni에서 OpenSearch 데이터에 액세스

문서 버전 선택:

AlloyDB Omni의 외부 검색 통합을 사용하여 OpenSearch에 저장된 데이터에 액세스하고 검색할 수 있습니다. 이 통합을 사용하면 데이터를 복사하거나 이동하지 않고도 기존 OpenSearch 색인과 관계형 테이블에서 통합 검색을 실행할 수 있습니다.

시작하기 전에

시작하기 전에 다음을 완료하세요.

컨테이너를 사용하여 AlloyDB Omni를 설치합니다.
액세스 가능한 공개 엔드포인트로 OpenSearch를 배포하고 구성합니다.
OpenSearch 클러스터에서 보안 플러그인을 사용 설정하고 내부 사용자 데이터베이스에서 읽기 전용 사용자를 만듭니다. AlloyDB Omni는 이러한 사용자 인증 정보를 사용하여 OpenSearch 클러스터에 액세스합니다.

Secret Manager에 OpenSearch 사용자 인증 정보 저장

AlloyDB Omni는 Secret Manager에서 OpenSearch 사용자 인증 정보를 저장하고 읽습니다. 기본 HTTP 인증의 경우 Secret Manager의 보안 비밀 값은 username:password 형식의 문자열이어야 합니다. Secret Manager 사용 방법에 대한 자세한 내용은 Secret Manager를 사용하여 보안 비밀 만들기 및 액세스를 참조하세요.

AlloyDB Omni에서 사용하는 서비스 계정에 Secret Manager에서 보안 비밀을 읽을 수 있는 secretmanager.secretAccessor 권한이 있는지 확인합니다. 자세한 내용은 보안 비밀에 대한 액세스 관리를 참조하세요.

`external_search_fdw` 확장 프로그램 사용 설정 및 구성

OpenSearch와의 통합을 시작하려면 외부 데이터 서버를 통해 OpenSearch 클러스터에 대한 액세스를 구성합니다.

데이터베이스에 연결하고 확장 프로그램을 사용 설정합니다.
```
CREATE EXTENSION external_search_fdw;
```
외부 서버를 만듭니다.
```
CREATE SERVER OPENSEARCH_SERVER_NAME
FOREIGN DATA WRAPPER external_search_fdw
OPTIONS (
  server 'OPENSEARCH_SERVER_HOST_PORT',
  search_provider 'opensearch',
  auth_mode 'secret_manager',
  auth_method 'AUTH_METHOD',
  secret_path 'SECRET_PATH'
);
```
다음 변수를 바꿉니다.
- OPENSEARCH_SERVER_NAME: 외부 데이터 서버의 이름입니다. 예를 들면 opensearch입니다.
- OPENSEARCH_SERVER_HOST_PORT: OpenSearch 클러스터의 공개 URL입니다. 예를 들면 https://search-my-domain.us-east-1.es.amazonaws.com:443입니다.
- AUTH_METHOD: 사용할 인증 유형입니다. 예를 들면 Basic입니다.
- SECRET_PATH: OpenSearch 인증 사용자 인증 정보의 Secret Manager 경로입니다. 예를 들면 projects/PROJECT_ID/secrets/opensearch-credentials/versions/1입니다.

OpenSearch 서버의 사용자 매핑을 정의합니다.

CREATE USER MAPPING FOR CURRENT_USER
SERVER OPENSEARCH_SERVER_NAME;

OpenSearch 색인의 스키마를 PostgreSQL 외부 테이블에 매핑합니다.
```
CREATE FOREIGN TABLE OPENSEARCH_FD_TABLE(
    metadata external_search_fdw_schema.OpaqueMetadata,
    OPENSEARCH_FIELDS)
       SERVER OPENSEARCH_SERVER_NAME
       OPTIONS(
            remote_table_name 'OPENSEARCH_INDEX_NAME'
       );
```
다음 변수를 바꿉니다.
- OPENSEARCH_FD_TABLE: OpenSearch 테이블을 나타내는 외부 데이터 테이블의 이름입니다. 예를 들면 my-fd-opensearch-table입니다.
- OPENSEARCH_FIELDS: 각 항목이 opensearch_field_name PG_DATA_TYPE 형식을 따르는 쉼표로 구분된 목록입니다. 지원되는 OpenSearch 데이터 유형 및 해당 PostgreSQL 유형의 목록은 지원되는 데이터 유형을 참조하세요.
- OPENSEARCH_INDEX_NAME: OpenSearch 색인의 이름입니다. 예를 들면 my-opensearch-index입니다.

OpenSearch 데이터 쿼리

AlloyDB Omni는 SQL 쿼리를 OpenSearch REST API 쿼리로 변환합니다.

표준 SQL 쿼리

검색 표현식에 Lucene 구문과 함께 표준 SQL을 사용할 수 있습니다.

SELECT id, body
FROM OPENSEARCH_FD_TABLE
WHERE FILTER
ORDER BY metadata <@> 'QUERY';

다음 변수를 바꿉니다.

OPENSEARCH_FD_TABLE: OpenSearch 테이블을 나타내는 외부 데이터 테이블의 이름입니다. 예를 들면 my-fd-opensearch-table입니다.
FILTER: (선택사항) OpenSearch 쿼리에 적용할 필터입니다. 예를 들면 a = 10 AND b < 105입니다.
QUERY: OpenSearch로 전송할 쿼리입니다. 예를 들면 body:database입니다.

DSL 쿼리

고급 사용 사례의 경우 OpenSearch JSON 스타일 쿼리 도메인 특정 언어 (DSL)를 사용합니다.

SELECT id, title
FROM OPENSEARCH_FD_TABLE
ORDER BY metadata <@> $${
  "query": {
    "bool": {
      "must": { "match": { "title": "opensearch" } },
      "filter": { "term": { "category": "software" } }
    }
  },
  "sort": [
    { "price": { "order": "desc" } }
  ]
}$$
LIMIT 1;

OPENSEARCH_FD_TABLE을 OpenSearch 테이블을 나타내는 외부 데이터 테이블의 이름으로 바꿉니다. 예를 들면 my-fd-opensearch-table입니다.

하이브리드 검색

OpenSearch 데이터에서 하이브리드 검색을 실행하려면 OpenSearch 토큰 검색 결과를 AlloyDB Omni 벡터 검색 결과와 조인합니다.

SELECT *
FROM ai.hybrid_search(
  ARRAY[
    '{"limit": LIMIT,
      "weight": WEIGHT,
      "table_name": "OPENSEARCH_FD_TABLE",
      "key_column": "id",
      "query_text_input": "QUERY"}'::jsonb
  ])
ORDER BY score DESC;