SearchHint

검색 색인 엔진에 대한 힌트를 나타냅니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "useIndex": {
    object (IndexHint)
  },
  "useKnn": boolean,
  "knnHint": {
    object (KnnHint)
  },
  "indexHint": {
    object (IndexHint)
  }
  // End of mutually exclusive fields.
}
필드
사용할 색인 유형입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
useIndex
(deprecated)

object (IndexHint)

(선택사항) 지원 중단됨: 대신 indexHint을 사용하세요. 검색에서 특정 색인을 사용해야 함을 지정합니다.
useKnn
(deprecated)

boolean

(선택사항) 지원 중단됨: 대신 knnHint을 사용하세요. true로 설정하면 검색에서 시스템의 기본 K-최근접 이웃 (KNN) 색인 엔진을 사용합니다.
knnHint

object (KnnHint)

(선택사항) 설정된 경우 검색에서 시스템의 기본 K-최근접 이웃 (KNN) 색인 엔진을 사용합니다.
indexHint

object (IndexHint)

(선택사항) 검색에서 특정 색인을 사용해야 함을 지정합니다.
상호 배타적 필드의 끝입니다.

IndexHint

검색에 사용할 색인을 지정하는 메시지입니다.

JSON 표현 
{
  "name": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "denseScannParams": {
    object (DenseScannParams)
  }
  // End of mutually exclusive fields.
}
필드
name

string

필수 항목입니다. 검색에 사용할 색인의 리소스 이름입니다. 색인은 동일한 프로젝트, 위치, 컬렉션에 있어야 합니다. 형식: projects/{project}/locations/{location}/collections/{collection}/indexes/{index}
색인의 매개변수입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
denseScannParams

object (DenseScannParams)

(선택사항) 밀집 ScaNN 매개변수입니다.
상호 배타적 필드의 끝입니다.

DenseScannParams

밀도 높은 ScaNN의 파라미터입니다.

JSON 표현 
{
  "searchLeavesPct": integer,
  "initialCandidateCount": integer,
  "targetRecall": number
}
필드
searchLeavesPct

integer

(선택사항) 재현율과 지연 시간을 제어하기 위해 재정의되는 밀도 높은 ANN 매개변수입니다. 검색할 리프의 비율입니다(범위: [0, 100]). STORAGE_OPTIMIZED 색인에는 지원되지 않습니다. targetRecall와 함께 설정할 수 없습니다.
initialCandidateCount

integer

(선택사항) 초기 후보 수입니다. 양의 정수 (> 0)여야 합니다. STORAGE_OPTIMIZED 색인에는 지원되지 않습니다. targetRecall와 함께 설정할 수 없습니다.
targetRecall

number

(선택사항) 검색의 타겟 재현율입니다. [0, 1] 범위의 double이어야 합니다. 검색은 이 수준의 재현율을 달성하는 것을 목표로 하지만 보장되지는 않습니다.

KnnHint

이 유형에는 필드가 없습니다.

검색을 시스템의 기본 K-최근접 이웃 (KNN) 색인 엔진에서 명시적으로 실행해야 하는 경우 KnnHint가 사용됩니다.