Documents - Index

참조

Service:: Search Service

API Version:: 2023-10-01-Preview

문서 쓰기 작업의 일괄 처리를 인덱스에 보냅니다.

POST {endpoint}/indexes('{indexName}')/docs/search.index?api-version=2023-10-01-Preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	검색 서비스의 엔드포인트 URL입니다.
indexName	path	True	string	인덱스의 이름입니다.
api-version	query	True	string	클라이언트 API 버전.

요청 헤더

Name	필수	형식	Description
x-ms-client-request-id		string uuid	디버깅에 도움이 되도록 요청과 함께 전송된 추적 ID입니다.

요청 본문

Name	필수	형식	Description
value	True	IndexAction[]	일괄 처리의 작업입니다.

응답

Name	형식	Description
200 OK	IndexDocumentsResult	일괄 처리의 모든 작업에 대한 작업의 상태 포함하는 응답입니다.
Other Status Codes	IndexDocumentsResult	일괄 처리의 모든 작업에 대한 작업의 상태 포함하는 응답입니다.
Other Status Codes	SearchError	오류 응답입니다.

예제

SearchIndexIndexDocuments

Sample Request

HTTP

POST https://myservice.search.windows.net/indexes('myindex')/docs/search.index?api-version=2023-10-01-Preview

{
  "value": [
    {
      "@search.action": "upload",
      "docId": "1",
      "title": "Fancy Stay",
      "description": "Best hotel in town"
    },
    {
      "@search.action": "merge",
      "docId": "2",
      "title": "Roach Motel"
    },
    {
      "@search.action": "mergeOrUpload",
      "docId": "3",
      "title": "Econo Motel"
    },
    {
      "@search.action": "delete",
      "docId": "4"
    }
  ]
}

Sample Response

Status code:: 200

{
  "value": [
    {
      "key": "1",
      "status": true,
      "errorMessage": null,
      "statusCode": 201
    },
    {
      "key": "2",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "3",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "4",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    }
  ]
}

Status code:: 207

{
  "value": [
    {
      "key": "1",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "2",
      "status": false,
      "errorMessage": "Document not found.",
      "statusCode": 404
    },
    {
      "key": "3",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "4",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    }
  ]
}

정의

Name	Description
IndexAction	문서에서 작동하는 인덱스 작업을 나타냅니다.
IndexActionType	인덱싱 일괄 처리의 문서에서 수행할 작업입니다.
IndexBatch	인덱스에 보낼 문서 쓰기 작업의 일괄 처리를 포함합니다.
IndexDocumentsResult	인덱싱 요청의 모든 문서에 대한 작업의 상태 포함하는 응답입니다.
IndexingResult	단일 문서에 대한 인덱싱 작업의 상태입니다.
SearchError	API에 대한 오류 조건에 대해 설명합니다.

IndexAction

문서에서 작동하는 인덱스 작업을 나타냅니다.

Name	형식	Description
@search.action	IndexActionType	인덱싱 일괄 처리의 문서에서 수행할 작업입니다.

IndexActionType

인덱싱 일괄 처리의 문서에서 수행할 작업입니다.

Name	형식	Description
delete	string	삭제 시에는 지정된 문서를 인덱스에서 제거합니다. 키 필드 이외의 삭제 작업에서 지정한 모든 필드는 무시됩니다. 문서에서 개별 필드를 제거하려면 병합을 대신 사용하고 필드를 명시적으로 null로 설정합니다.
merge	string	지정된 필드 값을 기존 문서와 병합합니다. 문서가 없으면 병합이 실패합니다. 문서의 기존 필드는 병합에서 지정하는 필드로 바뀝니다. 이는 기본 형식 및 복합 형식의 컬렉션에도 적용됩니다.
mergeOrUpload	string	지정된 키가 있는 문서가 인덱스에 이미 있는 경우 병합처럼 동작합니다. 문서가 없으면 새 문서를 사용하여 업로드하는 것처럼 동작합니다.
upload	string	문서가 새로 추가되면 인덱스에 삽입하고 있는 경우 업데이트합니다. 업데이트 사례에서 모든 필드가 대체됩니다.

IndexBatch

인덱스에 보낼 문서 쓰기 작업의 일괄 처리를 포함합니다.

Name	형식	Description
value	IndexAction[]	일괄 처리의 작업입니다.

IndexDocumentsResult

인덱싱 요청의 모든 문서에 대한 작업의 상태 포함하는 응답입니다.

Name	형식	Description
value	IndexingResult[]	인덱싱 요청의 각 문서에 대한 상태 정보 목록입니다.

IndexingResult

단일 문서에 대한 인덱싱 작업의 상태입니다.

Name	형식	Description
errorMessage	string	키로 식별된 문서에 대해 인덱싱 작업이 실패한 이유를 설명하는 오류 메시지입니다. 인덱싱에 성공하면 null입니다.
key	string	인덱싱 요청에 있던 문서의 키입니다.
status	boolean	키로 식별된 문서에 대해 인덱싱 작업이 성공했는지 여부를 나타내는 값입니다.
statusCode	integer	인덱싱 작업의 상태 코드입니다. 가능한 값은 성공적인 업데이트 또는 삭제의 경우 200, 문서 만들기 성공 201, 잘못된 입력 문서의 경우 400, 문서를 찾을 수 없는 경우 404, 버전 충돌의 경우 409, 인덱스가 일시적으로 사용할 수 없는 경우 422, 서비스가 너무 바쁠 때 503입니다.

SearchError

API에 대한 오류 조건에 대해 설명합니다.

Name	형식	Description
code	string	서버 정의 오류 코드 집합 중 하나입니다.
details	SearchError[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

다음을 통해 공유

Documents - Index

URI 매개 변수

요청 헤더

요청 본문

응답

예제

SearchIndexIndexDocuments

Sample Request

Sample Response

정의

IndexAction

IndexActionType

IndexBatch

IndexDocumentsResult

IndexingResult

SearchError

추가 리소스