SELECT

Cláusula FROM

A cláusula FROM especifica uma ou mais tabelas fonte para o comando SELECT. Se forem especificadas várias fontes, o resultado será o produto cartesiano (junção cruzada) de todas as fontes, mas normalmente são incluídas condições de qualificação para restringir as linhas retornadas a um pequeno subconjunto do produto cartesiano.

A cláusula FROM pode conter os seguintes elementos:

Cláusula WHERE

A cláusula opcional WHERE possui a forma geral

WHERE condição

onde condição é uma expressão que produz um resultado do tipo boolean. [8] [9] Todas as linhas que não satisfazem a esta condição são eliminadas da saída. A linha satisfaz a condição se retorna verdade quando os valores reais da linha são colocados no lugar das variáveis que os referenciam. [10]

Cláusula GROUP BY

A cláusula opcional GROUP BY possui a forma geral

GROUP BY expressão [, ...]

A cláusula GROUP BY condensa em uma única linha todas as linhas selecionadas que compartilham os mesmos valores para as expressões de agrupamento. A expressão pode ser o nome de uma coluna da entrada, ou o nome ou o número ordinal de uma coluna da saída (lista de itens do SELECT), ou uma expressão arbitrária formada por valores das colunas da entrada. Havendo ambigüidade, o nome na cláusula GROUP BY será interpretado como sendo o nome da coluna da entrada, e não o nome da coluna da saída.

As funções de agregação, caso sejam usadas, são computadas entre todas as linhas que constituem cada grupo, produzindo um valor separado para cada grupo (enquanto sem GROUP BY, uma agregação produz um único valor computado entre todas as linhas selecionadas). Quando GROUP BY está presente, não é válido a lista de expressões do SELECT fazer referência a colunas não agrupadas, exceto dentro das funções de agregação, uma vez que haveria mais de um valor possível retornado por uma coluna não agrupada.

Cláusula HAVING

A cláusula opcional HAVING possui a forma geral

HAVING condição

onde a condição é especificada da mesma forma que na cláusula WHERE.

A cláusula HAVING elimina os grupos de linhas que não satisfazem a condição. A cláusula HAVING é diferente da cláusula WHERE: WHERE filtra individualmente as linhas antes do GROUP BY ser aplicado, enquanto HAVING filtra grupos de linhas criados pelo GROUP BY. Cada coluna referenciada na condição deve referenciar sem ambigüidade uma coluna de agrupamento, a menos que a referência apareça dentro de uma função de agregação.

A presença da cláusula HAVING torna a consulta uma consulta agrupada, mesmo que não exista a cláusula GROUP BY. É o mesmo que acontece quando a consulta contém funções de agregação mas não possui a cláusula GROUP BY. Todas as linhas selecionadas são consideradas como formando um único grupo, e tanto a lista do SELECT quanto a cláusula HAVING somente podem fazer referência a colunas da tabela dentro de funções de agregação. Este tipo de consulta gera uma única linha se a condição da cláusula HAVING for verdade, ou nenhuma linha se não for verdade.

Lista do SELECT

A lista do SELECT (entre as palavras chave SELECT e FROM) especifica expressões que formam as linhas de saída do comando SELECT. As expressões podem (e geralmente fazem) referenciar colunas computadas na cláusula FROM. Usando a cláusula AS nome_de_saída, pode ser especificado outro nome para uma coluna da saída. Este nome é usado, principalmente, como rótulo da coluna mostrada. Também pode ser usado para fazer referência ao valor da coluna nas cláusulas ORDER BY e GROUP BY, mas não nas cláusulas WHERE e HAVING; nestas, a expressão deve ser escrita.

Em vez da expressão pode ser escrito * na lista de saída, como abreviação para todas as colunas das linhas selecionadas. Também pode ser escrito nome_da_tabela.* como abreviação das colunas provenientes apenas desta tabela.

Cláusula UNION

A cláusula UNION possui a forma geral

comando_de_seleção UNION [ ALL ] comando_de_seleção

onde comando_de_seleção é qualquer comando SELECT sem as cláusulas ORDER BY, LIMIT e FOR UPDATE (as cláusulas ORDER BY e LIMIT podem ser aplicadas a uma subexpressão se esta estiver entre parênteses. Sem os parênteses, estas cláusulas são consideradas como aplicadas ao resultado da cláusula UNION, e não à sua expressão de entrada à direita).

