# Insert Data Table

Inserts a data table into the specified table in the database.

<table data-header-hidden><thead><tr><th width="287.83331298828125" valign="top"></th><th width="321.33343505859375" valign="top"></th></tr></thead><tbody><tr><td valign="top">Connection String</td><td valign="top">[Text] The connection string to the database. The string is specified according to the selected provider. When using an already open connection, do not set this property, but specify a variable with the current connection object in the "Connection Reference" property.</td></tr><tr><td valign="top">User</td><td valign="top">[Text] The username for authentication.</td></tr><tr><td valign="top">Password</td><td valign="top">[Text/SecureString] The password for authentication.</td></tr><tr><td valign="top">SQL Provider</td><td valign="top">Select the SQL provider.</td></tr><tr><td valign="top">Connection Reference</td><td valign="top">[Link] The SQL connection object. The variable name in this property must match the variable name in the "Connection Reference" property of the "Connect" block from the Databases group that was previously used to connect to SQL.</td></tr><tr><td valign="top">Data Table</td><td valign="top">[Data Table] The data table that will be inserted into the table. The column names of the data table must match the names from the database table.</td></tr><tr><td valign="top">Table Name</td><td valign="top">[Text] The name of the table into which the data should be inserted.</td></tr><tr><td valign="top">Exclude Columns</td><td valign="top">[Number/Text] The column number or a string with column numbers separated by commas. The specified columns will not be used in the query. Numbering starts from zero.</td></tr><tr><td valign="top">Timeout</td><td valign="top">[Number] The timeout for executing the query in seconds.</td></tr><tr><td valign="top">Result</td><td valign="top">[Number] Returns the number of inserted records.</td></tr><tr><td valign="top">Error Handling Level</td><td valign="top"><p>Select the error handling level. Possible values:</p><ul><li>"Default" - default;</li><li>"Ignore" - errors are ignored;</li><li>"Handle" - errors are handled.</li></ul><p>If "Default" is selected, the value from the "Start" block of this diagram will be used.</p></td></tr><tr><td valign="top">Message Level</td><td valign="top"><p>Select the message level that the blocks will output during operation. Possible values:</p><ul><li>"Default" - default;</li><li>"Release" - output is disabled;</li><li>"Debug" - outputs main information;</li><li>"Detailed" - outputs detailed information.</li></ul><p>If "Default" is selected, the value from the "Start" block of this diagram will be used.</p></td></tr><tr><td valign="top">Error Text</td><td valign="top">[Text] Returns detailed information about the error in case of incorrect execution of the block's work.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/en/sherpa-rpa/sherpa-designer/spravochnik-blokov/bazy-dannykh/vstavit-tablicu-dannykh-databaseinsertdatatable.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
