Rumatadocs
Browse documentation

Work with databases

Store structured information, understand tables, and inspect database health.

Step-by-step guidance.

Before you start

  • Access to the project’s Database view.
  • Database entitlement and the permission needed for the operation.
  • Sample data for learning; a reviewed recovery plan before changing production data.

Understand tables and records

A database stores structured information that your product needs to remember. A table groups one kind of information, such as requests. Each row is one record. Columns describe its fields, such as title, due date, and status.

TermIn the request portal
Tablerequests
RowOne client request
Columntitle or status
IdentifierA stable value that identifies a specific request
RelationshipA request belongs to a particular client

Inspect your data

  1. Open Database in your factory’s product tools. Check the status before trying to query it.
  2. Browse the available tables. Select a table to inspect its columns and sample rows.
  3. Choose the table, diagram, query builder, or SQL view for the information you want to inspect.
  4. If you are new to databases, ask Rumata to explain the table structure and propose a read-only query.
  5. Verify that the result belongs to the project and users you expected.
The Tables diagram shows table structures and relationships. Its row counts are summaries; it does not display individual customer records.

Describe the information your app needs

text
For each request, store a title, description, due date, status,
and the client who submitted it.
Explain the tables and relationships before changing the database.
Clients must only be able to read their own requests.

Access rules need backend enforcement. A filtered list in the frontend does not protect records from direct requests. Coordinate schema changes with the backend services, workflows and screens that read those fields.

Starting, idle, and degraded states

Wait for a hosted database to start or wake before running operations. Check its state and recovery controls in Database. Startup delays, failed SQL statements, and a degraded state have different causes, so use the diagnostic information for the reported state.

Capacity and idle behavior depend on your account’s entitlement. Check Usage (opens in a new tab) and the database status message when writes fail or a database cannot start. Do not repeatedly recreate a database to troubleshoot availability.

Recovery and retention

Use the database recovery controls only after checking the scope, available recovery points, and the expected effect on later data. Recovery windows depend on the plan and current operational state. Retain independent exports when your business requires them.