選択する
SELECT
ステートメントは、TiDB からデータを読み取るために使用されます。
概要
- SelectStmt
- SelectStmtBasic
- SelectStmtFromDualTable
- SelectStmtFromTable
- SelectStmtOpts
- TableRefsClause
- AsOfClause
- SelectStmtLimit
- SelectLockOpt
- TableList
- WindowClause
- TableSampleOpt
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 AsOfClause? ( ',' TableRef AsOfClause? )*
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 )*
WindowClause ::=
"WINDOW" WindowDefinition ("," WindowDefinition)*
TableSampleOpt ::=
'TABLESAMPLE' 'REGIONS' '(' ')'
構文要素の説明
構文要素 | 説明 |
---|---|
TableOptimizerHints | これは、TiDB のオプティマイザの動作を制御するためのヒントです。詳細については、 オプティマイザのヒントを参照してください。 |
ALL DISTINCT DISTINCTROW | ALL 修飾子DISTINCTROW DISTINCT 重複する行を返すかどうかを指定します。ALL (デフォルト) は、一致するすべての行を返すことを指定します。 |
HIGH_PRIORITY | HIGH_PRIORITY 、現在のステートメントに他のステートメントよりも高い優先度を与えます。 |
SQL_CALC_FOUND_ROWS | TiDB はこの機能をサポートしていないため、 tidb_enable_noop_functions=1 設定されていないとエラーが返されます。 |
SQL_CACHE , SQL_NO_CACHE | SQL_CACHE とSQL_NO_CACHE リクエスト結果を TiKV (RocksDB) のBlockCache にキャッシュするかどうかを制御するために使用されます。 count(*) クエリなどの大量のデータに対する 1 回限りのクエリの場合は、 BlockCache のホット ユーザー データをフラッシュしないように、 SQL_NO_CACHE を入力することをお勧めします。 |
STRAIGHT_JOIN | STRAIGHT_JOIN 、オプティマイザがFROM 句で使用されているテーブルの順序で結合クエリを実行するように強制します。オプティマイザが適切でない結合順序を選択した場合、この構文を使用してクエリの実行を高速化できます。 |
select_expr | 各select_expr 取得する列を示します。列名と式を含みます。3 \* すべての列を表します。 |
FROM table_references | FROM table_references 句は、行を取得するテーブル ( select * from t; など)、または複数のテーブル ( select * from t1 join t2; など)、あるいはselect 1+1 from dual; 個のテーブル ( select 1+1; に相当) を示します。 |
WHERE where_condition | WHERE 句が指定されている場合は、行が選択されるために満たす必要のある条件を示します。結果には、条件を満たすデータのみが含まれます。 |
GROUP BY | GROUP BY ステートメントは結果セットをグループ化するために使用されます。 |
HAVING where_condition | HAVING 節とWHERE 節はどちらも結果をフィルタリングするために使用されます。 HAVING 節はGROUP BY の結果をフィルタリングし、 WHERE 節は集計前の結果をフィルタリングします。 |
ORDER BY | ORDER BY 句は、 select_expr リスト内の列、式、または項目に基づいて、データを昇順または降順で並べ替えるために使用されます。 |
LIMIT | LIMIT 句は行数を制約するために使用できます。 LIMIT は 1 つまたは 2 つの数値引数を取ります。 引数が 1 つの場合、引数は返される行の最大数を指定します。返される最初の行は、デフォルトでテーブルの最初の行です。引数が 2 つの場合、最初の引数は返される最初の行のオフセットを指定し、2 番目の引数は返される行の最大数を指定します。 TiDB はFETCH FIRST/NEXT n ROW/ROWS ONLY 構文もサポートしており、これはLIMIT n と同じ効果があります。 この構文でn 省略すると、その効果はLIMIT 1 と同じになります。 |
Window window_definition | これはウィンドウ関数の構文であり、通常は何らかの解析計算を行うために使用されます。詳細については、 ウィンドウ関数を参照してください。 |
FOR UPDATE | SELECT FOR UPDATE 節は、他のトランザクションからの同時更新を検出するために、結果セット内のすべてのデータをロックします。クエリ条件に一致するが結果セットに存在しないデータは、現在のトランザクションの開始後に他のトランザクションによって書き込まれた行データのように、読み取りロックされません。 TiDB が楽観的トランザクションモードを使用する場合、ステートメント実行フェーズではトランザクションの競合が検出されません。したがって、現在のトランザクションは、PostgreSQL などの他のデータベースのように、他のトランザクションの実行をUPDATE 、 DELETE 、またはSELECT FOR UPDATE からブロックしません。コミットフェーズでは、 SELECT FOR UPDATE によって読み取られた行は 2 フェーズでコミットされるため、競合検出に参加することもできます。書き込み競合が発生した場合、 SELECT FOR UPDATE 節を含むすべてのトランザクションのコミットは失敗します。競合が検出されない場合は、コミットは成功します。また、ロックされた行の新しいバージョンが生成されるため、後で他のコミットされていないトランザクションがコミットされるときに書き込み競合を検出できます。 TiDB が悲観的トランザクションモードを使用する場合、動作は基本的に他のデータベースと同じです。詳細については、 MySQL InnoDBとの違いを参照してください。 TiDB は、 FOR UPDATE のNOWAIT 修飾子をサポートしています。詳細はTiDB 悲観的トランザクションモード参照。 |
LOCK IN SHARE MODE | 互換性を保証するために、TiDB はこれら 3 つの修飾子を解析しますが、無視します。 |
TABLESAMPLE | テーブルから行のサンプルを取得します。 |
例
選択する
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-Hosted にのみ適用され、 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 ではサポートされていません。