テーブル名

一時テーブル

テーブルのクローニングおよびコピー

カラムのデータ型および属性

インデックス、外部キーおよび CHECK 制約

テーブルオプション

テーブルのパーティション化

tbl_name

特定のデータベース内にテーブルを作成するには、テーブル名を db_name.tbl_name として指定できます。 そのデータベースが存在すると仮定すると、これは、デフォルトデータベースが存在するかどうかには関係なく機能します。 引用符で囲まれた識別子を使用する場合は、データベース名とテーブル名を個別に引用符で囲みます。 たとえば、`mydb.mytbl` ではなく、`mydb`.`mytbl` と記述します。

許可されるテーブル名のルールは、セクション9.2「スキーマオブジェクト名」に示されています。

IF NOT EXISTS

テーブルが存在する場合にエラーが発生しないようにします。 ただし、既存のテーブルの構造が CREATE TABLE ステートメントによって示されている構造と同一であることの検証は行われません。

LIKE

CREATE TABLE ... LIKE を使用して、元のテーブルに定義されているカラム属性やインデックスなど、別のテーブルの定義に基づいて空のテーブルを作成します:

CREATE TABLE new_tbl LIKE orig_tbl;

詳細は、セクション13.1.20.3「CREATE TABLE ... LIKE ステートメント」を参照してください。

[AS] query_expression

別のテーブルからテーブルを作成するには、CREATE TABLE ステートメントの最後に SELECT ステートメントを追加します:

CREATE TABLE new_tbl AS SELECT * FROM orig_tbl;

詳細は、セクション13.1.20.4「CREATE TABLE ... SELECT ステートメント」を参照してください。

IGNORE | REPLACE

IGNORE および REPLACE オプションは、SELECT ステートメントを使用してテーブルをコピーするときに一意キー値を複製する行の処理方法を示します。

詳細は、セクション13.1.20.4「CREATE TABLE ... SELECT ステートメント」を参照してください。

data_type

data_type は、カラム定義のデータ型を表します。 カラムのデータ型の指定に使用できる構文の詳細、および各型のプロパティの詳細は、第11章「データ型」 を参照してください。

NOT NULL | NULL

NULL と NOT NULL のどちらも指定されていない場合、そのカラムは NULL が指定されたかのように処理されます。

MySQL 8.0 では、InnoDB、MyISAM および MEMORY ストレージエンジンのみが NULL 値を持つことができるカラムのインデックスをサポートしています。 それ以外の場合は、インデックス付きカラムを NOT NULL として宣言する必要があります。そうしないと、エラー結果が発生します。

DEFAULT

カラムのデフォルト値を指定します。 カラム定義に明示的な DEFAULT 値が含まれていない場合など、デフォルト値の処理の詳細は、セクション11.6「データ型デフォルト値」 を参照してください。

NO_ZERO_DATE または NO_ZERO_IN_DATE SQL モードが有効になっているときに、日付の値のデフォルトがそのモードに従って正しくない場合、CREATE TABLE では厳密な SQL モードが有効になっていない場合は警告を、厳密モードが有効になっている場合はエラーを生成します。 たとえば、NO_ZERO_IN_DATE が有効になっている場合は、c1 DATE DEFAULT '2010-00-00' によって警告が生成されます。

VISIBLE, INVISIBLE

カラムの可視性を指定します。 どちらのキーワードも存在しない場合、デフォルトは VISIBLE です。 テーブルには、少なくとも 1 つの表示可能なカラムが必要です。 すべてのカラムを非表示にしようとすると、エラーが発生します。 詳細は、セクション13.1.20.10「非表示カラム」を参照してください。

VISIBLE および INVISIBLE キーワードは、MySQL 8.0.23 の時点で使用できます。 MySQL 8.0.23 より前は、すべてのカラムが表示されます。

AUTO_INCREMENT

整数または浮動小数点のカラムには、追加の属性 AUTO_INCREMENT を指定できます。 インデックスが設定された AUTO_INCREMENT カラムに NULL (推奨) または 0 の値を挿入すると、カラムは次のシーケンス値に設定されます。 通常、これは value+1 です。ここで value は現在テーブルにあるカラムの最大値です。 AUTO_INCREMENT シーケンスは 1 で始まります。

行を挿入したあとに AUTO_INCREMENT 値を取得するには、LAST_INSERT_ID() SQL 関数または mysql_insert_id() C API 関数を使用します。 セクション12.16「情報関数」およびmysql_insert_id()を参照してください。

NO_AUTO_VALUE_ON_ZERO SQL モードが有効になっている場合は、新しいシーケンス値を生成することなく、0 を AUTO_INCREMENT カラム内に 0 として格納できます。 セクション5.1.11「サーバー SQL モード」を参照してください。

テーブルごとに存在できる AUTO_INCREMENT カラムは 1 つだけです。このカラムはインデックス付きである必要があり、DEFAULT 値を割り当てることはできません。 AUTO_INCREMENT カラムは、正の値だけが含まれている場合にのみ正しく機能します。 負の数を挿入すると、非常に大きな正の数を挿入したと見なされます。 これは、数字が正から負に「ラップする」ときの精度の問題を回避すると同時に、0 を含む AUTO_INCREMENT カラムを誤って取得してしまわないようにするために行われます。

MyISAM テーブルの場合は、マルチカラムキー内の AUTO_INCREMENT セカンダリカラムを指定できます。 セクション3.6.9「AUTO_INCREMENT の使用」を参照してください。

MySQL を一部の ODBC アプリケーションと互換性があるようにするために、次のクエリーを使用して、最後に挿入された行の AUTO_INCREMENT 値を見つけることができます。

SELECT * FROM tbl_name WHERE auto_col IS NULL

このメソッドでは、sql_auto_is_null 変数が 0 に設定されていない必要があります。 セクション5.1.8「サーバーシステム変数」を参照してください。

InnoDB と AUTO_INCREMENT については、セクション15.6.1.6「InnoDB での AUTO_INCREMENT 処理」を参照してください。 AUTO_INCREMENT と MySQL レプリケーションについては、セクション17.5.1.1「レプリケーションと AUTO_INCREMENT」を参照してください。

COMMENT

カラムのコメントは、COMMENT オプションで 1024 文字以内で指定できます。 このコメントは、SHOW CREATE TABLE および SHOW FULL COLUMNS ステートメントによって表示されます。

COLUMN_FORMAT

NDB Cluster では、COLUMN_FORMAT を使用して NDB テーブルの個々のカラムのデータストレージ形式を指定することもできます。 許可されるカラムフォーマットは、FIXED、DYNAMIC、および DEFAULT です。 FIXED は固定幅記憶域の指定に使用され、DYNAMIC はカラムを可変幅にすることを許可し、DEFAULT はカラムのデータ型によって決定される固定幅記憶域または可変幅記憶域 (ROW_FORMAT 指定子によってオーバーライドされる可能性がある) を使用します。

