Construtor de strings de conexão SQLite
Construa strings de conexão SQLite para Microsoft.Data.Sqlite, JDBC, SQLAlchemy, Python e Node a partir de um caminho de arquivo, ou cole um nome de arquivo URI ou uma string de Data Source para ver o que cada opção faz. Tudo roda no seu navegador: nada do que você digita é enviado para lugar nenhum.
Abrir esta conexão no SQLly
Abre o editor de conexão do SQLly preenchido.
Abrir esta conexão no SQLly
Privado por design. O construtor e o decodificador são JavaScript puro rodando nesta aba. A página não envia nenhuma solicitação com o que você digita, não armazena nada (nem mesmo no seu navegador) e continua funcionando offline após carregada. O link Abrir no SQLly vai do seu navegador direto para o aplicativo no seu computador.
Formatos de string de conexão SQLite
Uma «string de conexão» SQLite é, na maioria das vezes, um caminho de arquivo, mas cada wrapper a formata de um jeito diferente: Data Source=app.db em .NET, jdbc:sqlite:/path em Java, sqlite:////abs/path.db (quatro barras) em SQLAlchemy. Os próprios nomes de arquivos URI do SQLite (file:app.db?mode=ro) adicionam opções como modo somente leitura, mas apenas quando o chamador habilita a manipulação de URI.
Caminho do arquivo sqlite3 CLI, a maioria dos drivers, SQLly
/var/data/app.db
Nome de arquivo URI (somente leitura) Nomes de arquivos URI do SQLite
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
URL do SQLAlchemy Python SQLAlchemy
sqlite:////var/data/app.db
Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao SQLite: SQLly para SQLite.
Parâmetros de nomes de arquivo URI do SQLite
O esquema é file:; a autoridade deve estar vazia ou localhost, então file:/abs/path, file:///abs/path e file://localhost/abs/path são todos o mesmo arquivo. Codifique ? como %3F e # como %23 no caminho. O suporte a URI vem desativado por padrão: ative-o com SQLITE_OPEN_URI, uri=True em Python, ou o equivalente no seu wrapper.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
mode |
- | rwc | ro somente leitura, rw leitura e escrita (deve existir), rwc leitura, escrita e criação, memory em memória. |
cache |
- | privado | shared permite que conexões em um processo compartilhem um cache. |
immutable |
- | 0 | 1 garante que o arquivo nunca mude: sem bloqueio algum. Leituras podem estar corrompidas se alguém fizer escrita. |
nolock |
- | 0 | 1 desativa o bloqueio de arquivo. |
vfs |
- | VFS padrão | Nome do módulo VFS a ser usado. |
psow |
- | construir padrão | Sobrescrita segura. |
Palavras-chave do Microsoft.Data.Sqlite
Estilo ADO.NET. Data Source também pode ser um nome de arquivo URI.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
Data Source |
DataSource, Filename | vazio (banco de dados temporário em disco) | Caminho do arquivo, :memory:, ou um nome de arquivo URI. |
Mode |
- | ReadWriteCreate | ReadWriteCreate, ReadWrite, ReadOnly, Memory. |
Cache |
- | Padrão | Default, Private, Shared. |
Password |
- | - | Envia PRAGMA key; precisa de uma build com suporte a criptografia, como SQLCipher. |
Foreign Keys |
- | vazio (sem pragma) | True ativa PRAGMA foreign_keys. |
Recursive Triggers |
- | Falso | PRAGMA recursive_triggers. |
Default Timeout |
Tempo limite do comando | 30 | 6.0+. Segundos; também define quanto tempo esperar em um banco de dados bloqueado. |
Pooling |
- | Verdadeiro | 6.0+. Pool de conexões. |
Erros comuns de conexão SQLite
unable to open database file
Por que: SQLITE_CANTOPEN: o diretório não existe, o processo não pode escrever no diretório (o SQLite precisa criar arquivos de diário próximo ao banco de dados), um caminho relativo resolvido contra um diretório de trabalho inesperado, ou ~ foi usado (SQLite não o expande).
Correção: Use um caminho absoluto, crie o diretório e dê ao processo permissão de escrita para o diretório, não apenas para o arquivo.
database is locked
Por que: SQLITE_BUSY: outra conexão possui um bloqueio de escrita e esta não esperou tempo suficiente.
Correção: Defina um busy timeout (Default Timeout no Microsoft.Data.Sqlite, timeout no Python, busy_timeout pragma), mantenha as transações de escrita curtas e considere PRAGMA journal_mode=WAL para leitores concorrentes.
attempt to write a readonly database
Por que: O arquivo ou seu diretório é somente leitura para este processo, ou foi aberto com mode=ro / Mode=ReadOnly.
Correção: Corrija as permissões do arquivo e de seu diretório, ou abra em modo leitura-escrita.
file is not a database
Por que: SQLITE_NOTADB: o arquivo não é SQLite (por exemplo, um arquivo DuckDB), está criptografado com uma chave que você não forneceu ou está danificado.
Correção: Verifique o que é o arquivo (file app.db no macOS/Linux) e abra-o com o mecanismo ou chave corretos.
FAQ de string de conexão SQLite
Qual é a string de conexão do SQLite?
Normalmente apenas o caminho do arquivo. No .NET é Data Source=/path/app.db, em Java jdbc:sqlite:/path/app.db, em SQLAlchemy sqlite:////path/app.db para um caminho absoluto (sqlite:///app.db para um relativo).
Como faço para abrir um banco de dados SQLite em modo somente leitura?
Use um nome de arquivo URI com mode=ro (file:/path/app.db?mode=ro, com o tratamento de URI ativado), Mode=ReadOnly no Microsoft.Data.Sqlite, open_mode=1 no sqlite-jdbc, ou readonly: true no better-sqlite3.
Como criar um banco de dados SQLite em memória?
Use :memory: como o caminho. Cada conexão obtém seu próprio banco de dados privado, a menos que você use um URI de cache compartilhado, como file::memory:?cache=shared.
Por que quatro barras em uma URL do SQLAlchemy SQLite?
sqlite:// é o esquema e o host vazio, a terceira barra termina a parte do host, e o resto é o caminho. Um caminho absoluto começa com sua própria barra, então /var/data/app.db se torna sqlite:////var/data/app.db.
Outros mecanismos
- Strings de conexão do SQL Server
- Strings de conexão do PostgreSQL
- Strings de conexão do MySQL
- Strings de conexão do MariaDB
- Strings de conexão do Oracle
- Strings de conexão do Redis
- Strings de conexão do ClickHouse
- Strings de conexão do DuckDB
- Strings de conexão do libSQL
- Todos os mecanismos e formatos
- Formatador SQL
- Todas as ferramentas gratuitas
Conecte-se uma vez. Depois é só escrever SQL.
O SQLly é um ambiente de trabalho SQL nativo para macOS, Windows e Linux. Cole uma string de conexão no editor de conexões, mantenha as senhas no chaveiro do sistema e tenha IntelliSense baseado no esquema no SQLite e muito mais.