Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Method: projects.locations.dataStores.importDocuments

장기 실행 작업을 시작하여 문서를 DataStore로 가져옵니다.

이미 가져온 파일은 Cloud Storage 객체를 덮어쓰거나 SOURCE_FORMAT_DOCUMENT_JSON의 경우 메타데이터가 변경되지 않는 한 건너뜁니다. 이전 가져오기에서 실패한 파일이 다시 처리됩니다. 가져올 수 없는 개별 파일은 전체 가져오기가 실패하는 대신 오류 보고서(ImportOutputConfig.error_gcs_prefix 참고)에 보고됩니다.

dataStores.importDocuments, dataStores.purgeDocuments, dataStores.patch는 데이터 스토어당 한 번에 하나씩 실행됩니다. 하나가 실행되는 동안 하나 더 대기할 수 있습니다. 실행 중인 작업이 완료될 때까지 추가 요청은 ABORTED로 실패합니다. 여러 파일을 가져오려면 병렬 요청을 전송하는 대신 하나의 요청에 있는 inputUris에 모두 나열합니다.

HTTP 요청

POST https://vectorsearch.googleapis.com/v1beta/{name}:importDocuments

경로 매개변수

매개변수

매개변수
`name`	`string` 필수 항목입니다. 문서를 가져올 DataStore의 리소스 이름입니다. 형식은 `projects/{project}/locations/{location}/dataStores/{dataStore}`입니다.

name

string

필수 항목입니다. 문서를 가져올 DataStore의 리소스 이름입니다. 형식은 projects/{project}/locations/{location}/dataStores/{dataStore}입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현

JSON 표현
{ "importOutputConfig": { object (`ImportOutputConfig`) }, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "gcsSource": { object (`GcsSource`) } // End of mutually exclusive fields. }

{
  "importOutputConfig": {
    object (ImportOutputConfig)
  },

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

필드
`importOutputConfig`	`object (ImportOutputConfig)` (선택사항) 가져오기 문서 출력의 대상 구성: 가져오기 오류 보고서를 작성할 위치입니다.
필수 항목입니다. 입력 소스입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
`gcsSource`	`object (GcsSource)` 입력 콘텐츠의 Cloud Storage 위치입니다. 기본 `sourceFormat`를 사용하면 URI는 `gs://my-bucket/folder/*`과 같은 패턴일 수 있으며, 이는 `folder`의 객체와 직접 일치하지만 하위 폴더의 객체와는 일치하지 않습니다. 한 번의 가져오기에는 `UNSTRUCTURED` DataStore의 경우 최대 100,000개의 파일, `VIDEO` DataStore의 경우 최대 100개의 파일을 포함할 수 있습니다.
상호 배타적인 필드의 끝입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/vectorsearch

자세한 내용은 Authentication Overview를 참조하세요.

ImportOutputConfig

문서 가져오기 관련 출력의 대상 구성입니다.

JSON 표현
{ "errorGcsPrefix": string }

필드

필드
`errorGcsPrefix`	`string` (선택사항) 가져오기 중에 발생한 오류를 작성할 Cloud Storage 위치의 URI 프리픽스입니다. 프리픽스에는 객체가 포함되지 않아야 합니다. 오류는 이 프리픽스 아래의 샤딩된 파일에 JSON으로 인코딩된 `google.rpc.Status` 메시지로 한 줄에 하나씩 작성됩니다. 이 필드가 비어 있으면 오류 보고서가 작성되지 않습니다.

errorGcsPrefix