Bancos de dados¶
| Banco | --driver |
Situação |
|---|---|---|
| Microsoft SQL Server | sqlserver |
disponível |
| PostgreSQL | postgres |
disponível |
| SQLite | sqlite |
disponível |
| Oracle Database | em desenvolvimento | |
| MySQL / MariaDB | em desenvolvimento |
O Sql2DevOps conversa com cada banco no protocolo nativo dele, com drivers embutidos no executável: não é preciso instalar mais nada. As versões gerenciadas na nuvem funcionam como os seus servidores: Azure SQL Database e Managed Instance, Amazon RDS e Aurora, Google Cloud SQL e AlloyDB, Azure Database for PostgreSQL, Supabase, Neon e outros.
SQL Server¶
sqlserver://usuario:senha@host:1433?database=app
sqlserver://usuario:senha@host:1433?database=app&encrypt=true&TrustServerCertificate=false
- Os scripts são divididos nas linhas
GO, como no SSMS e no sqlcmd;GO 5repete o lote cinco vezes. - Um lote pode ter vários comandos; o relatório de falha mostra a linha onde começa o comando que falhou, como o SQL Server informa.
- Trava:
sp_getapplock.
PostgreSQL¶
postgres://usuario:senha@host:5432/app?sslmode=require
- Os scripts são divididos no
;de nível superior, respeitando textos, identificadores entre aspas, corpos$$e$tag$, comentários aninhados e blocosBEGIN ATOMIC ... END. - Cada lote é um comando; os erros vêm com SQLSTATE, detalhe, dica e a linha e coluna exatas.
- Variáveis do psql (
:'nome') funcionam;\set ON_ERROR_STOP oné ignorado. - Trava: advisory lock.
SQLite¶
A string de conexão é o caminho do arquivo do banco.
- Os scripts são divididos no
;de nível superior, respeitando corpos de trigger (CREATE TRIGGER ... BEGIN ...; END;). - O SQLite não tem trava de sessão: escritores concorrentes esperam a trava do arquivo.
-
Funções que uma aplicação registra no código (muitas vezes chamadas pelos triggers) recebem um valor fixo por destino, para os comandos nessas tabelas funcionarem:
targets: app-db: driver: sqlite dsn_env: APP_DB_PATH functions: { app_usuario: sql2devops, app_sincronizando: 0 }ou
--sqlite-function nome=valornoexece nopackage run.
Codificação dos arquivos¶
UTF-8, UTF-8 com BOM, UTF-16 e Windows-1252 são detectados automaticamente, então scripts salvos por editores antigos no Windows funcionam como estão.