REST API 버전(Azure AI Search)
이 문서에서는 Azure AI Search용 Search REST API의 현재 및 이전 버전을 나열합니다.
버전이 지정된 API 문서
이제 REST API 문서의 버전이 지정됩니다. API 참조 페이지를 열면 버전 선택기가 목차 위에 표시됩니다.
참조 > 데이터 평면을 확장합니다.
API 참조 페이지를 선택합니다.
왼쪽 위에 있는 드롭다운 필터에서 API 버전을 선택합니다.
안정적인 버전
API 버전 | 사양 | API 업데이트 |
---|---|---|
2023-11-01 (최신) |
Swagger 사양 | 릴리스 정보 |
2020-06-30 |
Swagger 사양 | 릴리스 정보 |
2019-05-06 |
Swagger 사양 | 복합 형식을 추가합니다. |
2017-11-11 |
Swagger 사양 | 기술 세트 및 AI 보강을 추가합니다. |
2016-09-01 |
Swagger 사양 | 인덱서를 추가합니다. |
2015-02-28 |
10-10-2020 이후 지원되지 않음 | 첫 번째 일반 공급 릴리스. |
미리 보기 버전
미리 보기 버전은 새 기능을 테스트하고, 피드백을 수집하고, 문제를 검색하고 해결하기 위해 릴리스됩니다. 미리 보기 API는 Microsoft Azure Preview에 대한 추가 사용 약관에 따라 사용할 수 있습니다.
API 버전 | 사양 | API 업데이트 |
---|---|---|
2023-10-01-Preview |
Swagger 사양 | 릴리스 정보 |
2023-07-01-Preview |
Swagger 사양 | 릴리스 정보 |
2021-04-30-Preview |
Swagger 사양 | 릴리스 정보 |
2020-06-30-Preview |
Swagger 사양 | 릴리스 정보 |
2019-05-06-Preview |
Swagger 사양 | 릴리스 정보 |
2017-11-11-Preview |
Swagger 사양 | 안정적인 버전과 연결된 미리 보기 버전입니다. |
2016-09-01-Preview |
Swagger 사양 | 안정적인 버전과 연결된 미리 보기 버전입니다. |
2015-02-28-Preview |
10-10-2020 이후 지원되지 않음 | 안정적인 버전과 연결된 미리 보기 버전입니다. |
2014-10-20-Preview |
10-10-2020 이후 지원되지 않음 | 두 번째 공개 미리 보기입니다. |
2014-07-31-Preview |
10-10-2020 이후 지원되지 않음 | 첫 번째 공개 미리 보기입니다. |
릴리스 정보
2023-11-01
이 버전은 다음을 포함하여 일반적으로 사용할 수 있는 기능을 제공합니다.
- 검색 게시물 요청의 의미 체계 순위입니다.
- 인덱스 요청 만들기 또는 업데이트의 벡터 검색 인덱싱 및 검색 게시물 요청의 벡터 쿼리
2023-10-01-Preview
이 버전에는 이전 미리 보기에 도입된 모든 기능과 벡터 검색 API에 대한 추가 및 수정 사항이 포함되어 있습니다. 벡터 검색 API에 대한 업데이트 2023-07-01-Preview의 호환성이 손상되는 변경입니다. 마이그레이션 도움말 은 벡터 필드 추가 및 벡터 쿼리 만들기 를 참조하세요.
새 사전 필터링 기능을 사용하려는 경우 2023-10-01 이후에 만든 인덱스 를 사용해야 합니다.
vectorSearch
에는 ,profiles
및 에 대한algorithms
정의가 있습니다vectorizers
.algorithms
은 HNSW(계층적 탐색 가능 Small World) 및 eKNN(완전 K-가장 가까운 인접)을 참조하여 를 계속 지원hnsw
eknn
합니다. 알고리즘 섹션 내에서 HNSW 및 eKNN 매개 변수의 여러 명명된 조합을 정의할 수 있습니다. 이는 2023-07-01-Preview의 속성 내에서vectorSearch
대체됩니다algorithmConfigurations
.profiles
는 알고리즘 구성을 지정하는 새 정의입니다. 예를 들어 HNSW-1, HSNW-2, eKNN-1이라는 알고리즘 구성이 있다고 가정합니다. 프로필은 HNSW-1을 지정할 수 있습니다.vectorizers
가 표시되지만 현재는 무시됩니다.
벡터 필드에서 를
vectorSearchProfile
대체합니다vectorSearchConfiguration
. 속성은vectorSearchProfile
필드에서 사용할 벡터 검색 프로필을 지정합니다.이 API 버전 이전에 만든 인덱스에서 2023-10-01-Preview API를 호출할 때 요청에서 프로필이 이전에 지정된
vectorSearchConfiguration
것과 동일한 알고리즘을vectorSearchProfile
지정하는 한 필드를 변경하여 를 지정해야 합니다. 예를 들어 기존 필드 정의가 를 지정"vectorSearchConfiguration": "myHnsw"
하는 경우 를 로"vectorSearchProfile": "your profile name"
바꿔야 하며, 동일한"algorithm": "myHnsw"
를 참조하려면 프로필을 정의해야 합니다.
vectorQueries
vectors
2023-07-01-Preview에서 교체vectorQueries.vectors
는 2023-07-01-Preview에서 를 대체합니다vectors.values
.이제 벡터 쿼리가 다형 구조입니다.
kind
요청되는 벡터 쿼리의 형식을 나타내려면 를 지정해야 합니다."kind": "vector"
는 쿼리가 벡터이므로 호출자가 검색 쿼리 문자열을 벡터 포함으로 이미 벡터화했어야 했음을 의미합니다.
"exhaustive": "true"
는 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 인접 검색을 수행할지 여부를 지정하는 새 속성입니다.vectorFilterMode
는 쿼리에서 사전 필터링(2023-10-01 이후 생성된 인덱스의 기본값) 또는 사후 필터링(이전 인덱스의 기본값)을 지정하기 위한 새 매개 변수입니다.
2023-07-01-Preview
이 버전에는 이전 미리 보기에 도입된 모든 기능과 벡터 검색 지원이 포함됩니다.
검색 인덱스에서 단정밀도 부동 소수점 숫자 배열이 포함된 필드에 데이터 형식을 할당
Collection(Edm.Single)
합니다. 이는 문서 필드당 하나의 생성된 포함을 저장하는 데 사용되는 새 벡터 검색 기능의 데이터 형식입니다. 또한 검색 인덱스에서 벡터 구성 속성을 지정합니다. 이러한 API에 대한 인덱스 만들기 또는 업데이트를 참조하세요.인덱싱 워크로드는 벡터 데이터를 허용하도록 업데이트됩니다. 문서 추가, 업데이트 또는 삭제를 참조하세요.
벡터 검색에 대한 쿼리 매개 변수입니다. 이러한 매개 변수는 문서 검색 을 참조하세요.
서비스 통계 가져오기: 서비스에 대한 벡터 인덱스 할당량 및 사용량을 반환합니다.
인덱스 통계 가져오기: 검색 인덱스에 대한 벡터 인덱스 할당량 및 사용량을 반환합니다.
2021-04-30-미리 보기
이 미리 보기 버전에는 2020-06-30-Preview에 도입된 모든 기능과 다음 API가 추가되었습니다.
인덱스 별칭은 쿼리 및 인덱싱 요청에서 인덱스를 참조하는 데 사용되는 보조 이름을 추가합니다. 별칭 작업에는 만들기, 업데이트, 삭제, 가져오기 및 목록이 포함됩니다.
아웃바운드 연결에 대한 관리 ID입니다. 데이터 원본 만들기 또는 업데이트의 연결 문자열에 대한 새 값은 하드 코딩된 데이터베이스 자격 증명 또는 키 대신 Microsoft Entra ID 인증 및 역할을 사용하여 연결을 지원합니다.
관리 ID 지원은 고객 관리형 암호화를 사용하여 기본 암호화를 보완하는 검색 솔루션에 대해 키 자격 증명 모음 연결에도 지원됩니다.
텍스트 번역 인식 기술에 대한 추가 언어입니다.
문서 검색(미리 보기)에서 의미 체계 검색 및 맞춤법 검사기용 추가 queryLanguages입니다.
선택적으로 문서 검색(미리 보기)에서 의미 체계 검색에서 캡션을 요청하는 캡션 매개 변수입니다.
의미 체계 구성은인덱스 만들기 또는 업데이트에 지정됩니다. 의미 체계 구성은 의미 체계 순위, 캡션, 강조 표시 및 답변에 사용해야 하는 필드를 결정합니다.
문서 검색(미리 보기)의 의미 체계 쿼리에 필요한 semanticConfiguration 매개 변수입니다.
2020-06-30
이 버전은 다음을 포함하여 일반적으로 사용할 수 있는 기능을 제공합니다.
- 데이터 평면 작업에 대한 Azure 역할 기반 액세스 제어
- 관련성 점수 매기기(BM25)
- 지식 저장소
- ADLS(Azure Data Lake Storage) Gen2에 대한 인덱서 데이터 원본
- 사용자 지정 엔터티 조회 기술
- Microsoft Entra ID 통해 시스템 또는 사용자 관리 ID에서 실행되는 인덱서
2020-06-30-Preview
이 미리 보기 버전에는 2019-05-06-Preview에 도입된 모든 기능과 다음 추가 기능이 포함되어 있습니다.
- 의미 체계 검색은 표준 계층 서비스에서 실행되고 의미 체계 순위를 호출하는 프리미엄 기능입니다.
- Power Query 커넥터에 대한 인덱서 데이터 원본
- MySQL에 대한 인덱서 데이터 원본
- Cosmos DB Gremlin API에 대한 인덱서 데이터 원본
- SharePoint Online의 인덱서 데이터 원본
- 대/소문자를 구분하지 않는 필터링, 패싯 및 정렬을 위한 텍스트 정규화의 Normalizer 속성
- ID별로 특정 문서를 구체적으로 새로 고치도록 인덱서 기반 인덱싱을 위한 문서 다시 설정
- 엔터티 연결 인식 기술(v3)
- 엔터티 인식 기술(v3)
- 감정 분석 인지 기술(v3)
2019-05-06-Preview
- Cosmos DB MongoDB API에 대한 인덱서 데이터 원본 지원
- Blob Storage에서 네이티브 Blob 일시 삭제에 대한 인덱서 데이터 원본
- featuresMode 관련성 점수에 대한 자세한 정보를 반환하는 매개 변수
- AML(Azure Machine Learning) 인지 기술
- 개인 식별 감지 인지 기술
- 이미지 처리(및 기타 AI 보강)를 보존하고 재사용하기 위해 보강된 문서 캐시