2026年9月1日に最終更新

MySQL との互換性に関する注意事項

Doris は MySQL プロトコルおよび標準 SQL 構文と高い互換性があります。業務システム、BI ツール、運用スクリプトは、通常、大きな変更を加えずに接続できます。ただし、分析向けの MPP データベースである Doris は、データ型、テーブル作成構文、データモデル、DML の動作などで MySQL と異なります。

このドキュメントでは、移行時と日常的な利用時の二つの観点から Doris と MySQL の主な違いを整理し、構文や動作の非互換性をすばやく特定できるようにします。

対象読者と利用場面

MySQL アプリケーションやデータウェアハウスを Doris に移行する予定があり、SQL の互換性をすばやく評価したい場合。
MySQL に慣れた方法で Doris の SQL を記述し、構文や動作の違いに遭遇した場合。
特定のデータ型や DDL/DML ステートメントが Doris でサポートされるか確認したい場合。

データ型の違い

MySQL との違いを、数値型、日付型、文字列型、JSON 型、Doris 固有の型に分けて以下に示します。

数値型

型	MySQL	Doris
Boolean	- サポート - 範囲: 0 は false、1 は true	- サポート - キーワード: Boolean - 範囲: 0 は false、1 は true
Bit	- サポート - 範囲: 1 ～ 64	サポート対象外
Tinyint	- サポート - 符号付きと符号なしをサポート - 範囲: 符号付きは -128 ～ 127、符号なしは 0 ～ 255	- サポート - 符号付きのみサポート - 範囲: -128 ～ 127
Smallint	- サポート - 符号付きと符号なしをサポート - 範囲: 符号付きは -2^15 ～ 2^15-1、符号なしは 0 ～ 2^16-1	- サポート - 符号付きのみサポート - 範囲: -32768 ～ 32767
Mediumint	- サポート - 符号付きと符号なしをサポート - 範囲: 符号付きは -2^23 ～ 2^23-1、符号なしは 0 ～ 2^24-1	サポート対象外
Int	- サポート - 符号付きと符号なしをサポート - 範囲: 符号付きは -2^31 ～ 2^31-1、符号なしは 0 ～ 2^32-1	- サポート - 符号付きのみサポート - 範囲: -2147483648 ～ 2147483647
Bigint	- サポート - 符号付きと符号なしをサポート - 範囲: 符号付きは -2^63 ～ 2^63-1、符号なしは 0 ～ 2^64-1	- サポート - 符号付きのみサポート - 範囲: -2^63 ～ 2^63-1
Largeint	サポート対象外	- サポート - 符号付きのみサポート - 範囲: -2^127 ～ 2^127-1
Decimal	- サポート - 符号付きと符号なしをサポート（8.0.17 より前はサポート。それ以降のバージョンでは非推奨） - デフォルト: Decimal(10, 0)	- サポート - 符号付きのみサポート - デフォルト: Decimal(9, 0)
Float/Double	- サポート - 符号付きと符号なしをサポート（8.0.17 より前はサポート。それ以降のバージョンでは非推奨）	- サポート - 符号付きのみサポート

日付型

型	MySQL	Doris
Date	- サポート - 範囲: ['1000-01-01', '9999-12-31'] - 形式: YYYY-MM-DD	- サポート - 範囲: ['0000-01-01', '9999-12-31'] - 形式: YYYY-MM-DD
DateTime	- サポート - DATETIME([P])。省略可能なパラメータ P は精度 - 範囲: '1000-01-01 00:00:00.000000' ～ '9999-12-31 23:59:59.999999' - 形式: YYYY-MM-DD hh:mm .fraction	- サポート - DATETIME([P])。省略可能なパラメータ P は精度 - 範囲: ['0000-01-01 00:00:00[.000000]', '9999-12-31 23:59:59[.999999]'] - 形式: YYYY-MM-DD hh:mm .fraction
Timestamp	- サポート - Timestamp[(p)]。省略可能なパラメータ P は精度 - 範囲: ['1970-01-01 00:00:01.000000' UTC, '2038-01-19 03:14:07.999999' UTC] - 形式: YYYY-MM-DD hh:mm .fraction	- サポート - TIMESTAMPTZ([P])。省略可能なパラメータ P は精度 - 範囲: ['0000-01-01 00:00:00[.000000]' UTC, '9999-12-31 23:59:59[.999999]' UTC] - 形式: YYYY-MM-DD hh:mm .fraction +XX.XX
Time	- サポート - Time[(p)] - 範囲: ['-838:59:59.000000', '838:59:59.000000'] - 形式: hh:mm .fraction	- 計算ではサポート。OLAP テーブルの列としては保存不可 - Time[(p)] - 範囲: ['-838:59:59.999999', '838:59:59.999999'] - 形式: hh:mm .fraction
Year	- サポート - 範囲: 1901 ～ 2155、または 0000 - 形式: yyyy	サポート対象外

