---
sidebar_position: 3
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Add rows
 Adds new rows to the table



`Function AddRecords(Val Table, Val DataArray, Val Transaction = True, Val Connection = "") Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | Table | --table | String | ✔ | Table name |
  | DataArray | --rows | Array of Structure | ✔ | An array of string data structures: Key > field, Value > field value |
  | Transaction | --trn | Boolean | ✖ | True > adding records to transactions with rollback on error |
  | Connection | --db | String, Arbitrary | ✖ | Existing connection or database path |

  
  Returns:  Map Of KeyAndValue - Result of query execution

<br/>

:::tip
Binary data can also be transferred as a structure `{'blob':File path}`
:::
<br/>



```bsl title="1C:Enterprise/OneScript code example"
    Image = "https://api.athenaeum.digital/test_data/picture.jpg";
    OPI_TypeConversion.GetBinaryData(Image); // Image - Type: BinaryData

    PictureFile = GetTempFileName("png");
    Image.Write(PictureFile); // PictureFile - File to disk

    Base  = "C:\Users\Administrator\AppData\Local\Temp\v8_5571_2fd.sqlite";
    Table = "test";

    DataArray = New Array;

    RowStructure2 = New Structure;
    RowStructure2.Insert("name"      , "Vitaly"); // TEXT
    RowStructure2.Insert("age"       , 25); // INTEGER
    RowStructure2.Insert("salary"    , 1000.12); // REAL
    RowStructure2.Insert("is_active" , True); // BOOL
    RowStructure2.Insert("created_at", OPI_Tools.GetCurrentDate()); // DATETIME
    RowStructure2.Insert("data"      , Image); // BLOB

    RowStrucutre1 = New Structure;
    RowStrucutre1.Insert("name"      , "Lesha") ; // TEXT
    RowStrucutre1.Insert("age"       , 20); // INTEGER
    RowStrucutre1.Insert("salary"    , 200.20) ; // REAL
    RowStrucutre1.Insert("is_active" , False) ; // BOOL
    RowStrucutre1.Insert("created_at", OPI_Tools.GetCurrentDate()); // DATETIME
    RowStrucutre1.Insert("data"      , New Structure("blob", PictureFile)); // BLOB

    DataArray.Add(RowStructure2);
    DataArray.Add(RowStrucutre1);

    Result = OPI_SQLite.AddRecords(Table, DataArray, , Base);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint sqlite AddRecords \
             --table "test" \
             --rows "[{'name':'Vitaly','age':25,'salary':1000.12,'is_active':true,'created_at':'2025-02-10T11:41:58.8112687Z','data':{'blob':'C:\\Users\\Administrator\\AppData\\Local\\Temp\\ux3xujo4qln.png'}},{'name':'Lesha','age':20,'salary':200.20,'is_active':false,'created_at':'2025-02-10T11:41:58.8122651Z','data':{'blob':'C:\\Users\\Administrator\\AppData\\Local\\Temp\\ux3xujo4qln.png'}}]" \
             --db "C:\Users\Administrator\AppData\Local\Temp\cfyaxf0knp1.sqlite"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint sqlite AddRecords ^
             --table "test" ^
             --rows "[{'name':'Vitaly','age':25,'salary':1000.12,'is_active':true,'created_at':'2025-02-10T11:41:58.8112687Z','data':{'blob':'C:\\Users\\Administrator\\AppData\\Local\\Temp\\ux3xujo4qln.png'}},{'name':'Lesha','age':20,'salary':200.20,'is_active':false,'created_at':'2025-02-10T11:41:58.8122651Z','data':{'blob':'C:\\Users\\Administrator\\AppData\\Local\\Temp\\ux3xujo4qln.png'}}]" ^
             --db "C:\Users\Administrator\AppData\Local\Temp\cfyaxf0knp1.sqlite"
        ```
    </TabItem>
</Tabs>


```json title="Result"
{
 "commit": {
  "result": true
 },
 "result": true,
 "rows": 2,
 "errors": []
}
```