Saltearse al contenido

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, exports y tenants, y los nombres que empiezan con nmdbexp-, 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

EstadoSignificado
readyAtiende consultas.
restoringSe 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.
failedLa 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

PlanBases de datos
Free2
Pro20
Scale100
EnterpriseDefinido 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.