SQLly Embedded

Hospede o SQLly dentro do seu próprio aplicativo web: o que vem no pacote, como a bridge, o seu aplicativo e o sqlly.app se encaixam, e por onde começar.

O SQLLY Embedded coloca a versão de navegador do SQLLY dentro do seu próprio aplicativo web. Seus usuários ganham o workbench completo em uma página do seu site: o editor SQL com IntelliSense, o explorador de objetos, a grade de resultados, gráficos e planos de execução. Seu servidor fica com todas as senhas de banco de dados. Você decide quais conexões cada grupo de usuários vê, e a ponte do SQLLY faz cumprir sua licença.

O que você executa

PeçaO que fazOnde ele é executado
Seu aplicativo webAutentica seus usuários, decide qual perfil (conjunto de conexões) que cada um recebe, pede à ponte um token de inicialização e serve a página que carrega o SQLly.Seu servidor
Ponte SQLly (sqlly-bridge embedded)Guarda os perfis e as credenciais, emite tokens de lançamento, aceita WebSockets do navegador, roda um mecanismo por sessão, conta os usuários e valida a licença com sqlly.app.Seu servidor, próximo ao seu app
Mecanismo do SQLly (sqlly-cli)Conecta-se aos seus bancos de dados e executa consultas durante uma sessão do navegador. O Bridge o inicia e o encerra; nada mais se comunica com ele.Seu servidor (processo filho da ponte)
Pacote web SQLly (web/)O aplicativo SQLly compilado para WebAssembly. Arquivos estáticos servidos pelo seu aplicativo.Os navegadores dos seus usuários
sqlly.appEmite sua licença e assina uma concessão de curta duração toda vez que a ponte faz check-in (a cada 20 minutos). Licenças offline nunca entram em contato com ela.Nossa

O pacote também inclui um exemplo de aplicativo de administração (Node.js, sem dependências) que faz tudo o que seu aplicativo faria: uma tela de administração para perfis, etiquetas e usuários, e uma página de login que abre o SQLly para cada usuário. Execute-o para ver todo o fluxo, depois substitua-o pelo seu próprio aplicativo ou comece a partir do seu código.

Nesta seção

Como funciona
Como funciona por dentro: a ponte, o mecanismo por sessão, os tokens de inicialização, a concessão de licença assinada, os check-ins, os assentos, a regra de Origin e onde ficam as credenciais.
Início rápido
Execute o pacote SQLly Embedded no localhost em cinco minutos: inicie a ponte e o app de exemplo, vincule uma licença, adicione um perfil e abra o SQLly como usuário.
Tour do aplicativo de exemplo
Um tour tela a tela do app de administração de exemplo que vem com o SQLly Embedded: status e licenciamento, perfis e conexões, rótulos, usuários e como iniciar o SQLly.
Crie seu próprio app
Passo a passo: dirija a ponte SQLly Embedded a partir do seu próprio aplicativo web - armazene perfis, crie tokens de lançamento, forneça a build para o navegador, libere assentos e vincule instalações.
Abrir o SQLly em uma consulta
Inicie o SQLly direto em uma aba de consulta: o script, sua conexão e banco de dados, os valores de parâmetro e o cursor, enviados com o token de inicialização dos botões «Abrir no SQLly».
Referência da API
Todos os endpoints da API de gerenciamento da ponte SQLly Embedded, gerados a partir do seu documento OpenAPI (swagger.json), além dos endpoints de vinculação sqlly.app.
Licenciamento
Planos, assentos, sessões, instâncias, domínios, check-ins, períodos de carência, arquivos de licença offline, todos os estados de licença em que a ponte pode estar e como corrigir cada um.
Indo para produção
TLS, proxies reversos, o domínio licenciado, gerenciadores de serviço, backups, Content-Security-Policy e cabeçalhos de isolamento, e um checklist de produção para SQLly Embedded.

Escolha um caminho

A versão curta

  • As credenciais nunca chegam ao navegador. As senhas de um perfil vivem no diretório de estado da ponte. O navegador recebe apenas a lista de conexões (nomes, mecanismos, rótulos) e envia consultas pelo WebSocket da ponte.
  • Assentos são usuários simultâneos. Um usuário ocupa um assento enquanto o SQLly está aberto para ele ou enquanto tiver um token de inicialização não expirado. O assento é liberado assim que ele termina. Planos pagos permitem quatro abas por usuário.
  • Um domínio por licença - com todos os subdomínios incluídos. O bridge só aceita navegadores cujo Origin está nesse domínio (além localhost enquanto você desenvolve).
  • Todos os mecanismos que o SQLly suporta funciona através da ponte: SQL Server, Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse, Oracle, libSQL/Turso, Redis e Valkey, e as variantes em nuvem.
  • Conectado ou offline. Licenças conectadas fazem check-in no sqlly.app a cada 20 minutos. Licenças offline são um arquivo assinado que a ponte verifica localmente, sem nunca se comunicar com o servidor.

Planos e preços estão em Página SQLly Embedded. Baixe o pacote da sua plataforma em Downloads, e gerencie suas licenças, chaves e instalações vinculadas em sua página Embedded.