UUIDsを操作するための関数

UUIDv7生成

生成されたUUIDは、Unixミリ秒で表された48ビットのタイムスタンプ、バージョン「7」（4ビット）、ミリ秒内のUUIDを区別するためのカウンター（42ビット、バリアントフィールド「2」、2ビットを含む）、およびランダムフィールド（32ビット）を含みます。特定のタイムスタンプ（unix_ts_ms）に対して、カウンターはランダムな値から開始され、タイムスタンプが変更されるまで新しいUUIDごとに1ずつインクリメントされます。カウンターがオーバーフローした場合、タイムスタンプフィールドは1つ増加し、カウンターはランダムな新しい開始値にリセットされます。 UUID生成関数は、同時に実行されるスレッドおよびクエリにおいて、タイムスタンプ内のカウンターフィールドがすべての関数呼び出しで単調増加することを保証します。

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤
|                           unix_ts_ms                          |
├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤
|          unix_ts_ms           |  ver  |   counter_high_bits   |
├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤
|var|                   counter_low_bits                        |
├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤
|                            rand_b                             |
└─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘

Snowflake ID生成

生成されたSnowflake IDは、現在のUnixタイムスタンプ（ミリ秒、41 + 1の上位ゼロビット）を含み、続いて機械ID（10ビット）、およびミリ秒内でのIDを区別するためのカウンター（12ビット）があります。特定のタイムスタンプ（unix_ts_ms）に対して、カウンターは0から開始され、タイムスタンプが変わるまで新しいSnowflake IDごとに1ずつインクリメントされます。カウンターがオーバーフローした場合、タイムスタンプフィールドは1つ増加し、カウンターは0にリセットされます。

注記

生成されたSnowflake IDはUNIXエポック1970年1月1日を基にしています。Snowflake IDのエポックに対する標準や推奨は存在しませんが、他のシステムの実装では異なるエポック（例えば、Twitter/X（2010年11月4日）やMastodon（2015年1月1日））を使用している場合があります。

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤
|0|                         timestamp                           |
├─┼                 ┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤
|                   |     machine_id    |    machine_seq_num    |
└─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘

generateUUIDv4

バージョン4 UUIDを生成します。

構文

generateUUIDv4([expr])

引数

expr — クエリ内で関数が複数回呼び出される場合に共通部分式排除をバイパスするために使用される任意の式。式の値は返されるUUIDには影響しません。オプション。

返される値

UUIDv4型の値。

例

まず、UUID型のカラムを持つテーブルを作成し、次に生成されたUUIDv4をテーブルに挿入します。

CREATE TABLE tab (uuid UUID) ENGINE = Memory;

INSERT INTO tab SELECT generateUUIDv4();

SELECT * FROM tab;

結果:

┌─────────────────────────────────uuid─┐
│ f4bf890f-f9dc-4332-ad5c-0c18e73f28e9 │
└──────────────────────────────────────┘

行ごとに複数のUUIDを生成する例

SELECT generateUUIDv4(1), generateUUIDv4(2);

┌─generateUUIDv4(1)────────────────────┬─generateUUIDv4(2)────────────────────┐
│ 2d49dc6e-ddce-4cd0-afb8-790956df54c1 │ 8abf8c13-7dea-4fdf-af3e-0e18767770e6 │
└──────────────────────────────────────┴──────────────────────────────────────┘

generateUUIDv7

バージョン7 UUIDを生成します。

UUIDの構造、カウンター管理、並行保証の詳細については、「"UUIDv7生成"」を参照してください。

注記

2024年4月現在、バージョン7 UUIDはドラフトステータスであり、そのレイアウトは今後変更される可能性があります。

構文

generateUUIDv7([expr])

引数

expr — クエリ内で関数が複数回呼び出される場合に共通部分式排除をバイパスするために使用される任意の式。式の値は返されるUUIDには影響しません。オプション。

返される値

UUIDv7型の値。

例

まず、UUID型のカラムを持つテーブルを作成し、次に生成されたUUIDv7をテーブルに挿入します。

CREATE TABLE tab (uuid UUID) ENGINE = Memory;

INSERT INTO tab SELECT generateUUIDv7();

SELECT * FROM tab;

結果:

┌─────────────────────────────────uuid─┐
│ 018f05af-f4a8-778f-beee-1bedbc95c93b │
└──────────────────────────────────────┘

