FT.CREATE

FT.CREATE는 검색 가능한 색인을 만듭니다.

구문

FT.CREATE index
  ON HASH
  [PREFIX count prefix [prefix ...]]
  SCHEMA field_name [AS alias] VECTOR [HNSW|FLAT] attribute_count [attribute_name attribute_value])
  • index(필수): 색인에 지정하는 이름입니다. 이름이 같은 색인이 이미 있으면 오류가 반환됩니다.

  • ON HASH(선택사항): HASH 데이터 유형을 나타냅니다. HASH 데이터 유형만 지원됩니다.

  • PREFIX [count] [prefix](선택사항): 색인을 생성할 해시 키를 나타냅니다.

  • SCHEMA hash_field_name(필수): SCHEMA 다음의 hash_field_name은 해시에서 필드 이름을 식별합니다. [AS alias] VECTOR는 VECTOR 이름을 필드 이름 속성의 별칭으로 할당합니다.

필드 유형

  • VECTOR(필수): 벡터 검색을 위한 벡터 필드입니다.

    • [HNSW|FLAT](필수): 지정된 알고리즘입니다. FLAT(무차별 대입) 또는 HNSW(Hierarchical Navigable Small World)입니다.

    • attribute_count(필수): 알고리즘 구성에 전달된 이름과 값의 총 속성 수입니다.

    • attribute_name attribute_value: 색인 구성을 정의하지만 사용 가능한 두 가지 알고리즘 중 하나와 관련된 키-값 쌍입니다.

      • 필수 HNSW 알고리즘 속성은 다음과 같습니다.

        • DIM(필수): 벡터 측정기준 수입니다. 허용되는 값은 1~32768입니다.

        • TYPE(필수): 벡터 유형입니다. FLOAT32만 지원됩니다.

        • DISTANCE_METRIC(필수): L2, IP, COSINE 중 하나여야 합니다.

      • 선택적 HNSW 알고리즘 속성은 다음과 같습니다.

        • EF_RUNTIME(선택사항): 쿼리 작업 중에 검사할 벡터 수를 설정합니다. 기본값은 10이고 최댓값은 4096입니다. 실행하는 쿼리마다 이 매개변수 값을 설정할 수 있습니다. 값이 클수록 쿼리 시간이 늘어나지만 쿼리 재현율이 향상됩니다.

        • M(선택사항): 각 레이어의 그래프에 있는 노드마다 허용되는 최대 발신 에지 수입니다. 레이어 0의 최대 발신 에지 수는 2,000,000입니다. 기본값은 16입니다. 최댓값은 512입니다.

        • EF_CONSTRUCTION(선택사항): 색인 생성 중에 검사할 벡터 수를 설정합니다. 기본값은 200이고 최댓값은 4096입니다. 값이 클수록 색인을 만드는 데 필요한 시간이 늘어나지만 재현율 비율이 향상됩니다.

        • INITIAL_CAP(선택사항): 색인의 시작 벡터 용량을 결정합니다. 기본값은 1024입니다. 이 매개변수는 색인 메모리 할당을 결정합니다.

      • 필수 FLAT 알고리즘 속성은 다음과 같습니다.

        • DIM(필수): 벡터 측정기준 수입니다.

        • TYPE(필수): 벡터 유형입니다. FLOAT32만 지원됩니다.

        • DISTANCE_METRIC(필수): L2, IP, COSINE 중 하나여야 합니다.

      • 선택적 FLAT 알고리즘 속성은 다음과 같습니다.

        • INITIAL_CAP(선택사항): 색인의 시작 벡터 용량을 결정합니다. 이 매개변수는 색인 메모리 할당을 결정합니다.

예시

HNSW 예시는 다음과 같습니다.

FT.CREATE my_index_name SCHEMA my_hash_field_key VECTOR HNSW 10 TYPE FLOAT32 DIM 20 DISTANCE_METRIC COSINE M 4 EF_CONSTRUCTION 100

FLAT 예시는 다음과 같습니다.

FT.CREATE my_index_name SCHEMA my_hash_field_key VECTOR Flat 8 TYPE FLOAT32 DIM 20 DISTANCE_METRIC COSINE INITIAL_CAP 15000