인덱스 가속 필드 구성 수정¶
POST /api/v1/workspace/index_speed_field/modify
개요¶
인덱스 쿼리 가속 필드 구성을 설정합니다.
현재 ScopeDB 스토리지 엔진의 로그 유형 인덱스만 지원합니다.
인덱스 정보는 日志-索引-列表 인터페이스에서 가져옵니다.
인덱스 필드 정보는 dql 구문 SHOW_LOGGING_FIELD(index='xx')으로 조회할 수 있습니다.
fieldSpeedConfig는 순서대로 필드 단위로 실행되며, 첫 번째 실패가 발생하면 즉시 오류가 반환되고 이후 필드는 더 이상 실행되지 않습니다. 이전에 성공한 항목은 유지되며 일괄 롤백은 수행되지 않습니다.
호출자는 오류를 처리한 후 동일한 목록을 다시 제출할 수 있습니다. 기존 인덱스는 하위 단계의 멱등 처리를 따르며, 수량 제한은 변경되지 않고 프로그램 내 자동 재시도도 추가되지 않습니다.
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| fieldSpeedConfig | array | 필드 가속 구성 빈 값 허용: False |
|
| fieldSpeedConfig[*] | None | ||
| fieldSpeedConfig[*].index | string | 인덱스 이름, 로그 인덱스 목록의 name 필드에서 가져옵니다예: default 빈 값 허용: False |
|
| fieldSpeedConfig[*].field | string | Y | 필드 예: dest_host 빈 값 허용: False |
| fieldSpeedConfig[*].enable | boolean | Y | 활성화 여부 예: False 빈 값 허용: False |
| fieldSpeedConfig[*].indexType | string | 인덱스 유형, 빈 값 또는 materialized는 일반/구체화 인덱스를 의미하며 search는 역색인 추가를 의미합니다 예: search 빈 값 허용: True 빈 문자열 허용: True |
|
| namespace | string | 네임스페이스, dql에서 namespace 전체 이름은 소문자입니다 빈 값 허용: False |
|
| source | string | 소스 빈 값 허용: False |
매개변수 추가 설명¶
요청 예시¶
curl 'https://openapi.guance.com/api/v1/workspace/index_speed_field/modify' \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"namespace":"logging","fieldSpeedConfig":[{"index":"default","field":"dest_host","enable":false}]}' \
--insecure