TABLESAMPLE cláusula

Aplica-se a: Databricks SQL Databricks Runtime

A TABLESAMPLE instrução é usada para amostrar a relação.

Sintaxe

TABLESAMPLE ( { percentage PERCENT ) |
                num_rows ROWS |
                BUCKET fraction OUT OF total } )
            [ REPEATABLE ( seed ) ]

Parâmetros

• percentage PERCENT

  Uma constante percentage inteira ou decimal entre 0 e 100 que especifica qual porcentagem das linhas da tabela deve ser amostrada.

• num_rows ROWS

  Uma expressão constante e positiva do tipo INTEGER num_rows especificando um número absoluto de linhas, a partir de todas as linhas, a serem amostradas.

• BUCKET fraction OUT OF total

  Uma constante INTEGER fraction que especifica a porção da constante INTEGER total a ser amostrada.

• REPEATABLE ( seed )

  Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e posteriores

  Uma constante seedINTEGER positiva opcional, usada para produzir sempre o mesmo conjunto de linhas. Use esta cláusula quando quiser reemitir a consulta repetidamente e espera o mesmo conjunto de linhas amostradas.

Nota

• TABLESAMPLE Devolve o número aproximado de linhas ou frações solicitadas.
• Sempre use TABLESAMPLE (percent PERCENT) se a aleatoriedade for importante. TABLESAMPLE (num_rows ROWS) não é uma simples amostra aleatória, mas é implementada usando LIMIT.
• TABLESAMPLE não suporta flexões de filtro, uma vez que a amostragem precede a aplicação de quaisquer outros filtros, tais como WHERE cláusulas.

Exemplos

> CREATE TEMPORARY VIEW test(id, name) AS
  VALUES ( 1, 'Lisa'),
         ( 2, 'Mary'),
         ( 3, 'Evan'),
         ( 4, 'Fred'),
         ( 5, 'Alex'),
         ( 6, 'Mark'),
         ( 7, 'Lily'),
         ( 8, 'Lucy'),
         ( 9, 'Eric'),
         (10, 'Adam');
> SELECT * FROM test;
  5 Alex
  8 Lucy
  2 Mary
  4 Fred
  1 Lisa
  9 Eric
 10 Adam
  6 Mark
  7 Lily
  3 Evan

> SELECT * FROM test TABLESAMPLE (30 PERCENT) REPEATABLE (123);
  1     Lisa
  2     Mary
  3     Evan
  5     Alex
  8     Lucy

> SELECT * FROM test TABLESAMPLE (5 ROWS);
  5 Alex
  8 Lucy
  2 Mary
  4 Fred
  1 Lisa

> SELECT * FROM test TABLESAMPLE (BUCKET 4 OUT OF 10);
  8 Lucy
  2 Mary
  9 Eric
  6 Mark

Artigos relacionados

• SELECT