行ごとに複数のUUIDを生成する例

SELECT generateUUIDv7(1), generateUUIDv7(2);

┌─generateUUIDv7(1)────────────────────┬─generateUUIDv7(2)────────────────────┐
│ 018f05c9-4ab8-7b86-b64e-c9f03fbd45d1 │ 018f05c9-4ab8-7b86-b64e-c9f12efb7e16 │
└──────────────────────────────────────┴──────────────────────────────────────┘

dateTimeToUUIDv7

指定された時間でのDateTime値をUUIDv7に変換します。

UUIDの構造、カウンター管理、並行保証の詳細については、「"UUIDv7生成"」を参照してください。

注記

2024年4月現在、バージョン7 UUIDはドラフトステータスであり、そのレイアウトは今後変更される可能性があります。

構文

dateTimeToUUIDv7(value)

引数

value — 時間付き日付。 DateTime。

返される値

UUIDv7型の値。

例

SELECT dateTimeToUUIDv7(toDateTime('2021-08-15 18:57:56', 'Asia/Shanghai'));

結果:

┌─dateTimeToUUIDv7(toDateTime('2021-08-15 18:57:56', 'Asia/Shanghai'))─┐
│ 018f05af-f4a8-778f-beee-1bedbc95c93b                                   │
└─────────────────────────────────────────────────────────────────────────┘

同じタイムスタンプの複数のUUIDの例

SELECT dateTimeToUUIDv7(toDateTime('2021-08-15 18:57:56'));
SELECT dateTimeToUUIDv7(toDateTime('2021-08-15 18:57:56'));

結果

   ┌─dateTimeToUUIDv7(t⋯08-15 18:57:56'))─┐
1. │ 017b4b2d-7720-76ed-ae44-bbcc23a8c550 │
   └──────────────────────────────────────┘

   ┌─dateTimeToUUIDv7(t⋯08-15 18:57:56'))─┐
1. │ 017b4b2d-7720-76ed-ae44-bbcf71ed0fd3 │
   └──────────────────────────────────────┘

この関数は、同じタイムスタンプでの複数の呼び出しが一意で単調増加するUUIDを生成することを保証します。

empty

入力UUIDが空であるかどうかをチェックします。

構文

empty(UUID)

UUIDはすべてゼロ（ゼロUUID）を含む場合、空と見なされます。

この関数は、ArraysやStringsにも適用されます。

引数

x — UUID。 UUID。

返される値

空のUUIDの場合は1、非空のUUIDの場合は0を返します。 UInt8。

例

UUID値を生成するために、ClickHouseはgenerateUUIDv4関数を提供します。

クエリ:

SELECT empty(generateUUIDv4());

結果:

┌─empty(generateUUIDv4())─┐
│                       0 │
└─────────────────────────┘

notEmpty

入力UUIDが非空であるかどうかをチェックします。

構文

notEmpty(UUID)

UUIDはすべてゼロ（ゼロUUID）を含む場合、空と見なされます。

この関数は、ArraysやStringsにも適用されます。

引数

x — UUID。 UUID。

返される値

非空のUUIDの場合は1、空のUUIDの場合は0を返します。 UInt8。

例

UUID値を生成するために、ClickHouseはgenerateUUIDv4関数を提供します。

クエリ:

SELECT notEmpty(generateUUIDv4());

結果:

┌─notEmpty(generateUUIDv4())─┐
│                          1 │
└────────────────────────────┘

toUUID

String型の値をUUIDに変換します。

toUUID(string)

返される値

UUID型値。

使用例

SELECT toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0') AS uuid

結果:

┌─────────────────────────────────uuid─┐
│ 61f0c404-5cb3-11e7-907b-a6006ad3dba0 │
└──────────────────────────────────────┘

toUUIDOrDefault

引数

string — 36文字のStringまたはFixedString(36)。 String。
default — 最初の引数がUUID型に変換できない場合に使用されるデフォルトのUUID。 UUID。

返される値

UUID

toUUIDOrDefault(string, default)

返される値

UUID型値。

使用例

最初の例は、変換可能なUUID型に変換された最初の引数を返します:

SELECT toUUIDOrDefault('61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' AS UUID));

結果:

┌─toUUIDOrDefault('61f0c404-5cb3-11e7-907b-a6006ad3dba0', CAST('59f0c404-5cb3-11e7-907b-a6006ad3dba0', 'UUID'))─┐
│ 61f0c404-5cb3-11e7-907b-a6006ad3dba0                                                                          │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

2番目の例は、最初の引数がUUID型に変換できないため、2番目の引数（提供されたデフォルトUUID）を返します:

SELECT toUUIDOrDefault('-----61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' AS UUID));

