Instrução UPDATE

Use a instrução UPDATE para alterar registros em uma tabela de banco de dados. O formato da instrução UPDATE é:

Copiar

UPDATE nome_tabela SET nome_coluna = expr, ... [ WHERE { condições } ]

nome_coluna é o nome de uma coluna cujo valor será alterado. Várias colunas podem ser alteradas em uma única instrução.

expr é o novo valor da coluna.

Geralmente, as expressões são valores de constante das colunas (mas elas também podem ser uma subconsulta). Você deve colocar os valores de cadeia de caracteres entre aspas simples ('). Para incluir uma aspa simples em um valor de cadeia de caracteres que já está entre aspas simples, use duas aspas simples juntas (por exemplo, 'Don''t').

As subconsultas devem ser colocadas entre parênteses.

A cláusula WHERE é qualquer cláusula válida. Ela determina quais registros são atualizados.

Exemplo

Instrução UPDATE na tabela func.

Copiar

UPDATE func SET salário=32000, isento=1 WHERE id_funcionário = 'E10001'

Cada instrução UPDATE altera todos os registros que atendem às condições na cláusula WHERE. Nesse caso, o status do salário e da isenção são alterados para todos os funcionários que têm a ID de funcionário E10001. Como as IDs de funcionário são exclusivas na tabela Funcionário, somente um registro será atualizado.

Exemplo

Instrução UPDATE na tabela func com uma subconsulta.

Copiar

UPDATE func SET salário = (SELECT avg(salário) from func) WHERE id_funcionário = ‘E10001’

Nesse caso, o salário é alterado para a média salarial da empresa para o funcionário que tem a ID de funcionário E10001.

Importante

Nos campos de container, você pode atualizar somente texto usando a instrução UPDATE, a menos que prepare uma instrução parametrizada e obtenha os dados no aplicativo. Para usar dados binários, basta atribuir o nome de arquivo colocando-o entre aspas simples ou usar a função PutAs(). Ao especificar o nome de arquivo, o tipo de arquivo é deduzido da extensão do arquivo:

Copiar

UPDATE nome_tabela SET (nome_container) = ? AS 'nome do arquivo.extensão do arquivo'

Tipos de arquivo não suportados serão inseridos como tipo FILE.

Ao usar a função PutAs() especifique o tipo: PutAs(col, 'type'), em que o valor de tipo é um tipo conforme descrito em Recuperação do conteúdo de um campo de container: CAST() function and GetAs() function.