Documentación Console
Log In Start now
eneszh
v1v2
InceptionDB
Guía de Inicio Rápido con InceptionDB
Manejando colecciones
Trabajando con datos
Lambda
Primeros pasos
Files
Primeros pasos
Config
Primeros pasos
InstantLogs
Primeros pasos
Tailon
Primeros pasos
Crear una Colección
Listar Colecciones
Eliminar una Colección
Formas Implícitas de Crear una Colección
Al Insertar
Al Crear un Índice
Al Usar

Manejando colecciones

Crear una Colección

Para crear una colección en la base de datos, se utiliza un comando 

1POST
a la URL correspondiente con las credenciales API necesarias. A continuación, se presenta un ejemplo de cómo se hace esto usando 
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 

1GET
a la URL correspondiente con las credenciales API necesarias. A continuación, se presenta un ejemplo de cómo se hace esto usando 
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 

1POST
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 
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

Utilizando el método 

1setDefaults
en una colección inexistente también se crea la colección de forma implícita.

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.