O operador UNION computa o conjunto união das linhas retornadas pelos comandos SELECT envolvidos. Uma linha estará presente no conjunto união dos dois conjuntos de resultados se estiver presente em pelo menos um destes dois conjuntos de resultados. Os dois comandos SELECT que representam os operandos diretos do operador UNION devem produzir o mesmo número de colunas, e as colunas correspondentes devem possuir tipos de dado compatíveis.

O resultado do operador UNION não contém nenhuma linha duplicada, a menos que a opção ALL seja especificada. ALL não permite a eliminação das duplicatas( portanto, UNION ALL geralmente é significativamente mais rápido do que UNION; deve ser utilizado ALL se for possível).

Havendo vários operadores UNION no mesmo comando SELECT, estes são avaliados da esquerda para a direita, a menos que os parênteses indiquem o contrário.

Atualmente não pode ser especificado FOR UPDATE nem para o resultado do operador UNION, nem para qualquer entrada do operador UNION. [11] [12]

Cláusula INTERSECT

A cláusula INTERSECT possui a forma geral

comando_de_seleção INTERSECT [ ALL ] comando_de_seleção

onde comando_de_seleção é qualquer comando SELECT sem as cláusulas ORDER BY, LIMIT e FOR UPDATE.

O operador INTERSECT computa o conjunto interseção das linhas retornadas pelos comandos SELECT envolvidos. Uma linha estará na interseção dos dois conjuntos de resultados se estiver presente nos dois conjuntos de resultados.

O resultado do operador INTERSECT não contém nenhuma linha duplicada, a menos que a opção ALL seja especificada. Usando ALL, uma linha contendo m duplicatas na tabela à esquerda e n duplicatas na tabela à direita, aparecerá min(m,n) vezes no conjunto de resultados.

Havendo vários operadores INTERSECT no mesmo comando SELECT, estes são avaliados da esquerda para a direita, a menos que os parênteses indiquem outra ordem. O operador INTERSECT tem nível de precedência superior ao do operador UNION, ou seja, A UNION B INTERSECT C é lido como A UNION (B INTERSECT C).

Atualmente a cláusula FOR UPDATE não pode ser especificada para o resultado do operador INTERSECT, nem em qualquer entrada do operador INTERSECT.

Cláusula EXCEPT

A cláusula EXCEPT possui a forma geral

comando_de_seleção EXCEPT [ ALL ] comando_de_seleção

onde comando_de_seleção é qualquer comando SELECT sem as cláusulas ORDER BY, LIMIT e FOR UPDATE.

O operador EXCEPT computa o conjunto de linhas presentes no resultado do comando SELECT à esquerda, mas que não estão presentes no resultado do comando à direita.

O resultado do operador EXCEPT não contém nenhuma linha duplicada, a menos que a cláusula ALL seja especificada. Usando ALL, uma linha que possua m duplicatas na tabela à esquerda e n duplicatas na tabela à direita aparecerá max(m-n,0) vezes no conjunto de resultados.

Havendo vários operadores EXCEPT no mesmo comando SELECT, estes são processados da esquerda para a direita, a menos que os parênteses especifiquem outra ordem. O operador EXCEPT possui o mesmo nível de precedência do operador UNION.

Atualmente a cláusula FOR UPDATE não pode ser especificada para o resultado do operador EXCEPT, nem em nenhuma entrada do operador EXCEPT.

Cláusula ORDER BY

A cláusula opcional ORDER BY possui a forma geral

ORDER BY expressão [ ASC | DESC | USING operador ] [, ...]

onde expressão pode ser o nome ou o número ordinal de uma coluna da saída (item da lista do SELECT), ou pode ser uma expressão arbitrária formada por valores das colunas da entrada.

A cláusula ORDER BY faz as linhas do resultado serem classificadas de acordo com as expressões especificadas. Se duas linhas forem iguais de acordo com a expressão mais à esquerda, estas serão comparadas de acordo com a próxima expressão, e assim por diante. Se forem iguais de acordo com todas as expressões especificadas, serão retornadas em uma ordem dependente da implementação.

O número ordinal se refere à posição ordinal (esquerda para a direita) da coluna do resultado. Esta funcionalidade torna possível definir uma ordenação baseada em uma coluna que não possui um nome único. Isto nunca é imprescindível, porque sempre é possível atribuir um nome à coluna do resultado usando a cláusula AS.

Também é possível utilizar expressões arbitrárias na cláusula ORDER BY, incluindo colunas que não aparecem na lista de resultado do SELECT. Portanto, o seguinte comando é válido:

SELECT nome FROM distribuidores ORDER BY codigo;

