Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Execute the SQL Statement against a FileMaker database.

Component Version macOS Windows Linux Server iOS SDK
Matrix 9.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Matrix.NewWithSQL"; FileName; SQL Statement { ; Params... } )   More


Parameter Description Example Flags
FileName The target database name. Can be empty to not limit query to one database. ""
SQL Statement SQL Statement as a Text string
Params... Optional, pass here parameters. One parameter to this function for each parameter you want to pass to the SQL statement. 123 Optional


Returns matrix reference number or error.


Execute the SQL Statement against a FileMaker database.
Returns a matrix reference number, so you can use functions like Matrix.Height, Matrix.Width, Matrix.GetValue and Matrix.DataType to query result.
Don't forget to use Matrix.Release to release the result from memory when you are done with it.

This function takes variable number of parameters. Pass as much parameters as needed separated by the semicolon in FileMaker.
Please repeat Params parameter as often as you need.

See also

Blog Entries

This function checks for a license.

Created 8th April 2019, last changed 7th April 2022

Matrix.New - Matrix.Release