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.
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 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-chave | Sinônimos | Padrão | O 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.
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 DuckDB
- 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 libSQL e muito mais.