NDB テーブルの場合、COLUMN_FORMAT のデフォルト値は FIXED です。

NDB Cluster では、COLUMN_FORMAT=FIXED で定義されたカラムの可能な最大オフセットは 8188 バイトです。 詳細および考えられる回避策については、セクション23.1.7.5「NDB Cluster 内のデータベースオブジェクトに関連付けられる制限」 を参照してください。

COLUMN_FORMAT は現在、NDB 以外のストレージエンジンを使用しているテーブルのカラムには影響を与えません。 MySQL 8.0 は、COLUMN_FORMAT を暗黙的に無視します。

ENGINE_ATTRIBUTE および SECONDARY_ENGINE_ATTRIBUTE オプション (MySQL 8.0.21 の時点で使用可能) を使用して、プライマリおよびセカンダリストレージエンジンのカラム属性を指定します。 オプションは、将来の使用のために予約されています。

許可される値は、有効な JSON ドキュメントまたは空の文字列 ('') を含む文字列リテラルです。 無効な JSON が拒否されました。

CREATE TABLE t1 (c1 INT ENGINE_ATTRIBUTE='{"key":"value"}');

ENGINE_ATTRIBUTE および SECONDARY_ENGINE_ATTRIBUTE の値は、エラーなしで繰り返すことができます。 この場合、最後に指定した値が使用されます。

ENGINE_ATTRIBUTE および SECONDARY_ENGINE_ATTRIBUTE の値は、サーバーによってチェックされず、テーブルストレージエンジンが変更されたときにもクリアされません。

STORAGE

NDB テーブルの場合、STORAGE 句を使用して、カラムをディスクに格納するかメモリーに格納するかを指定できます。 STORAGE DISK を指定するとカラムはディスク上に格納され、STORAGE MEMORY を指定するとインメモリーストレージが使用されます。 使用される CREATE TABLE ステートメントには、引き続き TABLESPACE 句が含まれている必要があります。

mysql> CREATE TABLE t1 (
    ->     c1 INT STORAGE DISK,
    ->     c2 INT STORAGE MEMORY
    -> ) ENGINE NDB;
ERROR 1005 (HY000): Can't create table 'c.t1' (errno: 140)

mysql> CREATE TABLE t1 (
    ->     c1 INT STORAGE DISK,
    ->     c2 INT STORAGE MEMORY
    -> ) TABLESPACE ts_1 ENGINE NDB;
Query OK, 0 rows affected (1.06 sec)

NDB テーブルの場合、STORAGE DEFAULT は STORAGE MEMORY と同等です。

STORAGE 句は、NDB 以外のストレージエンジンを使用しているテーブルには影響を与えません。 STORAGE キーワードは NDB Cluster で提供される mysqld の構築でのみサポートされます。ほかのバージョンの MySQL では認識されず、STORAGE キーワードを使用しようとすると構文エラーが発生します。

GENERATED ALWAYS

生成されたカラム式を指定するために使用します。 generated columns の詳細は、セクション13.1.20.8「CREATE TABLE および生成されるカラム」 を参照してください。

Stored generated columns はインデックス付けできます。 InnoDB は、virtual generated columns でセカンダリインデックスをサポートしています。 セクション13.1.20.9「セカンダリインデックスと生成されたカラム」を参照してください。

CONSTRAINT symbol

CONSTRAINT symbol 句を指定して制約に名前を付けることができます。 句が指定されていない場合、または CONSTRAINT キーワードの後に symbol が含まれていない場合、MySQL では制約名が自動的に生成されますが、次に示す例外があります。 symbol 値 (使用する場合) は、制約タイプごとにスキーマ (データベース) ごとに一意である必要があります。 symbol が重複すると、エラーになります。 セクション9.2.1「識別子の長さ制限」 で生成される制約識別子の長さ制限に関する説明も参照してください。

SQL 標準では、すべてのタイプの制約 (主キー、一意インデックス、外部キー、チェック) が同じネームスペースに属することが指定されています。 MySQL では、各制約タイプにスキーマごとに独自のネームスペースがあります。 したがって、各タイプの制約の名前はスキーマごとに一意である必要がありますが、異なるタイプの制約には同じ名前を付けることができます。

PRIMARY KEY

すべてのキーカラムを NOT NULL として定義する必要がある一意のインデックス。 それらが NOT NULL として明示的に宣言されていない場合、MySQL は、それらを暗黙的に (かつ警告なしで) そのように宣言します。 テーブルに存在できる PRIMARY KEY は 1 つだけです。 PRIMARY KEY の名前は、常に PRIMARY です。そのため、これをその他のどの種類のインデックスの名前としても使用できません。

PRIMARY KEY が存在しないときに、アプリケーションがテーブル内の PRIMARY KEY を要求した場合、MySQL は、NULL カラムのない最初の UNIQUE インデックスを PRIMARY KEY として返します。

InnoDB テーブルでは、セカンダリインデックスのためのストレージのオーバーヘッドを最小限に抑えるために、PRIMARY KEY を短い値に維持してください。 各セカンダリインデックスエントリには、対応する行の主キーカラムのコピーが含まれています。 (セクション15.6.2.1「クラスタインデックスとセカンダリインデックス」を参照してください。)

作成されたテーブルでは、PRIMARY KEY が最初に配置され、そのあとにすべての UNIQUE インデックス、さらに一意でないインデックスが続きます。 これは、MySQL オプティマイザが、使用するインデックスに優先順位を付けたり、重複した UNIQUE キーをよりすばやく検出したりするのに役立ちます。

PRIMARY KEY をマルチカラムインデックスにすることができます。 ただし、カラム指定で PRIMARY KEY キー属性を使用してマルチカラムインデックスを作成することはできません。 それを行なっても、その単一カラムがプライマリとしてマークされるだけです。 別の PRIMARY KEY(key_part, ...) 句を使用する必要があります。

テーブルに整数型の単一カラムで構成される PRIMARY KEY または UNIQUE NOT NULL インデックスがある場合、一意インデックス で説明されているように、_rowid を使用して SELECT ステートメントのインデックス付きカラムを参照できます。

MySQL では、PRIMARY KEY の名前は PRIMARY です。 その他のインデックスでは、名前を割り当てなかった場合、そのインデックスには最初のインデックス付きカラムと同じ名前が割り当てられ、それを一意にするためにオプションのサフィクス (_2、_3、...) が付けられます。 テーブルのインデックス名は、SHOW INDEX FROM tbl_name を使用して確認できます。 セクション13.7.7.22「SHOW INDEX ステートメント」を参照してください。

KEY | INDEX

KEY は通常、INDEX のシノニムです。 キー属性 PRIMARY KEY もまた、カラム定義内で指定する場合は、単に KEY として指定できます。 これは、ほかのデータベースシステムとの互換性のために実装されました。

UNIQUE

