# SQLite Compatibility

This document describes the SQLite compatibility status of Limbo:

* [SQL statements](#sql-statements)
* [SQL functions](#sql-functions)
* [SQLite API](#sqlite-api)
* [SQLite VDBE opcodes](#sqlite-vdbe-opcodes)

## SQL statements

| Statement                    | Status  | Comment |
|------------------------------|---------|---------|
| ALTER TABLE                  | No      |         |
| ANALYZE                      | No      |         |
| ATTACH DATABASE              | No      |         |
| BEGIN TRANSACTION            | No      |         |
| COMMIT TRANSACTION           | No      |         |
| CREATE INDEX                 | No      |         |
| CREATE TABLE                 | No      |         |
| CREATE TRIGGER               | No      |         |
| CREATE VIEW                  | No      |         |
| CREATE VIRTUAL TABLE         | No      |         |
| DELETE                       | No      |         |
| DETACH DATABASE              | No      |         |
| DROP INDEX                   | No      |         |
| DROP TABLE                   | No      |         |
| DROP TRIGGER                 | No      |         |
| DROP VIEW                    | No      |         |
| END TRANSACTION              | No      |         |
| EXPLAIN                      | Yes     |         |
| INDEXED BY                   | No      |         |
| INSERT                       | Partial |         |
| ON CONFLICT clause           | No      |         |
| PRAGMA                       | Partial |         |
| PRAGMA cache_size            | Yes     |         |
| REINDEX                      | No      |         |
| RELEASE SAVEPOINT            | No      |         |
| REPLACE                      | No      |         |
| RETURNING clause             | No      |         |
| ROLLBACK TRANSACTION         | No      |         |
| SAVEPOINT                    | No      |         |
| SELECT                       | Partial |         |
| SELECT ... WHERE             | Partial |         |
| SELECT ... WHERE ... LIKE    | Yes     |         |
| SELECT ... LIMIT             | Yes     |         |
| SELECT ... ORDER BY          | Partial |         |
| SELECT ... GROUP BY          | Partial |         |
| SELECT ... JOIN              | Partial |         |
| SELECT ... CROSS JOIN        | Partial |         |
| SELECT ... INNER JOIN        | Partial |         |
| SELECT ... OUTER JOIN        | Partial |         |
| UPDATE                       | No      |         |
| UPSERT                       | No      |         |
| VACUUM                       | No      |         |
| WITH clause                  | No      |         |

## SQL functions

### Scalar functions

| Function                     | Status | Comment |
|------------------------------|--------|---------|
| abs(X)                       | Yes    |         |
| changes()                    | No     |         |
| char(X1,X2,...,XN)           | Yes    |         |
| coalesce(X,Y,...)            | Yes    |         |
| concat(X,...)                | Yes    |         |
| concat_ws(SEP,X,...)         | Yes    |         |
| format(FORMAT,...)           | No     |         |
| glob(X,Y)                    | No     |         |
| hex(X)                       | No     |         |
| ifnull(X,Y)                  | Yes    |         |
| iif(X,Y,Z)                   | No     |         |
| instr(X,Y)                   | No     |         |
| last_insert_rowid()          | No     |         |
| length(X)                    | Yes    |         |
| like(X,Y)                    | No     |         |
| like(X,Y,Z)                  | No     |         |
| likelihood(X,Y)              | No     |         |
| likely(X)                    | No     |         |
| load_extension(X)            | No     |         |
| load_extension(X,Y)          | No     |         |
| lower(X)                     | Yes    |         |
| ltrim(X)                     | Yes    |         |
| ltrim(X,Y)                   | Yes    |         |
| max(X,Y,...)                 | Yes    |         |
| min(X,Y,...)                 | Yes    |         |
| nullif(X,Y)                  | Yes    |         |
| octet_length(X)              | No     |         |
| printf(FORMAT,...)           | No     |         |
| quote(X)                     | Yes    |         |
| random()                     | Yes    |         |
| randomblob(N)                | No     |         |
| replace(X,Y,Z)               | No     |         |
| round(X)                     | Yes    |         |
| round(X,Y)                   | Yes    |         |
| rtrim(X)                     | Yes    |         |
| rtrim(X,Y)                   | Yes    |         |
| sign(X)                      | Yes    |         |
| soundex(X)                   | No     |         |
| sqlite_compileoption_get(N)  | No     |         |
| sqlite_compileoption_used(X) | No     |         |
| sqlite_offset(X)             | No     |         |
| sqlite_source_id()           | No     |         |
| sqlite_version()             | Yes    |         |
| substr(X,Y,Z)                | Yes    |         |
| substr(X,Y)                  | Yes    |         |
| substring(X,Y,Z)             | Yes    |         |
| substring(X,Y)               | Yes    |         |
| total_changes()              | No     |         |
| trim(X)                      | Yes    |         |
| trim(X,Y)                    | Yes    |         |
| typeof(X)                    | No     |         |
| unhex(X)                     | No     |         |
| unhex(X,Y)                   | No     |         |
| unicode(X)                   | Yes    |         |
| unlikely(X)                  | No     |         |
| upper(X)                     | Yes    |         |
| zeroblob(N)                  | No     |         |

### Aggregate functions

| Function                     | Status  | Comment |
|------------------------------|---------|---------|
| avg(X)                       | Yes     |         |
| count()                      | Yes     |         |
| count(*)                     | Yes     |         |
| group_concat(X)              | Yes     |         |
| group_concat(X,Y)            | Yes     |         |
| string_agg(X,Y)              | Yes     |         |
| max(X)                       | Yes     |         |
| min(X)                       | Yes     |         |
| sum(X)                       | Yes     |         |
| total(X)                     | Yes     |         |


### Date and time functions

| Function    | Status  | Comment                      |
|-------------|---------|------------------------------|
| date()      | Yes     | partially supports modifiers |
| time()      | Yes     | partially supports modifiers |
| datetime()  | No      |                              |
| julianday() | No      |                              |
| unixepoch() | Partial | does not support modifiers   |
| strftime()  | No      |                              |
| timediff()  | No      |                              |

### JSON functions

| Function                           | Status  | Comment |
|------------------------------------|---------|---------|
| json(json)                         | Partial |         |
| jsonb(json)                        |         |         |
| json_array(value1,value2,...)      |         |         |
| jsonb_array(value1,value2,...)     |         |         |
| json_array_length(json)            |         |         |
| json_array_length(json,path)       |         |         |
| json_error_position(json)          |         |         |
| json_extract(json,path,...)        |         |         |
| jsonb_extract(json,path,...)       |         |         |
| json -> path                       |         |         |
| json ->> path                      |         |         |
| json_insert(json,path,value,...)   |         |         |
| jsonb_insert(json,path,value,...)  |         |         |
| json_object(label1,value1,...)     |         |         |
| jsonb_object(label1,value1,...)    |         |         |
| json_patch(json1,json2)            |         |         |
| jsonb_patch(json1,json2)           |         |         |
| json_pretty(json)                  |         |         |
| json_remove(json,path,...)         |         |         |
| jsonb_remove(json,path,...)        |         |         |
| json_replace(json,path,value,...)  |         |         |
| jsonb_replace(json,path,value,...) |         |         |
| json_set(json,path,value,...)      |         |         |
| jsonb_set(json,path,value,...)     |         |         |
| json_type(json)                    |         |         |
| json_type(json,path)               |         |         |
| json_valid(json)                   |         |         |
| json_valid(json,flags)             |         |         |
| json_quote(value)                  |         |         |
| json_group_array(value)            |         |         |
| jsonb_group_array(value)           |         |         |
| json_group_object(label,value)     |         |         |
| jsonb_group_object(name,value)     |         |         |
| json_each(json)                    |         |         |
| json_each(json,path)               |         |         |
| json_tree(json)                    |         |         |
| json_tree(json,path)               |         |         |

## SQLite API

| Interface                    | Status  | Comment |
|------------------------------|---------|---------|
| sqlite3_open                 | Partial |         |
| sqlite3_close                | Yes     |         |
| sqlite3_prepare              | Partial |         |
| sqlite3_finalize             | Yes     |         |
| sqlite3_step                 | Yes     |         |
| sqlite3_column_text          | Yes     |         |


## SQLite VDBE opcodes

| Opcode          | Status |
|-----------------|--------|
| Add             | Yes    |
| AddImm          | No     |
| Affinity        | No     |
| AggFinal        | Yes    |
| AggStep         | Yes    |
| AggStep         | Yes    |
| And             | No     |
| AutoCommit      | No     |
| BitAnd          | No     |
| BitNot          | No     |
| BitOr           | No     |
| Blob            | No     |
| Checkpoint      | No     |
| Clear           | No     |
| Close           | No     |
| CollSeq         | No     |
| Column          | Yes    |
| Compare         | No     |
| Concat          | No     |
| Copy            | Yes    |
| Count           | No     |
| CreateIndex     | No     |
| CreateTable     | No     |
| DecrJumpZero    | Yes    |
| Delete          | No     |
| Destroy         | No     |
| Divide          | No     |
| DropIndex       | No     |
| DropTable       | No     |
| DropTrigger     | No     |
| EndCoroutine    | Yes    |
| Eq              | Yes    |
| Expire          | No     |
| Explain         | No     |
| FkCounter       | No     |
| FkIfZero        | No     |
| Found           | No     |
| Function        | Yes    |
| Ge              | Yes    |
| Gosub           | No     |
| Goto            | Yes    |
| Gt              | Yes    |
| Halt            | Yes    |
| HaltIfNull      | No     |
| IdxDelete       | No     |
| IdxGE           | No     |
| IdxInsert       | No     |
| IdxLT           | No     |
| IdxRowid        | No     |
| If              | Yes    |
| IfNeg           | No     |
| IfNot           | Yes    |
| IfPos           | Yes    |
| IfZero          | No     |
| IncrVacuum      | No     |
| Init            | Yes    |
| InitCoroutine   | Yes    |
| Insert          | No     |
| InsertAsync     | Yes    |
| InsertAwait     | Yes    |
| InsertInt       | No     |
| Int64           | No     |
| Integer         | Yes    |
| IntegrityCk     | No     |
| IsNull          | No     |
| IsUnique        | No     |
| JournalMode     | No     |
| Jump            | No     |
| Last            | No     |
| Le              | Yes    |
| LoadAnalysis    | No     |
| Lt              | Yes    |
| MakeRecord      | Yes    |
| MaxPgcnt        | No     |
| MemMax          | No     |
| Move            | No     |
| Multiply        | No     |
| MustBeInt       | Yes    |
| Ne              | Yes    |
| NewRowid        | Yes    |
| Next            | No     |
| NextAsync       | Yes    |
| NextAwait       | Yes    |
| Noop            | No     |
| Not             | No     |
| NotExists       | Yes    |
| NotFound        | No     |
| NotNull         | Yes    |
| Null            | Yes    |
| NullRow         | Yes    |
| Once            | No     |
| OpenAutoindex   | No     |
| OpenEphemeral   | No     |
| OpenPseudo      | Yes    |
| OpenRead        | Yes    |
| OpenReadAsync   | Yes    |
| OpenWrite       | No     |
| OpenWriteAsync  | Yes    |
| OpenWriteAwait  | Yes    |
| Or              | No     |
| Pagecount       | No     |
| Param           | No     |
| ParseSchema     | No     |
| Permutation     | No     |
| Prev            | No     |
| Program         | No     |
| ReadCookie      | No     |
| Real            | Yes    |
| RealAffinity    | Yes    |
| Remainder       | No     |
| ResetCount      | No     |
| ResultRow       | Yes    |
| Return          | No     |
| Rewind          | Yes    |
| RewindAsync     | Yes    |
| RewindAwait     | Yes    |
| RowData         | No     |
| RowId           | Yes    |
| RowKey          | No     |
| RowSetAdd       | No     |
| RowSetRead      | No     |
| RowSetTest      | No     |
| Rowid           | Yes    |
| SCopy           | No     |
| Savepoint       | No     |
| Seek            | No     |
| SeekGe          | No     |
| SeekGt          | No     |
| SeekLe          | No     |
| SeekLt          | No     |
| SeekRowid       | Yes    |
| Sequence        | No     |
| SetCookie       | No     |
| ShiftLeft       | No     |
| ShiftRight      | No     |
| SoftNull        | Yes    |
| Sort            | No     |
| SorterCompare   | No     |
| SorterData      | Yes    |
| SorterInsert    | Yes    |
| SorterNext      | Yes    |
| SorterOpen      | Yes    |
| SorterSort      | Yes    |
| String          | No     |
| String8         | Yes    |
| Subtract        | No     |
| TableLock       | No     |
| ToBlob          | No     |
| ToInt           | No     |
| ToNumeric       | No     |
| ToReal          | No     |
| ToText          | No     |
| Trace           | No     |
| Transaction     | No     |
| VBegin          | No     |
| VColumn         | No     |
| VCreate         | No     |
| VDestroy        | No     |
| VFilter         | No     |
| VNext           | No     |
| VOpen           | No     |
| VRename         | No     |
| VUpdate         | No     |
| Vacuum          | No     |
| Variable        | No     |
| VerifyCookie    | No     |
| Yield           | Yes    |