Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2   9.3    Statistic  


Assigns an DBMS client for the connection.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
SQL 2.6 Yes Yes Yes Yes Yes
MBS( "SQL.SetClient"; Connection; Client )   More


Parameter Description Example value
Connection The connection reference number gained with SQL.NewConnection. $Connection
Client The name of the database client to use. "SQLite"


Returns "OK" on success.


Assigns an DBMS client for the connection.

You can set a client in Connect method, in this case you don't need to use setClient method. The main destination of this method is to connect to a server with no connection to a database (for example, to check a client availability and version). But if you are calling Connect method with no specified client you have to use setClient method before.

If you are calling setClient method when the connection is set to another client the previous connection will be disconnected and new client will be set.

Pass one of this values: CubeSQL, SQLAnywhere, ODBC, Oracle, SQLServer, Firebird, InterBase, SQLBase, DB2, Informix, Sybase, MySQL, PostgreSQL or SQLite.
Be aware that for most database servers, you need to specify client library with SQL.SetConnectionOption first.


Sets client to be SQLite:

MBS( "SQL.SetClient"; $Connection; "SQLite" )

Sets client to be Oracle:

MBS( "SQL.SetClient"; $Connection; "Oracle" )

See also

Example Databases

Created 18th August 2014, last changed 14th July 2018

SQL.SetAutoCommit   -   SQL.SetCommandOption

Feedback: Report problem or ask question.

MBS Xojo tutorial videos