TIMESTAMP_NS は MySQL の TIMESTAMP に相当する型ではなく、Doris の拡張です。タイムゾーン情報を持たず、精度はナノ秒で固定され、1677-09-21 00:12:43.145224192 から 2262-04-11 23:47:16.854775807 までの範囲をサポートします。

文字列型

型	MySQL	Doris
Char	- サポート - CHAR(M)。M は文字数で、デフォルトは 1 - 固定長 - 範囲: [0, 255] バイト	- サポート - CHAR(M)。M はバイト長 - 可変長 - 範囲: [1, 255]
Varchar	- サポート - VARCHAR(M)。M は文字数 - 範囲: [0, 65535] バイト	- サポート - VARCHAR(M)。M はバイト長 - 範囲: [1, 65533]
String	サポート対象外	- サポート - 1048576 バイト（1 MB）。最大 2147483643 バイト（2 GB）まで増やせます
Binary	- サポート - Char に類似	サポート対象外
Varbinary	- サポート - Varchar に類似	サポート対象外
Blob	- サポート - TinyBlob、Blob、MediumBlob、LongBlob	サポート対象外
Text	- サポート - TinyText、Text、MediumText、LongText	サポート対象外
Enum	- サポート - 最大 65535 要素	サポート対象外
Set	- サポート - 最大 64 要素	サポート対象外

JSON データ型

型	MySQL	Doris
JSON	サポート	サポート

Doris 固有のデータ型

以下の型は、Doris が MySQL に対して拡張した、分析向けのデータ型です。主に重複を除いた件数の計算、分位数の計算、半構造化データの処理に使います。

HyperLogLog

HLL 型は Key 列として使用できません。Aggregate モデルのテーブルで使用する場合、テーブル作成時に対応する集約型として HLL_UNION を指定します。長さやデフォルト値を指定する必要はありません。長さはデータの集約レベルに応じてシステムが内部で制御します。HLL 列のクエリや利用には、対応する HLL_UNION_AGG、HLL_RAW_AGG、HLL_CARDINALITY、HLL_HASH 関数のみを使用できます。

HLL は概算の重複排除件数を計算する方式で、大量のデータでは Count Distinct より高い性能を発揮します。HLL の誤差率は通常約 1% で、場合によっては 2% に達することがあります。
BITMAP

BITMAP 型は Key 列として使用できません。Aggregate テーブルで使用する場合、BITMAP_UNION 集約定義と組み合わせる必要があります。長さやデフォルト値を指定する必要はありません。長さはデータの集約レベルに応じてシステムが内部で制御します。BITMAP 列のクエリや利用には、対応する BITMAP_UNION_COUNT、BITMAP_UNION、BITMAP_HASH、BITMAP_HASH64 などの関数のみを使用できます。

オフライン処理で BITMAP を使用すると、インポート速度に影響する場合があります。大量のデータでは、クエリ速度は HLL より遅いものの、Count Distinct より速くなります。注意: リアルタイム処理でグローバル辞書を使わずに BITMAP を使用し、代わりに BITMAP_HASH() を使う場合、約千分の一の誤差が発生する可能性があります。この誤差を許容できない場合は BITMAP_HASH64 を使用できます。
QUANTILE_PERCENT (QUANTILE_STATE)

QUANTILE_STATE 型は Key 列として使用できません。Aggregate モデルのテーブルで使用する場合、テーブル作成時に対応する集約型として QUANTILE_UNION を指定します。長さやデフォルト値を指定する必要はありません。長さはデータの集約レベルに応じてシステムが内部で制御します。QUANTILE_STATE 列のクエリや利用には、対応する QUANTILE_PERCENT、QUANTILE_UNION、TO_QUANTILE_STATE などの関数のみを使用できます。

QUANTILE_STATE は概算の分位数を計算する型です。インポート時には、同じ Key に属する異なる Value を事前集約します。Value の数が 2048 以下の場合はすべてのデータを詳細に記録し、2048 を超える場合は TDigest アルゴリズムでデータを集約（クラスタリング）し、各クラスタの重心を保存します。
Array<T>

Array<T> は T 型の要素からなる配列で、Key 列として使用できません。
MAP<K, V>

Map は K 型と V 型の要素の対応関係を表し、Key 列として使用できません。
STRUCT<field_name:field_type, ...>

Struct は複数の Field で構成される構造体で、複数の列の集合とも考えられます。Key として使用できません。