A limitação desta funcionalidade é que a cláusula ORDER BY aplicada ao resultado das cláusulas UNION, INTERSECT ou EXCEPT somente pode especificar nomes de coluna ou números, mas não expressões.

Se a expressão na cláusula ORDER BY for simplesmente um nome correspondendo tanto ao nome de uma coluna do resultado quanto ao nome de uma coluna da entrada, a cláusula ORDER BY interpretará como sendo o nome da coluna do resultado. Esta é a escolha oposta à feita pela cláusula GROUP BY na mesma situação. Esta inconsistência está presente para ficar compatível com o padrão SQL.

Pode ser adicionada, opcionalmente, a palavra chave ASC (ascendente) ou DESC (descendente) após cada expressão na cláusula ORDER BY. Se nenhuma das duas palavras chave for especificada, ASC é assumido por padrão. Como alternativa, pode ser especificado o nome de um operador de ordenação específico na cláusula USING. Geralmente ASC é equivalente a USING < e geralmente DESC é equivalente a USING > (Mas o criador de um tipo de dado definido pelo usuário pode definir exatamente qual é a ordem de classificação padrão, podendo corresponder a operadores com outros nomes).

O valor nulo é classificado em uma posição mais alta do que qualquer outro valor. Em outras palavras, na ordem de classificação ascendente os valores nulos ficam no final, e na ordem de classificação descendente os valores nulos ficam no início. [13] [14] [15]

Dados na forma de cadeias de caracteres são classificados de acordo com a ordem de intercalação (collation [16] [17] [18] [19] ) estabelecida quando o agrupamento de bancos de dados foi inicializado.

Cláusula DISTINCT

Se for especificada a cláusula DISTINCT, todas as linhas duplicadas serão removidas do conjunto de resultados (será mantida uma linha para cada grupo de duplicatas). A cláusula ALL especifica o oposto: todas as linhas serão mantidas; este é o padrão.

DISTINCT ON ( expressão [, ...] ) preserva apenas a primeira linha de cada conjunto de linhas onde as expressões fornecidas forem iguais. As expressões em DISTINCT ON são interpretadas usando as mesmas regras da cláusula ORDER BY (veja acima). Deve ser observado que a "primeira linha" de cada conjunto é imprevisível, a menos que seja utilizado ORDER BY para garantir que a linha desejada apareça na frente. Por exemplo,

SELECT DISTINCT ON (local) local, data, condicao
    FROM tbl_condicao_climatica
    ORDER BY local, data DESC;

retorna o relatório de condição climática mais recente para cada local, mas se não tivesse sido usado ORDER BY para obrigar a ordem descendente dos valores da data para cada local, teria sido obtido um relatório com datas imprevisíveis para cada local.

As expressões em DISTINCT ON devem corresponder às expressões mais à esquerda no ORDER BY. A cláusula ORDER BY normalmente contém expressões adicionais para determinar a precedência desejada das linhas dentro de cada grupo DISTINCT ON.

Cláusula LIMIT

A cláusula LIMIT consiste em duas subcláusulas independentes:

LIMIT { contador | ALL }
OFFSET início

onde contador especifica o número máximo de linhas a serem retornadas, enquanto início especifica o número de linhas a serem puladas antes de começar a retornar as linhas. Quando as duas são especificadas, as início primeiras linhas são puladas antes de começar a contar as contador linhas a serem retornadas.

Ao se usar a cláusula LIMIT é uma boa idéia usar também a cláusula ORDER BY para colocar as linhas do resultado dentro de uma ordem única. Caso contrário será retornado um subconjunto imprevisível de linhas da consulta — pode-se estar querendo receber da décima a vigésima linha, mas da décima a vigésima em que ordem? Não é possível saber qual será a ordem, a não ser que ORDER BY seja especificado.

O planejador de comandos leva LIMIT em consideração ao gerar o plano da consulta, por isso é muito provável serem obtidos planos diferentes (produzindo linhas em ordens diferentes) dependendo do que for especificado para LIMIT e OFFSET. Portanto, utilizar valores diferentes para LIMIT/OFFSET para selecionar subconjuntos diferentes do resultado da consulta produz resultados inconsistentes, a não ser que seja imposta uma ordem previsível para os resultados utilizando ORDER BY. Isto não está errado; isto é uma conseqüência direta do fato do SQL não prometer retornar os resultados de uma consulta em nenhuma ordem específica, a não ser que ORDER BY seja utilizado para impor esta ordem.

Cláusula FOR UPDATE

