SELECT

A cláusula FROM

A cláusula FROM especifica uma ou mais tabelas de origem para o SELECT. Se múltiplas tabelas de origem forem especificadas o resultado será, conceitualmente, o produto Cartesiano de todas as linhas de todas estas tabelas -- mas, geralmente, condições de qualificação são adicionadas para restringir as linhas retornadas a um pequeno subconjunto do produto Cartesiano.

Quando o item da cláusula FROM é simplesmente o nome de uma tabela, implicitamente são incluídas as linhas das subtabelas desta tabela (filhas que herdam). Especificando-se ONLY causa a supressão das linhas das subtabelas da tabela. Antes do PostgreSQL 7.1 este era o comportamento padrão, e a adição das subtabelas era feita anexando-se um * ao nome da tabela. Este comportamento antigo está disponível através do comando SET SQL_Inheritance TO OFF;

Um item da cláusula FROM pode ser também uma subconsulta entre parênteses (note que uma cláusula aliás é exigida para a subconsulta!). Esta característica é extremamente útil porque esta é a única maneira de se obter múltiplos níveis de agrupamento, agregação ou ordenação em uma única consulta.

Finalmente, um item da cláusula FROM pode ser uma cláusula JOIN, que combina dois itens do FROM (Use parênteses, se for necessário, para determinar a ordem de aninhamento).

O CROSS JOIN e o INNER JOIN são um produto Cartesiano simples, o mesmo que seria obtido listando-se os dois itens no nível superior do FROM. O CROSS JOIN é equivalente ao INNER JOIN ON (TRUE), ou seja, nenhuma linha é removida pela qualificação. Estes tipos de junção são apenas uma notação conveniente, porque não fazem nada que não poderia ser feito usando simplesmente o FROM e o WHERE.

O LEFT OUTER JOIN retorna todas as linhas do produto Cartesiano qualificado (i.e., todas as linhas combinadas que passam pela condição ON), mais uma cópia de cada linha da tabela à esquerda para a qual não há uma linha da tabela à direita que tenha passado pela condição ON. Esta linha da tabela à esquerda é estendida por toda a largura da tabela combinada inserindo-se nulos para as colunas da tabela à direita. Observe que somente as condições ON ou USING do próprio JOIN são consideradas na hora de decidir quais linhas possuem correspondência. Condições ON ou WHERE externas são aplicadas depois.

De forma inversa, o RIGHT OUTER JOIN retorna todas as linhas da junção, mais uma linha para cada linha da tabela à direita sem correspondência (estendida com nulos na tabela à esquerda). Isto é apenas uma conveniência da notação, porque poderia ser convertido em um LEFT OUTER JOIN trocando-se a tabela à direita pela tabela à esquerda.

O FULL OUTER JOIN retorna todas as linhas da junção, mais uma linha para cada linha da tabela à esquerda sem correspondência (estendida com nulos na tabela à direita), mais uma linha da tabela à direita sem correspondência (estendida com nulos na tabela à esquerda)

Para todos os tipos de JOIN, exceto CROSS JOIN, deve-se escrever exatamente um entre ON condição_de_junção, USING ( lista_coluna_junção ), ou NATURAL. A cláusula ON é o caso mais geral: pode ser escrita qualquer expressão de qualificação envolvendo as duas tabelas da junção. A forma USING lista de colunas ( a, b, ... ) é uma abreviação para a condição ON tabela_esquerda.a = tabela_direita.a AND tabela_esquerda.b = tabela_direita.b ... Além disso, USING implica em que somente uma coluna de cada par de colunas equivalentes será incluída na saída do JOIN, e não as duas. NATURAL é uma abreviação para USING quando a lista menciona todas as colunas das tabelas com mesmo nome.

A cláusula WHERE

A condição opcional WHERE possui a forma geral:

WHERE expressão_booleana
    

A expressão_booleana pode ser qualquer expressão que retorna um valor booleano. Em muitos casos esta expressão possui a forma:

     expressão op_condição expressão
    

ou

     op_logico expressão
    

onde op_condição pode ser um entre: =, <, <=, >, >= ou <>, um operador condicional como ALL, ANY, IN, LIKE, ou um operador definido localmente, e op_logico pode ser um entre: AND, OR e NOT. O SELECT ignora todas as linhas para as quais a condição WHERE não retorna TRUE.

A cláusula GROUP BY

O GROUP BY especifica uma tabela agrupada derivada da aplicação desta cláusula:

GROUP BY expressão [, ...]
    

O GROUP BY condensa em uma única linha todas as linhas selecionadas que compartilham os mesmos valores para as colunas agrupadas. As funções de agregação, caso existam, são computadas através de todas as linhas que pertencem a cada grupo, produzindo um valor separado para cada grupo (enquanto que sem GROUP BY, uma função de agregação produz um único valor computado através de todas as linhas selecionadas). Quando GROUP BY está presente, não é válido uma expressão de saída do SELECT fazer referência a uma coluna não agrupada, exceto dentro de uma função de agregação, porque pode haver mais de um valor possível retornado para uma coluna não agrupada.

