文字列型
TiDB はCHAR
、 VARCHAR
、 BINARY
、 VARBINARY
、 BLOB
、 TEXT
、 ENUM
、 SET
を含むすべての MySQL 文字列型をサポートしています。詳細については、 MySQL の文字列型参照してください。
サポートされているタイプ
CHAR
型
CHAR
は固定長文字列です。M は列の長さを文字数 (バイト数ではありません) で表します。M の範囲は 0 ~ 255 です。2 タイプとは異なり、 VARCHAR
列にデータを挿入すると、末尾のスペースはCHAR
られます。
[NATIONAL] CHAR[(M)] [CHARACTER SET charset_name] [COLLATE collation_name]
VARCHAR
型
VARCHAR
可変長の文字列です。M は文字数 (バイト数ではありません) での最大列長を表しますVARCHAR
の最大サイズは 65,535 バイトを超えることはできません。最大行長と使用されている文字セットによってVARCHAR
さが決まります。
1 つの文字が占めるスペースは、文字セットによって異なる場合があります。次の表は、1 つの文字が消費するバイト数と、各文字セットのVARCHAR
列の長さの範囲を示しています。
文字セット | 1文字あたりのバイト数 | VARCHAR カラムの最大長の範囲 |
---|---|---|
アスキー | 1 | (0, 65535] |
ラテン1 | 1 | (0, 65535] |
バイナリ | 1 | (0, 65535] |
utf8 | 3 | (0, 21845] |
utf8mb4 | 4 | (0, 16383] |
[NATIONAL] VARCHAR(M) [CHARACTER SET charset_name] [COLLATE collation_name]
TEXT
タイプ
TEXT
可変長の文字列です。列の最大長は 65,535 バイトです。オプションの M 引数は文字数で、 TEXT
列の最適な型を自動的に選択するために使用されます。たとえば、 TEXT(60)
最大 255 バイトを保持できるTINYTEXT
データ型を生成し、これは 1 文字あたり最大 4 バイト (4×60=240) の 60 文字の UTF-8 文字列に適合します。M 引数の使用は推奨されません。
TEXT[(M)] [CHARACTER SET charset_name] [COLLATE collation_name]
TINYTEXT
タイプ
TINYTEXT
タイプはTEXT
タイプと似ていますが、違いはTINYTEXT
の最大列長が 255 であることです。
TINYTEXT [CHARACTER SET charset_name] [COLLATE collation_name]
MEDIUMTEXT
タイプ
MEDIUMTEXT
タイプはTEXT
タイプと似ています。違いは、 MEDIUMTEXT
の最大列長が 16,777,215 であることです。ただし、 txn-entry-size-limit
の制限により、TiDB の単一行の最大storageサイズはデフォルトで 6 MiB であり、構成を変更することで 120 MiB まで増やすことができます。
MEDIUMTEXT [CHARACTER SET charset_name] [COLLATE collation_name]
LONGTEXT
型
LONGTEXT
型はTEXT
タイプ型と似ています。違いは、 LONGTEXT
の最大列長が 4,294,967,295 であることです。ただし、 txn-entry-size-limit
の制限により、TiDB の単一行の最大storageサイズはデフォルトで 6 MiB であり、構成を変更することで 120 MiB まで増やすことができます。
LONGTEXT [CHARACTER SET charset_name] [COLLATE collation_name]
BINARY
型
BINARY
型はCHAR
型と似ています。違いは、 BINARY
バイナリ バイト文字列を格納することです。
BINARY(M)
VARBINARY
型
VARBINARY
型はVARCHAR
型と似ています。違いは、 VARBINARY
バイナリ バイト文字列を格納することです。
VARBINARY(M)
BLOB
型
BLOB
大きなバイナリ ファイルです。M は、0 から 65,535 までの最大列長をバイト単位で表します。
BLOB[(M)]
TINYBLOB
型
TINYBLOB
タイプはBLOB
型と似ていますが、違いはTINYBLOB
の最大列長が 255 であることです。
TINYBLOB
MEDIUMBLOB
型
MEDIUMBLOB
タイプはBLOB
型と似ています。違いは、 MEDIUMBLOB
の最大列長が 16,777,215 であることです。ただし、 txn-entry-size-limit
の制限により、TiDB の単一行の最大storageサイズはデフォルトで 6 MiB であり、構成を変更することで 120 MiB まで増やすことができます。
MEDIUMBLOB
LONGBLOB
型
LONGBLOB
型はBLOB
型と似ています。違いは、 LONGBLOB
の最大列長が 4,294,967,295 であることです。ただし、 txn-entry-size-limit
の制限により、TiDB の単一行の最大storageサイズはデフォルトで 6 MiB であり、構成を変更することで 120 MiB まで増やすことができます。
LONGBLOB
ENUM
型
ENUM
は、テーブルの作成時に列仕様で明示的に列挙される許可された値のリストから選択された値を持つ文字列オブジェクトです。構文は次のとおりです。
ENUM('value1','value2',...) [CHARACTER SET charset_name] [COLLATE collation_name]
# For example:
ENUM('apple', 'orange', 'pear')
ENUM
データ型の値は数値として保存されます。各値は定義順序に従って数値に変換されます。前の例では、各文字列が数値にマッピングされています。
価値 | 番号 |
---|---|
NULL | NULL |
'' | 0 |
'りんご' | 1 |
'オレンジ' | 2 |
'梨' | 3 |
詳細についてはMySQLのENUM型参照してください。
SET
型
SET
0 個以上の値を持つことができる文字列オブジェクトであり、各値はテーブルの作成時に指定された許可された値のリストから選択する必要があります。構文は次のとおりです。
SET('value1','value2',...) [CHARACTER SET charset_name] [COLLATE collation_name]
# For example:
SET('1', '2') NOT NULL
この例では、次のいずれかの値が有効になります。
''
'1'
'2'
'1,2'
TiDB では、 SET
型の値は内部的にInt64
に変換されます。各要素の存在は、0 または 1 のバイナリを使用して表されます。 SET('a','b','c','d')
として指定された列の場合、メンバーは次の 10 進値と 2 進値を持ちます。
メンバー | 小数値 | バイナリ値 |
---|---|---|
'あ' | 1 | 0001 |
'ブ' | 2 | 0010 |
'ハ' | 4 | 0100 |
'd' | 8 | 1000 |
この場合、 ('a', 'c')
の要素は 2 進数では0101
なります。
詳細についてはMySQLのSET型参照してください。