結果:

┌─toUUIDOrDefault('-----61f0c404-5cb3-11e7-907b-a6006ad3dba0', CAST('59f0c404-5cb3-11e7-907b-a6006ad3dba0', 'UUID'))─┐
│ 59f0c404-5cb3-11e7-907b-a6006ad3dba0                                                                               │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

toUUIDOrNull

String型の引数を取り、UUIDにパースしようとします。失敗した場合はNULLを返します。

toUUIDOrNull(string)

返される値

Nullable(UUID)型値。

使用例

SELECT toUUIDOrNull('61f0c404-5cb3-11e7-907b-a6006ad3dba0T') AS uuid

結果:

┌─uuid─┐
│ ᴺᵁᴸᴸ │
└──────┘

toUUIDOrZero

String型の引数を取り、UUIDにパースしようとします。失敗した場合はゼロUUIDを返します。

toUUIDOrZero(string)

返される値

UUID型値。

使用例

SELECT toUUIDOrZero('61f0c404-5cb3-11e7-907b-a6006ad3dba0T') AS uuid

結果:

┌─────────────────────────────────uuid─┐
│ 00000000-0000-0000-0000-000000000000 │
└──────────────────────────────────────┘

UUIDStringToNum

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx形式で36文字を含むstringを受け取り、そのバイナリ表現としてFixedString(16)を返します。形式はvariantによってオプションで指定できます（デフォルトはBig-endian）。

構文

UUIDStringToNum(string[, variant = 1])

引数

string — 36文字のStringまたはFixedString
variant — RFC4122で指定された型を表す整数。1 = Big-endian（デフォルト）、2 = Microsoft。

返される値

FixedString(16)

使用例

SELECT
    '612f3c40-5d3b-217e-707b-6a546a3d7b29' AS uuid,
    UUIDStringToNum(uuid) AS bytes

結果:

┌─uuid─────────────────────────────────┬─bytes────────────┐
│ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │ a/<@];!~p{jTj={) │
└──────────────────────────────────────┴──────────────────┘

SELECT
    '612f3c40-5d3b-217e-707b-6a546a3d7b29' AS uuid,
    UUIDStringToNum(uuid, 2) AS bytes

結果:

┌─uuid─────────────────────────────────┬─bytes────────────┐
│ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │ @</a;]~!p{jTj={) │
└──────────────────────────────────────┴──────────────────┘

UUIDNumToString

UUIDのバイナリ表現を含むbinaryを受け取り、形式はvariant（デフォルトはBig-endian）でオプションとして指定でき、テキスト形式で36文字を含む文字列を返します。

構文

UUIDNumToString(binary[, variant = 1])

引数

binary — UUIDのバイナリ表現としてのFixedString(16)。
variant — RFC4122で指定された型を表す整数。1 = Big-endian（デフォルト）、2 = Microsoft。

返される値

String。

使用例

SELECT
    'a/<@];!~p{jTj={)' AS bytes,
    UUIDNumToString(toFixedString(bytes, 16)) AS uuid

結果:

┌─bytes────────────┬─uuid─────────────────────────────────┐
│ a/<@];!~p{jTj={) │ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │
└──────────────────┴──────────────────────────────────────┘

SELECT
    '@</a;]~!p{jTj={)' AS bytes,
    UUIDNumToString(toFixedString(bytes, 16), 2) AS uuid

結果:

┌─bytes────────────┬─uuid─────────────────────────────────┐
│ @</a;]~!p{jTj={) │ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │
└──────────────────┴──────────────────────────────────────┘

UUIDToNum

UUIDを受け取り、そのバイナリ表現をFixedString(16)として返します。形式はvariant（デフォルトはBig-endian）でオプションとして指定できます。この関数は、UUIDから文字列への中間変換を必要とせず、UUIDStringToNum(toString(uuid))という2つの別の関数への呼び出しを置き換えます。

構文

UUIDToNum(uuid[, variant = 1])

引数

uuid — UUID。
variant — RFC4122で指定された型を表す整数。1 = Big-endian（デフォルト）、2 = Microsoft。

返される値

UUIDのバイナリ表現。

使用例

SELECT
    toUUID('612f3c40-5d3b-217e-707b-6a546a3d7b29') AS uuid,
    UUIDToNum(uuid) AS bytes

結果:

┌─uuid─────────────────────────────────┬─bytes────────────┐
│ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │ a/<@];!~p{jTj={) │
└──────────────────────────────────────┴──────────────────┘

SELECT
    toUUID('612f3c40-5d3b-217e-707b-6a546a3d7b29') AS uuid,
    UUIDToNum(uuid, 2) AS bytes

結果:

┌─uuid─────────────────────────────────┬─bytes────────────┐
│ 612f3c40-5d3b-217e-707b-6a546a3d7b29 │ @</a;]~!p{jTj={) │
└──────────────────────────────────────┴──────────────────┘

UUIDv7ToDateTime

バージョン7のUUIDのタイムスタンプコンポーネントを返します。

構文

UUIDv7ToDateTime(uuid[, timezone])

引数

uuid — バージョン7のUUID。
timezone — 返される値のためのタイムゾーン名（オプション）。 String。

返される値

ミリ秒精度のタイムスタンプ。UUIDが有効なバージョン7 UUIDでない場合、1970-01-01 00:00:00.000を返します。 DateTime64(3)。

使用例

SELECT UUIDv7ToDateTime(toUUID('018f05c9-4ab8-7b86-b64e-c9f03fbd45d1'))

結果:

┌─UUIDv7ToDateTime(toUUID('018f05c9-4ab8-7b86-b64e-c9f03fbd45d1'))─┐
│                                          2024-04-22 15:30:29.048 │
└──────────────────────────────────────────────────────────────────┘

SELECT UUIDv7ToDateTime(toUUID('018f05c9-4ab8-7b86-b64e-c9f03fbd45d1'), 'America/New_York')

結果:

┌─UUIDv7ToDateTime(toUUID('018f05c9-4ab8-7b86-b64e-c9f03fbd45d1'), 'America/New_York')─┐
│                                                              2024-04-22 08:30:29.048 │
└──────────────────────────────────────────────────────────────────────────────────────┘

serverUUID

ClickHouseサーバーの最初の起動時に生成されたランダムUUIDを返します。UUIDはClickHouseサーバーディレクトリ（例：/var/lib/clickhouse/）内のファイルuuidに保存され、サーバーの再起動間で保持されます。

構文

serverUUID()

返される値

サーバーのUUID。 UUID。

generateSnowflakeID

Snowflake IDを生成します。この関数は、同時に実行されるスレッドおよびクエリにおいて、タイムスタンプ内のカウンターフィールドがすべての関数呼び出しで単調増加することを保証します。

実装の詳細については、「"Snowflake ID生成"」を参照してください。

構文

generateSnowflakeID([expr, [machine_id]])

引数

expr — クエリ内で関数が複数回呼び出される場合に共通部分式排除をバイパスするために使用される任意の式。式の値は返されるSnowflake IDには影響しません。オプション。
machine_id — 機械ID、最下位10ビットが使用されます。 Int64。オプション。

返される値

UInt64型の値。

例

まず、UInt64型のカラムを持つテーブルを作成し、次に生成されたSnowflake IDをテーブルに挿入します。

CREATE TABLE tab (id UInt64) ENGINE = Memory;

INSERT INTO tab SELECT generateSnowflakeID();

SELECT * FROM tab;

結果:

┌──────────────────id─┐
│ 7199081390080409600 │
└─────────────────────┘

行ごとに複数のSnowflake IDを生成する例

SELECT generateSnowflakeID(1), generateSnowflakeID(2);

┌─generateSnowflakeID(1)─┬─generateSnowflakeID(2)─┐
│    7199081609652224000 │    7199081609652224001 │
└────────────────────────┴────────────────────────┘

式と機械IDを持つ例

SELECT generateSnowflakeID('expr', 1);

┌─generateSnowflakeID('expr', 1)─┐
│            7201148511606784002 │
└────────────────────────────────┘

snowflakeToDateTime

Deprecated feature

注意

この関数は廃止されており、設定 allow_deprecated_snowflake_conversion_functions が有効な場合にのみ使用できます。この関数は将来的に削除される予定です。

代わりにsnowflakeIDToDateTime関数を使用してください。

Snowflake IDのタイムスタンプコンポーネントをDateTime形式で抽出します。

構文

snowflakeToDateTime(value[, time_zone])

引数

value — Snowflake ID。 Int64。
time_zone — タイムゾーン。関数は、タイムゾーンに従ってtime_stringを解析します。オプション。 String。

返される値

valueのタイムスタンプコンポーネントをDateTime型で返します。

例

クエリ:

SELECT snowflakeToDateTime(CAST('1426860702823350272', 'Int64'), 'UTC');

結果:


┌─snowflakeToDateTime(CAST('1426860702823350272', 'Int64'), 'UTC')─┐
│                                              2021-08-15 10:57:56 │
└──────────────────────────────────────────────────────────────────┘

snowflakeToDateTime64

Deprecated feature

注意

この関数は廃止されており、設定 allow_deprecated_snowflake_conversion_functions が有効な場合にのみ使用できます。この関数は将来的に削除される予定です。

代わりにsnowflakeIDToDateTime64関数を使用してください。

Snowflake IDのタイムスタンプコンポーネントをDateTime64形式で抽出します。

構文

snowflakeToDateTime64(value[, time_zone])

引数

value — Snowflake ID。 Int64。
time_zone — タイムゾーン。関数は、タイムゾーンに従ってtime_stringを解析します。オプション。 String。

返される値

valueのタイムスタンプコンポーネントを、スケール=3のDateTime64型（つまりミリ秒精度）で返します。

例

クエリ:

SELECT snowflakeToDateTime64(CAST('1426860802823350272', 'Int64'), 'UTC');

結果:


┌─snowflakeToDateTime64(CAST('1426860802823350272', 'Int64'), 'UTC')─┐
│                                            2021-08-15 10:58:19.841 │
└────────────────────────────────────────────────────────────────────┘

dateTimeToSnowflake

Deprecated feature

注意

この関数は廃止されており、設定 allow_deprecated_snowflake_conversion_functions が有効な場合にのみ使用できます。この関数は将来的に削除される予定です。

代わりにdateTimeToSnowflakeID関数を使用してください。

DateTime値を指定された時間での最初のSnowflake IDに変換します。

構文

dateTimeToSnowflake(value)

引数

value — 時間付き日付。 DateTime。

返される値

指定された時間での最初のSnowflake IDとして Int64データ型に変換された入力値。

例

クエリ:

WITH toDateTime('2021-08-15 18:57:56', 'Asia/Shanghai') AS dt SELECT dateTimeToSnowflake(dt);

結果:

┌─dateTimeToSnowflake(dt)─┐
│     1426860702823350272 │
└─────────────────────────┘

dateTime64ToSnowflake

Deprecated feature

注意

この関数は廃止されており、設定 allow_deprecated_snowflake_conversion_functions が有効な場合にのみ使用できます。この関数は将来的に削除される予定です。

代わりにdateTime64ToSnowflakeID関数を使用してください。

DateTime64を指定された時間での最初のSnowflake IDに変換します。

構文

dateTime64ToSnowflake(value)

引数

value — 時間付き日付。 DateTime64。

返される値

指定された時間での最初のSnowflake IDとして Int64データ型に変換された入力値。

例

クエリ:

WITH toDateTime64('2021-08-15 18:57:56.492', 3, 'Asia/Shanghai') AS dt64 SELECT dateTime64ToSnowflake(dt64);

結果:

┌─dateTime64ToSnowflake(dt64)─┐
│         1426860704886947840 │
└─────────────────────────────┘

snowflakeIDToDateTime

Snowflake IDのタイムスタンプコンポーネントをDateTime型の値として返します。

構文

snowflakeIDToDateTime(value[, epoch[, time_zone]])

引数

value — Snowflake ID。 UInt64。
epoch - 1970年1月1日からのミリ秒単位でのSnowflake IDのエポック。デフォルトは0（1970年1月1日）。Twitter/Xのエポック（2015年1月1日）の場合は1288834974657を指定します。オプション。 UInt*。
time_zone — タイムゾーン。関数は、タイムゾーンに従ってtime_stringを解析します。オプション。 String。

返される値

valueのタイムスタンプコンポーネントをDateTime型で返します。

例

クエリ:

SELECT snowflakeIDToDateTime(7204436857747984384) AS res

結果:

┌─────────────────res─┐
│ 2024-06-06 10:59:58 │
└─────────────────────┘

snowflakeIDToDateTime64

Snowflake IDのタイムスタンプコンポーネントをDateTime64型の値として返します。

構文

snowflakeIDToDateTime64(value[, epoch[, time_zone]])

引数

value — Snowflake ID。 UInt64。
epoch - 1970年1月1日からのミリ秒単位でのSnowflake IDのエポック。デフォルトは0（1970年1月1日）。Twitter/Xのエポック（2015年1月1日）の場合は1288834974657を指定します。オプション。 UInt*。
time_zone — タイムゾーン。関数は、タイムゾーンに従ってtime_stringを解析します。オプション。 String。

返される値

valueのタイムスタンプコンポーネントをスケール=3のDateTime64型（つまりミリ秒精度）で返します。

例

クエリ:

SELECT snowflakeIDToDateTime64(7204436857747984384) AS res

結果:

┌─────────────────res─┐
│ 2024-06-06 10:59:58 │
└─────────────────────┘

dateTimeToSnowflakeID

DateTime値を指定された時間での最初のSnowflake IDに変換します。

構文

dateTimeToSnowflakeID(value[, epoch])

引数

value — 時間付き日付。 DateTime。
epoch - 1970年1月1日からのミリ秒単位でのSnowflake IDのエポック。デフォルトは0（1970年1月1日）。Twitter/Xのエポック（2015年1月1日）の場合は1288834974657を指定します。オプション。 UInt*。

返される値

指定された時間での最初のSnowflake IDとしてUInt64に変換された入力値。

例

クエリ:

SELECT toDateTime('2021-08-15 18:57:56', 'Asia/Shanghai') AS dt, dateTimeToSnowflakeID(dt) AS res;

結果:

┌──────────────────dt─┬─────────────────res─┐
│ 2021-08-15 18:57:56 │ 6832626392367104000 │
└─────────────────────┴─────────────────────┘

dateTime64ToSnowflakeID

DateTime64を指定された時間での最初のSnowflake IDに変換します。

構文

dateTime64ToSnowflakeID(value[, epoch])

引数

value — 時間付き日付。 DateTime64。
epoch - 1970年1月1日からのミリ秒単位でのSnowflake IDのエポック。デフォルトは0（1970年1月1日）。Twitter/Xのエポック（2015年1月1日）の場合は1288834974657を指定します。オプション。 UInt*。

返される値

指定された時間での最初のSnowflake IDとしてUInt64に変換された入力値。

例

クエリ:

SELECT toDateTime('2021-08-15 18:57:56.493', 3, 'Asia/Shanghai') AS dt, dateTime64ToSnowflakeID(dt) AS res;

結果:

┌──────────────────────dt─┬─────────────────res─┐
│ 2021-08-15 18:57:56.493 │ 6832626394434895872 │
└─────────────────────────┴─────────────────────┘

また見る

dictGetUUID

UUIDv7生成​

Snowflake ID生成​

generateUUIDv4​

generateUUIDv7​

dateTimeToUUIDv7​

empty​

notEmpty​

toUUID​

toUUIDOrDefault​

toUUIDOrNull​

toUUIDOrZero​

UUIDStringToNum​

UUIDNumToString​

UUIDToNum​

UUIDv7ToDateTime​

serverUUID​

generateSnowflakeID​

snowflakeToDateTime​

snowflakeToDateTime64​

dateTimeToSnowflake​

dateTime64ToSnowflake​

snowflakeIDToDateTime​

snowflakeIDToDateTime64​

dateTimeToSnowflakeID​

dateTime64ToSnowflakeID​

また見る​

UUIDv7生成

Snowflake ID生成

generateUUIDv4

generateUUIDv7

dateTimeToUUIDv7

empty

notEmpty

toUUID

toUUIDOrDefault

toUUIDOrNull

toUUIDOrZero

UUIDStringToNum

UUIDNumToString

UUIDToNum

UUIDv7ToDateTime

serverUUID

generateSnowflakeID

snowflakeToDateTime

snowflakeToDateTime64

dateTimeToSnowflake

dateTime64ToSnowflake

snowflakeIDToDateTime

snowflakeIDToDateTime64

dateTimeToSnowflakeID

dateTime64ToSnowflakeID

また見る