UNIQUE インデックスは、そのインデックス内のすべての値が異なっている必要があるという制約を作成します。 既存の行に一致するキー値を持つ新しい行を追加しようとすると、エラーが発生します。 すべてのエンジンについて、UNIQUE インデックスは、NULL を含むことができるカラムでの複数の NULL 値を許可します。 UNIQUE インデックスのカラムに接頭辞値を指定する場合、カラム値は接頭辞の長さ内で一意である必要があります。

テーブルに整数型の単一カラムで構成される PRIMARY KEY または UNIQUE NOT NULL インデックスがある場合、一意インデックス で説明されているように、_rowid を使用して SELECT ステートメントのインデックス付きカラムを参照できます。

FULLTEXT

FULLTEXT インデックスは、全文検索に使用される特別なタイプのインデックスです。 FULLTEXT インデックスをサポートするのは、InnoDB および MyISAM だけです。 これらは、CHAR、VARCHAR、および TEXT カラムからのみ作成できます。 インデックス設定は常に、カラム全体に対して実行されます。カラムプリフィクスのインデックス設定はサポートされていないため、プリフィクス長が指定されてもすべて無視されます。 操作の詳細は、セクション12.10「全文検索関数」を参照してください。 WITH PARSER 句は、全文インデックス設定および検索操作に特殊な処理が必要な場合にパーサープラグインをインデックスに関連付けるために、index_option 値として指定できます。 この句は、FULLTEXT インデックスに対してのみ有効です。 InnoDB および MyISAM は、フルテキストパーサープラグインをサポートしています。 詳細は、Full-Text Parser Plugins および Writing Full-Text Parser Plugins を参照してください。

SPATIAL

空間データ型に SPATIAL インデックスを作成できます。 空間型は InnoDB および MyISAM テーブルでのみサポートされており、インデックス付けされたカラムは NOT NULL として宣言する必要があります。 セクション11.4「空間データ型」を参照してください。

FOREIGN KEY

MySQL は、関連データのテーブルにまたがる相互参照を可能にする外部キーと、この分散したデータの整合性を維持するために役立つ外部キー制約をサポートします。 定義およびオプションの情報は、reference_definition および reference_option を参照してください。

InnoDB ストレージエンジンを使用するパーティション化されたテーブルは、外部キーをサポートしていません。 詳細については、セクション24.6「パーティショニングの制約と制限」を参照してください。

CHECK

CHECK 句を使用すると、テーブルの行のデータ値について制約を作成できます。 セクション13.1.20.6「CHECK 制約」を参照してください。

key_part

index_type

一部のストレージエンジンでは、インデックスの作成時にインデックスタイプを指定できます。 index_type 指定子の構文は、USING type_name です。

例:

CREATE TABLE lookup
  (id INT, INDEX USING BTREE (id))
  ENGINE = MEMORY;

USING の推奨される位置は、インデックスカラムリストのあとです。 カラムリストの前に指定できますが、その位置でのオプションの使用のサポートは非推奨であるため、将来の MySQL リリースで削除される予定です。

index_option

index_option 値は、インデックスの追加オプションを指定します。

許容される index_option 値の詳細は、セクション13.1.15「CREATE INDEX ステートメント」 を参照してください。 インデックスの詳細は、セクション8.3.1「MySQL のインデックスの使用の仕組み」を参照してください。

reference_definition

reference_definition 構文の詳細および例は、セクション13.1.20.5「FOREIGN KEY の制約」 を参照してください。

InnoDB および NDB テーブルは、外部キー制約のチェックをサポートしています。 参照されるテーブルのカラムには、常に明示的に名前を付ける必要があります。 外部キーに対しては ON DELETE と ON UPDATE の両方のアクションがサポートされています。 詳細および例については、セクション13.1.20.5「FOREIGN KEY の制約」を参照してください。

その他のストレージエンジンの場合、MySQL Server は、CREATE TABLE ステートメント内の FOREIGN KEY および REFERENCES 構文を解析して無視します。 セクション1.7.2.3「FOREIGN KEY 制約の違い」を参照してください。

reference_option

RESTRICT, CASCADE, SET NULL, NO ACTION および SET DEFAULT オプションの詳細は、セクション13.1.20.5「FOREIGN KEY の制約」 を参照してください。

ENGINE

次のテーブルに示すいずれかの名前を使用して、テーブルのストレージエンジンを指定します。 エンジン名は、引用符で囲んでも囲まなくてもかまいません。 引用符で囲まれた名前 'DEFAULT' は認識されますが、無視されます。

デフォルトでは、使用できないストレージエンジンが指定されている場合、ステートメントはエラーで失敗します。 この動作をオーバーライドするには、サーバーの SQL モードから NO_ENGINE_SUBSTITUTION を削除します (セクション5.1.11「サーバー SQL モード」 を参照)。これにより、MySQL では、指定されたエンジンをデフォルトのストレージエンジンに置き換えることができます。 通常、このような場合、これは default_storage_engine システム変数のデフォルト値である InnoDB です。 NO_ENGINE_SUBSTITUTION が無効になっている場合、ストレージエンジンの指定が受け入れられないと警告が発生します。

AUTOEXTEND_SIZE

テーブルスペースが一杯になったときに InnoDB がテーブルスペースのサイズを拡張する量を定義します。 MySQL 8.0.23 で導入されました。 設定は 4MB の倍数である必要があります。 デフォルト設定は 0 で、暗黙的なデフォルト動作に従ってテーブルスペースが拡張されます。 詳細は、セクション15.6.3.9「テーブルスペースの AUTOEXTEND_SIZE 構成」を参照してください。

AUTO_INCREMENT

テーブルの初期の AUTO_INCREMENT 値。 MySQL 8.0 では、これは MyISAM、MEMORY、InnoDB、および ARCHIVE テーブルに対して機能します。 AUTO_INCREMENT テーブルオプションをサポートしていないエンジンの最初の自動インクリメント値を設定するには、テーブルを作成したあとに目的の値より 1 小さい値を持つ「ダミーの」行を挿入してから、そのダミーの行を削除します。

CREATE TABLE ステートメント内の AUTO_INCREMENT テーブルオプションをサポートするエンジンの場合は、ALTER TABLE tbl_name AUTO_INCREMENT = N を使用して AUTO_INCREMENT 値をリセットすることもできます。 この値を、現在カラム内にある最大値より小さく設定することはできません。

AVG_ROW_LENGTH

テーブルの平均の行の長さの近似値。 これを設定する必要があるのは、可変サイズの行を持つ大きなテーブルの場合だけです。

