database Service
Database capability acquired through a declared System Service.
Contract database · 1.0.0-draft.1
Functions
create
Unsaved Record for the named Collection.
| Argument | Type | Required | Default |
|---|---|---|---|
| collection | core.string | Yes | — |
Returns: database.Record
first
Record or null.
| Argument | Type | Required | Default |
|---|---|---|---|
| query | database.Query | Yes | — |
Returns: database.Record?
query
Forward Cursor of Records.
| Argument | Type | Required | Default |
|---|---|---|---|
| query | database.Query | Yes | — |
Returns: database.RecordCursor
count
Integer count.
| Argument | Type | Required | Default |
|---|---|---|---|
| query | database.Query | Yes | — |
Returns: core.integer
update
Bulk update of matching records; returns integer affected row count.
| Argument | Type | Required | Default |
|---|---|---|---|
| query | database.BulkUpdate | Yes | — |
Returns: core.integer
Behavior
- Records are execution-owned handles. Field reads use only the loaded projection. Assignment and load change pending values; remove clears one field. save persists pending state without committing the transaction.
- A reference value contains the target identity according to the Collection. Arrays of values do not automatically become arrays of linked Records.
- For a single-record business decision use first, check the record, change or remove fields and save. update applies one bulk change to matching base records.
- Queries follow Query or BulkUpdate schemas and query-semantics.json. Field names, reference paths, projections and aggregate results are checked against declared Collections.
- Read filters explicitly express the intended soft-deletion policy. The Service exposes no physical record deletion. A zero affected-row count is not automatically NotFound.
- A RecordCursor is iterated using for each. It visits only the requested page and is released by its execution scope. No undocumented cursor methods are exposed.