バージョン: 4.x

MySQL互換性

DorisはMySQLの構文と高い互換性を持ち、標準SQLをサポートしています。ただし、DorisとMySQLの間にはいくつかの違いがあり、以下に概要を示します。

データ型

数値型

型	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

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:ss[.fraction]	- サポート - DATETIME([P])、Pは精度を定義するオプションパラメータ - 範囲: ['0000-01-01 00:00:00[.000000]', '9999-12-31 23:59:59[.999999]'] - フォーマット: YYYY-MM-DD hh:mm:ss[.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:ss[.fraction]	- サポート外
Time	- サポート - Time[(p)] - 範囲: ['-838:59:59.000000'から'838:59:59.000000'] - フォーマット: hh:mm:ss[.fraction]	- サポート外
Year	- サポート - 範囲: 1901から2155、または0000 - フォーマット: yyyy	- サポート外

文字列型

型	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	- サポート外	- サポート - 1,048,576バイト（1MB）、2,147,483,643バイト（2GB）まで増加可能
Binary	- サポート - Charと同様	- サポート外
Varbinary	- サポート - Varcharと同様	- サポート外
Blob	- サポート - TinyBlob、Blob、MediumBlob、LongBlob	- サポート外
Text	- サポート - TinyText、Text、MediumText、LongText	- サポート外
Enum	- サポート - 最大65,535要素をサポート	- サポート外
Set	- サポート - 最大64要素をサポート	- サポート外

JSON型

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

Doris固有のデータ型

Dorisにはいくつかの固有のデータ型があります。詳細は以下のとおりです：

HyperLogLog

HLL（HyperLogLog）は、キー列として使用できないデータ型です。集約モデルテーブルでは、HLLに対応する集約タイプはHLL_UNIONです。長さとデフォルト値を指定する必要はありません。長さは、データ集約レベルに基づいて内部で制御されます。HLL列は、HLL_UNION_AGG、HLL_RAW_AGG、HLL_CARDINALITY、HLL_HASHなどの関連する関数でのみクエリまたは使用できます。

HLLは近似ファジー重複排除に使用され、大量のデータを扱う際にはcount distinctよりも優れたパフォーマンスを発揮します。HLLの典型的なエラー率は約1%で、時に2%に達することがあります。
Bitmap

Bitmapは、キー列として使用できないデータ型です。集約モデルテーブルでは、BITMAPに対応する集約タイプはBITMAP_UNIONです。HLLと同様に、長さとデフォルト値を指定する必要はなく、長さはデータ集約レベルに基づいて内部で制御されます。Bitmap列は、BITMAP_UNION_COUNT、BITMAP_UNION、BITMAP_HASH、BITMAP_HASH64などの関数でのみクエリまたは使用できます。

従来のシナリオでBITMAPを使用すると読み込み速度に影響を与える可能性がありますが、大量のデータを扱う際は一般的にCount Distinctよりも優れたパフォーマンスを発揮します。リアルタイムシナリオでは、グローバル辞書なしでbitmap_hash()関数と一緒にBITMAPを使用すると、約0.1%のエラーが生じる可能性があることにご注意ください。このエラーが許容できない場合は、代わりにbitmap_hash64を使用できます。
QUANTILE_PERCENT

QUANTILE_STATEは、キー列として使用できないデータ型です。集約モデルテーブルでは、QUANTILE_STATEに対応する集約タイプはQUANTILE_UNIONです。長さとデフォルト値を指定する必要はなく、長さはデータ集約レベルに基づいて内部で制御されます。QUANTILE_STATE列は、QUANTILE_PERCENT、QUANTILE_UNION、TO_QUANTILE_STATEなどの関数でのみクエリまたは使用できます。

QUANTILE_STATEは近似分位値の計算に使用されます。インポート中、同じキーで異なる値の事前集約を実行します。値の数が2048を超えない場合、すべてのデータを詳細に保存します。値の数が2048を超える場合、TDigestアルゴリズムを使用してデータを集約（クラスタ化）し、クラスタの重心を保存します。
Array<T>

ArrayはDorisのデータ型で、型Tの要素で構成される配列を表します。キー列として使用することはできません。
MAP<K, V>

MAPはDorisのデータ型で、型KとVの要素で構成されるマップを表します。
STRUCT<field_name:field_type,...>

構造体（STRUCT）は複数のフィールドで構成されます。複数の列の集合として識別することもできます。
- field_name：フィールドの識別子。一意である必要があります。
- field_type：フィールドの型。
Agg_State

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

長さとデフォルト値を指定する必要はなく、実際のストレージサイズは関数の実装に依存します。

AGG_STATEは、SQLマニュアルのアグリゲータのSTATE / MERGE/ UNION関数と組み合わせてのみ使用できます。

構文

DDL

01 DorisのCreate Table構文

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]