Struct の Field 名と数は固定され、各 Field は常に Nullable です。Field は通常、次の要素で構成されます。
- field_name: Field の識別子。一意である必要があります
- field_type: Field の型
Agg_State

AGG_STATE は Key 列として使用できません。テーブル作成時には、集約関数のシグネチャも宣言する必要があります。

長さやデフォルト値を指定する必要はありません。実際の保存サイズは関数の実装によって決まります。

AGG_STATE は、STATE / MERGE / UNION 関数コンビネータと組み合わせてのみ使用できます。

構文の違い

Doris の SQL 構文は全体として MySQL に近いものの、テーブル作成、インデックス、ビューなどでは独自の拡張や制限があります。移行時には特に注意してください。

DDL の違い

CREATE TABLE

Doris のテーブル作成構文は次のとおりです。

CREATE TABLE [IF NOT EXISTS] [database.]table
(
    column_definition_list
    [, index_definition_list]
)
[engine_type]
[keys_type]
[table_comment]
[partition_info]
distribution_desc
[rollup_list]
[properties]
[extra_properties]

各句と MySQL との違いは次のとおりです。

パラメータ	MySQL との違い
column_definition_list	- 列の一覧を定義します。基本構文は MySQL と似ています。 - Doris は、主に Aggregate Key データモデルで使用する集約型の操作もサポートします。 - MySQL では列の定義後に Index、Primary Key、Unique Key などの制約を追加できます。Doris では、これらの制約や計算をデータモデルによってサポートします。
index_definition_list	- インデックスの一覧を定義します。基本構文は MySQL と似ています。 - Doris はビットマップインデックス、転置インデックス、N-Gram インデックスをサポートし、プロパティで Bloom フィルターインデックスを有効にすることもできます。 - MySQL は B+Tree インデックスと Hash インデックスをサポートします。
engine_type	- テーブルエンジンの種類を指定します。省略可能です。 - 現在サポートされる主なテーブルエンジンは、ネイティブの OLAP エンジンです。 - MySQL は InnoDB や MyISAM などのストレージエンジンをサポートします。
keys_type	- データモデルを指定します。省略可能です。 - サポートされる種類: 1) DUPLICATE KEY（デフォルト）: 後続に指定した列がソート列になります。 2) AGGREGATE KEY: 後続に指定した列がディメンション列になります。 3) UNIQUE KEY: 後続に指定した列が主キー列になります。 - MySQL にはデータモデルという概念がありません。
table_comment	テーブルのコメント。
partition_info	パーティション分割方式。省略可能です。 Doris は次のパーティション分割方式をサポートします。 - LESS THAN: パーティションの上限のみを定義します。下限は前のパーティションの上限によって決まります。 - FIXED RANGE: 左閉右開の区間をパーティションとして定義します。 - MULTI RANGE: 時間単位とステップ幅を指定し、左閉右開の区間を持つ RANGE パーティションを一括作成します。サポートされる時間単位は年、月、日、週、時間です。 MySQL がサポートする方式は Hash、Range、List Key で、サブパーティションもサポートします。サブパーティションでは Hash と Key をサポートします。
distribution_desc	- バケット分割方式。必須です。次の方式があります。 1) Hash バケット分割: `DISTRIBUTED BY HASH (k1[, k2 ...]) [BUCKETS num\|auto]`。指定したキー列でハッシュ分割します。 2) Random バケット分割: `DISTRIBUTED BY RANDOM [BUCKETS num\|auto]`。乱数でバケット分割します。 - MySQL にはバケット分割方式がありません。
rollup_list	- テーブル作成時に、複数の同期マテリアライズドビューを同時に作成できます。 - 構文: `rollup_name (col1[, col2, ...]) [DUPLICATE KEY(col1[, col2, ...])][PROPERTIES("key" = "value")]`。 - MySQL ではサポートされません。
properties	テーブルのプロパティ。プロパティの内容と定義構文は MySQL と異なります。

CREATE INDEX

CREATE INDEX [IF NOT EXISTS] index_name ON table_name (column [, ...],) [USING BITMAP];

Doris は現在、ビットマップインデックス、転置インデックス、N-Gram インデックス、および Bloom フィルターインデックス（別の構文で設定）をサポートします。
MySQL は B+Tree と Hash のインデックスアルゴリズムをサポートします。

CREATE VIEW

CREATE VIEW [IF NOT EXISTS]
 [db_name.]view_name
 (column1[ COMMENT "col comment"][, column2, ...])
AS query_stmt

