기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon OpenSearch Service의 특정 시점 검색
특정 시점(PIT) 기능은 고정된 데이터세트에 대해 다양한 쿼리를 실행할 수 있는 검색 유형입니다. 문서가 계속해서 인덱싱, 업데이트 및 삭제되기 때문에 서로 다른 시점에 동일한 인덱스에서 동일한 쿼리를 실행하면 다른 결과가 나타나는 경우가 일반적입니다. PIT를 사용하면 데이터 세트의 상수 상태를 기준으로 쿼리할 수 있습니다.
PIT 검색의 주요 용도는 `search_after` 기능과 결합하는 것입니다. 이는 OpenSearch에서 선호되는 페이지 매김 메서드이며, 시간 제한이 있는 데이터 집합에서 작동하고 쿼리에 바인딩되지 않으며 앞뒤로 일관된 페이지 매김을 지원하기 때문에 특히 딥 페이지 매김의 경우에 선호됩니다. OpenSearch 버전 2.5를 실행하는 도메인에서 PIT를 사용할 수 있습니다.
**참고**
이 주제에서는 PIT 개요 그리고 자체 관리형 OpenSearch 클러스터가 아닌 관리형 Amazon OpenSearch Service 도메인에서 PIT를 사용할 때 고려해야 할 몇 가지 사항을 제공합니다. 포괄적인 API 참조를 포함한 PIT의 전체 설명서는 오픈 소스 OpenSearch 설명서의 [특정 시점](https://opensearch.org/docs/latest/opensearch/point-in-time/)을 참조하세요.
## 고려 사항
PIT 검색을 구성할 때 다음 사항을 고려하세요.
+ OpenSearch 버전 2.3을 실행하는 도메인에서 업그레이드하고 PIT 작업에 대한 세분화된 액세스 제어가 필요한 경우 해당 작업과 역할을 수동으로 추가해야 합니다.
+ PIT에 대한 복원성이 없습니다. 노드 재부팅, 노드 종료, 블루/그린 배포, EOpenSearch 프로세스 재시작으로 인해 모든 PIT 데이터가 손실됩니다.
+ 블루/그린 배포 중에 샤드가 재배치되는 경우 라이브 데이터 세그먼트만 새 노드로 전송됩니다. PIT가 보유한 샤드 세그먼트(단독 및 라이브 데이터와 공유된 샤드 세그먼트 모두)는 이전 노드에 그대로 남아 있습니다.
+ PIT 검색은 현재 비동기 검색에서는 작동하지 않습니다.
## PIT 생성
PIT 쿼리를 실행하려면 다음 형식을 사용하여 `_search/point_in_time`에 HTTP 요청을 전송합니다.
```
POST opensearch-domain/my-index/_search/point_in_time?keep_alive=time
```
다음 PIT 옵션을 지정할 수 있습니다.
| 옵션 | 설명 | 기본값 | 필수 |
| --- | --- | --- | --- |
| keep\$1alive | PIT를 보존하는 시간입니다. 검색 요청으로 PIT에 액세스할 때마다 PIT 수명이 `keep_alive` 파라미터와 동일한 시간만큼 연장됩니다. 이 쿼리 파라미터는 PIT를 생성할 때는 필수이지만 검색 요청에서는 선택 사항입니다. | | 예 |
| preference | 검색을 수행하는 데 사용되는 노드 또는 샤드를 지정하는 문자열입니다. | 무작위 | 아니요 |
| routing | 검색 요청을 특정 샤드로 라우팅하도록 지정하는 문자열입니다. | 문서의 \$1id | 아니요 |
| expand\$1wildcards | 와일드카드 패턴과 일치할 수 있는 인덱스 유형을 지정하는 문자열입니다. 쉼표로 분리된 값을 지원합니다. 유효한 값은 다음과 같습니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/opensearch-service/latest/developerguide/pit.html) | open | 아니요 |
| allow\$1partial\$1pit\$1creation | 부분 오류가 있는 PIT를 생성할지 여부를 지정하는 부울입니다. | true | 아니요 |
**샘플 응답**
```
{
"pit_id": "o463QQEPbXktaW5kZXgtMDAwMDAxFnNOWU43ckt3U3IyaFVpbGE1UWEtMncAFjFyeXBsRGJmVFM2RTB6eVg1aVVqQncAAAAAAAAAAAIWcDVrM3ZIX0pRNS1XejE5YXRPRFhzUQEWc05ZTjdyS3dTcjJoVWlsYTVRYS0ydwAA",
"_shards": {
"total": 1,
"successful": 1,
"skipped": 0,
"failed": 0
},
"creation_time": 1658146050064
}
```
PIT를 생성하면 응답으로 PIT ID를 받게 됩니다. PIT로 검색을 수행하는 데 사용하는 ID입니다.
## 특정 시점 권한
PIT는 [세분화된 액세스 제어](fgac.md)를 지원합니다. OpenSearch 버전 2.5 도메인으로 업그레이드하고 세분화된 액세스 제어가 필요한 경우 다음 권한이 있는 역할을 수동으로 생성해야 합니다.
```
# Allows users to use all point in time search search functionality
point_in_time_full_access:
reserved: true
index_permissions:
- index_patterns:
- '*'
allowed_actions:
- "indices:data/read/point_in_time/create"
- "indices:data/read/point_in_time/delete"
- "indices:data/read/point_in_time/readall"
- "indices:data/read/search"
- "indices:monitor/point_in_time/segments"
# Allows users to use point in time search search functionality for specific index
# All type operations like list all PITs, delete all PITs are not supported in this case
point_in_time_index_access:
reserved: true
index_permissions:
- index_patterns:
- 'my-index-1'
allowed_actions:
- "indices:data/read/point_in_time/create"
- "indices:data/read/point_in_time/delete"
- "indices:data/read/search"
- "indices:monitor/point_in_time/segments"
```
OpenSearch 버전 2.5 이상인 도메인의 경우 기본 제공 `point_in_time_full_access` 역할을 사용할 수 있습니다. 자세한 내용은 OpenSearch 설명서의 [보안 모델]( https://opensearch.org/docs/latest/search-plugins/point-in-time/#security-model)을 참조하세요.
## PIT 설정
OpenSearch를 사용하면 `_cluster/settings` API를 사용하여 사용 가능한 모든 [PIT 설정](https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#pit-settings)을 변경할 수 있습니다. OpenSearch Service에서는 현재 설정을 수정할 수 없습니다.
## 클러스터 간 검색
다음과 같은 사소한 제한 사항을 제외하고 PIT를 생성하고, PIT ID로 검색하고, PIT를 나열하고, 클러스터 전체에서 PIT를 삭제할 수 있습니다.
+ 소스 도메인에서만 PIT를 모두 나열하고 삭제할 수 있습니다.
+ 클러스터 간 검색 쿼리의 일부로 네트워크 왕복을 최소화할 수 없습니다.
자세한 내용은 [Amazon OpenSearch Service의 교차 클러스터 검색](cross-cluster-search.md) 단원을 참조하십시오.
## UltraWarm
UltraWarm 인덱스를 사용한 PIT 검색은 계속 작동합니다. 자세한 내용은 [Amazon OpenSearch Service를 위한 UltraWarm 스토리지](ultrawarm.md) 단원을 참조하십시오.
**참고**
CloudWatch에서 PIT 검색 통계를 모니터링할 수 있습니다. 전체 지표 목록은 [특정 시점 지표](managedomains-cloudwatchmetrics.md#managedomains-cloudwatchmetrics-pit) 섹션을 참조하세요.