// ferramenta gratuita

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.

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

// 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 DuckDB e muito mais.