MATCH_RECOGNIZEの PATTERN 句

適用対象:はい Databricks SQL チェックが Databricks Runtime 19.0 以降" とマークされているチェック

Important

この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。

MATCH_RECOGNIZE操作で一致するパターンを指定します。

Syntax

PATTERN ( row_pattern )

row_pattern
  { { pattern_primary | pattern_operator } [ pattern_quantifier ] }

pattern_primary
  { variable
  | $
  | ^ }

pattern_operator
  { ( [ row_pattern ] )
  | PERMUTE ( row_pattern [, ...] )
  | row_pattern | row_pattern
  | row_pattern row_pattern }

pattern_quantifier
  { *
  | +
  | ?
  | { n }
  | { min , [ max ] }
  | { , max } }

Parameters

パターン プライマリ

  • variable

    DEFINE 句で定義されている変数。 未定義の変数は、すべての行と一致します。

  • $

    パーティションの末尾。

  • ^

    パーティションの先頭。

    このリリースでは、 ^ と $ は、最上位のパターンの先頭または末尾の位置でのみサポートされます。 たとえば、 ^ A B $ はサポートされていますが、 A ^ B などのミッド シーケンス アンカーや、 (^ A) | (B $) などの分岐ごとのアンカーはサポートされていません。

パターン演算子

  • ( [ row_pattern ] )

    優先順位をオーバーライドするグループ。

  • PERMUTE ( row_pattern [, ...] )

    順序の並べ替えで行パターンと一致します。 PERMUTE には、少なくとも 2 つのパターンが必要です。 指定する値が 2 未満の場合、Azure DatabricksはMATCH_RECOGNIZE_PERMUTE_TOO_FEW_PATTERNSを発生させます。 サポートされている最大値を超える値を指定すると、Azure Databricks MATCH_RECOGNIZE_PERMUTE_TOO_MANY_PATTERNSが発生します。

  • row_pattern | row_pattern

    いずれかの行パターンに一致します。

  • row_pattern row_pattern

    行パターンのシーケンスに一致します。

パターン量指定子

pattern_primaryを照合する必要がある頻度を指定します。

  • *

    ゼロ回以上。

  • +

    1 回以上。

  • ?

    最大 1 回。

  • { n }

    正確に n 時間。 nは、0 より大きいINTEGERリテラルである必要があります。

  • { min , [ max ] }

    少なくとも min 時間。最大 max 時間まで指定されている場合。

  • { , max }

    max回以下。

量指定子を省略した場合、既定値は { 1 }: 完全に 1 つの一致です。

一般的なエラー状態

  • Last updated on