SQLite 연결 문자열 빌더
파일 경로로 Microsoft.Data.Sqlite, JDBC, SQLAlchemy, Python, Node용 SQLite 연결 문자열을 만들거나, URI 파일 이름이나 Data Source 문자열을 붙여넣어 각 옵션이 무엇을 하는지 확인하세요. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.
이 연결을 SQLly에서 열기
설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.
SQLite 연결 문자열 형식
SQLite "연결 문자열"은 대부분 파일 경로이지만, 각 래퍼(wrapper)가 다르게 처리합니다: Data Source=app.db .NET에서는, jdbc:sqlite:/path Java에서는, sqlite:////abs/path.db (슬래시 네 개)를 쓰는 SQLAlchemy. SQLite 자체의 URI 파일 이름(file:app.db?mode=ro)은 읽기 전용 모드와 같은 옵션을 추가할 수 있지만, 호출자가 URI 처리를 활성화할 때만 작동합니다.
파일 경로 sqlite3 CLI, 대부분의 드라이버, SQLly
/var/data/app.db
URI 파일 이름 (읽기 전용) SQLite URI 파일 이름
file:///var/data/app.db?mode=ro
ADO.NET Microsoft.Data.Sqlite, EF Core
Data Source=/var/data/app.db;Mode=ReadOnly
JDBC xerial sqlite-jdbc
jdbc:sqlite:/var/data/app.db
SQLAlchemy URL Python SQLAlchemy
sqlite:////var/data/app.db
다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 SQLite에 연결하는 방법 더 알아보기: SQLite용 SQLly.
SQLite URI 파일 이름 매개변수
스킴은 file:; authority는 비어 있거나 다음이어야 합니다 localhost, 그래서 file:/abs/path, file:///abs/path 그리고 file://localhost/abs/path 은 모두 같은 파일입니다. 인코딩할 때는 ? as %3F 그리고 # as %23 경로에 들어갑니다. URI 처리는 기본적으로 꺼져 있으며, 다음으로 켤 수 있습니다 SQLITE_OPEN_URI, uri=True 를 사용하여 활성화하거나, 사용하는 래퍼의 대응 기능을 사용하세요.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
mode |
- | rwc | ro 읽기 전용, rw 읽기-쓰기 (존재해야 함), rwc 읽기-쓰기-생성, memory 인메모리입니다. |
cache |
- | 개인 | shared 한 프로세스의 연결들이 캐시를 공유하도록 허용합니다. |
immutable |
- | 0 | 1 파일이 절대 바뀌지 않는다고 약속합니다: 잠금 전혀 없음. 누군가 쓰기라도 하면 읽기가 깨짐. |
nolock |
- | 0 | 1 파일 잠금 비활성화. |
vfs |
- | 기본 VFS | 사용할 VFS 모듈의 이름. |
psow |
- | 빌드 기본값 | 정전에도 안전한 덮어쓰기. |
Microsoft.Data.Sqlite 키워드
ADO.NET 스타일. 데이터 원본은 URI 파일 이름일 수도 있습니다.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
Data Source |
DataSource, 파일 이름 | 비어 있음 (임시 디스크 상 데이터베이스) | 파일 경로, :memory:, 또는 URI 파일 이름. |
Mode |
- | ReadWriteCreate | ReadWriteCreate, ReadWrite, ReadOnly, Memory. |
Cache |
- | 기본값 | Default, Private, Shared. |
Password |
- | - | 보냄 PRAGMA key; SQLCipher와 같은 암호화 지원 빌드 필요. |
Foreign Keys |
- | 비어 있음 (프래그마 없음) | True 켜기 PRAGMA foreign_keys. |
Recursive Triggers |
- | 거짓 | PRAGMA recursive_triggers. |
Default Timeout |
명령 제한 시간 | 30 | 6.0+. 초 단위; 잠긴 데이터베이스를 기다릴 시간이기도 합니다. |
Pooling |
- | 참 | 6.0+. 연결 풀링. |
일반적인 SQLite 연결 오류
unable to open database file
이유: SQLITE_CANTOPEN: 디렉터리가 존재하지 않거나, 프로세스가 디렉터리에 쓸 수 없거나(SQLite는 데이터베이스 옆에 저널 파일을 만들어야 함), 예상 밖의 작업 디렉터리를 기준으로 풀린 상대 경로이거나, ~ 가 사용되었습니다(SQLite는 이를 확장하지 않습니다).
해결: 절대 경로를 사용하고 디렉터리를 생성한 후 파일뿐 아니라 디렉터리에도 프로세스의 쓰기 권한을 부여하세요.
database is locked
이유: SQLITE_BUSY: 다른 연결이 쓰기 잠금을 보유하고 있으며, 이 연결은 충분히 기다리지 않았습니다.
해결: busy timeout을 설정(Default Timeout in Microsoft.Data.Sqlite, timeout Python에서 설정하거나, 쓰는 래퍼의 동급 기능으로. busy_timeout pragma), 쓰기 트랜잭션은 짧게 유지하고, 다음도 고려해 보세요 PRAGMA journal_mode=WAL 동시에 읽는 연결들에는 유용합니다.
attempt to write a readonly database
이유: 파일이나 그 디렉터리가 이 프로세스에 읽기 전용이거나, 다음 옵션으로 열렸습니다 mode=ro / Mode=ReadOnly.
해결: 파일과 디렉터리의 권한을 수정하거나 읽기/쓰기 모드로 여세요.
file is not a database
이유: SQLITE_NOTADB: 파일이 SQLite가 아니거나(예: DuckDB 파일), 제공하지 않은 키로 암호화되었거나 손상되었습니다.
해결: 파일이 무엇인지 확인하십시오 (file app.db macOS/Linux에서)를 누른 뒤 알맞은 엔진이나 키로 엽니다.
SQLite 연결 문자열 FAQ
SQLite 연결 문자열이란 무엇인가요?
보통 파일 경로일 뿐입니다. .NET에서는 Data Source=/path/app.db, Java에서는 jdbc:sqlite:/path/app.db, SQLAlchemy에서는 sqlite:////path/app.db 절대 경로에는 (sqlite:///app.db 상대 경로의 경우).
SQLite 데이터베이스를 읽기 전용으로 열려면 어떻게 하나요?
URI 파일 이름을 사용하고 mode=ro (file:/path/app.db?mode=ro, URI 처리가 켜진 상태로) Mode=ReadOnly in Microsoft.Data.Sqlite, open_mode=1 sqlite-jdbc에서 하거나 readonly: true better-sqlite3에서.
메모리 내 SQLite 데이터베이스는 어떻게 생성하나요?
다음을 사용하세요 :memory: 경로로 취급됩니다. 다음과 같은 공유 캐시 URI를 쓰지 않는 한 연결마다 자체 전용 데이터베이스가 할당됩니다 file::memory:?cache=shared.
SQLAlchemy SQLite URL에 슬래시가 네 개인 이유는 무엇인가요?
sqlite:// 는 스킴과 빈 호스트이고, 세 번째 슬래시는 호스트 부분을 끝내며, 나머지는 경로입니다. 절대 경로는 자체 슬래시로 시작하므로 /var/data/app.db 다음과 같이 됩니다 sqlite:////var/data/app.db.
한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.
SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, SQLite 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.