SELECT¶

Sintaxe¶

As seções a seguir descrevem a sintaxe deste comando:

• Como selecionar todas as colunas

• Como selecionar colunas específicas

[ ... ]
SELECT [ { ALL | DISTINCT } ]
       [ TOP <n> ]
       [{<object_name>|<alias>}.]*

       [ ILIKE '<pattern>' ]

       [ EXCLUDE
         {
           <col_name> | ( <col_name>, <col_name>, ... )
         }
       ]

       [ REPLACE
         {
           ( <expr> AS <col_name> [ , <expr> AS <col_name>, ... ] )
         }
       ]

       [ RENAME
         {
           <col_name> AS <col_alias>
           | ( <col_name> AS <col_alias>, <col_name> AS <col_alias>, ... )
         }
       ]

SELECT * ILIKE ... REPLACE ...

SELECT * ILIKE ... RENAME ...

SELECT * ILIKE ... REPLACE ... RENAME ...

SELECT * EXCLUDE ... REPLACE ...

SELECT * EXCLUDE ... RENAME ...

SELECT * EXCLUDE ... REPLACE ... RENAME ...

SELECT * REPLACE ... RENAME ...

[ ... ]
SELECT [ { ALL | DISTINCT } ]
       [ TOP <n> ]
       {
         [{<object_name>|<alias>}.]<col_name>
         | [{<object_name>|<alias>}.]$<col_position>
         | <expr>
       }
       [ [ AS ] <col_alias> ]
       [ , ... ]
[ ... ]

Parâmetros¶

ALL | DISTINCT

Especifica se a eliminação duplicada deve ser feita no conjunto de resultados:

• ALL inclui todos os valores no conjunto de resultados.

• DISTINCT elimina os valores duplicados do conjunto de resultados.

Padrão: ALL

TOP n

Especifica o número máximo de resultados a serem retornados. Consulte TOP <n>.

object_name ou . alias

Especifica o identificador do objeto ou alias do objeto, conforme definido na cláusula FROM.

*

O asterisco é um asterisco para indicar que a saída deve incluir todas as colunas do objeto especificado, ou todas as colunas de todos os objetos se * não estiver qualificado com um nome ou alias do objeto.

Ao especificar *, você também pode especificar ILIKE, EXCLUDE, REPLACE e RENAME:

ILIKE 'pattern'

Especifica que apenas as colunas que correspondem a pattern devem ser incluídas nos resultados.

No pattern, você pode usar os seguintes curingas SQL:

• Use um sublinhado (_) para corresponder a qualquer caractere único.

• Use um sinal de porcentagem (%) para corresponder a qualquer sequência de zero ou mais caracteres.

Para corresponder uma sequência em qualquer lugar do nome da coluna, comece e termine o padrão com %.

A correspondência não diferencia maiúsculas e minúsculas.

Se nenhuma coluna corresponder ao padrão especificado, ocorrerá um erro de compilação (001080 (42601): ... SELECT with no columns).

EXCLUDE col_name . EXCLUDE (col_name, col_name, ...)

Especifica as colunas que devem ser excluídas dos resultados.

Se você estiver selecionando de várias tabelas, use SELECT table_name.* para especificar que deseja selecionar todas as colunas de uma tabela específica, e especifique o nome da coluna não qualificado em EXCLUDE. Por exemplo:

SELECT table_a.* EXCLUDE column_in_table_a ,
  table_b.* EXCLUDE column_in_table_b
  ...

Copy

REPLACE (expr AS col_name [ , expr AS col_name, ...] )

Substitui o valor de col_name pelo valor da expressão avaliada expr.

Por exemplo, para preceder a cadeia de caracteres 'DEPT-' aos valores na coluna department_id, use:

SELECT REPLACE ('DEPT-' || department_id AS department_id) ...

Copy

Para col_name:

• A coluna deve existir e não pode ser filtrada por ILIKE ou EXCEPT.

• Você não pode especificar a mesma coluna mais de uma vez na lista de substituições.

• Se a coluna estiver em diversas tabelas (por exemplo, em ambas as tabelas em uma junção), a instrução falhará com um erro de «coluna ambígua».

expr deve avaliar como um único valor.

RENAME col_name AS col_alias . RENAME (col_name AS col_alias, col_name AS col_alias, ...)

Especifica os alias das colunas que devem ser usados nos resultados.

Se você estiver selecionando de várias tabelas, use SELECT table_name.* para especificar que deseja selecionar todas as colunas de uma tabela específica, e especifique o nome da coluna não qualificado em RENAME. Por exemplo:

SELECT table_a.* RENAME column_in_table_a AS col_alias_a,
  table_b.* RENAME column_in_table_b AS col_alias_b
  ...

Copy

Nota

Ao especificar uma combinação de palavras-chave após SELECT *:

• Você não pode especificar ILIKE e EXCLUDE.

• Se você especificar EXCLUDE com RENAME ou REPLACE:

  • Você deve especificar EXCLUDE antes de RENAME ou REPLACE:

    SELECT * EXCLUDE col_a RENAME col_b AS alias_b ...
    

    Copy

    SELECT * EXCLUDE employee_id REPLACE ('DEPT-' || department_id AS department_id) ...
    

    Copy

  • Não se pode especificar a mesma coluna em EXCLUDE e RENAME.

• Se você especificar ILIKE com RENAME ou REPLACE, deverá especificar ILIKE primeiro:

  SELECT * ILIKE '%id%' RENAME department_id AS department ...
  

  Copy

  SELECT * ILIKE '%id%' REPLACE ('DEPT-' || department_id AS department_id) ...
  

  Copy

• Se você especificar REPLACE e RENAME:

  • Você deve especificar REPLACE primeiro:

    SELECT * REPLACE ('DEPT-' || department_id AS department_id) RENAME employee_id as employee ...
    

    Copy

  • Você pode especificar o mesmo nome de coluna em REPLACE e RENAME:

    SELECT * REPLACE ('DEPT-' || department_id AS department_id) RENAME department_id as department ...
    

    Copy

col_name

Especifica o identificador da coluna, conforme definido na cláusula FROM.

$col_position

Especifica a posição da coluna (baseado em 1) conforme definido na cláusula FROM. Se uma coluna for referenciada a partir de uma tabela, este número não pode exceder o número máximo de colunas na tabela.

expr

Especifica uma expressão, como uma expressão matemática, que avalia como um valor específico para qualquer linha específica.

[ AS ] col_alias

Especifica o alias da coluna atribuída à expressão resultante. Isto é usado como o nome de exibição em uma lista SELECT de nível superior, e o nome da coluna em uma exibição em linha.

Notas de uso¶

