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

O que informa o resultado de uma gravação no banco de dados?

Uma execução SQL bem-sucedida retorna as linhas produzidas pela instrução, a quantidade de alterações e, quando disponível, o ID da última linha inserida. Esses campos ajudam a distinguir um comando bem-sucedido de uma gravação sem linhas correspondentes e a encaminhar um registro novo para a próxima etapa.

Bancos de dados

Interprete cada campo conforme o contexto

A quantidade de alterações descreve as linhas modificadas pela gravação; não é necessariamente igual à quantidade de linhas retornadas. Um UPDATE pode terminar sem erro e alterar zero linhas se nenhuma atender ao WHERE. Avalie se zero alterações são esperadas para a operação.

O ID da linha inserida só é útil quando a instrução cria uma linha e o banco fornece o identificador gerado. Ele não representa o ID de todas as linhas alteradas por UPDATE ou DELETE. Se outra etapa depender dele, confirme a inserção e passe o valor retornado, sem presumir um ID.

Use o resultado para planejar as próximas etapas

Em um workflow, use os valores retornados para escolher o próximo passo quando o processo depender de alteração dos dados. Zero mudanças pode seguir para uma etapa de não encontrado; um valor positivo pode continuar com confirmação ou notificação. Mantenha a condição SQL específica.

O status de execução não valida o significado de negócio da gravação. Use transações ou uma sequência planejada quando mudanças relacionadas precisarem ocorrer juntas e só informe sucesso depois de verificar os campos relevantes. Mantenha o resultado no histórico para diagnóstico.

Voltar às perguntas frequentes sobre Bancos de dados