Construtor de string de conexão do DuckDB
O DuckDB roda dentro do seu processo e abre um arquivo, então sua "string de conexão" é um caminho. Construa a URL JDBC, a chamada Python, a URL SQLAlchemy e o comando CLI para um arquivo de banco de dados, somente leitura ou em memória. 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 do DuckDB
Todo cliente DuckDB abre um caminho de arquivo de banco de dados, ou :memory: para um banco de dados temporário em memória. Apenas um processo pode abrir um arquivo com permissão de leitura e escrita por vez; vários processos podem compartilhá-lo somente leitura.
Caminho do arquivo todo cliente, SQLly
/var/data/analytics.duckdb
JDBC Driver JDBC do DuckDB
jdbc:duckdb:/var/data/analytics.duckdb
URL do SQLAlchemy duckdb-engine
duckdb:////var/data/analytics.duckdb
CLI, somente leitura duckdb
duckdb -readonly /var/data/analytics.duckdb
Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao DuckDB: SQLly para DuckDB.
Abrindo um banco de dados DuckDB
O modo somente leitura permite que diversos processos leiam um arquivo.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
JDBC |
- | jdbc:duckdb: (em memória) | jdbc:duckdb:/path/file.duckdb; somente leitura com a duckdb.read_only=true propriedade de conexão. Configurações podem seguir com ponto e vírgula: jdbc:duckdb:/path;threads=4. |
Python |
- | :memory: | duckdb.connect("file.duckdb", read_only=True). |
SQLAlchemy |
- | - | duckdb:///relative.duckdb, duckdb:////abs/path.duckdb, duckdb:///:memory:; somente leitura via connect_args={"read_only": True}. |
CLI |
- | em memória | duckdb file.duckdb; adicionar -readonly para somente leitura. |
Node.js |
- | - | @duckdb/node-api: await DuckDBInstance.create("file.duckdb"). |
Erros comuns de conexão do DuckDB
IO Error: Could not set lock on file "analytics.duckdb": Conflicting lock is held
Por que: Outro processo já abriu o arquivo em modo leitura-escrita (frequentemente um notebook, uma sessão CLI ou uma segunda instância do aplicativo).
Correção: Feche o outro processo ou abra ambos em modo somente leitura se nenhum deles precisar escrever.
IO Error: Cannot open database "analytics.duckdb" in read-only mode: database does not exist
Por que: O modo somente leitura nunca cria o arquivo, e o caminho está errado ou é relativo a um diretório de trabalho inesperado.
Correção: Use um caminho absoluto para um banco de dados existente.
FAQ sobre string de conexão do DuckDB
O DuckDB possui uma string de conexão?
Não no sentido cliente/servidor: o DuckDB é incorporado, então você abre um caminho de arquivo (ou :memory:). Os wrappers diferem: jdbc:duckdb:/path em Java, duckdb:///path no SQLAlchemy, um caminho simples em Python, Node e na CLI.
Como abrir um arquivo DuckDB em modo somente leitura?
read_only=True em Python, a duckdb.read_only=true propriedade em JDBC, connect_args={"read_only": True} no SQLAlchemy, ou duckdb -readonly file.duckdb no CLI.
Dois programas podem usar o mesmo arquivo DuckDB?
Apenas um processo pode mantê-lo aberto em leitura e escrita. Vários processos podem abri-lo em somente leitura ao mesmo tempo.
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 SQLite
- Strings de conexão do Oracle
- Strings de conexão do Redis
- Strings de conexão do ClickHouse
- 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 DuckDB e muito mais.