選択
SELECTステートメントは、TiDB からデータを読み取るために使用されます。
概要
- SelectStmt
- SelectStmtBasic
- SelectStmtFromDualTable
- SelectStmtFromTable
- SelectStmtOpts
- TableRefsClause
- TableRef
- TableFactor
- JoinTable
- JoinClause
- AsOfClause
- SelectStmtLimit
- SelectLockOpt
- TableList
- WhereClause
- GroupByClause
- OrderBy
- WindowClause
- TableSample
SelectStmt ::=
( SelectStmtBasic | SelectStmtFromDualTable | SelectStmtFromTable )
OrderBy? SelectStmtLimit? SelectLockOpt? SelectStmtIntoOption
SelectStmtBasic ::=
"SELECT" SelectStmtOpts Field ("," Field)* ( "HAVING" Expression)?
SelectStmtFromDualTable ::=
"SELECT" SelectStmtOpts Field ("," Field)* "FROM" "DUAL" WhereClause?
SelectStmtFromTable ::=
"SELECT" SelectStmtOpts Field ("," Field)* "FROM" TableRefsClause
WhereClause? GroupByClause? ( "HAVING" Expression)? WindowClause?
SelectStmtOpts ::=
TableOptimizerHints DefaultFalseDistictOpt PriorityOpt SelectStmtSQLSmallResult
SelectStmtSQLBigResult SelectStmtSQLBufferResult SelectStmtSQLCache SelectStmtCalcFoundRows
SelectStmtStraightJoin
TableRefsClause ::=
TableRef ( ',' TableRef )*
TableRef ::=
TableFactor
| JoinTable
TableFactor ::=
TableName ( "PARTITION" "(" Identifier ("," Identifier)* ")" )? ("AS" TableAlias)? AsOfClause? TableSample?
JoinTable ::=
TableRef
(
("INNER" | "CROSS")? "JOIN" TableRef JoinClause?
| "STRAIGHT_JOIN" TableRef "ON" Expression
| ("LEFT" | "RIGHT") "OUTER"? "JOIN" TableRef JoinClause
| "NATURAL" ("LEFT" | "RIGHT") "OUTER"? "JOIN" TableFactor
)
JoinClause ::=
("ON" Expression
| "USING" "(" ColumnNameList ")" )
AsOfClause ::=
'AS' 'OF' 'TIMESTAMP' Expression
SelectStmtLimit ::=
("LIMIT" LimitOption ( ("," | "OFFSET") LimitOption )?
| "FETCH" ("FIRST" | "NEXT") LimitOption? ("ROW" | "ROWS") "ONLY" )
SelectLockOpt ::=
( 'FOR' 'UPDATE' ( 'OF' TableList )? 'NOWAIT'?
| 'LOCK' 'IN' 'SHARE' 'MODE' )
TableList ::=
TableName ( ',' TableName )*
WhereClause ::=
"WHERE" Expression
GroupByClause ::=
"GROUP" "BY" Expression
OrderBy ::=
"ORDER" "BY" Expression
WindowClause ::=
"WINDOW" WindowDefinition ("," WindowDefinition)*
TableSample ::=
'TABLESAMPLE' 'REGIONS' '(' ')'
構文要素の説明
注記:
TiDB v6.6.0以降、 リソース管理サポートします。この機能を使用すると、異なるリソースグループで異なる優先度のSQL文を実行できます。これらのリソースグループに適切なクォータと優先度を設定することで、優先度の異なるSQL文のスケジュールをより適切に制御できます。リソース制御を有効にすると、文の優先度(
HIGH_PRIORITY)は無効になります。異なるSQL文のリソース使用量を管理するには、 リソース管理使用することをお勧めします。
例
選択
mysql> CREATE TABLE t1 (id INT NOT NULL PRIMARY KEY AUTO_INCREMENT, c1 INT NOT NULL);
Query OK, 0 rows affected (0.11 sec)
mysql> INSERT INTO t1 (c1) VALUES (1),(2),(3),(4),(5);
Query OK, 5 rows affected (0.03 sec)
Records: 5 Duplicates: 0 Warnings: 0
mysql> SELECT * FROM t1;
+----+----+
| id | c1 |
+----+----+
| 1 | 1 |
| 2 | 2 |
| 3 | 3 |
| 4 | 4 |
| 5 | 5 |
+----+----+
5 rows in set (0.00 sec)
mysql> SELECT AVG(s_quantity), COUNT(s_quantity) FROM stock TABLESAMPLE REGIONS();
+-----------------+-------------------+
| AVG(s_quantity) | COUNT(s_quantity) |
+-----------------+-------------------+
| 59.5000 | 4 |
+-----------------+-------------------+
1 row in set (0.00 sec)
mysql> SELECT AVG(s_quantity), COUNT(s_quantity) FROM stock;
+-----------------+-------------------+
| AVG(s_quantity) | COUNT(s_quantity) |
+-----------------+-------------------+
| 54.9729 | 1000000 |
+-----------------+-------------------+
1 row in set (0.52 sec)
上記の例では、 tiup bench tpcc prepareで生成されたデータを使用しています。最初のクエリはTABLESAMPLEの使用を示しています。
選択...出力ファイルへ
SELECT ... INTO OUTFILEステートメントは、クエリの結果をファイルに書き込むために使用されます。
注記:
- このステートメントは TiDB Self-Managed にのみ適用され、 TiDB Cloudでは使用できません。
- このステートメントは、Amazon S3 や GCS などへの外部ストレージ結果の書き込みをサポートしていません。
ステートメントでは、次の句を使用して出力ファイルの形式を指定できます。
FIELDS TERMINATED BY: ファイル内のフィールド区切り文字を指定します。例えば、カンマ区切り値 (CSV) を出力する場合は','、タブ区切り値 (TSV) を出力する場合は'\t'指定します。FIELDS ENCLOSED BY: ファイル内の各フィールドを囲む囲み文字を指定します。LINES TERMINATED BY: 特定の文字で行を終了する場合に、ファイル内の行末文字を指定します。
次のような 3 つの列を持つテーブルtがあるとします。
mysql> CREATE TABLE t (a INT, b VARCHAR(10), c DECIMAL(10,2));
Query OK, 0 rows affected (0.02 sec)
mysql> INSERT INTO t VALUES (1, 'a', 1.1), (2, 'b', 2.2), (3, 'c', 3.3);
Query OK, 3 rows affected (0.01 sec)
次の例は、 SELECT ... INTO OUTFILEステートメントを使用してクエリ結果をファイルに書き込む方法を示しています。
例1:
mysql> SELECT * FROM t INTO OUTFILE '/tmp/tmp_file1';
Query OK, 3 rows affected (0.00 sec)
この例では、クエリ結果は次のように/tmp/tmp_file1で見つかります。
1 a 1.10
2 b 2.20
3 c 3.30
例2:
mysql> SELECT * FROM t INTO OUTFILE '/tmp/tmp_file2' FIELDS TERMINATED BY ',' ENCLOSED BY '"';
Query OK, 3 rows affected (0.00 sec)
この例では、クエリ結果は次のように/tmp/tmp_file2で見つかります。
"1","a","1.10"
"2","b","2.20"
"3","c","3.30"
例3:
mysql> SELECT * FROM t INTO OUTFILE '/tmp/tmp_file3'
-> FIELDS TERMINATED BY ',' ENCLOSED BY '\'' LINES TERMINATED BY '<<<\n';
Query OK, 3 rows affected (0.00 sec)
この例では、クエリ結果は次のように/tmp/tmp_file3で見つかります。
'1','a','1.10'<<<
'2','b','2.20'<<<
'3','c','3.30'<<<
MySQLの互換性
- 構文
SELECT ... INTO @variableサポートされていません。 - 構文
SELECT ... INTO DUMPFILEサポートされていません。 - 構文
SELECT .. GROUP BY expr、MySQL 5.7のようにGROUP BY expr ORDER BY expr意味するわけではありません。TiDB は MySQL 8.0 の動作と一致し、デフォルトの順序を意味しません。 - 構文
SELECT ... TABLESAMPLE ...、他のデータベース システムおよびISO/IEC 9075-2標準との互換性のために設計された TiDB 拡張機能ですが、現在 MySQL ではサポートされていません。