02 MySQLとの違い

パラメータ	MySQLとの違い
Column_definition_list	- フィールドリスト定義：基本構文はMySQLと似ていますが、集約型の追加操作が含まれています。 - 集約型操作は主にAggregateをサポートします。 - テーブル作成時、MySQLではフィールドリスト定義の後にIndex（例：Primary Key、Unique Key）などの制約を追加できますが、Dorisではデータモデルを定義することでこれらの制約と計算をサポートします。
Index_definition_list	- インデックスリスト定義：基本構文はMySQLと似ており、bitmapインデックス、inverted indexes、N-Gramインデックスをサポートしますが、Bloom filterインデックスはpropertiesを通して設定されます。 - 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などのアルゴリズムをサポートします。MySQLはサブパーティションもサポートしており、サブパーティションではHashとKeyのみがサポートされています。
Distribution_desc	- バケッティングアルゴリズム：必須。含まれるもの：1) Hashバケッティング構文：DISTRIBUTED BY HASH (k1[,k2 ...]) [BUCKETS num\|auto]。説明：指定されたキーカラムを使用してハッシュバケッティングを行います。2) ランダムバケッティング構文：DISTRIBUTED BY RANDOM [BUCKETS num\|auto]。説明：乱数を使用してバケッティングを行います。 - MySQLにはバケッティングアルゴリズムはありません。
Rollup_list	- テーブル作成時に複数の同期マテリアライズドビューを作成できます。 - 構文：`rollup_name (col1[, col2, ...]) [DUPLICATE KEY(col1[, col2, ...])][PROPERTIES("key" = "value")]` - MySQLはこれをサポートしていません。
Properties	テーブルプロパティ：MySQLのテーブルプロパティとは異なり、テーブルプロパティを定義する構文もMySQLとは異なります。

03 CREATE INDEX

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

Dorisは現在、Bitmapインデックス、転置インデックス、およびN-Gramインデックスをサポートしています。BloomFilterインデックスもサポートされていますが、それらを設定するための別の構文があります。
MySQLはB+TreeやHashなどのインデックスアルゴリズムをサポートしています。

04 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は論理ビューをサポートし、同期マテリアライズドビューと非同期マテリアライズドビューの2種類のマテリアライズドビューをサポートします
MySQLは非同期マテリアライズドビューをサポートしていません。

05 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 } ...];

構文はフィルタ述語のみを指定できます

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

この構文は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 Function

Doris FunctionはMySQLの関数のほとんどをカバーしています。

SQL Mode

Name	有効時の動作	無効時の動作	Notes
PIPES_AS_CONCAT	`\|\|`を`concat`関数として解析する	`\|\|`を論理OR演算子として解析する	-
NO_BACKSLASH_ESCAPES	文字列内のバックスラッシュをリテラル文字として扱う	文字列内のバックスラッシュをエスケープ文字として扱う	-
ONLY_FULL_GROUP_BY	標準的な集約のみを許可する	GROUP BYキーに含まれないスカラー値が集約結果に現れることを許可する	バージョン3.1.0以降でサポート

データ型​

数値型​

日付型​

文字列型​

JSON型​

Doris固有のデータ型​

構文​

DDL​

01 DorisのCreate Table構文​

02 MySQLとの違い​

03 CREATE INDEX​

04 CREATE VIEW​

05 ALTER TABLE / ALTER INDEX​

DROP TABLE / DROP INDEX​

DML​

INSERT​

UPDATE​

Delete​

SELECT​

SQL Function​

SQL Mode​

データ型

数値型

日付型

文字列型

JSON型

Doris固有のデータ型

構文

DDL

01 DorisのCreate Table構文

02 MySQLとの違い

03 CREATE INDEX

04 CREATE VIEW

05 ALTER TABLE / ALTER INDEX

DROP TABLE / DROP INDEX

DML

INSERT

UPDATE

Delete

SELECT

SQL Function

SQL Mode