// ferramenta gratuita

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.

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-chaveSinônimosPadrãoO 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-chaveSinônimosPadrãoO 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.

// dispense as strings por completo

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.