MyISAM テーブルを作成すると、MySQL は MAX_ROWS および AVG_ROW_LENGTH オプションの積を使用して、結果として得られるテーブルがどれくらいの大きさになるかを判定します。 どちらのオプションも指定しない場合、MyISAM データおよびインデックスファイルの最大サイズは、デフォルトで 256T バイトになります。 (オペレーティングシステムでその大きさのファイルがサポートされていない場合、テーブルサイズはファイルサイズ制限によって制約されます。) インデックスをより小さく、かつ高速にするためにポインタサイズを小さく維持したいと考えており、実際に大きなファイルが必要でない場合は、myisam_data_pointer_size システム変数を設定することによってデフォルトのポインタサイズを小さくすることができます。 (セクション5.1.8「サーバーシステム変数」を参照してください。) すべてのテーブルをデフォルトの制限を超えて拡張できるようにしたいと考えており、テーブルが必要以上に少し遅く、かつ大きくなってもかまわない場合は、この変数を設定することによってデフォルトのポインタサイズを大きくすることができます。 この値を 7 に設定すると、最大 65,536T バイトのテーブルサイズが許可されます。

[DEFAULT] CHARACTER SET

テーブルのデフォルトの文字セットを指定します。 CHARSET は CHARACTER SET のシノニムです。 文字セット名が DEFAULT である場合は、データベース文字セットが使用されます。

CHECKSUM

MySQL ですべての行のライブチェックサム (つまり、テーブルが変更されると MySQL が自動的に更新するチェックサム) が保持されるようにする場合は、これを 1 に設定します。 これにより、テーブルの更新が少し遅くなりますが、破損したテーブルを見つけることが容易になります。 CHECKSUM TABLE ステートメントは、このチェックサムをレポートします。 (MyISAM のみ。)

[DEFAULT] COLLATE

テーブルのデフォルトの照合を指定します。

COMMENT

テーブルのコメントであり、長さは最大 2048 文字です。

table_option COMMENT 句を使用して、テーブルの InnoDB MERGE_THRESHOLD 値を設定できます。 セクション15.8.11「インデックスページのマージしきい値の構成」を参照してください。

「NDB_TABLE の設定」オプション.  NDB テーブルを作成する CREATE TABLE のまたは変更する ALTER TABLE ステートメントのテーブルコメントは、NDB_TABLE オプション NOLOGGING, READ_BACKUP, PARTITION_BALANCE、または FULLY_REPLICATED の 1 つから 4 つを指定するのに使用でき、カンマ区切り (必要ならば) の名前 - 値ペアのセットとして、引用符付きテキストで始まる文字列 NDB_TABLE= の直後に続きます。 この構文を使用したステートメントの例を次に示します (強調されたテキスト):

CREATE TABLE t1 (
    c1 INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
    c2 VARCHAR(100),
    c3 VARCHAR(100) )
ENGINE=NDB
COMMENT="NDB_TABLE=READ_BACKUP=0,PARTITION_BALANCE=FOR_RP_BY_NODE";

引用符で囲まれた文字列内ではスペースを使用できません。 文字列では大文字と小文字は区別されません。

コメントは、SHOW CREATE TABLE の出力の一部として表示されます。 コメントのテキストは、MySQL Information Schema TABLES テーブルの TABLE_COMMENT カラムとしても使用できます。

このコメント構文は、NDB テーブルの ALTER TABLE ステートメントでもサポートされています。 ALTER TABLE で使用されるテーブルコメントは、テーブルにある可能性のある既存のコメントを置き換えることに注意してください。

テーブルコメントでの MERGE_THRESHOLD オプションの設定は、NDB テーブルではサポートされていません (無視されます)。

完全な構文情報および例は、セクション13.1.20.11「NDB_TABLE オプションの設定」 を参照してください。

COMPRESSION

InnoDB テーブルのページレベル圧縮に使用される圧縮アルゴリズム。 サポートされている値は、Zlib、LZ4 および None です。 COMPRESSION 属性は、透過的ページ圧縮機能とともに導入されました。 ページ圧縮は、file-per-table テーブルスペースに存在する InnoDB テーブルでのみサポートされており、スパースファイルおよびホールパンチをサポートする Linux および Windows プラットフォームでのみ使用できます。 詳細は、セクション15.9.2「InnoDB ページ圧縮」を参照してください。

CONNECTION

FEDERATED テーブルの接続文字列。

DATA DIRECTORY、INDEX DIRECTORY

InnoDB の場合、DATA DIRECTORY='directory'句を使用すると、データディレクトリ外にテーブルを作成できます。 DATA DIRECTORY 句を使用するには、innodb_file_per_table 変数を有効にする必要があります。 完全なディレクトリパスを指定する必要があります。 MySQL 8.0.21 では、指定されたディレクトリは InnoDB で認識されている必要があります。 詳細は、セクション15.6.1.2「外部でのテーブルの作成」を参照してください。

MyISAM テーブルを作成する場合は、DATA DIRECTORY='directory' 句、INDEX DIRECTORY='directory' 句、またはその両方を使用できます。 これらは、それぞれ MyISAM テーブルのデータファイルとインデックスファイルを配置する場所を指定します。 InnoDB テーブルとは異なり、DATA DIRECTORY または INDEX DIRECTORY オプションで MyISAM テーブルを作成する場合、MySQL はデータベース名に対応するサブディレクトリを作成しません。 各ファイルは、指定されたディレクトリ内に作成されます。

DATA DIRECTORY または INDEX DIRECTORY テーブルオプションを使用するには、FILE 権限が必要です。

これらのオプションは、--skip-symbolic-links オプションを使用していない場合にのみ機能します。 また、オペレーティングシステムにも、機能するスレッドに対して安全な realpath() 呼び出しが存在する必要があります。 詳細は、セクション8.12.2.2「Unix 上の MyISAM へのシンボリックリンクの使用」を参照してください。

MyISAM テーブルが DATA DIRECTORY オプションなしで作成される場合、.MYD ファイルがデータベースディレクトリ内に作成されます。 デフォルトでは、MyISAM が既存の .MYD ファイルを検出した場合、そのファイルを上書きします。 INDEX DIRECTORY オプションを指定せずに作成されたテーブルについて、.MYI ファイルに同じことが当てはまります。 この動作を抑制するには、--keep_files_on_create オプションを使用してサーバーを起動します。この場合、MyISAM は既存のファイルを上書きせず、かわりにエラーを返します。

DATA DIRECTORY または INDEX DIRECTORY オプションを使用して MyISAM テーブルが作成され、既存の .MYD または .MYI ファイルが見つかった場合、MyISAM は常にエラーを返し、指定されたディレクトリ内のファイルを上書きしません。

DELAY_KEY_WRITE

テーブルのキー更新をテーブルが閉じられるまで遅らせる場合は、これを 1 に設定します。 セクション5.1.8「サーバーシステム変数」にある delay_key_write システム変数の説明を参照してください。 (MyISAM のみ。)

ENCRYPTION

