カテゴリ:

文字列とバイナリ関数 (マッチング/比較)

LIKE ANY

大文字小文字を区別した比較を実行し、1つ以上の指定されたパターンのいずれかと文字列を一致させます。この関数を WHERE 句で使用して、一致するものをフィルターします。大文字と小文字を区別しない一致では、代わりに ILIKE ANY を使用します。

Tip

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

こちらもご参照ください:

[ NOT ] LIKE , ILIKE ANY

構文

<subject> LIKE ANY (<pattern1> [, <pattern2> ... ] ) [ ESCAPE <escape_char> ]
Copy

引数

必須:

subject

パターンと比較する文字列です。

pattern#

文字列が比較されるパターンです。少なくとも1つのパターンを指定する必要があります。

オプション:

escape_char

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

戻り値

BOOLEAN または NULL を返します。一致する場合は TRUE になります。それ以外の場合は、 FALSE を返します。いずれかの引数が NULL の場合は NULL を返します。

使用上の注意

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

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

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

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

  • パターンが入力文字列(サブジェクト)全体と一致する場合、パターンは一致すると見なされます。文字列内の任意の場所でシーケンスを照合するには、パターンを % (例: %something%)で開始および終了します。

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

  • NOT 論理演算子を subject の前に使用すると、大文字と小文字を区別した比較を実行し、指定されたパターンのいずれかに一致しない場合は TRUE を返します。

照合の詳細

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

注釈

upperlower、または trim 照合順序指定子を持つ列でこの関数を使用するには、 アカウントで2024_02動作変更バンドルを有効にする 必要があります。

アカウントでこのバンドルを有効にするには、以下のステートメントを実行します。

SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');
Copy

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

CREATE OR REPLACE TABLE like_example(name VARCHAR(20));
INSERT INTO like_example VALUES
    ('John  Dddoe'),
    ('Joe   Doe'),
    ('John_down'),
    ('Joe down'),
    ('Tom   Doe'),
    ('Tim down'),
    (null);
Copy

このクエリは、ワイルドカード(%)を含むパターンを使用して一致を見つける方法を示しています。

SELECT * 
  FROM like_example 
  WHERE name LIKE ANY ('%Jo%oe%','T%e')
  ORDER BY name;
Copy
+-------------+                                                                 
| NAME        |
|-------------|
| Joe   Doe   |
| John  Dddoe |
| Tom   Doe   |
+-------------+

このクエリは、エスケープ文字を使用して、通常はワイルドカード(_)である文字をリテラルとして扱うことを指定する方法を示しています。

SELECT * 
  FROM like_example 
  WHERE name LIKE ANY ('%J%h%^_do%', 'T%^%e') ESCAPE '^'
  ORDER BY name;
Copy
+-----------+                                                                   
| NAME      |
|-----------|
| John_down |
+-----------+