// ferramenta gratuita

Construtor de strings de conexão do libSQL

Crie uma URL de banco de dados Turso ou libSQL com seu token de autenticação para TypeScript, Python, Go e variáveis de ambiente, ou cole uma para ver o host, se o TLS está ativado e quando o token expira. 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 strings de conexão do libSQL

Um banco de dados Turso é acessado por um libsql://<database>-<organization>.turso.io URL mais um token de autenticação (um JWT). libsql:// significa TLS; um sqld auto-hospedado na sua própria máquina normalmente escuta em conexão simples http://127.0.0.1:8080.

O decodificador lê a carga útil do token aqui mesmo em seu navegador para mostrar sua expiração e se é somente leitura. Ele não verifica a assinatura, e não envia o token para lugar nenhum.

URL do banco de dados Turso CLI, todas as SDKs libSQL

libsql://mydb-myorg.turso.io

URL com token de autenticação Go database/sql, @libsql/client, SQLly

libsql://mydb-myorg.turso.io?authToken=your_auth_token

sqld local servidor libSQL auto-hospedado

http://127.0.0.1:8080

Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao libSQL: SQLly para libSQL.

Esquemas e opções de URL do libSQL

A partir do código-fonte do @libsql/client e da referência do SDK da Turso.

Palavra-chaveSinônimosPadrãoO que faz
libsql:// - - TLS; o cliente escolhe HTTPS ou WebSockets seguros.
https:// / wss:// - - TLS sobre um transporte específico.
http:// / ws:// - - Texto puro, para um sqld local.
file: - - Um arquivo libSQL/SQLite local (incorporado).
authToken - - Parâmetro de consulta que carrega o token de autenticação; ou passe authToken / auth_token nas opções do cliente.
tls - 1 ?tls=0 desliga o TLS para libsql://; necessita de uma porta explícita.
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN - - Nomes de variáveis de ambiente que os quickstarts do Turso usam.

Erros comuns de conexão libSQL

401 Unauthorized

Por que: O token de autenticação está ausente, expirado, revogado ou pertence a outro banco de dados ou organização.

Correção: Crie um novo token com turso db tokens create <database> e cole-o no decodificador para verificar sua validade.

Connection refused on 127.0.0.1:8080

Por que: Nenhum sqld local está em execução, ou ele está ouvindo em outra porta.

Correção: Inicie o sqld (por exemplo turso dev para um servidor de desenvolvimento local) e use a URL que ele exibe.

FAQ de strings de conexão do libSQL

O que é uma URL de banco de dados Turso?

libsql://<database>-<organization>.turso.io, mostrado por turso db show <database>. Associe-o a um token de autenticação de turso db tokens create <database>.

É seguro colocar o token de autenticação na URL?

Funciona (?authToken=), mas a URL vira um segredo que acaba em logs e no histórico do shell. Prefira passar o token separadamente, por exemplo, no TURSO_AUTH_TOKEN variável de ambiente.

Esta ferramenta verifica meu token?

Decodifica o payload do token no seu navegador para mostrar a data de expiração e se ele é somente leitura. Não verifica a assinatura e nunca envia o token para lugar nenhum.

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