カテゴリ:

文字列関数(正規表現)

[ NOT ] RLIKE

文字列が指定されたパターンに一致するかしないかを比較します。両方の入力はテキスト式でなければなりません。

RLIKE は [ NOT ] LIKE 関数に似ていますが、 SQL LIKE パターン構文ではなく POSIX 拡張正規表現を使用します。LIKEよりも複雑な一致条件をサポートします。

Tip

検索最適化サービスを使用すると、この関数を呼び出すクエリのパフォーマンスを向上させることができます。詳細については、 検索最適化サービス をご参照ください。

エイリアス:

[ NOT ] REGEXP (2番目の構文)、 REGEXP_LIKE (1番目の構文)

文字列関数(正規表現) もご参照ください。

構文

-- 1st syntax
RLIKE( <subject> , <pattern> [ , <parameters> ] )

-- 2nd syntax
<subject> [ NOT ] RLIKE <pattern>
Copy

引数

必須:

subject

一致するサブジェクトです。

pattern

一致するパターンです。

オプション:

parameters

一致の検索に使用されるパラメーターを指定する1つ以上の文字の文字列です。サポートされている値:

cimes

詳細については、 正規表現のパラメーターの指定 をご参照ください。

デフォルト: c

戻り値

BOOLEAN または NULL を返します。

  • RLIKE を指定した場合、一致するときの値は TRUE。それ以外の場合は、 FALSE を返します。

  • NOT RLIKE を指定した場合、一致しない時の値は TRUE。それ以外の場合は、 FALSE を返します。

  • RLIKE か NOT RLIKE のどちらかを指定した場合、引数の中に NULL があれば NULL を返します。

使用上の注意

  • 関数は暗黙的に両端でパターンを固定します(つまり、 '' は自動的に '^$' になり、 'ABC' は自動的に '^ABC$' になります)。ABC で始まる文字列と一致する場合、パターンは 'ABC.*' になります。

  • バックスラッシュ文字(\)はエスケープ文字です。詳細については、 一重引用符で囲まれた文字列定数での正規表現の指定 をご参照ください。

  • 使用上の注意については、正規表現関数の 一般的な使用上の注意 をご参照ください。

照合の詳細

Arguments with collation specifications are currently not supported.

次のコマンドを実行して、このトピックの例のデータを設定します。

CREATE OR REPLACE TABLE rlike_ex(city varchar(20));
INSERT INTO rlike_ex VALUES ('Sacramento'), ('San Francisco'), ('San Jose'), (null);
Copy

最初の構文

次の例では、ワイルドカードを使用して大文字と小文字を区別しないパターン一致を実行します。

SELECT * FROM rlike_ex WHERE RLIKE(city, 'san.*', 'i');
Copy
+---------------+
| CITY          |
|---------------|
| San Francisco |
| San Jose      |
+---------------+
SELECT * FROM rlike_ex WHERE NOT RLIKE(city, 'san.*', 'i');
Copy
+------------+
| CITY       |
|------------|
| Sacramento |
+------------+

次の例では、文字列が電話番号とメールアドレスの形式と一致するかどうかを判断します。これらの例では、正規表現でバックスラッシュがエスケープされないように、正規表現は ドル引用符で囲まれた文字列 で指定されています。

SELECT RLIKE('800-456-7891', $$[2-9]\d{2}-\d{3}-\d{4}$$) AS matches_phone_number;
Copy
+----------------------+
| MATCHES_PHONE_NUMBER |
|----------------------|
| True                 |
+----------------------+
SELECT RLIKE('jsmith@email.com',$$\w+@[a-zA-Z_]+?\.[a-zA-Z]{2,3}$$) AS matches_email_address;
Copy
+-----------------------+
| MATCHES_EMAIL_ADDRESS |
|-----------------------|
| True                  |
+-----------------------+

次の例は同じ一致を実行しますが、 一重引用符で囲まれた文字列定数 を使用して正規表現を指定します。

この例では一重引用符で囲まれた文字列定数を使用しているため、 各バックスラッシュは別のバックスラッシュでエスケープする必要があります

-- Escape the backslash character (\) in \w and \d

SELECT RLIKE('800-456-7891','[2-9]\\d{2}-\\d{3}-\\d{4}') AS matches_phone_number;
Copy
+----------------------+
| MATCHES_PHONE_NUMBER |
|----------------------|
| True                 |
+----------------------+
SELECT RLIKE('jsmith@email.com','\\w+@[a-zA-Z_]+?\\.[a-zA-Z]{2,3}') AS matches_email_address;
Copy
+-----------------------+
| MATCHES_EMAIL_ADDRESS |
|-----------------------|
| True                  |
+-----------------------+

あるいは、ステートメントを書き直して、バックスラッシュ文字に依存するシーケンスを回避します。

SELECT RLIKE('800-456-7891','[2-9][0-9]{2}-[0-9]{3}-[0-9]{4}') AS matches_phone_number;
Copy
+----------------------+
| MATCHES_PHONE_NUMBER |
|----------------------|
| True                 |
+----------------------+
SELECT RLIKE('jsmith@email.com','[a-zA-Z_]+@[a-zA-Z_]+?\\.[a-zA-Z]{2,3}') AS matches_email_address;
Copy
+-----------------------+
| MATCHES_EMAIL_ADDRESS |
|-----------------------|
| True                  |
+-----------------------+

2番目の構文

大文字と小文字を区別するパターンマッチング:

SELECT * FROM rlike_ex WHERE city RLIKE 'San.* [fF].*';
Copy
+---------------+
| CITY          |
|---------------|
| San Francisco |
+---------------+

追加の例

正規表現のその他の例については、 [ NOT ] REGEXP をご参照ください。