文字列関数（正規表現）¶

正規表現関数のリスト¶

一般的な使用上の注意¶

これらの注意では、「サブジェクト」は操作対象の文字列を指し、「パターン」は正規表現を指します。

• 通常、サブジェクトは可変列であり、パターンは定数ですが、これは必須ではありません。正規表現関数のすべての引数は、定数または変数のいずれかにできます。

• Patterns support the most of the POSIX ERE (Extended Regular Expression) syntax. For details, see the POSIX basic and extended section (in Wikipedia).

  One exception is that the regular expression functions don't support non-greedy quantifiers, for example *?, ??, and +?.

• パターンは、次のPerlバックスラッシュシーケンスもサポートしています。

  • \d：10進数（0～9）。

  • \D：10進数ではありません。

  • \s：空白文字。

  • \S：空白文字ではありません。

  • \w：「単語」文字（a～z、A～Z、アンダースコア（「_」）、または10進数）。

  • \W：単語の文字ではありません。

  • \b：単語の境界。

  • \B：単語の境界ではありません。

  詳細については、 文字クラス セクション（Wikipedia内）または バックスラッシュシーケンス セクション（Perlドキュメント内）をご参照ください。

  注釈

  一重引用符で囲まれた文字列定数 では、バックスラッシュシーケンスのバックスラッシュをエスケープする必要があります。たとえば、 \d を指定するには、 \\d を使用します。詳細については、 一重引用符で囲まれた文字列定数での正規表現の指定 （このトピック内）をご参照ください。

  文字列を ドル記号のペア（$$） （一重引用符ではなく）で区切る場合は、バックスラッシュをエスケープする必要はありません。

• デフォルトでは、 POSIX ワイルドカード文字 . （パターン内）には一致する改行文字 \n （サブジェクト内）は含まれません。

  改行文字にも一致させるには 、 pattern 引数で . を (.|\n) に置き換えるか、 parameters 引数で s パラメーターを使用します（以下を参照）。

• すべての正規表現関数はUnicodeをサポートしています。単一のUnicode文字は、その文字の対応するバイナリ表現のバイト長に関係なく、常に1文字としてカウントされます（ POSIX メタ文字 . は正確に1つのUnicode文字に一致します）。また、サブジェクトオフセットを取得または返す関数の場合、単一のUnicode文字は1としてカウントされます。

正規表現のパラメーターの指定¶

ほとんどの正規表現関数は、任意の parameters 引数をサポートしています。 parameters 引数は、正規表現関数の一致動作に特化する VARCHAR 文字列です。次のパラメーターがサポートされています。

デフォルトの文字列は単に c であり、次を指定します。

• 大文字と小文字を区別する一致。

• 単一行モード。

• REGEXP_REPLACE を除き、常にサブマッチ抽出を使用するサブマッチ抽出はありません。

• POSIX ワイルドカード文字 . は、 \n 改行文字と一致しません。

複数のパラメーターを指定する場合、文字列はスペースまたは区切り文字なしで入力されます。たとえば、 ims は、 POSIX ワイルドカード一致の複数行モードで大文字と小文字を区別しない一致を指定します。

parameters 文字列に c と i の両方が含まれている場合は、文字列の最後により、関数が大文字と小文字を区別する一致を実行するかどうかが決まります。たとえば、 ci は、 i が文字列の最後にあるため、大文字と小文字を区別する一致を指定します。

次の例は、大文字と小文字を区別する一致と区別しない一致で、結果がどのように異なるかを示しています。 REGEXP_COUNT 関数は、大文字小文字を区別する一致 (c パラメーター、デフォルト) では snow と SNOW にマッチせず、大文字小文字を区別しない一致 (i パラメータ) では1つの一致を返します。

SELECT REGEXP_COUNT('snow', 'SNOW', 1, 'c') AS case_sensitive_matching,
       REGEXP_COUNT('snow', 'SNOW', 1, 'i') AS case_insensitive_matching;

+-------------------------+---------------------------+
| CASE_SENSITIVE_MATCHING | CASE_INSENSITIVE_MATCHING |
|-------------------------+---------------------------|
|                       0 |                         1 |
+-------------------------+---------------------------+

e パラメーターを持つ REGEXP_SUBSTR 関数を使用して、単語 Release 、その後に1つ以上の単語以外の文字が続き、その後に1つ以上の数字が続くものを探し、その数字にマッチする部分文字列を返します。

SELECT REGEXP_SUBSTR('Release 24', 'Release\\W+(\\d+)', 1, 1, 'e') AS release_number;

+----------------+
| RELEASE_NUMBER |
|----------------|
| 24             |
+----------------+

パラメーターを使用するその他の例については、 REGEXP_INSTR 、 REGEXP_LIKE 、 REGEXP_SUBSTR 、 REGEXP_SUBSTR_ALL 、 [ NOT ] RLIKE をご参照ください。

メタ文字である一致する文字¶

正規表現では、一部の文字は特定の意味を持つメタ文字として扱われます。例:

• . は、 任意の1文字に一致するメタ文字 です。

• * is a quantifier that matches zero or more instances of the preceding element. For example, BA* matches B, BA, BAA, and so on.

