Online Documentation - Statistics - FAQ - Plugin Parts (All, Dependencies) - Class hierarchy
New in Version 22.2 22.3 22.4 22.5 23.0 23.1 23.2 23.3 23.4 23.5 24.0 24.1
The list of the topics, classes, interfaces, controls, modules, global methods by category, global methods by name, screenshots, licenses and examples.
Platforms to show: All Mac Windows Linux Cross-Platform
Super class: Database
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
class | SQL | MBS SQL Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
You can use the SQL plugin without using Xojo built in database classes if you use the SQLConnectionMBS and SQLCommandMBS classes.
Or you use the SQLDatabaseMBS class which is a subclass of the database class and can be used with Xojo's RecordSet class. The current implementation is not complete. You can connect with passing the database URL in the DatabaseName property of the SQLDatabaseMBS class. You prefix this URL with the database type you are using.
You can use Execute and Select to run SQL statements. Errors can be queries with the lasterror properties. For the RecordSet, you can get the column count, the column names and values and move to the next row. All the other methods like deleting a record or updating a value are not implemented and you need to use SQL commands to do this.
Supported databases: CubeSQL, Centura SQLBase, DB2, DuckDB, Firebird, Informix, InterBase, MariaDB, Microsoft Access, Microsoft SQL Server, MySQL, ODBC, Oracle Database Server, PostgreSQL, SQL Anywhere, SQLite, SQLCipher and Sybase.
Connect to Microsoft Access, FileMaker Server (or Pro), Microsoft Visual FoxPro and others via ODBC.
As field and table schema functions are not implemented, you can't use this database with the database browser features in the Xojo IDE.
The plugin does not provide RecordCount on RecordSet class. For that you need to make a extra SELECT count(*) query.
With Xojo 2013r1, you only need a database server license from Xojo, Inc. if you use the SQLDatabaseMBS class. The SQLConnectionMBS class does not require this license. But some features like getting a recordset do need the license as they refer to the SQLDatabaseMBS class.
Please free all RecordSets and SQLCommand objects before you close the SQLConnection or the SQLDatabase. The plugin keeps references from RecordSets and SQLCommand to prevent automatic destruction of the database connection. If you close a database connection while you have RecordSets and SQLCommand in use, things may go wrong.
The plugin can cache the recordset locally. To enable you can call SQLCommandMBS.Cache or use the Option("AutoCache") = "true" on either command or connection or database objects. The plugin will than fetch all records and store them in memory. After this you can walk over the recordset and use FetchPos, FetchFirst, FetchLast, FetchPrev and FetchNext to locate the rows you need. When you call Field() you always get last row, but to read from cached result set, please use Value() function. When using RecordSet, the values are read via Value() functions automatically.
You can use InternalPostgreSQLLibraryMBS or InternalSQLiteLibraryMBS if you like to use our built in SQLite or PostgreSQL database libraries.
The class pings the database every minute by checking whether it's alive and to avoid server dropping connection. This can be disabled by setting Option("Ping") = "false". Ping is not used for SQLite.
MBS Plugin 21.1 adds support for Edit/Update methods in RecordSet and RowSet classes.
MBS Database connections are implemented via SQLConnectionMBS and SQLCommandMBS classes. We provide a thin layer on top with SQLDatabaseMBS class to make it compatible to the Xojo database class. And when you use SQLDatabaseMBS, you can always get the matching SQLConnectionMBS objet via Connection property. Instead of SQLCommandMBS class, you may just use SelectSQL/ExecuteSQL or older SQLSelect/SQLExecute functions.
We have a collection of library files here:
https://www.monkeybreadsoftware.de/xojo/download/plugin/Libs/
Subclass of the Database class.
Constant | Value | Description |
---|---|---|
kOptionLibraryCubeSQL | "CUBESQL.LIBS" | One of the option constant to specify the library with the SetFileOption method. Tells the plugin where to find the library for CubeSQL. Only needed if you don't use InternalCubeSQLLibraryMBS module! more |
kOptionLibraryDuckDB | "DUCKDB.LIBS" | ConstantsGroup: Options to specify the library with SetFileOption dim con as SQLDatabaseMBS // your connection more |
SQLiteInMemory | "Sqlite::memory:" |
Connection string for SQLite for a new in-memory database.
Prefixed with SQLite to use directly. |
Constant | Value | Description |
---|---|---|
kANSILevel0 | 0 |
ANSI Level 0 |
kANSILevel1 | 1 |
ANSI Level 1 |
kANSILevel2 | 2 |
ANSI Level 2 |
kANSILevel3 | 3 |
ANSI Level 3 |
kLevelUnknown | -1 |
Unknown |
kReadCommitted | 1 |
Read committed. |
kReadUncommitted | 0 |
Read uncommitted. |
kRepeatableRead | 2 |
Repeatable read. |
kSerializable | 3 |
Serializable. |
kSnapshot | 4 |
Changes made in other transactions can not be seen. For Microsoft SQL Server. |
Constant | Value | Description |
---|---|---|
kAutoCommitOff | 0 |
Autocommit is off. Example |
kAutoCommitOn | 1 |
Autocommit is on. Example |
kAutoCommitUnknown | -1 |
Autocommit unknown |
Constant | Value | Description |
---|---|---|
kCommandTypeSQLStatement | 1 |
Command is an SQL statement. |
kCommandTypeSQLStatementRaw | 2 |
Command is an SQL statement that mustn't be interpreted by SQLAPI. |
kCommandTypeStoredProcedure | 3 |
Command is a stored procedure or a function. |
kCommandTypeUnknown | 0 |
Used by default. Library detects command type automatically. |
Constant | Value | Description |
---|---|---|
kErrorBindVarNotFound | 7 |
Bind variable not found. |
kErrorClientInitFails | 6 |
Initialization failed for client. |
kErrorClientNotSet | 1 |
Client not set. |
kErrorClientNotSupported | 2 |
Unsupported client type for this platform. |
kErrorClientVersionOld | 5 |
Library file is too old. |
kErrorFieldNotFound | 8 |
Field not found. |
kErrorGetLibraryVersionFails | 4 |
Failed to query library version. |
kErrorLoadLibraryFails | 3 |
Failed to load a library. For example path could be wrong or 32/64bit mismatch. |
kErrorNoMemory | 0 |
Out of memory. |
kErrorUnknownColumnType | 11 |
Unknown column type. |
kErrorUnknownDataType | 9 |
Unknown data type. |
kErrorUnknownParameterType | 10 |
Unknown parameter type. |
kErrorWrongConversion | 12 |
Failed to convert a value, e.g. string to number. |
kErrorWrongDatetime | 13 |
Can't convert text to date. |
Constant | Value | Description |
---|---|---|
kOptionLibraryDB2 | "DB2CLI.LIBS" | Tells the plugin where to find the library for DB2. more |
kOptionLibraryFirebird | "IBASE.LIBS" | Tells the plugin where to find the library for FireBird (or Interbase). more |
kOptionLibraryInformix | "INFCLI.LIBS" | Tells the plugin where to find the library for Informix. more |
kOptionLibraryInterbase | "IBASE.LIBS" | Tells the plugin where to find the library for FireBird (or Interbase). more |
kOptionLibraryMySQL | "MYSQL.LIBS" | Tells the plugin where to find the library for MySQL (or MariaDB). more |
kOptionLibraryODBC | "ODBC.LIBS" | Tells the plugin where to find the library for ODBC. more |
kOptionLibraryOracle | "OCI8.LIBS" | Tells the plugin where to find the library for Oracle. more |
kOptionLibraryPostgreSQL | "LIBPQ.LIBS" | Tells the plugin where to find the library for PostgreSQL more |
kOptionLibrarySQLanywhere | "SQLANY.LIBS" | Tells the plugin where to find the library for SQL Anywhere. more |
kOptionLibrarySQLBase | "SQLBASE.LIBS" | Tells the plugin where to find the library for SQLBase. more |
kOptionLibrarySQLite | "SQLITE.LIBS" | Tells the plugin where to find the library for SQLite. Not needed if you use InternalSQLiteLibraryMBS module! more |
kOptionLibrarySybaseComn | "SYBCOMN.LIBS" | Tells the plugin where to find the library for Sybase. more |
kOptionLibrarySybaseCS | "SYBCS.LIBS" | Tells the plugin where to find the library for Sybase. more |
kOptionLibrarySybaseCT | "SYBCT.LIBS" | Tells the plugin where to find the library for Sybase. more |
kOptionLibrarySybaseIntl | "SYBINTL.LIBS" | Tells the plugin where to find the library for Sybase. more |
kOptionLibrarySybaseTCL | "SYBTCL.LIBS" | Tells the plugin where to find the library for Sybase. more |
This class has no sub classes.
The items on this page are in the following plugins: MBS SQL Plugin.
SQLConnectionMBS - SQLDataConsumerMBS