Um item do GROUP BY pode ser o nome de uma coluna da entrada, o nome ou o número ordinal de uma coluna da saída (expressão SELECT), ou pode ser uma expressão arbitrária formada pelos valores das colunas da entrada. No caso de haver ambigüidade, o nome no GROUP BY vai ser interpretado como o sendo o nome de uma coluna da entrada, e não como o nome de uma coluna da saída.

A cláusula HAVING

A condição opcional HAVING possui a forma geral:

HAVING expressão_booleana
    

onde expresão_booleana é a mesma que foi especificada para a cláusula WHERE.

HAVING especifica uma tabela agrupada derivada pela eliminação das linhas agrupadas que não satisfazem a expressão_booleana. HAVING é diferente de WHERE: WHERE filtra individualmente as linhas antes da aplicação do GROUP BY, enquanto HAVING filtra os grupos de linhas criados pelo GROUP BY.

Cada coluna referenciada na expressão_booleana 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 cláusula ORDER BY

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

Um item do ORDER BY pode ser o nome ou o número ordinal de uma coluna da saída (expressão SELECT), ou pode ser uma expressão arbitrária formada por valores da coluna de entrada. No caso de haver ambigüidade, o nome no ORDER BY será interpretado como o nome de uma coluna da saída.

O número ordinal refere-se à posição ordinal (da esquerda para a direita) da coluna do resultado. Esta característica torna possível definir uma ordenação baseada em uma coluna que não possui um nome próprio. Nunca isto é absolutamente necessário, porque é sempre possível atribuir um nome a uma coluna do resultado usando a cláusula AS, como no exemplo abaixo:

SELECT titulo, data_prod + 1 AS newlen FROM filmes ORDER BY newlen;
    

Também é possível efetuar um ORDER BY por expressões arbitrárias (uma extensão ao SQL92), incluindo campos que não aparecem na lista de resultados do SELECT. Portanto, o seguinte comando é válido:

SELECT nome FROM distribuidores ORDER BY cod;
    

Uma limitação desta funcionalidade é que uma cláusula ORDER BY aplicada ao resultado de uma consulta com UNION, INTERSECT, ou EXCEPT pode apenas especificar um nome ou um número de coluna, mas não uma expressão.

Observe que se um item do ORDER BY for um nome simples que corresponda tanto ao nome de uma coluna do resultado quanto ao nome de uma coluna da entrada, o ORDER BY vai interpretar como sendo o nome da coluna do resultado. Esta opção é oposta a que é feita pelo GROUP BY na mesma situação. Esta inconsistência é determinada pelo padrão SQL92.

Opcionalmente pode ser utilizada a palavra chave DESC (descendente) ou ASC (ascendente) após cada nome de coluna na cláusula ORDER BY. Se nada for especificado, ASC é assumido por padrão. Alternativamente, um nome de operador de ordenação específico pode ser especificado. ASC é equivalente a USING < e DESC é equivalente a USING >.

O valor nulo possui posição de ordenação maior do que qualquer outro valor do domínio. Em outras palavras, na ordenação ascendente os valores nulos ficam no final, e na ordenação descendente os valores nulos ficam no início.

A cláusula UNION

tabela_consulta UNION [ ALL ] tabela_consulta
    [ ORDER BY expressão [ ASC | DESC | USING operador ] [, ...] ]
    [ LIMIT { contador | ALL } ]
    [ OFFSET início ]
    

onde tabela_consulta especifica qualquer expressão de seleção sem as cláusulas ORDER BY, FOR UPDATE, ou LIMIT (ORDER BY e LIMIT podem aparecer na subexpressão se estiver entre parênteses. Sem os parênteses estas cláusulas se aplicam ao resultado da UNION, e não na sua expressão de entrada da direita).

O operador UNION computa a coleção (conjunto união) das linhas retornadas pelas consultas envolvidas. Os dois SELECT que representam os operandos diretos do UNION devem produzir o mesmo número de colunas, e as colunas correspondentes devem possuir tipos de dado compatíveis.

O resultado de uma UNION não contém nenhuma linha repetida, a menos que a opção ALL all seja especificada. ALL impede a eliminação das linhas repetidas.

Quando existem vários operadores UNION no mesmo comando SELECT, estes são processados da esquerda para a direita, a menos que outra ordem seja definida pelo uso de parênteses.

Atualmente, FOR UPDATE não deve ser especificado nem no resultado nem nas entradas de uma UNION.

A cláusula INTERSECT

tabela_consulta INTERSECT [ ALL ] tabela_consulta
    [ ORDER BY expressão [ ASC | DESC | USING operador ] [, ...] ]
    [ LIMIT { contador | ALL } ]
    [ OFFSET início ]
    

onde tabela_consulta especifica qualquer expressão de seleção sem as cláusulas ORDER BY, FOR UPDATE, ou LIMIT.

