수동 삭제 후 버전 처리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Cloud Search는 항목 삭제 요청을 받으면 전체 항목을 즉시 삭제하지 않습니다. 대신 Cloud Search는 항목을 삭제된 것으로 표시하고 ACL, 콘텐츠, 구조화된 데이터, 메타데이터와 같은 항목 정보의 하위 집합을 삭제하여 소프트 삭제를 실행합니다. 상품 버전과 같은 기타 정보는 유지됩니다.
재색인 요청에서 기존 값보다 큰 버전을 제공하는 경우, 항목이 일시삭제 상태일 때 해당 항목을 재색인하면 항목이 복원됩니다.
항목은 삭제된 것으로 표시된 후 7~10일이 지나면 Cloud Search에서 하드 삭제를 실행하여 항목을 영구 삭제합니다. 항목이 더 이상 존재하지 않으며 버전 번호가 더 이상 해당 특정 항목을 참조하지 않습니다.
일관된 항목 버전 유지
콘텐츠 커넥터는 항목의 버전 관리를 처리해야 합니다.
하지만 커넥터 로직 외부에서 items.delete를 사용하여 항목을 삭제하는 경우 재색인에 성공하려면 다음 중 하나를 수행해야 합니다.
- 하드 삭제 (7~10일) 후에 콘텐츠의 색인을 다시 생성합니다.
- 항목을 수동으로 삭제할 때는 'None'과 같은 임의의 문자열 대신 items.get을 호출하여 가져올 수 있는 실제 항목 버전을 사용하세요.
이러한 제안 중 하나를 따르지 않으면 색인 생성 중에 오류가 발생하고 색인 생성이 실패합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Handle revisions after manual deletes\n\nWhen the Cloud Search gets a delete item request, it doesn't immediately remove\nthe entire item. Instead, Cloud Search performs a *soft delete* by marking the\nitem as deleted and removing a subset of item information, such as the ACLs,\ncontent, structured data, and metadata. Other information, such as the item\nversion, is retained.\n\nIf a re-indexing request provides a version greater than the existing value,\nre-indexing that item while it is in a soft delete state restores the item.\n\nAn item is marked as deleted for 7-10 days after which Cloud Search performs\na *hard delete* to permanently delete the item. The item ceases to exist and\nits version number no longer refers to that specific item.\n\nMaintain consistent item versions\n---------------------------------\n\nYour content connector should handle versioning of items.\nHowever, if you delete an item outside of your connector logic using\n[items.delete](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items/delete)\nyou must do one of the following to ensure reindexing can be successful:\n\n- Reindex your content *after* the hard delete (7-10 days).\n- When manually deleting an item, use the actual item version, which you can obtain by calling [items.get](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items/get) , instead of a random string, such as \"None.\".\n\nIf you don't follow one of these suggestions, an error occurs during indexing\nand indexing fails."]]