UUID

Universally Unique Identifier (UUID、汎用一意識別子) は、レコードを識別するために使用される 16 バイトの値です。UUID の詳細については、Wikipedia を参照してください。

UUIDv4 や UUIDv7 など、異なる UUID バリアントが存在しますが（こちらを参照）、ClickHouse は挿入された UUID が特定のバリアントに準拠しているかどうかを検証しません。 UUID は内部的には 16 バイトのランダムなバイト列として扱われ、SQL レベルでは 8-4-4-4-12 表記で表現されます。

UUID 値の例：

61f0c404-5cb3-11e7-907b-a6006ad3dba0

デフォルトの UUID はすべて 0 です。これは、たとえば新しいレコードを挿入する際に、UUID 列の値が指定されていない場合などに使用されます。

00000000-0000-0000-0000-000000000000

注意

歴史的経緯により、UUID は後半部分によってソートされます。

これは UUIDv4 の値については問題ありませんが、主キー索引の定義に UUIDv7 カラムを使用する場合にはパフォーマンスが低下する可能性があります（ソートキーやパーティションキーでの使用は問題ありません）。より具体的には、UUIDv7 の値は前半がタイムスタンプ、後半がカウンタで構成されます。したがって、スパースな主キー索引（すなわち、各インデックスグラニュールの先頭の値）における UUIDv7 のソートはカウンタフィールドに基づくものになります。 UUID が前半（タイムスタンプ）でソートされていると仮定した場合、クエリの先頭に行われる主キー索引の解析ステップでは、1 つのパーツを除くすべてのパーツで全マークを刈り込むことが期待されます。しかし、後半（カウンタ）によるソートでは、すべてのパーツから少なくとも 1 つのマークが返されることになり、不要なディスクアクセスにつながります。

例:

CREATE TABLE tab (uuid UUID) ENGINE = MergeTree PRIMARY KEY (uuid);

INSERT INTO tab SELECT generateUUIDv7() FROM numbers(50);
SELECT * FROM tab;

結果：

┌─uuid─────────────────────────────────┐
│ 36a0b67c-b74a-4640-803b-e44bb4547e3c │
│ 3a00aeb8-2605-4eec-8215-08c0ecb51112 │
│ 3fda7c49-282e-421a-85ab-c5684ef1d350 │
│ 16ab55a7-45f6-44a8-873c-7a0b44346b3e │
│ e3776711-6359-4f22-878d-bf290d052c85 │
│                [...]                 │
│ 9eceda2f-6946-40e3-b725-16f2709ca41a │
│ 03644f74-47ba-4020-b865-be5fd4c8c7ff │
│ ce3bc93d-ab19-4c74-b8cc-737cb9212099 │
│ b7ad6c91-23d6-4b5e-b8e4-a52297490b56 │
│ 06892f64-cc2d-45f3-bf86-f5c5af5768a9 │
└──────────────────────────────────────┘

回避策として、UUID を後半部分から抽出したタイムスタンプに変換できます。

CREATE TABLE tab (uuid UUID) ENGINE = MergeTree PRIMARY KEY (UUIDv7ToDateTime(uuid));
-- Or alternatively:                      [...] PRIMARY KEY (toStartOfHour(UUIDv7ToDateTime(uuid)));

INSERT INTO tab SELECT generateUUIDv7() FROM numbers(50);
SELECT * FROM tab;

ORDER BY (UUIDv7ToDateTime(uuid), uuid)

UUID の生成

ClickHouse は、ランダムな UUID バージョン 4 の値を生成するための関数 generateUUIDv4 を提供します。

使用例

例 1

この例では、UUID カラムを持つテーブルを作成し、そのテーブルに値を挿入する方法を示します。

CREATE TABLE t_uuid (x UUID, y String) ENGINE=TinyLog

INSERT INTO t_uuid SELECT generateUUIDv4(), 'Example 1'

SELECT * FROM t_uuid

結果：

┌────────────────────────────────────x─┬─y─────────┐
│ 417ddc5d-e556-4d27-95dd-a34d84e46a50 │ Example 1 │
└──────────────────────────────────────┴───────────┘

例 2

この例では、レコード挿入時に UUID 列の値を指定しないため、つまりデフォルトの UUID 値が挿入されます。

INSERT INTO t_uuid (y) VALUES ('Example 2')

SELECT * FROM t_uuid

┌────────────────────────────────────x─┬─y─────────┐
│ 417ddc5d-e556-4d27-95dd-a34d84e46a50 │ Example 1 │
│ 00000000-0000-0000-0000-000000000000 │ Example 2 │
└──────────────────────────────────────┴───────────┘

制限事項

UUID データ型は、String データ型がサポートする関数のみをサポートします（たとえば min、max、count など）。

UUID データ型は、abs などの算術演算や、sum、avg などの集約関数はサポートされません。

UUID の生成​

使用例​

制限事項​

UUID の生成

使用例

制限事項