ENCRYPTION 句は、InnoDB テーブルのページレベルのデータ暗号化を有効または無効にします。 暗号化を有効にする前に、キーリングプラグインをインストールして構成する必要があります。 MySQL 8.0.16 より前では、ENCRYPTION 句は file-per-table テーブルスペースにテーブルを作成する場合にのみ指定できます。 MySQL 8.0.16 では、一般的なテーブルスペースにテーブルを作成するときに ENCRYPTION 句を指定することもできます。

MySQL 8.0.16 では、ENCRYPTION 句が指定されていない場合、テーブルはデフォルトのスキーマ暗号化を継承します。 table_encryption_privilege_check 変数が有効になっている場合、デフォルトのスキーマ暗号化とは異なる ENCRYPTION 句設定を使用してテーブルを作成するには、TABLE_ENCRYPTION_ADMIN 権限が必要です。 一般的なテーブルスペースにテーブルを作成する場合、テーブルとテーブルスペースの暗号化は一致する必要があります。

MySQL 8.0.16 の時点では、暗号化をサポートしていないストレージエンジンを使用する場合、'N'または''以外の値で ENCRYPTION 句を指定することはできません。 以前は、条項は受け入れられました。

詳細は、セクション15.13「InnoDB 保存データ暗号化」を参照してください。

ENGINE_ATTRIBUTE および SECONDARY_ENGINE_ATTRIBUTE オプション (MySQL 8.0.21 の時点で使用可能) を使用して、プライマリおよびセカンダリストレージエンジンのテーブル属性を指定します。 オプションは、将来の使用のために予約されています。

許可される値は、有効な JSON ドキュメントまたは空の文字列 ('') を含む文字列リテラルです。 無効な JSON が拒否されました。

CREATE TABLE t1 (c1 INT) ENGINE_ATTRIBUTE='{"key":"value"}';

ENGINE_ATTRIBUTE および SECONDARY_ENGINE_ATTRIBUTE の値は、エラーなしで繰り返すことができます。 この場合、最後に指定した値が使用されます。

ENGINE_ATTRIBUTE および SECONDARY_ENGINE_ATTRIBUTE の値は、サーバーによってチェックされず、テーブルストレージエンジンが変更されたときにもクリアされません。

INSERT_METHOD

MERGE テーブルにデータを挿入する場合は、INSERT_METHOD を使用して、行を挿入するテーブルを指定する必要があります。 INSERT_METHOD は、MERGE テーブルにのみ役立つオプションです。 最初または最後のテーブルに挿入するには FIRST または LAST の値を、挿入されないようにするには NO の値を使用します。 セクション16.7「MERGE ストレージエンジン」を参照してください。

KEY_BLOCK_SIZE

MyISAM テーブルの場合、KEY_BLOCK_SIZE はオプションで、インデックスキーブロックに使用するサイズをバイト単位で指定します。 この値はヒントとして扱われます。必要に応じて、異なるサイズが使用される可能性があります。 個々のインデックス定義に指定された KEY_BLOCK_SIZE 値は、テーブルレベルの KEY_BLOCK_SIZE 値をオーバーライドします。

InnoDB テーブルの場合、KEY_BLOCK_SIZE は compressed InnoDB テーブルに使用する page サイズを KB 単位で指定します。 KEY_BLOCK_SIZE 値は、ヒントとして処理されます。InnoDB では、必要に応じて異なるサイズが使用される可能性があります。 KEY_BLOCK_SIZE は、innodb_page_size 値以下にのみできます。 値 0 は、innodb_page_size 値の半分であるデフォルトの圧縮済みページサイズを表します。 innodb_page_size に応じて、可能な KEY_BLOCK_SIZE 値には 0、1、2、4、8 および 16 が含まれます。 詳しくはセクション15.9.1「InnoDB テーブルの圧縮」をご覧ください。

InnoDB テーブルに KEY_BLOCK_SIZE を指定する場合、Oracle では innodb_strict_mode を有効にすることをお薦めします。 innodb_strict_mode が有効な場合、無効な KEY_BLOCK_SIZE 値を指定するとエラーが返されます。 innodb_strict_mode が無効な場合、無効な KEY_BLOCK_SIZE 値は警告になり、KEY_BLOCK_SIZE オプションは無視されます。

SHOW TABLE STATUS に対するレスポンスの Create_options カラムには、SHOW CREATE TABLE と同様に、テーブルで使用される実際の KEY_BLOCK_SIZE がレポートされます。

InnoDB では、テーブルレベルでの KEY_BLOCK_SIZE のみがサポートされます。

KEY_BLOCK_SIZE は、32KB および 64KB の innodb_page_size 値ではサポートされていません。 InnoDB テーブル圧縮では、これらのページサイズはサポートされていません。

InnoDB では、一時テーブルの作成時に KEY_BLOCK_SIZE オプションをサポートしていません。

MAX_ROWS

テーブル内に格納することを予定している行の最大数。 これは強い制限値ではなく、どちらかと言うと、テーブルが少なくともこの行数を格納できる必要があるという、ストレージエンジンへのヒントです。

NDB ストレージエンジンは、この値を最大値として扱います。 非常に大きな「NDB Cluster」テーブル (数百万行を含む) を作成する場合は、このオプションを使用して、MAX_ROWS = 2 * rows を設定することで、NDB がテーブルの主キーのハッシュの格納に使用するハッシュテーブルに十分な数の索引スロットを割り当てるようにする必要があります (rows は、テーブルに挿入する予定の行数です)。

MAX_ROWS の最大値は 4294967295 です。これを超える値は、この制限に切り捨てられます。

MIN_ROWS

テーブル内に格納することを予定している行の最小数。 MEMORY ストレージエンジンは、このオプションをメモリー使用に関するヒントとして使用します。

PACK_KEYS

MyISAM テーブルでのみ有効です。 インデックスを小さくする場合は、このオプションを 1 に設定します。 通常は、これによって更新は遅く、読み取りは高速になります。 このオプションを 0 に設定すると、キーのすべてのパッキングが無効になります。 これを DEFAULT に設定すると、長い CHAR、VARCHAR、BINARY、または VARBINARY カラムのみをパックするようストレージエンジンに指示します。

PACK_KEYS を使用しない場合、デフォルトでは文字列をパックしますが、数値はパックしません。 PACK_KEYS=1 を使用した場合は、数値もパックされます。

2 進数のキーをパックする場合、MySQL は次のプリフィクス圧縮を使用します。

つまり、2 つの連続した行に等しいキーが多数存在する場合は、次の「同じ」キーはすべて、通常 (行へのポインタを含め) 2 バイトしか占有しません。 これを、次のキーが storage_size_for_key + pointer_size (ここで、ポインタサイズは通常 4) を占有する通常のケースと比較してください。 逆に言うと、プリフィクス圧縮から大きな利点が得られるのは、同じ数値が多数存在する場合だけです。 すべてのキーが完全に異なっている場合は、そのキーが NULL 値を持つことができるキーでないかぎり、キーあたり 1 バイト多く使用されます。 (この場合、パックされたキーの長さは、キーが NULL であるかどうかをマークするために使用されるのと同じバイトに格納されます。)

