Manejando colecciones
Crear una Colección
Para crear una colección en la base de datos, se utiliza un comando
a la URL correspondiente con las credenciales API necesarias. A continuación, se presenta un ejemplo de cómo se hace esto usando 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}'
Ejemplo de solicitud y respuesta 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}
Listar Colecciones
Para listar todas las colecciones en una base de datos, se utiliza un comando
a la URL correspondiente con las credenciales API necesarias. A continuación, se presenta un ejemplo de cómo se hace esto usando 1GET
.1curl
1curl "https://example.com/v1/databases/{database_id}/collections" \
2-H "Api-Key: {api_key}" \
3-H "Api-Secret: {api_secret}"
Ejemplo de solicitud y respuesta 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]
Eliminar una Colección
Para eliminar una colección, se utiliza un comando
a la URL específica con las credenciales API necesarias, indicando la colección que se desea eliminar. A continuación, se presenta un ejemplo de cómo se hace esto usando 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}"
Ejemplo de solicitud y respuesta 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
Formas Implícitas de Crear una Colección
Al Insertar
Una colección puede ser creada implícitamente cuando se inserta un documento en una colección que no existe previamente.
Al Crear un Índice
Si se intenta crear un índice en una colección que no existe, la colección se crea automáticamente.
Al Usar 1setDefaults
1setDefaults
Utilizando el método
en una colección inexistente también se crea la colección de forma implícita.1setDefaults
Este documento proporciona una guía detallada sobre cómo manejar colecciones en la base de datos, incluyendo la creación, listado y eliminación de colecciones, así como las formas implícitas de crearlas.