Skip to main content

Database interface support

Start with the task you need to complete. A checkmark means the linked guide contains a supported workflow for that interface; an em dash means to choose another interface.

Records and queries​

WorkflowJavaScriptPythonRESTConsoleRefineGuide
Create, read, update, and delete one record✓✓✓✓ReadRecords
Create or update by primary key✓✓✓——Records
Create, update, or delete an explicit batch✓✓✓——Bulk operations
Filter, sort, and paginate✓✓✓✓✓Query records
Select response fields✓—✓—✓Query records
Nested AND and OR filters✓✓✓✓✓Filter operators
Logical NOT filters—✓✓——Filter operators
Per-record allowed-action hints✓✓✓—✓Query records
Read related records with separate scoped queries✓✓✓—✓Relationships
Count, group, and aggregate✓✓✓——Aggregations
Full-text search✓✓✓—✓Search
Vector and hybrid search—✓✓——Search
Async record and query workflows—✓———Async Python
Parent-child and connection-table models✓✓✓✓ReadHierarchies and graphs
Application-controlled import and export✓✓✓——Import and export

Tables and schemas​

Database appears as Datatables in TaruviBase Console. Create and change tables there; applications work with records through the SDKs, REST, or Refine.

TaskInterfaceGuide
Inspect table metadata and the stored schemaTaruviBase ConsoleTaruviBase Console
Design a table and its fieldsTable schemaTables and schemas
Create, change, or delete a tableTaruviBase ConsoleTable lifecycle
Plan a schema changeTaruviBase Console or REST APISchema changes
Plan or verify indexesTable schemaIndexes
Add, browse, filter, edit, and delete recordsTaruviBase ConsoleTaruviBase Console

Production guidance​

RequirementGuide
Scope requests and apply least privilegeSecurity and limits
Test allowed, denied, anonymous, cross-app, and cross-site accessAccess policy testing
Plan transactions, retries, concurrent writes, and batch recoveryReliability
Design recoverable event consumersReliability
Handle success envelopes and structured errorsRequests, responses, and errors
Check flat-table and whole-table JSONB compatibilityStorage compatibility
Diagnose query, write, and SDK failuresTroubleshooting

Safe composition patterns​

Use these patterns when a task spans several records or tables:

RequirementPattern
Insert or update by primary keyUse the primary-key upsert workflow
Insert or update by another unique fieldRead and reconcile the field, then choose explicit create or update
Delete by a filterQuery a bounded set, review IDs, then use bulk delete
Filter, sort, or display related dataRead the related IDs first, then query the root table and join the results in application code
Traverse a hierarchyUse parent identifiers or junction tables with bounded queries
Build a graph or edge modelUse ordinary node records plus an authorized junction table
Import or export a datasetUse checkpointed record batches
Store structured JSON inside a recordUse an object field in a managed flat table
Use whole-table JSONB storageReview the separate storage compatibility contract before choosing an interface
Automate a Database taskUse the JavaScript SDK, Python SDK, or REST API

Setup and reference​

InterfaceSetupReference
JavaScript SDKConfigure the clientMethod signatures shown with each task
Python SDKConfigure the clientMethod signatures shown with each task
REST APIReview direct HTTP setupRequest contracts shown with each task
TaruviBase ConsoleOpen DatatablesThis product guide
Refine providerConnect RefineRefine integration

The product guides explain task behavior and supported interface combinations. Each task keeps its supported SDK methods and REST request contract beside the behavior it implements.