PASSWORD

このオプションは使用されません。

ROW_FORMAT

行が格納される物理フォーマットを定義します。

strict mode を無効にしてテーブルを作成する場合、指定した行フォーマットがサポートされていないと、ストレージエンジンのデフォルトの行フォーマットが使用されます。 テーブルの実際の行形式は、SHOW TABLE STATUS に応じて Row_format カラムにレポートされます。 Create_options カラムには、SHOW CREATE TABLE と同様に、CREATE TABLE ステートメントで指定された行形式が表示されます。

行形式の選択は、テーブルに使用されるストレージエンジンによって異なります。

InnoDB テーブルの場合:

MyISAM テーブルの場合は、このオプション値を、静的行フォーマットまたは可変長行フォーマットを示す FIXED または DYNAMIC に設定できます。myisampack は、この型を COMPRESSED に設定します。 セクション16.2.3「MyISAM テーブルのストレージフォーマット」を参照してください。

NDB テーブルの場合、デフォルトの ROW_FORMAT は DYNAMIC です。

STATS_AUTO_RECALC

InnoDB テーブルの永続的統計を自動的に再計算するかどうかを指定します。 値 DEFAULT を指定すると、テーブルの永続的統計設定は innodb_stats_auto_recalc 構成オプションによって決定されます。 値 1 を指定すると、統計は、テーブル内のデータの 10% が変更されたときに再計算されます。 値 0 は、このテーブルの自動再計算が行われないようにします。この設定の場合、テーブルへの大幅な変更を行なったあとに統計を再計算するには、ANALYZE TABLE ステートメントを発行します。 永続的統計機能の詳細は、セクション15.8.10.1「永続的オプティマイザ統計のパラメータの構成」を参照してください。

STATS_PERSISTENT

InnoDB テーブルの永続的統計を有効にするかどうかを指定します。 値 DEFAULT を指定すると、テーブルの永続的統計設定は innodb_stats_persistent 構成オプションによって決定されます。 値 1 がテーブルの永続的統計を有効にするのに対して、値 0 はこの機能を無効にします。 CREATE TABLE または ALTER TABLE ステートメントを使用して永続的統計を有効にしたあと、代表的なデータのテーブルへのロード後に統計を計算するには、ANALYZE TABLE ステートメントを発行します。 永続的統計機能の詳細は、セクション15.8.10.1「永続的オプティマイザ統計のパラメータの構成」を参照してください。

STATS_SAMPLE_PAGES

インデックス付きカラムのカーディナリティーやその他の統計 (ANALYZE TABLE によって計算される統計など) を推定するときにサンプリングするインデックスページの数。 詳細は、セクション15.8.10.1「永続的オプティマイザ統計のパラメータの構成」を参照してください。

TABLESPACE

TABLESPACE 句を使用すると、既存の一般テーブルスペース、file-per-table テーブルスペースまたはシステムテーブルスペースにテーブルを作成できます。

CREATE TABLE tbl_name ... TABLESPACE [=] tablespace_name

TABLESPACE 句を使用する前に、指定する一般テーブルスペースが存在している必要があります。 一般テーブルスペースの詳細は、セクション15.6.3.3「一般テーブルスペース」 を参照してください。

tablespace_name は、大/小文字を区別する識別子です。 引用符で囲むことも、引用符で囲まないこともできます。 スラッシュ文字 (「/」) は使用できません。 「innodb_」で始まる名前は、特別な用途のために予約されています。

システムテーブルスペースにテーブルを作成するには、テーブルスペース名として innodb_system を指定します。

CREATE TABLE tbl_name ... TABLESPACE [=] innodb_system

TABLESPACE [=] innodb_system を使用すると、innodb_file_per_table の設定に関係なく、圧縮されていない行形式のテーブルをシステムテーブルスペースに配置できます。 たとえば、TABLESPACE [=] innodb_system を使用して、ROW_FORMAT=DYNAMIC を含むテーブルをシステムテーブルスペースに追加できます。

file-per-table テーブルスペースにテーブルを作成するには、テーブルスペース名として innodb_file_per_table を指定します。

CREATE TABLE tbl_name ... TABLESPACE [=] innodb_file_per_table

DATA DIRECTORY 句は CREATE TABLE ... TABLESPACE=innodb_file_per_table では許可されますが、それ以外の場合は TABLESPACE 句との組合せでの使用はサポートされていません。 MySQL 8.0.21 では、DATA DIRECTORY 句で指定されたディレクトリは InnoDB で認識されている必要があります。 詳細は、DATA DIRECTORY 句の使用を参照してください。

STORAGE テーブルオプションは、NDB テーブルでのみ使用されます。 STORAGE は、使用される記憶域のタイプ (ディスクまたはメモリー) を決定し、DISK または MEMORY のいずれかになります。

TABLESPACE ... STORAGE DISK は、「NDB Cluster ディスクデータ」テーブルスペースにテーブルを割り当てます。 テーブルスペースは、CREATE TABLESPACE を使用してすでに作成されている必要があります。 詳細は、セクション23.5.10「NDB Cluster ディスクデータテーブル」を参照してください。

UNION

同一の MyISAM テーブルのコレクションにアクセスするために使用します。 これは、MERGE テーブルでのみ機能します。 セクション16.7「MERGE ストレージエンジン」を参照してください。

MERGE テーブルにマップするテーブルに対する SELECT、UPDATE、および DELETE 権限が必要です。

PARTITION BY

partition_options 句が使用される場合、この句は PARTITION BY で始まります。 この句には、パーティションを決定するために使用される関数が含まれています。この関数は、1 から num までの範囲の整数値を返します。ここで、num はパーティションの数です。 (テーブルに含めることのできるユーザー定義パーティションの最大数は 1024 です。この最大数には、このセクションのあとの方で説明されているサブパーティションの数が含まれています。)

HASH(expr)

1 つ以上のカラムをハッシュして、行を配置および検索するためのキーを作成します。expr は、1 つ以上のテーブルのカラムを使用する式です。 これは、1 つの整数値が得られる任意の有効な MySQL 式 (MySQL 関数を含む) にすることができます。 たとえば、次はどちらも、PARTITION BY HASH を使用した有効な CREATE TABLE ステートメントです。

CREATE TABLE t1 (col1 INT, col2 CHAR(5))
    PARTITION BY HASH(col1);

CREATE TABLE t1 (col1 INT, col2 CHAR(5), col3 DATETIME)
    PARTITION BY HASH ( YEAR(col3) );

PARTITION BY HASH では、VALUES LESS THAN または VALUES IN のどちらの句も使用できません。

PARTITION BY HASH は、expr をパーティションの数で割った余り (つまり、法) を使用します。 例および追加情報については、セクション24.2.4「HASH パーティショニング」を参照してください。

