Introdução à instrução INSERT do PostgreSQL

instrução INSERT no PostgreSQL permite inserir uma nova linha em uma tabela.

O seguinte ilustra a sintaxe mais básica da instrução INSERT:

Nesta sintaxe:

  • Primeiro, especifique o nome da tabela ( table_name) na qual deseja inserir dados após as palavras - chave INSERT INTO e uma lista de colunas separadas por vírgulas ( colum1, column2, ....).
  • Segundo, forneça uma lista de valores separados por vírgulas entre parênteses (value1, value2, ...)após a palavra – chave VALUES. As colunas e os valores nas listas de colunas e valores devem estar na mesma ordem.

A instrução INSERT retorna uma tag de comando com o seguinte formato:

O OID é um identificador de objeto. O PostgreSQL usa o internamente OID como chave primária para suas tabelas de sistema. Normalmente, a instrução INSERT retorna OID com o valor 0. O count é o número de linhas que a instrução INSERT inseriu com êxito.

Cláusula RETURNING

A instrução INSERT também possui uma cláusula RETURNING opcional que retorna as informações da linha inserida.

Se você quiser retornar a linha inteira inserida, use um asterisco ( *) após a palavra-chave RETURNING:

Se você deseja retornar apenas algumas informações da linha inserida, você pode especificar uma ou mais colunas após a cláusula RETURNING.

Por exemplo, a seguinte instrução retorna o idda linha inserida:

Para renomear o valor retornado, você usa a palavra-chave AS seguida pelo nome da saída. Por exemplo:

Exemplos de instruções INSERT do PostgreSQL

A seguinte declaração cria uma nova tabela chamada links para a demonstração:

Observe que você aprenderá a criar uma nova tabela no tutorial subsequente. Neste tutorial, você só precisa executá-lo para criar uma nova tabela.

1) PostgreSQL INSERT – Inserindo uma única linha em uma tabela

A seguinte instrução insere uma nova linha na tabela links:

A instrução retorna a seguinte saída:

Para inserir dados de caracteres , coloque-os entre aspas simples (‘), por exemplo 'PostgreSQL Tutorial'.

Se você omitir as colunas obrigatórias na instrução INSERT, o PostgreSQL emitirá um erro. Caso você omita uma coluna opcional, o PostgreSQL usará o valor padrão da coluna para inserir.

O PostgreSQL gera automaticamente um número sequencial para a coluna serial para que você não precise fornecer um valor para a coluna serial no comando INSERT.

A seguinte declaração SELECT mostra o conteúdo da tabela links:

2) PostgreSQL INSERT – Inserindo string de caracteres que contém aspas simples

Se você deseja inserir uma string que contém uma aspa simples ( '), como O'Reilly Media, você deve usar uma aspa simples adicional ( ') para escapar dela. Por exemplo:

Resultado:

A seguinte declaração verifica a inserção:

3) PostgreSQL INSERT – Inserindo um valor de data

Para inserir um valor de data em uma coluna com o tipo DATE, você usa a data no formato 'YYYY-MM-DD'.

A instrução a seguir insere uma nova linha com uma data especificada na linkstabela:

Resultado:

4) PostgreSQL INSERT- Obtendo o último id de inserção

Para obter o último id de inserção da linha inserida, você usa a cláusula RETURNING da instrução INSERT.

Por exemplo, a instrução a seguir insere uma nova linha na tabela links e retorna o último id de inserção:

plugins premium WordPress