Pular para conteúdo

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 5 repete 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 blocos BEGIN 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=valor no exec e no package 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.