バージョン: 4.x

SEQUENCE_MATCH

説明

シーケンスがパターンに一致するイベントチェーンを含んでいるかどうかを確認します。

警告！

同じ秒に発生するイベントは、シーケンス内で未定義の順序で配置される可能性があり、結果に影響を与えます。

構文

SEQUENCE_MATCH(<pattern>, <timestamp>, <cond_1> [, <cond_2>, ..., <cond_n>])

パラメータ

Parameter	デスクリプション
`<pattern>`	パターン文字列。以下のパターン構文を参照してください。
`<timestamp>`	時間データを含むと見なされるカラム。典型的なデータ型は `Date` および `DateTime` です。サポートされている UInt データ型のいずれかも使用できます。
`<cond_n>`	イベントのチェーンを記述する条件。データ型: `UInt8`。最大32個の条件引数を渡すことができます。関数はこれらの条件で記述されたイベントのみを考慮します。シーケンスに条件で記述されていないデータが含まれている場合、関数はそれらをスキップします。

パターン構文

(?N) — 位置Nの条件引数にマッチします。条件は [1, 32] の範囲で番号付けされます。例えば、(?1) は cond1 パラメータに渡された引数にマッチします。
.* — 任意の数のイベントにマッチします。パターンのこの要素にマッチするために条件引数は必要ありません。
(?t operator value) — 2つのイベント間に必要な時間を秒単位で設定します。
t を2つの時刻間の秒単位の差として定義します。例えば、パターン (?1)(?t>1800)(?2) は互いに1800秒以上離れて発生するイベントにマッチします。パターン (?1)(?t>10000)(?2) は互いに10000秒以上離れて発生するイベントにマッチします。これらのイベント間には任意の数の任意のイベントが存在できます。>=、>、<、<=、== の演算子を使用できます。

Return value

1: パターンがマッチした場合。

0: パターンがマッチしなかった場合。

Examples

マッチ例

CREATE TABLE sequence_match_test1(
    `uid` int COMMENT 'user id',
    `date` datetime COMMENT 'date time', 
    `number` int NULL COMMENT 'number' 
) DUPLICATE KEY(uid) 
DISTRIBUTED BY HASH(uid) BUCKETS AUTO
PROPERTIES ( 
    "replication_num" = "1"
); 

INSERT INTO sequence_match_test1(uid, date, number) values
(1, '2022-11-02 10:41:00', 1),
(2, '2022-11-02 13:28:02', 2),
(3, '2022-11-02 16:15:01', 1),
(4, '2022-11-02 19:05:04', 2),
(5, '2022-11-02 20:08:44', 3); 


SELECT 
sequence_match('(?1)(?2)', date, number = 1, number = 3) as c1,
sequence_match('(?1)(?2)', date, number = 1, number = 2) as c2,
sequence_match('(?1)(?t>=3600)(?2)', date, number = 1, number = 2) as c3
FROM sequence_match_test1;

+------+------+------+
| c1   | c2   | c3   |
+------+------+------+
|    1 |    1 |    1 |
+------+------+------+

一致しない例

CREATE TABLE sequence_match_test2(
    `uid` int COMMENT 'user id',
    `date` datetime COMMENT 'date time', 
    `number` int NULL COMMENT 'number' 
) DUPLICATE KEY(uid) 
DISTRIBUTED BY HASH(uid) BUCKETS AUTO
PROPERTIES ( 
    "replication_num" = "1"
); 

INSERT INTO sequence_match_test2(uid, date, number) values
(1, '2022-11-02 10:41:00', 1),
(2, '2022-11-02 11:41:00', 7),
(3, '2022-11-02 16:15:01', 3),
(4, '2022-11-02 19:05:04', 4),
(5, '2022-11-02 21:24:12', 5);

SELECT 
sequence_match('(?1)(?2)', date, number = 1, number = 2) as c1,
sequence_match('(?1)(?2).*', date, number = 1, number = 2) as c2,
sequence_match('(?1)(?t>3600)(?2)', date, number = 1, number = 7) as c3
FROM sequence_match_test2;

+------+------+------+
| c1   | c2   | c3   |
+------+------+------+
|    0 |    0 |    0 |
+------+------+------+

特別な例

CREATE TABLE sequence_match_test3(
    `uid` int COMMENT 'user id',
    `date` datetime COMMENT 'date time', 
    `number` int NULL COMMENT 'number' 
) DUPLICATE KEY(uid) 
DISTRIBUTED BY HASH(uid) BUCKETS AUTO
PROPERTIES ( 
    "replication_num" = "1"
); 

INSERT INTO sequence_match_test3(uid, date, number) values
(1, '2022-11-02 10:41:00', 1),
(2, '2022-11-02 11:41:00', 7),
(3, '2022-11-02 16:15:01', 3),
(4, '2022-11-02 19:05:04', 4),
(5, '2022-11-02 21:24:12', 5);

SELECT sequence_match('(?1)(?2)', date, number = 1, number = 5)
FROM sequence_match_test3;

+----------------------------------------------------------------+
| sequence_match('(?1)(?2)', `date`, `number` = 1, `number` = 5) |
+----------------------------------------------------------------+
|                                                              1 |
+----------------------------------------------------------------+

これは非常にシンプルな例です。この関数は、数値1の後に数値5が続くイベントチェーンを見つけました。その間にある数値7、3、4はスキップされました。これは、その数値がイベントとして記述されていないためです。例で示されたイベントチェーンを検索する際にこの数値を考慮したい場合は、そのための条件を作成する必要があります。

では、このクエリを実行してください：

SELECT sequence_match('(?1)(?2)', date, number = 1, number = 5, number = 4)
FROM sequence_match_test3;

+------------------------------------------------------------------------------+
| sequence_match('(?1)(?2)', `date`, `number` = 1, `number` = 5, `number` = 4) |
+------------------------------------------------------------------------------+
|                                                                            0 |
+------------------------------------------------------------------------------+

結果は少し混乱を招きます。この場合、番号4のイベントが1と5の間で発生したため、関数はパターンに一致するイベントチェーンを見つけることができませんでした。同じケースで番号6の条件をチェックした場合、シーケンスはパターンに一致するでしょう。

SELECT sequence_match('(?1)(?2)', date, number = 1, number = 5, number = 6)
FROM sequence_match_test3;

+------------------------------------------------------------------------------+
| sequence_match('(?1)(?2)', `date`, `number` = 1, `number` = 5, `number` = 6) |
+------------------------------------------------------------------------------+
|                                                                            1 |
+------------------------------------------------------------------------------+

説明​

構文​

パラメータ​

Return value​

Examples​

説明

構文

パラメータ

Return value

Examples