CREATE MATERIALIZED VIEW [IF NOT EXISTS] mvName=multipartIdentifier
        (LEFT_PAREN cols=simpleColumnDefs RIGHT_PAREN)? buildMode?
        (REFRESH refreshMethod? refreshTrigger?)?
        (KEY keys=identifierList)?
        (COMMENT STRING_LITERAL)?
        (PARTITION BY LEFT_PAREN partitionKey = identifier RIGHT_PAREN)?
        (DISTRIBUTED BY (HASH hashKeys=identifierList | RANDOM) (BUCKETS (INTEGER_VALUE | AUTO))?)?
        propertyClause?
        AS query

基本構文は MySQL と同じです。
Doris は論理ビューに加え、同期マテリアライズドビューと非同期マテリアライズドビューの二種類をサポートします。
MySQL はマテリアライズドビューをサポートしません。

ALTER TABLE / ALTER INDEX

Doris の ALTER 構文は、基本的に MySQL と同じです。

DROP TABLE / DROP INDEX

Doris の DROP 構文は、基本的に MySQL と同じです。

DML の違い

INSERT

INSERT INTO table_name
    [ PARTITION (p1, ...) ]
    [ WITH LABEL label]
    [ (column [, ...]) ]
    [ [ hint [, ...] ] ]
    { VALUES ( { expression | DEFAULT } [, ...] ) [, ...] | query }

Doris の INSERT 構文は、基本的に MySQL と同じです。

UPDATE

UPDATE target_table [table_alias]
    SET assignment_list
    WHERE condition

assignment_list:
    assignment [, assignment] ...

assignment:
    col_name = value

value:
    {expr | DEFAULT}

Doris の UPDATE 構文は、基本的に MySQL と同じですが、WHERE 条件が必須である点に注意してください。

DELETE

DELETE FROM table_name [table_alias]
    [PARTITION partition_name | PARTITIONS (partition_name [, partition_name])]
    WHERE column_name op { value | value_list } [ AND column_name op { value | value_list } ...];

Doris では、上記の構文ではフィルター条件のみを指定できます。

DELETE FROM table_name [table_alias]
    [PARTITION partition_name | PARTITIONS (partition_name [, partition_name])]
    [USING additional_tables]
    WHERE condition

Doris では、上記の構文は Unique Key モデルのテーブルでのみ使用できます。

Doris の DELETE 構文は、基本的に MySQL と同じです。ただし、Doris は分析向けのデータベースであるため、削除操作を頻繁に実行しないでください。

SELECT

SELECT
    [hint_statement, ...]
    [ALL | DISTINCT]
    select_expr [, select_expr ...]
    [EXCEPT ( col_name1 [, col_name2, col_name3, ...] )]
    [FROM table_references
      [PARTITION partition_list]
      [TABLET tabletid_list]
      [TABLESAMPLE sample_value [ROWS | PERCENT]
        [REPEATABLE pos_seek]]
    [WHERE where_condition]
    [GROUP BY [GROUPING SETS | ROLLUP | CUBE] {col_name | expr | position}]
    [HAVING where_condition]
    [ORDER BY {col_name | expr | position} [ASC | DESC], ...]
    [LIMIT {[offset_count,] row_count | row_count OFFSET offset_count}]
    [INTO OUTFILE 'file_name']

Doris の SELECT 構文は、基本的に MySQL と同じです。

SQL 関数

Doris の関数は、MySQL の関数の大部分をカバーしています。一般的な文字列関数、日付関数、集約関数、ウィンドウ関数は、そのまま使用できます。

SQL Mode

Doris では、一部の SQL Mode を設定して SQL の解析や実行の動作を制御し、MySQL の規則に合わせやすくできます。

名前	設定時の動作	未設定時の動作	備考
PIPES_AS_CONCAT	`\|\|` 記号を concat 関数として解釈します	`\|\|` 記号を論理 OR 演算子として解釈します	-
NO_BACKSLASH_ESCAPES	文字列内のバックスラッシュを通常の文字として扱います	文字列内のバックスラッシュをエスケープシーケンスの開始として扱います	-
ONLY_FULL_GROUP_BY	標準的な集約のみを許可します	集約結果の出力に、集約 KEY に含まれないスカラー値を含めることを許可します	バージョン 3.1.0 以降でサポート

対象読者と利用場面​

データ型の違い​

数値型​

日付型​

文字列型​

JSON データ型​

Doris 固有のデータ型​

構文の違い​

DDL の違い​

CREATE TABLE​

CREATE INDEX​

CREATE VIEW​

ALTER TABLE / ALTER INDEX​

DROP TABLE / DROP INDEX​

DML の違い​

INSERT​

UPDATE​

DELETE​

SELECT​

SQL 関数​

SQL Mode​