[ NOT ] LIKE¶

構文¶

<subject> [ NOT ] LIKE <pattern> [ ESCAPE <escape> ]

LIKE( <subject> , <pattern> [ , <escape> ] )

引数¶

必須：

subject

一致するサブジェクトです。通常、これは VARCHAR ですが、他のデータ型も使用できます。

pattern

一致するパターンです。通常、これは VARCHAR ですが、他のデータ型も使用できます。

オプション：

escape

ワイルドカードをワイルドカードとしてではなく通常の文字として解釈されることを示すために、ワイルドカード文字の前に挿入される文字です。

戻り値¶

BOOLEAN または NULL を返します。

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

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

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

使用上の注意¶

• パターンマッチに一重引用符やその他の特殊文字を含めるには、 バックスラッシュエスケープシーケンス を使用します。

• NULL は NULL と一致しません。つまり、サブジェクトが NULL で、パターンが NULLの場合、一致とは見なされません。

• SQL ワイルドカードは pattern でサポートされています。

  • アンダースコア（_）は、任意の1文字に一致します。

  • パーセント記号（%）は、ゼロ個以上の文字のシーケンスに一致します。

• pattern のワイルドカードには、一致として subject の改行文字（n）が含まれます。

• パターンマッチングは文字列全体をカバーします。文字列内の任意の場所でシーケンスを照合するには、パターンを % で開始および終了します。

• デフォルトのエスケープ文字はありません。

• バックスラッシュをエスケープ文字として使用する場合は、式と ESCAPE 句の両方でバックスラッシュをエスケープする必要があります。たとえば、次のコマンドは、エスケープ文字がバックスラッシュであることを指定し、そのエスケープ文字を使用してリテラルとして % を検索します（エスケープ文字なしでは、 % はワイルドカードとして扱われます）。

  CopyExpand

  'SOMETHING%' LIKE '%\\%%' ESCAPE '\\';
  

  Show lessSee more

  Scroll to top

  エスケープ文字の使用例、特にエスケープ文字としてのバックスラッシュについては、 例 をご参照ください。

• この関数がサポートするよりも複雑なパターンマッチングが必要な場合は、代わりに 正規表現関数 を使用できます。

照合順序の詳細¶

upper、 lower、 trim 照合順序仕様のみがサポートされています。upper、 lower、 trim の組み合わせもサポートされています（例: upper-trim と lower-trim）。ただし、ロケールの組み合わせは除きます（例: en-upper）。

例¶

いくつかの文字列を含むテーブルを作成します。

CREATE OR REPLACE TABLE like_ex(name VARCHAR(20));
INSERT INTO like_ex VALUES
  ('John  Dddoe'),
  ('John \'alias\' Doe'),
  ('Joe   Doe'),
  ('John_down'),
  ('Joe down'),
  ('Elaine'),
  (''),    -- empty string
  (null);

次の例は、 LIKE、 NOT LIKE、ワイルドカード文字 % の使用を示しています。

SELECT name
  FROM like_ex
  WHERE name LIKE '%Jo%oe%'
  ORDER BY name;

+------------------+
| NAME             |
|------------------|
| Joe   Doe        |
| John  Dddoe      |
| John 'alias' Doe |
+------------------+

SELECT name
  FROM like_ex
  WHERE name NOT LIKE '%Jo%oe%'
  ORDER BY name;

+-----------+
| NAME      |
|-----------|
|           |
| Elaine    |
| Joe down  |
| John_down |
+-----------+

SELECT name
  FROM like_ex
  WHERE name NOT LIKE 'John%'
  ORDER BY name;

+-----------+                                                                   
| NAME      |
|-----------|
|           |
| Elaine    |
| Joe   Doe |
| Joe down  |
+-----------+

SELECT name
  FROM like_ex
  WHERE name NOT LIKE ''
  ORDER BY name;

+------------------+
| NAME             |
|------------------|
| Elaine           |
| Joe   Doe        |
| Joe down         |
| John  Dddoe      |
| John 'alias' Doe |
| John_down        |
+------------------+

次の例では、バックスラッシュを使って一重引用符をエスケープし、パターンマッチで見つけられるようにしています。

SELECT name
  FROM like_ex
  WHERE name LIKE '%\'%'
  ORDER BY name;

+------------------+
| NAME             |
|------------------|
| John 'alias' Doe |
+------------------+

以下の例では、 ESCAPE 句を使用しています。

SELECT name
  FROM like_ex
  WHERE name LIKE '%J%h%^_do%' ESCAPE '^'
  ORDER BY name;

+-----------+                                                                   
| NAME      |
|-----------|
| John_down |
+-----------+

like_ex テーブルにさらに行を挿入します。

INSERT INTO like_ex (name) VALUES 
  ('100 times'),
  ('1000 times'),
  ('100%');

エスケープ文字がない場合は、パーセント記号（%）はワイルドカードとして扱われます。

SELECT * FROM like_ex WHERE name LIKE '100%'
  ORDER BY 1;

+------------+                                                                  
| NAME       |
|------------|
| 100 times  |
| 100%       |
| 1000 times |
+------------+

エスケープ文字を使用すると、パーセント記号（%）はリテラルとして扱われます。

SELECT * FROM like_ex WHERE name LIKE '100^%' ESCAPE '^'
  ORDER BY 1;

+------+                                                                        
| NAME |
|------|
| 100% |
+------+

次の例では、バックスラッシュがエスケープ文字である ESCAPE 句を使用しています。バックスラッシュ自体は ESCAPE 句と式の両方でエスケープする必要があることに注意してください。

SELECT * FROM like_ex WHERE name LIKE '100\\%' ESCAPE '\\'
  ORDER BY 1;

+------+                                                                        
| NAME |
|------|
| 100% |
+------+