제한 사항

원문 보기 위키 갱신 2026.10.11

제한 사항 (Limitations)

Turso Cloud는 대부분의 SQLite 기능과 호환되지만, 특히 순수 SQLite에서 갈아타는 경우 알아 두어야 할 알려진 제한이 몇 가지 있어요. 미리 알고 준비하면 마이그레이션이 훨씬 수월해요.

출처: 문서

Turso Cloud는 대부분의 SQLite 기능과 호환되지만, 특히 순수 SQLite(vanilla SQLite)에서 마이그레이션하는 경우 알아 두어야 할 몇 가지 알려진 제한이 있어요.

일부 SQLite pragma 문은 Turso Cloud에서 다르게 동작하거나 지원되지 않아요.

Pragma	참고
`user_version`	Turso Cloud에서 읽기 전용이에요. 스키마 마이그레이션 추적에는 대신 `_schema_version` 테이블을 사용하세요.
`application_id`	Turso Cloud에서 읽기 전용이에요. 애플리케이션 식별자 저장에는 대신 `_metadata` 테이블을 사용하세요.
`busy_timeout`	지원되지 않아요. Turso Cloud가 동시성을 내부적으로 관리하므로 busy timeout 설정은 효과가 없어요.
`journal_mode`	지원되지 않아요. Turso Cloud가 저널링을 내부적으로 관리하며 저널 모드 변경을 허용하지 않아요.

PRAGMA user_version으로 스키마 마이그레이션을 추적하고 있다면(순수 SQLite에서 흔한 패턴이죠), Turso Cloud에서는 테이블 기반 방식으로 전환해야 해요:

CREATE TABLE IF NOT EXISTS _schema_version (version INTEGER NOT NULL);
INSERT INTO _schema_version (version) VALUES (0);