TABLESAMPLE, klauzula (Databricks SQL)

Instrukcja TABLESAMPLE jest używana do próbkowania relacji.

Składnia

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

Parametry

  • percentage PERCENT

    Stała całkowita lub dziesiętna percentage z zakresu od 0 do 100 określająca procent wierszy tabeli do próbkowania.

  • num_rows ROWS

    Stałe wyrażenie dodatniej liczby całkowitej num_rows określające bezwzględną liczbę wierszy ze wszystkich wierszy do próbki.

  • BUCKET fraction OUT OF total

    Stała fraction INTEGER określająca część z stałej total INTEGER do próbki.

  • REPEATABLE ( seed )

    Wymaga:SQL punktu końcowego w wersji 2022.25 lub nowszej. Ta wersja jest dostępna w kanale podglądu.

    Opcjonalna dodatnia stała seedINTEGER , używana do tworzenia zawsze tego samego zestawu wierszy. Użyj tej klauzuli, jeśli chcesz ponownie wykonać zapytanie wiele razy i oczekujesz tego samego zestawu przykładowych wierszy.

Uwaga

  • TABLESAMPLE zwraca przybliżoną liczbę wierszy lub żądanych ułamków.
  • Zawsze używaj, TABLESAMPLE (percent PERCENT) jeśli losowość jest ważna. TABLESAMPLE (num_rows ROWS) nie jest prostą losową próbką, ale zamiast tego jest implementowana przy użyciu polecenia LIMIT.

Przykłady

> 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