> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Collection Project History Sharded Blobs

`projectHistoryShardedBlobs` lưu các bản ghi blob không vừa trong [projectHistoryBlobs](https://ayakaleaf-pro.mintlify.site/dev/data-model/project-history-blobs-collection.md): khi bucket của một tiền tố hash ở đó đã có 8 bản ghi, các bản ghi tiếp theo sẽ vào đây. Mỗi dự án có tối đa 16 tài liệu ở đây, mỗi tài liệu cho một chữ số hex đầu tiên của hash. Không có schema Mongoose; history-v1 ghi nó trong `services/history-v1/storage/lib/blob_store/mongo.js` (bố cục mô tả tại `mongo.js:1-16`).

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | Binary | 13 byte: id lịch sử của dự án, một `0`, và chữ số shard, đọc dưới dạng hex (`<history id>0<digit>`). Chữ số shard là chữ số hex đầu tiên của hash. | `mongo.js:439-453` |
| `blobs` | Object | Bản ghi blob được nhóm thành các bucket. Khóa của bucket là các chữ số hex thứ 2 đến 4 của hash. | `mongo.js:439-443` |
| `blobs.<bcd>` | Array of Object | Các bản ghi của bucket. Mã không giới hạn kích thước của nó. | `mongo.js:399-407` |
| `blobs.<bcd>[].h` | Binary | Hash, 20 byte, như trong projectHistoryBlobs. | `mongo.js:472` |
| `blobs.<bcd>[].b` | Number | Độ dài nội dung tính bằng byte. | `mongo.js:473` |
| `blobs.<bcd>[].s` | Number | Độ dài nội dung dưới dạng văn bản; `null` khi nội dung không phải văn bản chỉnh sửa được. | `mongo.js:474` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `services/history-v1/storage/lib/blob_store/mongo.js:399-407` | `insertRecordSharded`: upsert với `$addToSet` vào bucket. Được gọi bởi `insertBlob` khi bucket trong projectHistoryBlobs đã đầy (`mongo.js:387-389`). |
| `mongo.js:75-103` | `clone`: sao chép các shard của dự án sang id lịch sử khác, cho history-v1 `POST /projects/:project_id/clone`, route mà không có gì trong web gọi. |
| `mongo.js:413-422` | `deleteBlobs`: xóa mọi shard của dự án cùng với tài liệu projectHistoryBlobs của nó, khi history-v1 `DELETE /projects/:project_id`. |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `mongo.js:144-157` | `findBlobSharded`: một blob, chỉ được tra cứu khi bucket của nó trong projectHistoryBlobs có 8 bản ghi và không chứa nó (`mongo.js:127-131`). |
| `mongo.js:217-260` | `findBlobsSharded`: các blob mà `findBlobs` không tìm thấy trong projectHistoryBlobs (`mongo.js:202-206`). |
| `mongo.js:285-306` | `getProjectBlobs`: mọi shard của một dự án. |
| `mongo.js:337-361` | `getProjectBlobsBatch`: mọi shard của nhiều dự án, cho route thống kê blob. |

#### Chỉ mục

Chỉ có chỉ mục mặc định `_id`. Không migration nào trong `tools/migrations/` thêm chỉ mục.

#### Ghi chú

* Các shard của một dự án nằm cạnh nhau theo thứ tự `_id`, nên mã tìm chúng bằng một khoảng `_id` từ `<history id>00` đến `<history id>0f` (`mongo.js:75-80`, `287-295`).
* Collection chỉ xuất hiện khi có dự án nào đó có hơn 8 blob cùng tiền tố hash 3 chữ số, nên một instance nhỏ có thể hoàn toàn không có nó.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.