LINEAR キーワードには、いくぶん異なるアルゴリズムが必要になります。 この場合、行が格納されるパーティションの数は、1 つ以上の論理的な AND 演算の結果として計算されます。 線形ハッシュの説明および例については、セクション24.2.4.1「LINEAR HASH パーティショニング」を参照してください。

KEY(column_list)

これは HASH と似ていますが、偶数のデータ分散を保証するために、MySQL がハッシュ関数を提供する点が異なります。 column_list 引数は、単純に 1 つ以上のテーブルカラム (最大 16 個) のリストです。 この例は、4 つのパーティションを持つ、キーによってパーティション化された単純なテーブルを示しています。

CREATE TABLE tk (col1 INT, col2 CHAR(5), col3 DATE)
    PARTITION BY KEY(col3)
    PARTITIONS 4;

キーによってパーティション化されたテーブルの場合は、LINEAR キーワードを使用して線形パーティション化を採用できます。 これには、HASH によってパーティション化されたテーブルの場合と同じ効果があります。 つまり、パーティション番号は法ではなく、& 演算子を使用して見つけられます (詳細は、セクション24.2.4.1「LINEAR HASH パーティショニング」およびセクション24.2.5「KEY パーティショニング」を参照してください)。 この例では、キーによる線形パーティション化を使用して 5 つのパーティション間でデータを分散させます。

CREATE TABLE tk (col1 INT, col2 CHAR(5), col3 DATE)
    PARTITION BY LINEAR KEY(col3)
    PARTITIONS 5;

ALGORITHM={1 | 2} オプションは、[SUB]PARTITION BY [LINEAR] KEY でサポートされます。 ALGORITHM=1 を指定すると、サーバーは MySQL 5.1 と同じキーハッシュ関数を使用します。ALGORITHM=2 は、サーバーが、MySQL 5.5 以降で実装され、KEY によってパーティション化された新しいテーブルに対してデフォルトで使用されるキーハッシュ関数を採用することを示します。 (MySQL 5.5 以降で採用されたキーハッシュ関数によって作成されたパーティション化されたテーブルを MySQL 5.1 サーバーで使用することはできません。) このオプションを指定しない場合は、ALGORITHM=2 を使用するのと同じ効果があります。 このオプションは、主に [LINEAR] KEY によってパーティション化されたテーブルを MySQL 5.1 以降の MySQL バージョン間でアップグレードまたはダウングレードするときに使用するか、または MySQL 5.5 以降のサーバー上で、MySQL 5.1 サーバー上で使用できる KEY または LINEAR KEY によってパーティション化されたテーブルを作成することを目的にしています。 詳細は、セクション13.1.9.1「ALTER TABLE パーティション操作」を参照してください。

MySQL 5.7 以降の mysqldump では、次のようにバージョニングされたコメントにこのオプションが含まれています:

CREATE TABLE t1 (a INT)
/*!50100 PARTITION BY KEY */ /*!50611 ALGORITHM = 1 */ /*!50100 ()
      PARTITIONS 3 */

これにより、MySQL 5.6.10 以前のサーバーはこのオプションを無視するようになります。これらのバージョンでは、通常であれば構文エラーが発生します。 KEY によってパーティション化またはサブパーティション化されたテーブルをバージョン 5.6.11 より前の MySQL 5.6 サーバーに使用する MySQL 5.7 サーバーで作成されたダンプをロードする場合は、先に進む前に Changes in MySQL 5.6 に問い合せてください。 (見つかった情報は、MySQL 5.7(事実上 5.6.11 または later-server) から作成された KEY パーティションテーブルまたはサブパーティションテーブルを含むダンプを MySQL 5.5.30 以前のサーバーにロードする場合にも適用されます。)

また、MySQL 5.6.11 以降では、ALGORITHM=1 が mysqldump と同じ方法で、バージョン管理されたコメントを使用して SHOW CREATE TABLE の出力に必要に応じて表示されます。 ALGORITHM=2 は、元のテーブルを作成するときにこのオプションが指定された場合でも、SHOW CREATE TABLE の出力から常に省略されます。

PARTITION BY KEY では、VALUES LESS THAN または VALUES IN のどちらの句も使用できません。

RANGE(expr)

この場合、expr では、一連の VALUES LESS THAN 演算子を使用して値の範囲が表示されます。 範囲のパーティション化を使用する場合は、VALUES LESS THAN を使用して、少なくとも 1 つのパーティションを定義する必要があります。 範囲のパーティション化では VALUES IN を使用できません。

次のスキームに従って、年の値を含むカラムに関してパーティション化するテーブルがあるとします。

このようなパーティション化スキームを実装するテーブルは、次に示す CREATE TABLE ステートメントによって実現できます。

CREATE TABLE t1 (
    year_col  INT,
    some_data INT
)
PARTITION BY RANGE (year_col) (
    PARTITION p0 VALUES LESS THAN (1991),
    PARTITION p1 VALUES LESS THAN (1995),
    PARTITION p2 VALUES LESS THAN (1999),
    PARTITION p3 VALUES LESS THAN (2002),
    PARTITION p4 VALUES LESS THAN (2006),
    PARTITION p5 VALUES LESS THAN MAXVALUE
);

PARTITION ... VALUES LESS THAN ... ステートメントは、連続的に機能します。 VALUES LESS THAN MAXVALUE は、それ以外で指定されている最大値より大きい「残りの」値を指定するように機能します。

VALUES LESS THAN 句は、switch ... case ブロックの case 部分と同様の方法で順次機能します (C、Java、PHP などの多くのプログラミング言語で使用されています)。 つまり、この句は、連続した各 VALUES LESS THAN で指定されている上限が前の句の上限より大きく、かつ MAXVALUE を参照している句がリスト内のすべての句の最後に来るような方法で配置されている必要があります。

RANGE COLUMNS(column_list)

RANGE のこのバリアントにより、複数のカラムで範囲条件を使用する (つまり、WHERE a = 1 AND b < 10 や WHERE a = 1 AND b = 10 AND c < 10 などの条件を持つ) クエリーのパーティションプルーニングが容易になります。 これにより、COLUMNS 句内のカラムのリストと、各 PARTITION ... VALUES LESS THAN (value_list) パーティション定義句内のカラム値のセットを使用して、複数のカラム内の値の範囲を指定できるようになります。 (もっとも単純なケースでは、このセットは単一カラムで構成されます。) column_list および value_list で参照できるカラムの最大数は 16 です。

COLUMNS 句で使用される column_list には、カラムの名前のみを含めることができます。リスト内の各カラムは MySQL のデータ型のうち、整数型、文字列型、および時間または日付カラム型のいずれかである必要があります。 BLOB、TEXT、SET、ENUM、BIT、または空間データ型を使用したカラムは許可されていません。浮動小数点数型を使用するカラムも許可されていません。 また、COLUMNS 句では、関数や演算式も使用できません。

