Consulta SQL Server

O nó Consulta SQL Server permite executar uma query SQL em um banco de dados Microsoft SQL Server e trazer o resultado para o Dataflow.

---

⚙️ Parâmetros de Configuração

Conexão

• Descrição — A string de conexão ou o nome da credencial cadastrada
• Tipo — String / Seleção
• Valor:
  • Pode ser uma credencial salva no sistema (selecionável no dropdown)
  • Pode ser uma Variável Global no formato NOME_DA_VARIAVEL — a variável deve conter a connection string completa

Consulta SQL

• Descrição — O comando SQL SELECT que será executado no banco
• Tipo — Texto (Editor SQL)
• Exemplo:

  SELECT [Id], [Nome], [ValorTotal]
  FROM [Vendas]
  WHERE [DataVenda] >= DATEADD(day, -1, GETDATE())

---

🔧 Detalhes Técnicos

• Streaming — O conector utiliza DataEnumerator para ler os dados linha a linha (streaming), evitando carregar todo o result set na memória RAM
• Driver — Utiliza o driver oficial Microsoft.Data.SqlClient, suportando as versões mais recentes do SQL Server e Azure SQL
• Schema — O schema é inferido automaticamente. Evite usar SELECT * para garantir que mudanças no banco não quebrem o fluxo

---

📝 Exemplo de Uso

1. Arraste o nó Consulta SQL Server para o canvas
2. Selecione a credencial do banco corporativo
3. No campo SQL, insira a query para buscar os novos pedidos
4. Conecte a saída deste nó a um processador de transformação ou destino