다음을 통해 공유

Azure AI 검색에서 인덱스 별칭 만들기

  • 아티클

Important

인덱스 별칭은 현재 공개 미리 보기로 제공되며 보충 사용 약관에 따라 사용할 수 있습니다.

Azure AI 검색에서 인덱스 별칭은 쿼리, 인덱싱 및 기타 작업에 대한 인덱스를 참조하는 데 사용할 수 있는 보조 이름입니다. 검색 인덱스에 매핑되는 별칭을 만들고, 그렇지 않으면 인덱스 이름을 참조하는 위치에서 별칭 이름을 대체할 수 있습니다. 별칭은 애플리케이션이 가리키는 인덱스를 변경해야 하는 경우 유연성을 더합니다. 애플리케이션에서 참조를 업데이트하는 대신 별칭에 대한 매핑만 업데이트할 수 있습니다.

인덱스 별칭의 주요 목표는 프로덕션 인덱스를 더 쉽게 관리할 수 있도록 하는 것입니다. 예를 들어 필드 편집 또는 새 분석기 추가와 같이 인덱스 정의를 변경해야 하는 경우 모든 검색 인덱스를 변경할 수 없으므로 새 검색 인덱스를 만들어야 합니다. 즉, 인덱스를 삭제하고 다시 작성하거나 새 인덱스를 만든 다음, 애플리케이션을 해당 인덱스로 마이그레이션해야 합니다.

인덱스를 삭제하고 다시 빌드하는 대신 인덱스 별칭을 사용할 수 있습니다. 일반적인 워크플로는 다음과 같습니다.

  1. 검색 인덱스 만들기
  2. 검색 인덱스에 매핑되는 별칭 만들기
  3. 애플리케이션에서 쿼리/인덱싱 요청을 인덱스 이름이 아닌 별칭으로 보내도록 합니다.
  4. 다시 작성이 필요한 인덱스를 변경해야 하는 경우 새 검색 인덱스를 만듭니다.
  5. 새 인덱스가 준비되면 별칭을 업데이트하여 새 인덱스에 매핑하고 요청은 자동으로 새 인덱스로 라우팅됩니다.

인덱스 별칭 만들기

미리 보기 REST API, 미리 보기 SDK 또는 Azure Portal을 통해 별칭을 만들 수 있습니다. 별칭은 별칭의 name과 별칭이 매핑되는 검색 인덱스의 이름으로 구성됩니다. indexes 배열에는 하나의 인덱스 이름만 지정할 수 있습니다.

별칭 만들기 또는 업데이트(REST 미리 보기)를 사용하여 인덱스 별칭을 만들 수 있습니다.

POST /aliases?api-version=2024-05-01-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index"]
}

인덱스 별칭에 요청 보내기

별칭을 만들면 사용할 준비가 된 것입니다. 별칭은 쿼리, 인덱싱, 제안 및 자동 완성을 포함한 모든 문서 작업에 사용할 수 있습니다.

아래 쿼리에서 요청을 hotel-samples-index에 보내는 대신 my-alias에 요청을 보낼 수 있으며 그에 따라 라우팅됩니다.

POST /indexes/my-alias/docs/search?api-version=2024-05-01-preview
{
    "search": "pool spa +airport",
    "searchMode": any,
    "queryType": "simple",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

프로덕션 인덱스를 업데이트해야 하는 경우 클라이언트 쪽 애플리케이션의 인덱스 이름 대신 별칭을 지정합니다. 인덱스를 다시 빌드해야 하는 시나리오는 인덱스 드롭 및 다시 빌드에 설명되어 있습니다.

참고 항목

문서 작업에서 별칭만 사용하거나 인덱스 정의를 가져오고 업데이트할 수 있습니다. 별칭은 인덱스를 삭제하는 데 사용할 수 없으며 Analyze Text API와 함께 사용할 수 없으며 인덱서에서 targetIndexName으로 사용할 수 없습니다.

별칭에 대한 업데이트는 시스템을 통해 전파되는 데 최대 10초가 걸릴 수 있으므로 매핑되었거나 최근에 별칭에 매핑된 인덱스에서 작업을 수행하기 전에 최소 10초 동안 기다려야 합니다.

인덱스 교환

이제 새 인덱스를 가리키도록 애플리케이션을 업데이트해야 할 때마다 별칭의 매핑을 업데이트하기만 하면 됩니다. PUT는 별칭 만들기 또는 업데이트(REST 미리 보기)에 설명된 대로 업데이트에 필요합니다.

PUT /aliases/my-alias?api-version=2024-05-01-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index2"]
}

별칭을 업데이트하면 요청이 자동으로 새 인덱스로 라우팅되기 시작합니다.

참고 항목

별칭에 대한 업데이트는 전파하는 데 최대 10초가 걸릴 수 있으므로 별칭이 이전에 매핑된 인덱스를 삭제하기 전에 10초 이상 기다려야 합니다.

참고 항목