Início / dba / Perguntas / 300507
Accepted
ARX
Asked: 2021-10-03 19:21:13 +0800 CST

O que significa BEGIN ATOMIC ... END em uma função/procedimento SQL do PostgreSQL?

  • 772

Na documentação do PG 14, na CREATE FUNCTIONseção, o manual diz que o corpo de uma LANGUAGE SQLfunção pode ser uma única declaração:

RETURN expression

ou um bloco:

BEGIN ATOMIC
statement;
statement;
...
statement;
END

sem dar qualquer explicação sobre a semântica desse bloco. Isso se parece com um BEGIN ... END;bloco em PL/pgSQL, mas parece ser algo diferente.

Qual é a diferença entre escrever um conjunto de instruções dentro ou sem BEGIN ATOMIC ... END? Quando é necessário usar tal bloco? A ATOMICpalavra-chave é obrigatória?

postgresql functions

1 respostas

  1. Best Answer

    Essa é a nova (no Postgres 14) variante de sintaxe para funções padrão SQL .
    As notas de lançamento:

    Permitir que funções e procedimentos da linguagem SQL usem corpos de função padrão SQL (Peter Eisentraut)

    Anteriormente, apenas os corpos de função literais de string eram suportados. Ao escrever uma função ou procedimento na sintaxe padrão SQL, o corpo é analisado imediatamente e armazenado como uma árvore de análise. Isso permite um melhor rastreamento de dependências de função e pode ter benefícios de segurança.

    As funções e procedimentos tradicionais do Postgres salvam o corpo como uma string literal a ser analisada em tempo de execução, normalmente usando cotações de dólares. Ver:

    A nova sintaxe BEGIN ATOMIC ... END(com obrigatório ATOMIC!) não cita o corpo da função, que é analisado no momento da criação. Ele só se parece com um bloco PL/pgSQL, que é decorado com BEGIN ... END. Ambos são muito distintos. A nova variante de sintaxe só é permitida para LANGUAGE sql. Na verdade, essa linguagem é assumida sem declaração. O manual:

    O padrão é sqlse sql_bodyfor especificado.

    Você pode escrever várias instruções SQL puro, bem como em funções tradicionais de string literal ou corpos de procedimentos. Mas tudo é analisado no momento da criação da função. Portanto, "ligação antecipada" versus "ligação tardia" para a forma tradicional de string literal. Isso tem vários efeitos colaterais.
    Há uma boa explicação para a sintaxe padrão do SQL no manual :

    Isso é semelhante a escrever o texto do corpo da função como uma constante de string (veja a definição acima), mas há algumas diferenças: Este formulário só funciona para LANGUAGE SQL, o formulário de constante de string funciona para todos os idiomas. Este formulário é analisado em tempo de definição da função, o formulário constante de string é analisado em tempo de execução; portanto, este formulário não pode suportar tipos de argumentos polimórficos e outras construções que não podem ser resolvidas no momento da definição da função. Este formulário rastreia as dependências entre a função e os objetos usados ​​no corpo da função, portanto DROP ... CASCADE, funcionará corretamente, enquanto o formulário usando literais de string pode deixar funções pendentes. Finalmente, este formulário é mais compatível com o padrão SQL e outras implementações SQL.

    A nova variante de sintaxe normalmente será preferível para funções SQL simples.

    Exemplo de código
    CREATE OR REPLACE FUNCTION asterisks(n int)
  RETURNS SETOF text
  LANGUAGE sql IMMUTABLE STRICT PARALLEL SAFE
BEGIN ATOMIC
SELECT repeat('*', g) FROM generate_series (1, n) g;
END;
    • 13

relate perguntas