处理数据
本文档解释了如何在集合中插入、列出、修改和删除文档。还包括如何在列出时过滤数据。
插入文档
插入单个文档
要在集合中插入单个文档,请使用以下HTTP请求:
1POST /databases/{database}/collections/{collection}/documents
2Content-Type: application/json
3X-API-Key: your-api-key
4
5{
6 "document": {
7 "key1": "value1",
8 "key2": "value2"
9 }
10}
插入多个文档
要在集合中插入多个文档,请使用以下HTTP请求:
1POST /databases/{database}/collections/{collection}/documents/bulk
2Content-Type: application/json
3X-API-Key: your-api-key
4
5{
6 "documents": [
7 {
8 "key1": "value1",
9 "key2": "value2"
10 },
11 {
12 "key1": "value3",
13 "key2": "value4"
14 }
15 ]
16}
列出文档
列出所有文档(全扫描)
要列出集合中的所有文档,请使用以下HTTP请求:
1GET /databases/{database}/collections/{collection}/documents
2X-API-Key: your-api-key
通过唯一索引列出文档
要使用唯一索引列出文档,请使用以下HTTP请求:
1GET /databases/{database}/collections/{collection}/documents?filter={"key":"value"}
2X-API-Key: your-api-key
列出具有特定限制的文档
要列出具有特定限制的文档,请使用以下HTTP请求:
1GET /databases/{database}/collections/{collection}/documents?limit=10
2X-API-Key: your-api-key
修改文档
通过全扫描修改文档
要通过全扫描修改文档,请使用以下HTTP请求:
1PATCH /databases/{database}/collections/{collection}/documents
2Content-Type: application/json
3X-API-Key: your-api-key
4
5{
6 "filter": {"key": "value"},
7 "update": {"$set": {"key": "new_value"}}
8}
通过索引修改文档
要使用索引修改文档,请使用以下HTTP请求:
1PATCH /databases/{database}/collections/{collection}/documents?filter={"key":"value"}
2Content-Type: application/json
3X-API-Key: your-api-key
4
5{
6 "update": {"$set": {"key": "new_value"}}
7}
删除文档
通过索引删除文档
要使用索引删除文档,请使用以下HTTP请求:
1DELETE /databases/{database}/collections/{collection}/documents?filter={"key":"value"}
2X-API-Key: your-api-key
通过全扫描删除文档
要通过全扫描删除文档,请使用以下HTTP请求:
1DELETE /databases/{database}/collections/{collection}/documents
2Content-Type: application/json
3X-API-Key: your-api-key
4
5{
6 "filter": {"key": "value"}
7}