• ? は、先行要素の0個または1個のインスタンスに一致する量指定子です。

To match the actual character (for example, an actual period, asterisk, or question mark), you must escape the metacharacter with a backslash (for example, \., \*, \?, and so on).

たとえば、文字列内で開き括弧（(）を見つける必要があるとします。これを指定する1つの方法は、バックスラッシュを使用してパターン内の文字をエスケープすることです（例: \(）。

パターンを 一重引用符で囲まれた文字列定数 として指定する場合は、 そのバックスラッシュを2番目のバックスラッシュでエスケープ する必要もあります。

次のパターンは、括弧内に表示される英数字のシーケンスと一致します（例: (NY)）。

SELECT REGEXP_SUBSTR('Customers - (NY)','\\([[:alnum:]]+\\)') AS location;

+----------+
| LOCATION |
|----------|
| (NY)     |
+----------+

その他の例については、 一重引用符で囲まれた文字列定数でメタ文字を使用する例 をご参照ください。

ドル引用符で囲まれた文字列定数 を使用している場合は、バックスラッシュをエスケープする必要がないことに注意してください。

SELECT REGEXP_SUBSTR('Customers - (NY)',$$\([[:alnum:]]+\)$$) AS location;

+----------+
| LOCATION |
|----------|
| (NY)     |
+----------+

後方参照の使用¶

Snowflakeは、正規表現パターン（形式言語理論では「スクエア」として知られる）の後方参照をサポートしていません。ただし、後方参照は REGEXP_REPLACE 関数の置換文字列でサポートされています。

空のパターンの指定¶

ほとんどの正規表現関数では、空のパターン（つまり、 ''）は何にも一致せず、空の件名にも一致しません。

例外は REGEXP_LIKE と、そのエイリアスである [ NOT ] REGEXP および [ NOT ] RLIKE です。パターンは両端で暗黙的に固定されているため、空のパターンは空のサブジェクトに一致します（つまり、 '' は自動的に '^$' になる）。

空のグループ（つまり、サブ式 ()）は、サブジェクトの開始と終了を含む文字間のスペースに一致します。

ドル引用符で囲まれた文字列定数での正規表現の指定¶

文字列定数を使用して関数の正規表現を指定している場合は、 ドル引用符で囲まれた文字列定数 を使用して、 正規表現のバックスラッシュをエスケープ する必要をなくすことができます。（一重引用符で囲まれた文字列定数 を使用している場合は、バックスラッシュをエスケープする必要があります。）

ドル引用符で囲まれた文字列定数の内容は、常に文字通りに解釈されます。

たとえば、 メタ文字 をエスケープする場合は、バックスラッシュを1つ使用するだけで済みます。

SELECT w2
  FROM wildcards
  WHERE REGEXP_LIKE(w2, $$\?$$);

後方参照 を使用する場合は、バックスラッシュを1つ使用するだけで済みます。

SELECT w2, REGEXP_REPLACE(w2, '(.old)', $$very \1$$)
  FROM wildcards
  ORDER BY w2;

一重引用符で囲まれた文字列定数での正規表現の指定¶

一重引用符で囲まれた文字列定数 で正規表現を使用している場合は、 バックスラッシュシーケンス のバックスラッシュを2番目のバックスラッシュでエスケープする必要があります。

例:

• バックスラッシュで メタ文字をエスケープ する場合は、2番目のバックスラッシュでバックスラッシュをエスケープする必要があります。 一重引用符で囲まれた文字列定数でメタ文字を使用する例 をご参照ください。

• バックスラッシュシーケンス を使用している場合は、シーケンス内のバックスラッシュをエスケープする必要があります。

• 後方参照 を使用している場合は、後方参照でバックスラッシュをエスケープする必要があります。 一重引用符で囲まれた文字列定数で後方参照を使用する例 をご参照ください。

CREATE OR REPLACE TABLE wildcards (w VARCHAR, w2 VARCHAR);
INSERT INTO wildcards (w, w2) VALUES ('\\', '?');

SELECT w2
  FROM wildcards
  WHERE REGEXP_LIKE(w2, '\\?');

+----+
| W2 |
|----|
| ?  |
+----+

SELECT w2
  FROM wildcards
  WHERE REGEXP_LIKE(w2, '\\' || '?');

+----+
| W2 |
|----|
| ?  |
+----+

SELECT w, w2, w || w2 AS escape_sequence, w2
  FROM wildcards
  WHERE REGEXP_LIKE(w2, w || w2);

+---+----+-----------------+----+
| W | W2 | ESCAPE_SEQUENCE | W2 |
|---+----+-----------------+----|
| \ | ?  | \?              | ?  |
+---+----+-----------------+----+

INSERT INTO wildcards (w, w2) VALUES (NULL, 'When I am cold, I am bold.');

SELECT w2, REGEXP_REPLACE(w2, '(.old)', 'very \\1')
  FROM wildcards
  ORDER BY w2;

+----------------------------+------------------------------------------+
| W2                         | REGEXP_REPLACE(W2, '(.OLD)', 'VERY \\1') |
|----------------------------+------------------------------------------|
| ?                          | ?                                        |
| When I am cold, I am bold. | When I am very cold, I am very bold.     |
+----------------------------+------------------------------------------+