Voltar às perguntas frequentes sobre Bancos de dados
CENTRAL DE AJUDA · FAQBancos de dados2 min de leitura

Por que devo passar valores SQL pelo campo params?

Nas chamadas ao SQL Database da IaGenify, passe os valores da consulta pelo campo `params` em vez de inseri-los diretamente no texto SQL. Consultas parametrizadas mantêm os dados separados da estrutura do comando e facilitam a leitura e manutenção de consultas repetidas.

Bancos de dados

Mantenha os valores separados da sintaxe SQL

Uma consulta costuma combinar instruções fixas com valores de um formulário, entrada de workflow ou resultado anterior do banco. Monte o comando SQL com espaços reservados e forneça os valores correspondentes em `params`. Assim, o valor é tratado como dado, não como parte da sintaxe, reduzindo erros com aspas e escape de texto.

Use a mesma abordagem para leituras e gravações: SQL Database aceita `{ sql, params }` para leituras, enquanto operações execute aceitam `action: "execute"` junto de `sql` e `params`. Parâmetros representam valores, não nomes de tabelas ou colunas; escolha explicitamente os identificadores e a estrutura da consulta.

Confira o comando e o resultado

Use o formato de parâmetros esperado pelo banco conectado e forneça os valores na mesma ordem dos espaços reservados. Não presuma que um parâmetro possa substituir um nome de tabela, coluna ou palavra-chave SQL. Defina a estrutura intencionalmente e mantenha os dados variáveis em parâmetros.

Em uma leitura, examine as linhas retornadas e confirme que o filtro encontrou os registros pretendidos. Em uma operação execute, confira linhas, alterações ou lastRowId conforme o caso. Se uma gravação puder afetar todas as linhas, inclua uma condição WHERE deliberada; atualizações e exclusões sem limite exigem `all: true`.

Voltar às perguntas frequentes sobre Bancos de dados