의견 보내기
Method: projects.databases.documents.batchWrite
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
쓰기 작업 배치를 적용합니다.
documents.batchWrite 메서드는 쓰기 작업을 원자적으로 적용하지 않으며 비순차적으로 적용할 수 있습니다. 메서드에서는 문서당 두 번 이상의 쓰기를 허용하지 않습니다. 각 쓰기는 독립적으로 성공하거나 실패합니다. 각 쓰기의 성공 상태는 BatchWriteResponse
를 참조하세요.
원자적으로 적용되는 쓰기 집합이 필요한 경우 대신 documents.commit
를 사용하세요.
HTTP 요청
POST https://firestore.googleapis.com/v1/{database=projects/*/databases/*}/documents:batchWrite
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수
database
string
필수 항목입니다. 데이터베이스 이름입니다. 형식은 projects/{projectId}/databases/{databaseId}
입니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현
{
"writes" : [
{
object (Write
)
}
] ,
"labels" : {
string : string ,
...
}
}
입력란
writes[]
object (Write
)
적용할 쓰기입니다.
메서드가 원자적으로 쓰기를 적용하지 않으며 순서를 보장하지 않습니다. 각 쓰기는 독립적으로 성공하거나 실패합니다. 요청당 두 번 이상 동일한 문서에 쓸 수 없습니다.
labels
map (key: string, value: string)
이 일괄 쓰기와 연결된 라벨입니다.
"key": value
쌍 목록을 포함하는 객체입니다. 예를 들면 { "name": "wrench", "mass": "1.3kg", "count": "3" }
입니다.
응답 본문
Firestore.BatchWrite
의 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현
{
"writeResults" : [
{
object (WriteResult
)
}
] ,
"status" : [
{
object (Status
)
}
]
}
입력란
writeResults[]
object (WriteResult
)
쓰기 적용 결과입니다.
이 i번째 쓰기 결과는 요청의 i번째 쓰기에 해당합니다.
status[]
object (Status
)
쓰기 적용 상태입니다.
이 i번째 쓰기 상태는 요청의 i번째 쓰기에 해당합니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
자세한 내용은 인증 개요 를 참조하세요.
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-04-12(UTC)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"필요한 정보가 없음"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"너무 복잡함/단계 수가 너무 많음"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"오래됨"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"번역 문제"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"샘플/코드 문제"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"기타"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"이해하기 쉬움"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"문제가 해결됨"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"기타"
}]
의견을 전달하고 싶나요?