JSONデータ型

TiDBは、半構造化データの保存に便利なJSON （JavaScript Object Notation）データ型をサポートしていますJSONデータ型は、文字列列にJSON形式の文字列を保存する場合と比べて、以下の利点があります。

• シリアル化にはバイナリ形式を使用します。内部形式により、 JSONドキュメント要素への高速な読み取りアクセスが可能になります。
• JSON列に保存されたJSONドキュメントを自動検証します。有効なドキュメントのみを保存できます。

JSON列は、他のバイナリ タイプの列と同様に直接インデックス付けされませんが、生成された列の形式でJSONドキュメント内のフィールドをインデックス付けできます。

CREATE TABLE city (
    id INT PRIMARY KEY,
    detail JSON,
    population INT AS (JSON_EXTRACT(detail, '$.population')),
    index index_name (population)
    );
INSERT INTO city (id,detail) VALUES (1, '{"name": "Beijing", "population": 100}');
SELECT id FROM city WHERE population >= 100;

詳細については、 JSON関数および生成された列参照してください。

JSON値の型

JSONドキュメント内の値には型があります。これはJSON_TYPE ()の出力で確認できます。

制限

• 現在、TiDBはTiFlashへのプッシュダウンを限定的にJSON関数のみサポートしています。詳細についてはプッシュダウン式ご覧ください。
• TiDBバックアップ＆リストア（BR）は、v6.3.0でJSON列データのエンコード方法を変更します。そのため、JSON列を含むデータをBRを使用してv6.3.0より前のTiDBクラスターにリストアすることは推奨されません。
• DATE 、 DATETIME 、 TIMEなどの非標準JSONデータ型を含むデータをレプリケートする場合は、レプリケーション ツールを使用しないでください。

MySQLの互換性

• BINARY型のデータを含む JSON 列を作成すると、MySQL は現在そのデータをSTRING型として誤ってラベル付けしますが、TiDB はそれをBINARY型として正しく処理します。

  CREATE TABLE test(a json);
  INSERT INTO test SELECT json_objectagg('a', b'01010101');
  
  -- In TiDB, executing the following SQL statement returns `0, 0`. In MySQL, executing the following SQL statement returns `0, 1`.
  mysql> SELECT JSON_EXTRACT(JSON_OBJECT('a', b'01010101'), '$.a') = "base64:type15:VQ==" AS r1, JSON_EXTRACT(a, '$.a') = "base64:type15:VQ==" AS r2 FROM test;
  +------+------+
  | r1   | r2   |
  +------+------+
  |    0 |    0 |
  +------+------+
  1 row in set (0.01 sec)
  

  詳細については、第＃37443を参照してください。

• データ型をENUMまたはSETからJSONに変換する際、TiDB はデータ形式の正確性をチェックします。例えば、TiDB で以下の SQL 文を実行するとエラーが返されます。

  CREATE TABLE t(e ENUM('a'));
  INSERT INTO t VALUES ('a');
  mysql> SELECT CAST(e AS JSON) FROM t;
  ERROR 3140 (22032): Invalid JSON text: The document root must not be followed by other values.
  

  詳細については、第＃9999を参照してください。

• TiDB では、 ORDER BY使用して JSON 配列または JSON オブジェクトをソートできます。

  MySQL では、 ORDER BY使用して JSON 配列または JSON オブジェクトをソートすると、MySQL から警告が返され、ソート結果が比較演算の結果と一致しなくなります。

  CREATE TABLE t(j JSON);
  INSERT INTO t VALUES ('[1,2,3,4]');
  INSERT INTO t VALUES ('[5]');
  
  mysql> SELECT j FROM t WHERE j < JSON_ARRAY(5);
  +--------------+
  | j            |
  +--------------+
  | [1, 2, 3, 4] |
  +--------------+
  1 row in set (0.00 sec)
  
  -- In TiDB, executing the following SQL statement returns the correct sorting result. In MySQL, executing the following SQL statement returns the "This version of MySQL doesn't yet support 'sorting of non-scalar JSON values'." warning and the sorting result is inconsistent with the comparison result of `<`.
  mysql> SELECT j FROM t ORDER BY j;
  +--------------+
  | j            |
  +--------------+
  | [1, 2, 3, 4] |
  | [5]          |
  +--------------+
  2 rows in set (0.00 sec)
  

  詳細については、第＃37506を参照してください。

• JSON 列にデータを挿入すると、TiDB は暗黙的にデータの値をJSON型に変換します。

  CREATE TABLE t(col JSON);
  
  -- In TiDB, the following INSERT statement is executed successfully. In MySQL, executing the following INSERT statement returns the "Invalid JSON text" error.
  INSERT INTO t VALUES (3);
  

JSONデータ型の詳細については、 JSON関数および生成された列参照してください。