insert-tuple ( tuple -- )
High-level tuple/database integration » High-level tuple/database words

Prev:	drop-table ( class -- )
Next:	update-tuple ( tuple -- )

Vocabulary
db.tuples

Inputs

tuple

a tuple

Outputs
None

Word description
Inserts a tuple into a database if a relation has been defined with define-persistent. If a mapping states that the database assigns a primary key to the tuple, this value will be set after this word runs. Writes are run through serialize-transaction, so on backends like SQLite they participate in write serialization; on other backends they remain ordinary autocommit writes.

Notes
Objects should only be inserted into a database once per object. To store the object after the initial insert, call update-tuple.

See also
update-tuple, update-tuples, delete-tuples, reject-tuples

Definition

USING: classes db db.tuples.private db.types kernel ;

IN: db.tuples

: insert-tuple ( tuple -- )
    [
        dup class-of ensure-defined-persistent db-assigned?
        [ insert-db-assigned-statement ]
        [ insert-user-assigned-statement ] if
    ] curry serialize-transaction ;