管理集合
创建集合
要在数据库中创建集合,使用带有必要API凭据的
命令到相应的URL。以下是使用1POST
进行操作的示例。1curl
1curl -X POST "https://example.com/v1/databases/{database_id}/collections" \
2-H "Api-Key: {api_key}" \
3-H "Api-Secret: {api_secret}" \
4-d '{
5 "name": "my-collection"
6}'
HTTP请求和响应示例:
1POST /v1/databases/719e9421-e6e9-42b6-b9b7-b580e532b9d5/collections HTTP/1.1
2Host: example.com
3Api-Key: 1abbe476-6ad6-4b97-9cca-6deb6ab2901d
4Api-Secret: 4bda6d52-762b-4e5d-bed7-85614c13b8bf
5
6{
7 "name": "my-collection"
8}
9
10HTTP/1.1 201 Created
11Content-Length: 74
12Content-Type: text/plain; charset=utf-8
13Date: Mon, 15 Aug 2022 02:08:13 GMT
14
15{
16 "defaults": {
17 "id": "uuid()"
18 },
19 "indexes": 0,
20 "name": "my-collection",
21 "total": 0
22}
列出集合
要列出数据库中的所有集合,使用带有必要API凭据的
命令到相应的URL。以下是使用1GET
进行操作的示例。1curl
1curl "https://example.com/v1/databases/{database_id}/collections" \
2-H "Api-Key: {api_key}" \
3-H "Api-Secret: {api_secret}"
HTTP请求和响应示例:
1GET /v1/databases/13f8a9fa-7e46-4732-9545-658ea2b87112/collections HTTP/1.1
2Host: example.com
3Api-Secret: 07510cc8-40cc-41f1-825b-449ae72895b2
4Api-Key: 8f8617b1-320b-47bf-b534-6d701e03b2b0
5
6HTTP/1.1 200 OK
7Content-Length: 76
8Content-Type: text/plain; charset=utf-8
9Date: Mon, 15 Aug 2022 02:08:13 GMT
10
11[
12 {
13 "defaults": {
14 "id": "uuid()"
15 },
16 "indexes": 0,
17 "name": "my-collection",
18 "total": 0
19 }
20]
删除集合
要删除集合,使用带有必要API凭据的
命令到特定URL,指定要删除的集合。以下是使用1POST
进行操作的示例。1curl
1curl -X POST "https://example.com/v1/databases/{database_id}/collections/my-collection:dropCollection" \
2-H "Api-Key: {api_key}" \
3-H "Api-Secret: {api_secret}"
HTTP请求和响应示例:
1POST /v1/databases/dc992d92-c146-448b-a17d-e94614aff740/collections/my-collection:dropCollection HTTP/1.1
2Host: example.com
3Api-Key: 271ba1e6-87b5-4d0f-84a0-a3d1178d1356
4Api-Secret: 5346a7cf-6743-49eb-921b-6e977cf11e36
5
6HTTP/1.1 200 OK
7Content-Length: 0
8Date: Mon, 15 Aug 2022 02:08:13 GMT
隐式创建集合的方法
插入时
当在不存在的集合中插入文档时,可以隐式创建集合。
创建索引时
如果尝试在不存在的集合中创建索引,集合会自动创建。
使用1setDefaults
时
1setDefaults
在不存在的集合中使用
方法时,也会隐式创建集合。1setDefaults
本文档提供了有关如何在数据库中管理集合的详细指南,包括集合的创建、列出和删除以及隐式创建集合的方法。