Skip to content

Add insert of associations to OQL statement doc #10532

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
dahfjkg wants to merge 1 commit into
base: development
Choose a base branch
from
+10 −5
Open

Add insert of associations to OQL statement doc #10532

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 10 additions & 5 deletions content/en/docs/refguide/modeling/domain-model/oql/oql-statements.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -173,27 +173,32 @@ Available from Mendix version 11.6.0
The syntax of `INSERT` statements is:

```sql
INSERT INTO <entity> ( <attribute> [ , …n ] ) <oql-query>
INSERT INTO <entity> ( <attribute | <association> [ , …n ] ) <oql-query>
```

* `entity` is the entity for which new objects will be created.

* `attribute` is an attribute of the entity that will be inserted.

* `oql-query` is any OQL query that returns same number of columns as the number of attributes that will be inserted.
* `association` is an association to an existing object of associated entity. Associations can be inserted in Mendix version 11.7.0 and above.

* `oql-query` is any OQL query that returns same number of columns as the number of attributes and associations that will be inserted.
This query can select data from persistable entities and/or [view entities](/refguide/view-entities/).

Example:

```sql
INSERT INTO Module.Order ( OrderNumber, CustomerNumber )
SELECT NewOrderNumber, Loader.TemporaryData_Customer/Loader.Customer/Number FROM Loader.TemporaryData
INSERT INTO Module.Order ( OrderNumber, CustomerNumber, Module.Order_Customer )
SELECT NewOrderNumber, Loader.TemporaryData_Customer/Loader.Customer/Number, Loader.TemporaryData_Customer FROM Loader.TemporaryData
```

### OQL `INSERT` Limitations

* It is not yet possible to insert associations. As a workaround, they can be added after the `INSERT` using an OQL `UPDATE` statement.
* Only a single value can be specified per association.

If you need to set multiple values in a many-to-many association, we recommend doing that in two stages. First, use `INSERT` to create required objects and then set associations using `UPDATE`.
* Attributes of type "Date and time" with a default value of `'[%CurrentDateTime%]'` will not have their default values set when the `INSERT` statement does not specify them.

As a workaround, explicitly insert the attribute with a value of `'[%CurrentDatetime%]'` in the `SELECT` part.
* When using Oracle, due to database limitations, inserting attributes of type unlimited string or binary is not supported.
* The general limitations for OQL statements also apply. See [General Limitations for OQL Statements](#oql-limitations), below.
Expand Down