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ça | O que faz | Onde ele é executado |
|---|---|---|
| Seu aplicativo web | Autentica 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.app | Emite 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
- Está avaliando? Ler Como funciona, então siga o Início rápido. Toda conta sqlly.app inclui um teste gratuito de três meses (um usuário, um bridge), então você não precisa comprar nada para experimentar.
- Quer integrar? Faça o tour do aplicativo de exemplo para ver o que seu aplicativo precisa fornecer e, em seguida, seguir Crie seu próprio app com o Referência da API (ou carregue swagger.json em suas ferramentas de API).
- Vai implantar? Ler Licenciamento para assentos, domínios e o que cada estado de licença significa, depois Indo para produção.
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
Originestá nesse domínio (alémlocalhostenquanto 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.