• Os alias e identificadores diferenciam maiúsculas e minúsculas, por padrão. Para preservar o tipo de letra, coloque-os entre aspas duplas ("). Para obter mais informações, consulte Identificadores de objetos.

• Sem uma cláusula ORDER BY, os resultados retornados por SELECT são um conjunto não ordenado. Executar a mesma consulta repetidamente com as mesmas tabelas pode resultar em uma ordem de saída diferente a cada vez. Se a ordem for importante, use a cláusula ORDER BY.

• SELECT pode ser usado não apenas como uma instrução independente, mas também como uma cláusula em outras instruções, por exemplo INSERT INTO ... SELECT ...;. SELECT também pode ser usado em uma subconsulta dentro de uma instrução.

• Em muitos casos, quando você usa um alias de coluna para uma expressão (ou seja, expr AS col_alias) em outras partes da mesma consulta (em JOIN, FROM, WHERE, GROUP BY, outras expressões de coluna etc.), a expressão é avaliada apenas uma vez.

  Entretanto, observe que, em alguns casos, a expressão pode ser avaliada várias vezes, o que pode resultar em valores diferentes para o alias usado em partes diferentes da mesma consulta.

Exemplos¶

Alguns exemplos simples são fornecidos abaixo.

• Configuração dos dados para os exemplos

• Exemplos de seleção de todas as colunas (SELECT *)

• Exemplos de seleção de colunas específicas (SELECT nome de coluna)

Muitos exemplos adicionais estão incluídos em outras partes da documentação, incluindo as descrições detalhadas de Sintaxe de consulta.

Para obter exemplos relacionados à consulta de uma tabela de eventos (cujo esquema é predefinido pelo Snowflake), consulte Acesso a dados de mensagens registradas e Acesso a dados de rastreamento.

SELECT * FROM employee_table;

+-------------+------------+------------+---------------+
| EMPLOYEE_ID | LAST_NAME  | FIRST_NAME | DEPARTMENT_ID |
|-------------+------------+------------+---------------|
|         101 | Montgomery | Pat        |             1 |
|         102 | Levine     | Terry      |             2 |
|         103 | Comstock   | Dana       |             2 |
+-------------+------------+------------+---------------+

SELECT * ILIKE '%id%' FROM employee_table;

+-------------+---------------+
| EMPLOYEE_ID | DEPARTMENT_ID |
|-------------+---------------|
|         101 |             1 |
|         102 |             2 |
|         103 |             2 |
+-------------+---------------+

SELECT * EXCLUDE department_id FROM employee_table;

+-------------+------------+------------+
| EMPLOYEE_ID | LAST_NAME  | FIRST_NAME |
|-------------+------------+------------|
|         101 | Montgomery | Pat        |
|         102 | Levine     | Terry      |
|         103 | Comstock   | Dana       |
+-------------+------------+------------+

SELECT * EXCLUDE (department_id, employee_id) FROM employee_table;

+------------+------------+
| LAST_NAME  | FIRST_NAME |
|------------+------------|
| Montgomery | Pat        |
| Levine     | Terry      |
| Comstock   | Dana       |
+------------+------------+

SELECT * RENAME department_id AS department FROM employee_table;

+-------------+------------+------------+------------+
| EMPLOYEE_ID | LAST_NAME  | FIRST_NAME | DEPARTMENT |
|-------------+------------+------------+------------|
|         101 | Montgomery | Pat        |          1 |
|         102 | Levine     | Terry      |          2 |
|         103 | Comstock   | Dana       |          2 |
+-------------+------------+------------+------------+

SELECT * RENAME (department_id AS department, employee_id AS id) FROM employee_table;

+-----+------------+------------+------------+
|  ID | LAST_NAME  | FIRST_NAME | DEPARTMENT |
|-----+------------+------------+------------|
| 101 | Montgomery | Pat        |          1 |
| 102 | Levine     | Terry      |          2 |
| 103 | Comstock   | Dana       |          2 |
+-----+------------+------------+------------+

SELECT * EXCLUDE first_name RENAME (department_id AS department, employee_id AS id) FROM employee_table;

+-----+------------+------------+
|  ID | LAST_NAME  | DEPARTMENT |
|-----+------------+------------|
| 101 | Montgomery |          1 |
| 102 | Levine     |          2 |
| 103 | Comstock   |          2 |
+-----+------------+------------+

SELECT * ILIKE '%id%' RENAME department_id AS department FROM employee_table;

+-------------+------------+
| EMPLOYEE_ID | DEPARTMENT |
|-------------+------------|
|         101 |          1 |
|         102 |          2 |
|         103 |          2 |
+-------------+------------+

SELECT * REPLACE ('DEPT-' || department_id AS department_id) FROM employee_table;

+-------------+------------+------------+---------------+
| EMPLOYEE_ID | LAST_NAME  | FIRST_NAME | DEPARTMENT_ID |
|-------------+------------+------------+---------------|
|         101 | Montgomery | Pat        | DEPT-1        |
|         102 | Levine     | Terry      | DEPT-2        |
|         103 | Comstock   | Dana       | DEPT-2        |
+-------------+------------+------------+---------------+

SELECT * REPLACE ('DEPT-' || department_id AS department_id) RENAME department_id AS department FROM employee_table;

+-------------+------------+------------+------------+
| EMPLOYEE_ID | LAST_NAME  | FIRST_NAME | DEPARTMENT |
|-------------+------------+------------+------------|
|         101 | Montgomery | Pat        | DEPT-1     |
|         102 | Levine     | Terry      | DEPT-2     |
|         103 | Comstock   | Dana       | DEPT-2     |
+-------------+------------+------------+------------+

SELECT * ILIKE '%id%' REPLACE('DEPT-' || department_id AS department_id) FROM employee_table;

+-------------+---------------+
| EMPLOYEE_ID | DEPARTMENT_ID |
|-------------+---------------|
|         101 | DEPT-1        |
|         102 | DEPT-2        |
|         103 | DEPT-2        |
+-------------+---------------+

SELECT
  employee_table.* EXCLUDE department_id,
  department_table.* RENAME department_name AS department
FROM employee_table INNER JOIN department_table
  ON employee_table.department_id = department_table.department_id
ORDER BY department, last_name, first_name;

+-------------+------------+------------+---------------+------------------+
| EMPLOYEE_ID | LAST_NAME  | FIRST_NAME | DEPARTMENT_ID | DEPARTMENT       |
|-------------+------------+------------+---------------+------------------|
|         103 | Comstock   | Dana       |             2 | Customer Support |
|         102 | Levine     | Terry      |             2 | Customer Support |
|         101 | Montgomery | Pat        |             1 | Engineering      |
+-------------+------------+------------+---------------+------------------+