sqlite3 driver manual: A libdbi driver using the SQLite3 embedded database engine
Prev | Chapter 4. Peculiarities you should know about | Next

# 4.2. sqlite driver misfeatures

And now we have to discuss how successful the sqlite driver is in squeezing the SQLite idea of a database engine into the libdbi framework which was shaped after MySQL and PostgreSQL. Keep in mind that the limitations mentioned here are not intrinsic (except maybe the first one which is beyond our control), that is a sufficient amount of coding might fix these problems eventually.

- SQLite3 handles auto-increment columns in a fairly non-intuitive way. Only the type INTEGER PRIMARY KEY auto-increments. As a user of other database engine you might expect the row IDs to be 4-byte integers (they were in 2.x), but nope: they are in fact 8-byte integers, and therefore equivalent to INT8 or BIGINT of other engines. This leaves us with the odd "feature" of the sqlite3 driver that INTEGER is a 4-byte integer, whereas INTEGER PRIMARY KEY is a 8-bit integer type. If this were not the case, auto-incrementing columns would be artificially limited to the range of 4-byte integers. On the other hand this means that you cannot declare a real 4-byte integer auto-incrementing column.

  Warning
  Do not forget to use `dbi_result_get_longlong()` or `dbi_result_get_ulonglong` to retrieve values from columns declared as INTEGER PRIMARY KEY.

- The (essentially) typeless nature of SQLite has some nasty consequences. The sqlite driver takes great care to reconstruct the type of a field that you request in a query, but this isn't always successful. To help the driver get things right, please stick to the following rules:

  - When using a function as a result column [e.g. count(*)], the opening bracket must hug the function name as shown. The function call must also be aliased.

  - When using an expression as a result column [e.g. (count(*) + 6)], the entire expression must be enclosed in brackets as shown and must also be aliased.

- The sqlite driver currently assumes that the directory separator of your filesystem is a slash (/). This may be wrong on your particular system. It is not a problem for Windows systems as long as the sqlite driver is built with the Cygwin tools (see `README.win32`).

- Listing tables with the `dbi_conn_get_table_list()` libdbi function currently returns only permanent tables. Temporary tables are ignored.

- The sqlite driver assumes that table and field names do not exceed 128 characters in length, including the trailing \0. I don't know whether SQLite internally has such a limit or not (both MySQL and PostgreSQL have a lower limit). The limit can be increased by changing a single #define in the `dbd_sqlite.h` header file.

- In a few cases, the sqlite driver expects you to type SQL keywords in all lowercase or all uppercase, but not mixed. This holds true for the 'from' in a SELECT statement. Type it either as 'from' or as 'FROM', but refrain from using 'fRoM' or other funny mixtures of uppercase and lowercase. Most other database engines treat the keywords as case-insensitive and would accept all variants.

Prev | Home | Next
SQLite3 (mis)features | Up | GNU Free Documentation License