Nó SQL Server

O nó SQL Server permite executar consultas e operações em bancos Microsoft SQL Server. Ele oferece query builder visual para operações comuns e também permite escrever SQL customizado quando você precisa de controle total.

Visão Geral

Conexão

Usando Credenciais Salvas (Recomendado)

Selecione uma credencial do tipo SQL Server no campo Credencial. A credencial concentra os dados de conexão e evita expor senha diretamente no nó.

Configuração Manual

Em ambientes corporativos, é comum usar Encrypt habilitado. Em ambientes internos com certificado próprio, Trust Server Certificate pode ser necessário.

Modos de Consulta

O SQL Server suporta os mesmos presets visuais dos outros nós relacionais:

• Custom SQL — SQL livre com expressões {{ }};
• SELECT — query builder visual;
• EXISTS — verifica existência de registro;
• COUNT — conta registros;
• ASSERT — valida valor no banco;
• INSERT — insere registros;
• UPDATE — atualiza registros;
• DELETE — remove registros.

O query builder gera SQL compatível com SQL Server automaticamente.

Custom SQL

Use Custom SQL quando precisar escrever a consulta manualmente.

Usando Expressões no SQL

No painel atual do nó SQL Server, a query customizada é escrita diretamente no campo SQL. Para usar valores dinâmicos, escreva expressões {{ }} no próprio SQL.

Exemplo completo:

SELECT *
FROM dbo.Users
WHERE email = '{{ variables.EMAIL_TESTE }}'
  AND active = 1;

Se variables.EMAIL_TESTE for joao@exemplo.com, o SQL executado será equivalente a:

SELECT *
FROM dbo.Users
WHERE email = 'joao@exemplo.com'
  AND active = 1;

Para valores vindos de passos anteriores, use a mesma sintaxe:

SELECT *
FROM dbo.Users
WHERE id = {{ steps.api.outputs.json.id }};

Para textos, datas e valores que precisam ser tratados como string no SQL, coloque aspas:

SELECT *
FROM dbo.Orders
WHERE customer_email = '{{ steps.api.outputs.json.email }}'
  AND created_at >= '{{ variables.DATA_INICIAL }}';

Para números e flags, normalmente não use aspas:

SELECT *
FROM dbo.Users
WHERE id = {{ variables.USER_ID }}
  AND active = {{ variables.ACTIVE_FLAG }};

Cuidado: como a expressão é aplicada diretamente no SQL, use valores controlados e revise aspas em campos de texto. Evite usar conteúdo livre digitado por usuário final sem validação.

SELECT Visual

No preset SELECT, você pode montar consultas sem escrever SQL manualmente.

No SQL Server, o limite é gerado como TOP (...), não como LIMIT.

Exemplo gerado:

SELECT TOP (10) [id], [email], [active]
FROM [dbo].[Users]
WHERE [active] = 1;

Diferenças do SQL Server

Outputs

Acessando Outputs

{{ steps["sqlserver-query"].outputs.rows }}
{{ steps["sqlserver-query"].outputs.rows[0].email }}
{{ steps["sqlserver-query"].outputs.rowCount }}
{{ steps["sqlserver-query"].outputs.recordsAffected }}

Exemplos

Validar Registro Criado por API

[HTTP Request: POST /users]
    │
    ▼
[SQL Server: SELECT * FROM dbo.Users WHERE email = '{{ steps["http-request"].outputs.json.email }}']
    │
    ▼
[If: {{ steps["sqlserver-query"].outputs.rowCount > 0 }}]

Preparar Massa de Teste

INSERT INTO dbo.TestData ([key], [value])
VALUES ('pedido_teste', '{{ variables.PEDIDO_ID }}');

Limpar Massa de Teste

DELETE FROM dbo.TestData
WHERE [key] = 'pedido_teste';

Dicas

• Use credenciais salvas sempre que possível.
• Teste a conexão antes de executar o cenário.
• Coloque aspas em expressões que representam texto ou datas.
• Em ambientes com certificado interno, revise as opções Encrypt e Trust Server Certificate.
• Para consultas simples, prefira o query builder visual; para joins, procedures ou SQL avançado, use Custom SQL.