INTERSECT é semelhante a UNION, exceto que retorna somente as linhas presentes nas saídas das duas consultas, em vez de todas as linhas presentes nas duas consultas.

O resultado do INTERSECT não possui nenhuma linha repetida, a menos que a opção ALL seja especificada. Com ALL, uma linha que possui m repetições em L e n repetições em R aparece min(m,n) vezes.

Quando existem vários operadores INTERSECT no mesmo comando SELECT, estes são processados da esquerda para a direita, a menos que os parênteses estabeleçam outra ordem. INTERSECT tem prevalência sobre UNION --- ou seja, A UNION B INTERSECT C é processado como A UNION (B INTERSECT C), a menos que outra ordem seja estabelecida pelo uso de parênteses..

A cláusula EXCEPT

tabela_consulta EXCEPT [ ALL ] tabela_consulta
    [ ORDER BY expressão [ ASC | DESC | USING operador ] [, ...] ]
    [ LIMIT { contador | ALL } ]
    [ OFFSET início ]
    

onde tabela_consulta especifica qualquer expressão de seleção sem as cláusulas ORDER BY, FOR UPDATE, ou LIMIT.

EXCEPT é semelhante a UNION, exceto que retorna somente as linhas presentes na saída da consulta à esquerda, mas que não estão presentes na saída da consulta à direita.

O resultado do EXCEPT não possui nenhuma linha repetida, a menos que a opção ALL seja especificada. Com ALL, uma linha que possui m repetições em L e n repetições em R aparece max(m-n,0) vezes.

Quando existem vários operadores EXCEPT no mesmo comando SELECT, estes são processados da esquerda para a direita, a menos que os parênteses estabeleçam outra ordem. EXCEPT possui o mesmo nível de precedência de UNION.

A cláusula LIMIT

    LIMIT { contador | ALL }
    OFFSET início
    

onde contador especifica o número máximo de linhas retornadas, e início especifica o número de linhas a serem saltadas antes de começar a retornar as linhas.

O contador LIMIT permite que seja retornada apenas uma parte das linhas que são geradas pelo resultado da consulta. Se um contador limite for fornecido, não será retornado mais do que este número de linhas. Se um deslocamento for especificado, este número de linhas será saltado antes de começar o retorno das linhas.

Quando LIMIT é usado, aconselha-se utilizar a cláusula ORDER BY para colocar as linhas do resultado dentro de uma ordem única. De outra maneira, será obtido um subconjunto das linhas da consulta impossível de ser previsto --- pode-se estar querendo obter da décima a vigésima linha, mas da décima a vigésima linha de qual ordenação? Não é possível saber qual será a ordenação, a menos que ORDER BY seja especificado.

A partir do PostgreSQL 7.0, o otimizador de consultas leva LIMIT em consideração ao gerar o plano para a consulta, então é muito provável que sejam obtidos planos diferentes (resultando em ordenações diferentes das linhas) dependendo do que seja fornecido para LIMIT e OFFSET. Portanto, utilizar valores diferentes para LIMIT/OFFSET para selecionar subconjuntos diferentes do resultado de uma consulta vai produzir resultados inconsistentes, a menos que seja exigida uma ordenação previsível dos resultados utilizando ORDER BY. Isto não é um erro (bug), isto é uma conseqüência do fato de que o SQL não retorna os resultados de uma consulta em nenhuma ordem específica, a não ser que ORDER BY seja utilizado para definir esta ordem.

Extensões

O PostgreSQL permite que seja omitida a cláusula FROM da consulta. Esta funcionalidade da linguagem de consulta PostQuel original foi mantida, sendo muita utilizada para calcular os resultados de expressões com constantes:

SELECT 2+2;

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

Outros SGBDRs não podem fazer isto, a não ser que seja introduzida uma tabela especial com uma única linha para se efetuar a seleção a partir desta tabela. Uma utilização menos óbvia desta característica é para abreviar consultas normais a uma ou mais tabelas:

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

 did | nome
-----+----------
 108 | Westward
  

Isso funciona porque um FROM implícito é adicionado para cada tabela que é referenciada na consulta mas não é mencionada no FROM. Ao mesmo tempo em que é uma forma conveniente de abreviar, é fácil de ser usado de forma errada. Por exemplo, a consulta

SELECT distribuidores.* FROM distribuidores d;
  

deve ser um engano; provavelmente o que se deseja é

SELECT d.* FROM distribuidores d;
  

em vez da junção sem restrições

SELECT distribuidores.* FROM distribuidores d, distribuidores distribuidores;
  

que é obtido na realidade. Para ajudar a detectar este tipo de engano, o PostgreSQL 7.1, e posteriores, advertem quando um FROM implícito é usado em uma consulta que também possui uma cláusula FROM explícita.

SQL92

 
tabela_consulta UNION [ALL]
    [CORRESPONDING [BY (nome_coluna [,...])]]
    tabela_consulta