turso/COMPAT.md

SQLite Compatibility

This document describes the SQLite compatibility status of Limbo:

• SQL statements
• SQL functions
• SQLite API
• 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