A cláusula FOR UPDATE possui a forma

FOR UPDATE [ OF nome_da_tabela [, ...] ]

A cláusula FOR UPDATE faz as linhas retornadas pelo comando SELECT serem bloqueadas como se fosse para atualização. Isto impede a modificação ou exclusão destas linhas por outras transações até a transação corrente terminar. Ou seja, outras transações tentando usar os comandos UPDATE, DELETE ou SELECT FOR UPDATE nestas linhas ficarão bloqueadas até a transação corrente terminar. Também, se um comando UPDATE, DELETE, ou SELECT FOR UPDATE de outra transação já tiver bloqueado uma ou várias destas linhas, o SELECT FOR UPDATE ficará aguardando a outra transação completar e, então, irá bloquear e retornar a linha atualizada (ou nenhuma linha, se a linha foi excluída). Para obter mais explicações deve ser consultado o Capítulo 12.

Se forem especificados nomes de tabelas na cláusula FOR UPDATE, então somente as linhas vindas destas tabelas serão bloqueadas; todas as outras tabelas usadas no SELECT serão simplesmente lidas como de costume.

FOR UPDATE não pode ser utilizado nos contextos onde as linhas retornadas não podem ser claramente relacionadas com as linhas individuais da tabela; por exemplo, não pode ser utilizado junto com agregações.

FOR UPDATE pode estar antes de LIMIT para manter a compatibilidade com as versões do PostgreSQL anteriores a 7.3. Entretanto, será executado após o LIMIT e, portanto, este é o lugar adequado para ser escrito.

Cláusula FROM omitida

O PostgreSQL permite omitir a cláusula FROM. Tem uso direto no cômputo de resultados de expressões simples:

SELECT 2+2;

 ?column?
----------
        4

Alguns outros bancos de dados SQL não podem fazer isto, a não ser introduzindo uma tabela fictícia de uma linha para executar o comando SELECT.

Uma utilização menos óbvia desta funcionalidade é abreviar comandos SELECT comuns de tabelas:

SELECT distribuidores.* WHERE distribuidores.nome = 'Westward';

 id_dist |   nome
---------+----------
     108 | Westward

Isso funciona porque é adicionado um item implícito no FROM para cada tabela que é referenciada nas outras partes do comando SELECT, mas que não é mencionada no FROM.

Ao mesmo tempo em que é uma forma conveniente de abreviar, é fácil ser usado incorretamente. Por exemplo, o comando

SELECT distribuidores.* FROM distribuidores d;

provavelmente deve ser um engano; é mais provável que se deseje

SELECT d.* FROM distribuidores d;

do que a junção sem restrições

SELECT distribuidores.* FROM distribuidores d, distribuidores distribuidores;

que seria obtida na verdade. Para ajudar a detectar este tipo de engano, o PostgreSQL adverte se uma funcionalidade FROM implícita é utilizada em um comando SELECT que também contenha uma cláusula FROM explícita. Também é possível desativar a funcionalidade de FROM-implícito definindo a parâmetro add_missing_from como falso.

A palavra chave AS

No padrão SQL, a palavra chave opcional AS é sem efeito, podendo ser omitida sem afetar o significado. O analisador do PostgreSQL requer esta palavra chave quando uma coluna da saída é renomeada, porque a funcionalidade de extensividade de tipo conduz o analisador a ambigüidades caso não esteja presente. Entretanto, AS é opcional nos itens do FROM.

Espaço de nomes disponível para GROUP BY e ORDER BY

No padrão SQL-92, a cláusula ORDER BY somente pode utilizar nomes das colunas de resultado ou números, enquanto a cláusula GROUP BY somente pode utilizar expressões baseadas nos nomes das colunas da entrada. O PostgreSQL estende estas duas cláusulas para permitir, também, a outra escolha (mas utiliza a interpretação padrão se houver ambigüidade). O PostgreSQL também permite que as duas cláusulas especifiquem expressões arbitrárias. Deve ser observado que os nomes que aparecem na expressão são sempre considerados como nomes das colunas da entrada, e não como nomes das colunas do resultado.

O SQL:1999 e posteriores utilizam uma definição um pouco diferente, que não possui total compatibilidade ascendente [21] com o SQL-92. Entretanto, na maioria dos casos o PostgreSQL interpreta uma expressão presente em ORDER BY ou em GROUP BY da mesma maneira que o SQL:1999.

Cláusulas fora do padrão

As cláusulas DISTINCT ON, LIMIT e OFFSET não são definidas no padrão SQL.