に最終更新
MULTI_MATCH_ANY
説明
<haystack> が <patterns> 内のいずれかの正規表現に一致するかどうかを調べます。デフォルトでは大文字と小文字を区別します。0 が返され、NULL は返されないのは、いずれかの引数が NULL の場合です。
構文
MULTI_MATCH_ANY(<haystack>, <patterns>)
パラメータ
| パラメータ | 説明 |
|---|---|
<haystack> | 入力文字列。型は STRING です。 |
<patterns> | 正規表現の配列。型は ARRAY<STRING> です。各パターン要素には NULL 以外の文字列を指定してください。 |
戻り値
戻り値は TINYINT で、いずれかの式が一致すれば 1、それ以外は 0 です。空のパターン配列でも 0 を返し、いずれかの引数が NULL の場合も同様です。
この関数は Hyperscan/VectorScan 正規表現エンジンを使用します。無効なパターンやサポートされていないパターンを指定するとエラーが発生します。定数の入力文字列と、非定数のパターン配列カラムを組み合わせることはできず、その組み合わせでは引数エラーが発生します。
例
SELECT multi_match_any('Hello, World!', ['hello', '!', 'world']) AS matched;
1
SELECT multi_match_any('abc', ['A', 'bcd']) AS matched;
0
正規表現は、文字列をそのまま部分文字列として検索するのではなく、パターンマッチングを行います。
SELECT multi_match_any('abc123', ['[0-9]+', '^xyz']) AS matched;
1
SELECT multi_match_any('abc', CAST([] AS ARRAY<STRING>)) AS empty_patterns,
multi_match_any(CAST(NULL AS STRING), ['a']) AS null_text,
multi_match_any('abc', CAST(NULL AS ARRAY<STRING>)) AS null_patterns;
0 0 0
キーワード
MULTI_MATCH, MATCH, ANY