Bases de datos
Una base de datos es un grafo independiente dentro de tu organización: sus propios nodos, relaciones, índices y constraints. Las consultas siempre nombran una base de datos, y una consulta nunca ve los datos de otra.
Usa bases de datos para separar entornos (staging, production), tenants de
tu propio producto (tenant-acme, tenant-globex) o grafos sin relación entre
sí. No cuestan nada extra: pagas por lo que almacenan y las peticiones que
atienden.
Crear una
Desde la consola (Databases → Create database), la
API de gestión
(POST /databases), el ManagementClient de los SDKs, la
CLI (namidb databases create) o
Terraform (namidb_database).
Nombres:
- letras minúsculas, números,
-y_; - empiezan con una letra o un número;
- como máximo 63 caracteres;
- únicos en la organización;
backups,exportsytenants, y los nombres que empiezan connmdbexp-, están reservados.
Un nombre que acabas de eliminar vuelve a estar libre una vez que se borran los
datos anteriores (409 name_purging hasta entonces, normalmente en pocos
minutos).
Estado
| Estado | Significado |
|---|---|
ready | Atiende consultas. |
restoring | Se está llenando desde un backup (una restauración, un clon o una restauración a un punto en el tiempo). Las consultas responden 503 database_unavailable hasta que esté lista. |
failed | La restauración que la estaba creando falló. Elimínala y vuelve a intentarlo. |
Una base de datos también informa read_only (ver más abajo) y sus
endpoints: la URL HTTP y la URI de Bolt para consultarla.
Cuántas
| Plan | Bases de datos |
|---|---|
| Free | 2 |
| Pro | 20 |
| Scale | 100 |
| Enterprise | Definido en tu contrato |
Las restauraciones, los clones y las restauraciones a un punto en el tiempo
crean una base de datos nueva, así que cuentan contra el mismo límite
(403 plan_limit cuando se alcanza).
Por encima del límite después de bajar de plan
No se elimina nada cuando pasas a un plan con menos bases de datos. Las bases
de datos más nuevas que superan el nuevo límite pasan a ser de solo
lectura: las consultas siguen funcionando, las escrituras responden
429 plan_limit con el nombre de la base de datos, y la consola y la API
muestran read_only: true. Elimina una base de datos, o vuelve a subir de
plan, y la siguiente vuelve a aceptar escrituras.
Eliminar una
Los owners, admins y developers eliminan una base de datos desde su página, o
con DELETE /databases/{database}. Eliminarla:
- rechaza las consultas nuevas a ella en cuestión de segundos;
- revoca las API keys que tenían alcance solo sobre esa base de datos (las keys que también llegan a otras bases de datos siguen funcionando para esas);
- borra sus datos en segundo plano.
Los backups tomados antes de la eliminación se conservan hasta que vencen según
la retención del plan. Si guardaste el id de un backup, POST /restores
todavía puede restaurarlo en una base de datos nueva. Fuera de eso, eliminar una
base de datos no se puede deshacer: haz una
exportación o un
clon antes si podrías volver a necesitarla. Se pueden
eliminar como máximo 20 bases de datos por organización por hora.
Un motor, muchas bases de datos
Todas las bases de datos de una organización las atiende el motor propio de la organización, que arranca a demanda y se detiene cuando está inactivo (consulta Escalado a cero). Los límites del plan sobre peticiones por segundo, consultas concurrentes y sesiones Bolt aplican a la organización en su conjunto, entre todas sus bases de datos. Consulta Límites de uso.