パーティション定義で使用される VALUES LESS THAN 句は、COLUMNS() 句に現れるカラムごとにリテラル値を指定する必要があります。つまり、各 VALUES LESS THAN 句で使用される値のリストには、COLUMNS 句にリストされているカラムの数と同じ数の値が含まれている必要があります。 VALUES LESS THAN 句で COLUMNS 句に存在する数より多いか、または少ない値を使用しようとすると、このステートメントは次のエラーで失敗します。Inconsistency in usage of column lists for partitioning.... VALUES LESS THAN に現れるどの値にも NULL は使用できません。 この例に示すように、最初のカラム以外の特定のカラムで MAXVALUE を複数回使用できます。

CREATE TABLE rc (
    a INT NOT NULL,
    b INT NOT NULL
)
PARTITION BY RANGE COLUMNS(a,b) (
    PARTITION p0 VALUES LESS THAN (10,5),
    PARTITION p1 VALUES LESS THAN (20,10),
    PARTITION p2 VALUES LESS THAN (50,MAXVALUE),
    PARTITION p3 VALUES LESS THAN (65,MAXVALUE),
    PARTITION p4 VALUES LESS THAN (MAXVALUE,MAXVALUE)
);

VALUES LESS THAN 値リストで使用されている各値が、対応するカラムの型に正確に一致している必要があります。変換は行われません。 たとえば、整数型を使用するカラムに一致する値として文字列 '1' を使用したり (代わりに、数値 1 を使用する必要があります)、文字列型を使用するカラムに一致する値として数値 1 を使用したりすることはできません (このような場合は、引用符で囲まれた文字列 '1' を使用する必要があります)。

詳細は、セクション24.2.1「RANGE パーティショニング」およびセクション24.4「パーティションプルーニング」を参照してください。

LIST(expr)

これは、州や国コードなど、使用可能な値の制限されたセットを持つテーブルのカラムに基づいてパーティションを割り当てる場合に役立ちます。 このような場合は、特定の州または国に関連するすべての行を単一パーティションに割り当てたり、特定の州または国のセットのためにパーティションを予約したりできます。 これは RANGE に似ていますが、各パーティションに許可される値を指定するために VALUES IN しか使用できない点が異なります。

VALUES IN は、一致させる値のリストとともに使用されます。 たとえば、次のようなパーティション化スキームを作成できます。

CREATE TABLE client_firms (
    id   INT,
    name VARCHAR(35)
)
PARTITION BY LIST (id) (
    PARTITION r0 VALUES IN (1, 5, 9, 13, 17, 21),
    PARTITION r1 VALUES IN (2, 6, 10, 14, 18, 22),
    PARTITION r2 VALUES IN (3, 7, 11, 15, 19, 23),
    PARTITION r3 VALUES IN (4, 8, 12, 16, 20, 24)
);

リストのパーティション化を使用する場合は、VALUES IN を使用して、少なくとも 1 つのパーティションを定義する必要があります。 PARTITION BY LIST では VALUES LESS THAN を使用できません。

LIST COLUMNS(column_list)

LIST のこのバリアントにより、複数のカラムで比較条件を使用する (つまり、WHERE a = 5 AND b = 5 や WHERE a = 1 AND b = 10 AND c = 5 などの条件を持つ) クエリーのパーティションプルーニングが容易になります。 これにより、COLUMNS 句内のカラムのリストと、各 PARTITION ... VALUES IN (value_list) パーティション定義句内のカラム値のセットを使用して、複数のカラム内の値を指定できるようになります。

LIST COLUMNS(column_list) で使用されるカラムリストと VALUES IN(value_list) で使用される値リストに関連したデータ型を管理するルールは、VALUES IN 句では MAXVALUE が許可されず、NULL を使用できる点を除き、それぞれ RANGE COLUMNS(column_list) で使用されるカラムリストと VALUES LESS THAN(value_list) で使用される値リストの場合のルールと同じです。

PARTITION BY LIST COLUMNS で VALUES IN に使用される値のリストには、PARTITION BY LIST で使用された場合と比較して重要な違いが 1 つあります。 PARTITION BY LIST COLUMNS で使用された場合、VALUES IN 句内の各要素は、カラム値のセットである必要があります。各セット内の値の数は COLUMNS 句で使用されているカラム数と同じである必要があり、これらの値のデータ型はそれらのカラムのデータ型に一致している (しかも、同じ順序で現れる) 必要があります。 もっとも単純なケースでは、このセットは単一カラムで構成されます。 column_list および value_list を構成する各要素で使用できるカラムの最大数は 16 です。

次の CREATE TABLE ステートメントで定義されるテーブルは、LIST COLUMNS パーティション化を使用したテーブルの例を示しています。

CREATE TABLE lc (
    a INT NULL,
    b INT NULL
)
PARTITION BY LIST COLUMNS(a,b) (
    PARTITION p0 VALUES IN( (0,0), (NULL,NULL) ),
    PARTITION p1 VALUES IN( (0,1), (0,2), (0,3), (1,1), (1,2) ),
    PARTITION p2 VALUES IN( (1,0), (2,0), (2,1), (3,0), (3,1) ),
    PARTITION p3 VALUES IN( (1,3), (2,2), (2,3), (3,2), (3,3) )
);

PARTITIONS num

オプションで、PARTITIONS num 句を使用してパーティションの数を指定できます。ここで、num はパーティションの数です。 この句とほかのいずれかの PARTITION 句の両方が使用されている場合、num は、PARTITION 句を使用して宣言されているすべてのパーティションの総数と同じである必要があります。

SUBPARTITION BY

オプションで、パーティションを複数のサブパーティションに分割できます。 これは、オプションの SUBPARTITION BY 句を使用して示すことができます。 サブパーティション化は、HASH または KEY によって実行できます。 これらのどちらも LINEAR にすることができます。 これらは、同等のパーティショニングタイプについて前に説明したのと同じように機能します。 (LIST または RANGE によってサブパーティション化することはできません。)

サブパーティションの数は、SUBPARTITIONS キーワードと、そのあとの整数値を使用して示すことができます。

PARTITIONS または SUBPARTITIONS 句で使用されている値の厳密なチェックが適用され、この値は次のルールに従っている必要があります。

partition_definition

各パーティションは、partition_definition 句を使用して個別に定義できます。 この句を構成する個別の部分は次のとおりです。

subpartition_definition

オプションで、パーティション定義に 1 つ以上の subpartition_definition 句を含めることができます。 これらの各句は、少なくとも SUBPARTITION name で構成されます。ここで、name はそのサブパーティションの識別子です。 PARTITION キーワードが SUBPARTITION に置き換えられる点を除き、サブパーティション定義の構文はパーティション定義の構文と同じです。

サブパーティション化は HASH または KEY によって実行する必要があり、RANGE または LIST パーティションに対してのみ実行できます。 セクション24.2.6「サブパーティショニング」を参照してください。