FROM¶

Sintaxe¶

SELECT ...
FROM objectReference [ JOIN objectReference [ ... ] ]
[ ... ]

Onde:

objectReference ::=
   {
      [<namespace>.]<object_name>
           [ AT | BEFORE ( <object_state> ) ]
           [ CHANGES ( <change_tracking_type> ) ]
           [ MATCH_RECOGNIZE ]
           [ PIVOT | UNPIVOT ]
           [ [ AS ] <alias_name> ]
           [ SAMPLE ]
     | <table_function>
           [ PIVOT | UNPIVOT ]
           [ [ AS ] <alias_name> ]
           [ SAMPLE ]
     | ( VALUES (...) )
           [ SAMPLE ]
     | [ LATERAL ] ( <subquery> )
           [ [ AS ] <alias_name> ]
     | @[<namespace>.]<stage_name>[/<path>]
           [ ( FILE_FORMAT => <format_name>, PATTERN => '<regex_pattern>' ) ]
           [ [AS] <alias_name> ]
     | DIRECTORY( @<stage_name> )
   }

Copy

JOIN

Subcláusula que especifica a realização de uma junção de duas ou mais tabelas (ou exibições ou funções de tabela). A junção pode ser uma junção interna, uma junção externa ou outro tipo de junção. A junção pode usar a palavra-chave JOIN ou uma sintaxe alternativa de junção suportada. Para obter mais detalhes sobre junções, consulte JOIN e ASOF JOIN.

[ AS ] alias_name

Especifica um nome dado à referência do objeto ao qual está anexado. Pode ser usado com qualquer uma das outras subcláusulas da cláusula FROM.

Os nomes de alias devem seguir as regras de Identificadores de objetos.

VALUES

A cláusula VALUES pode especificar valores literais ou expressões a serem usadas na cláusula FROM. Esta cláusula pode conter aliases de tabela e coluna (não mostrados no diagrama acima). Para obter mais detalhes sobre a cláusula VALUES, consulte VALUES.

Notas de uso¶

• Os nomes dos objetos são identificadores SQL. Por padrão, eles diferenciam letras maiúsculas de minúsculas. Para preservar o tipo de letra, coloque-as entre aspas duplas (" ").

Exemplos¶

Criar uma tabela e carregar dados nela:

CREATE TABLE ftable1 (retail_price FLOAT, wholesale_cost FLOAT, description VARCHAR);
INSERT INTO ftable1 (retail_price, wholesale_cost, description) 
  VALUES (14.00, 6.00, 'bling');

Copy

Aqui está um exemplo básico do uso da cláusula FROM:

SELECT description, retail_price, wholesale_cost 
    FROM ftable1;
+-------------+--------------+----------------+
| DESCRIPTION | RETAIL_PRICE | WHOLESALE_COST |
|-------------+--------------+----------------|
| bling       |           14 |              6 |
+-------------+--------------+----------------+

Copy

Este exemplo é idêntico ao exemplo anterior, mas especifica o nome da tabela qualificado pelo esquema para a tabela:

SELECT description, retail_price, wholesale_cost 
    FROM temporary_doc_test.ftable1;
+-------------+--------------+----------------+
| DESCRIPTION | RETAIL_PRICE | WHOLESALE_COST |
|-------------+--------------+----------------|
| bling       |           14 |              6 |
+-------------+--------------+----------------+

Copy

Este exemplo cria uma exibição inline e depois a utiliza na consulta:

SELECT v.profit 
    FROM (SELECT retail_price - wholesale_cost AS profit FROM ftable1) AS v;
+--------+
| PROFIT |
|--------|
|      8 |
+--------+

Copy

Este exemplo consulta uma amostra de 10% dos dados da tabela:

SELECT *
    FROM sales SAMPLE(10);

Copy

Este exemplo executa uma UDTF (função de tabela definida pelo usuário):

SELECT *
    FROM TABLE(Fibonacci_Sequence_UDTF(6.0::FLOAT));

Copy

Estes exemplos usam uma cláusula AT para retornar dados históricos dos seguintes pontos especificados no passado:

• Um dia antes da hora atual (-86400 = -3600 * 24).

• Dia e hora específicos.

SELECT *
    FROM sales AT(OFFSET => -86400);
SELECT *
    FROM sales AT(TIMESTAMP => '2018-07-27 12:00:00'::TIMESTAMP);

Copy

Para obter mais detalhes sobre AT, consulte AT | BEFORE.

Este exemplo consulta arquivos localizados em um estágio nomeado:

SELECT
    v.$1, v.$2, ...
  FROM
    @my_stage( FILE_FORMAT => 'csv_format', PATTERN => '.*my_pattern.*') v;

Copy

Este exemplo recupera todas as colunas de metadados em uma tabela de diretório para um estágio chamado mystage:

SELECT * FROM DIRECTORY(@mystage);

Copy

Este exemplo recupera os valores da coluna FILE_URL de uma tabela de diretório para arquivos com tamanho superior a 100 K bytes:

SELECT FILE_URL FROM DIRECTORY(@mystage) WHERE SIZE > 100000;

Copy

Este exemplo recupera os valores da coluna FILE_URL de uma tabela de diretório para arquivos de valores separados por vírgula:

SELECT FILE_URL FROM DIRECTORY(@mystage) WHERE RELATIVE_PATH LIKE '%.csv';

Copy