15.2.16 TABLE Statement — MySQL 8.4

15.2.16 Заявление TABLE

Это DML-заявление, которое возвращает строки и столбцы указанной таблицы.

TABLE table_name
    [ORDER BY column_name]
    [LIMIT number [OFFSET number]]
    [INTO OUTFILE 'file_name'
        [{FIELDS | COLUMNS}
            [TERMINATED BY 'string']
            [[OPTIONALLY] ENCLOSED BY 'char']
            [ESCAPED BY 'char']
        ]
        [LINES
            [STARTING BY 'string']
            [TERMINATED BY 'string']
        ]
    | INTO DUMPFILE 'file_name'
    | INTO var_name [, var_name] ...]

Заявление TABLE в некотором смысле действует как SELECT. Учитывая существование таблицы с именем t, следующие два заявления генерируют одинаковый вывод:

TABLE t;

SELECT * FROM t;

Вы можете упорядочивать и ограничивать количество строк, возвращаемых с помощью TABLE, используя соответственно ORDER BY и LIMIT. Эти клаузы функционируют идентично тем же самым клаузам, используемым с SELECT (включая необязательную клаузу OFFSET с LIMIT), как показано здесь:

mysql> TABLE t;
+----+----+
| a  | b  |
+----+----+
|  1 |  2 |
|  6 |  7 |
|  9 |  5 |
| 10 | -4 |
| 11 | -1 |
| 13 |  3 |
| 14 |  6 |
+----+----+
7 rows in set (0.00 sec)

mysql> TABLE t ORDER BY b;
+----+----+
| a  | b  |
+----+----+
| 10 | -4 |
| 11 | -1 |
|  1 |  2 |
| 13 |  3 |
|  9 |  5 |
| 14 |  6 |
|  6 |  7 |
+----+----+
7 rows in set (0.00 sec)

mysql> TABLE t LIMIT 3;
+---+---+
| a | b |
+---+---+
| 1 | 2 |
| 6 | 7 |
| 9 | 5 |
+---+---+
3 rows in set (0.00 sec)

mysql> TABLE t ORDER BY b LIMIT 3;
+----+----+
| a  | b  |
+----+----+
| 10 | -4 |
| 11 | -1 |
|  1 |  2 |
+----+----+
3 rows in set (0.00 sec)

mysql> TABLE t ORDER BY b LIMIT 3 OFFSET 2;
+----+----+
| a  | b  |
+----+----+
|  1 |  2 |
| 13 |  3 |
|  9 |  5 |
+----+----+
3 rows in set (0.00 sec)

Заявление TABLE отличается от SELECT по двум ключевым аспектам:

TABLE всегда отображает все столбцы таблицы.

Исключение: Вывод TABLE не включает скрытые столбцы. См. Раздел 15.1.20.10, “Скрытые столбцы”.
TABLE не допускает произвольного фильтрации строк; то есть, TABLE не поддерживает клаузу WHERE.

Для ограничения возвращаемых столбцов таблицы, фильтрации строк, которые нельзя выполнить с помощью ORDER BY и LIMIT, или обоих вместе, используйте SELECT.

Заявление TABLE может использоваться с временными таблицами.

Заявление TABLE также может использоваться вместо SELECT в ряде других конструкций, включая перечисленные здесь:

С операторами множеств, такими как UNION, как показано здесь:
```
mysql> TABLE t1;
+---+----+
| a | b  |
+---+----+
| 2 | 10 |
| 5 |  3 |
| 7 |  8 |
+---+----+
3 rows in set (0.00 sec)

mysql> TABLE t2;
+---+---+
| a | b |
+---+---+
| 1 | 2 |
| 3 | 4 |
| 6 | 7 |
+---+---+
3 rows in set (0.00 sec)

mysql> TABLE t1 UNION TABLE t2;
+---+----+
| a | b  |
+---+----+
| 2 | 10 |
| 5 |  3 |
| 7 |  8 |
| 1 |  2 |
| 3 |  4 |
| 6 |  7 |
+---+----+
6 rows in set (0.00 sec)
```
Приведенное UNION эквивалентно следующему заявлению:
```
mysql> SELECT * FROM t1 UNION SELECT * FROM t2;
+---+----+
| a | b  |
+---+----+
| 2 | 10 |
| 5 |  3 |
| 7 |  8 |
| 1 |  2 |
| 3 |  4 |
| 6 |  7 |
+---+----+
6 rows in set (0.00 sec)
```
TABLE также может использоваться вместе в операциях с множествами с SELECT, VALUES или с обоими. См. Раздел 15.2.18, “UNION Clause”, Раздел 15.2.4, “EXCEPT Clause” и Раздел 15.2.8, “INTERSECT Clause” для получения дополнительной информации и примеров. См. также Раздел 15.2.14, “Операции с множествами с UNION, INTERSECT и EXCEPT”.
С INTO для заполнения переменных пользователя и с INTO OUTFILE или INTO DUMPFILE для записи данных таблицы в файл. См. Раздел 15.2.13.1, “SELECT ... INTO Statement” для более подробной информации и примеров.
Во многих случаях, где можно использовать подзапросы. Учитывая любую таблицу t1 со столбцом, названным a, и вторую таблицу t2 с одним столбцом, возможны заявления, такие как следующее:
```
SELECT * FROM t1 WHERE a IN (TABLE t2);
```
Предполагая, что единственный столбец таблицы t1 называется x, предыдущее эквивалентно каждому из показанных здесь заявлений (и в любом случае генерирует точно такой же результат):
```
SELECT * FROM t1 WHERE a IN (SELECT x FROM t2);

SELECT * FROM t1 WHERE a IN (SELECT * FROM t2);
```
См. Раздел 15.2.15, “Подзапросы” для получения дополнительной информации.
С INSERT и REPLACE заявлениями, где в противном случае используется SELECT *. См. Раздел 15.2.7.1, “INSERT ... SELECT Statement” для получения дополнительной информации и примеров.
TABLE также можно использовать во многих случаях вместо SELECT в CREATE TABLE ... SELECT или CREATE VIEW ... SELECT. См. описания этих заявлений для получения дополнительной информации и примеров.