pgref.dev/sqlite/errors/SQLITE_OK_SYMLINK
SQLITE_OK_SYMLINKSUCCESSTier 1 — Safe⚠️ MEDIUM confidence

File is a symlink (success with note)

Category: File AccessVersions: 3.31.0+

🔴 Production Risk Error

None — success code.

What this means

SQLITE_OK_SYMLINK (512) is returned by the xGetSystemCall VFS method to indicate that the database path is a symbolic link but the open was permitted (SQLITE_OPEN_NOFOLLOW was not set).

Why it happens

  1. 1Not an error — returned internally to note that the file is a symlink.

How to reproduce

Internal VFS open logic; not normally visible to application code.

trigger — this will ERROR
# SQLITE_OK_SYMLINK is internalnot surfaced to Python/driver level
# It indicates the VFS observed a symlink but allowed it
Open succeeds; no exception raised.

Fix 1

Why this works

No fix needed — this is a success code with an informational note about symlinks.

Version notes

Sources

📚 Official docs: https://www.sqlite.org/rescode.html#ok_symlink

🔧 Source ref: sqlite3.h — SQLITE_OK_SYMLINK = 512

Confidence assessment

⚠️ MEDIUM confidence

Stable.

See also

⚙️ This error reference was generated with AI assistance and reviewed for accuracy. Examples are provided to illustrate common scenarios and may not cover every case. Always test fixes in a development environment before applying to production. Spotted an error? Suggest a correction →