| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
Matrix.InsertRecordsToSQL
Inserts records in SQL database from records in memory.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| Matrix | 9.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "Matrix.InsertRecordsToSQL"; MatrixRef; Connection; InsertTableName; FieldNames { ; StartRow; EndRow; Replace } ) More
Parameters
| Parameter | Description | Example | Flags |
|---|---|---|---|
| MatrixRef | The matrix reference number. | $matrix | |
| Connection | The connection reference number gained with SQL.NewConnection. | $Connection | |
| InsertTableName | The name of the table to insert record into. | "Assets" | |
| FieldNames | A list of field names for the insert. Empty entries in the list are ignored. |
"Model¶Names" | |
| StartRow | The index of the start row. First row is 0. Pass -1 or nothing for default which is starting with row 0. |
-1 | Optional |
| EndRow | The index of the end row. First row is 0. Last Row would be Matrix.Height-1. Pass -1 to use all rows and the plugin will internally use RowCount-1. |
-1 | Optional |
| Replace | Set to 1 to replace existing entries. Currently available for MySQL and databases with same syntax. |
0 | Optional |
Result
Returns OK or error.
Description
Inserts records in SQL database from records in memory.This function allows to easily copy a lot of records from a query in FileMaker database into a SQL database.
Please provide field names in other table. The order has to match those in the record set.
Due to passing in new field names, you can even rearrange values from one column to other while copying. In the SQL you can use functions for sums or join data from several tables together to fill a new table.
Reports an error if field name list doesn't match column count of the query result.
Function will fail if data types in source and dest fields do not match for assignment. e.g. date and time fields will not work, only timestamp fields.
For insert within FileMaker, please use Matrix.InsertRecords.
See also
Release notes
- Version 13.2
- Changed field quoting for FM.SQL.InsertRecordsToSQL and Matrix.InsertRecordsToSQL to handle non ANSI quotes for MySQL/MariaDB.
- Version 13.1
- Fixed FM.SQL.InsertRecords, FM.SQL.InsertRecordsToSQL, Matrix.InsertRecordsToSQL and Matrix.InsertRecords to quote the table name for the SQL used internally.
Blog Entries
- MBS FileMaker Plugin, version 13.2pr1
- MBS FileMaker Plugin, version 13.1pr1
- CSV in FileMaker with MBS FileMaker Plugin
This function checks for a license.
Created 8th April 2019, last changed 7th April 2022
