SIMILAR TO

SIMILAR TO 演算子は、列名などの文字列式を、SQL の標準的な正規表現パターンと突き合わせます。SQL の正規表現パターンには、LIKE 演算子によってサポートされる 2 つを含む、一連のパターンマッチングメタ文字を含めることができます。

SIMILAR TO 演算子の場合は、POSIX の正規表現の動作 (パターンは文字列の任意の部分と一致できる) とは異なり、パターンが文字全体と一致した場合にのみ true を返します。

SIMILAR TO は大文字小文字を区別するマッチングを実行します。

注記

SIMILAR TO を使用する正規表現マッチングは、計算コストが高くなります。非常に多くの行を処理する場合は特に、可能な限り、LIKE を使用することをお勧めします。例えば、以下に示す各クエリは機能的には同じですが、LIKE を使用したクエリは、正規表現を使用したクエリよりも数倍速く実行できます。

select count(*) from event where eventname SIMILAR TO '%(Ring|Die)%'; 
select count(*) from event where eventname LIKE '%Ring%' OR eventname LIKE '%Die%'; 

構文

expression [ NOT ] SIMILAR TO pattern [ ESCAPE 'escape_char' ]

引数

expression

列名など、有効な UTF-8 文字式。

SIMILAR TO

SIMILAR TO は、expression 内の文字列全体について、大文字小文字を区別するパターンマッチングを実行します。

pattern

SQL の標準的な正規表現パターンを表現する有効な UTF-8 文字式。

escape_char

パターン内でメタ文字をエスケープする文字式。デフォルトは 2 個のバックスラッシュ (「\\」) です。

pattern にメタ文字が含まれていない場合、pattern は文字列そのものを表現するにすぎません。

どちらの文字式も CHAR または VARCHAR のデータ型になることができます。文字式の型が異なる場合、Amazon Redshift は pattern のデータ型を expression のデータ型に変換します。

SIMILAR TO では、次のパターンマッチングメタ文字をサポートしています。

演算子	説明
%	ゼロ個以上の任意の文字シーケンスをマッチングします。
_	任意の 1 文字をマッチングします。
|	交替を示します (2 つの選択肢のいずれか)。
*	前の項目をゼロ回以上繰り返します。
+	前の項目を 1 回以上繰り返します。
?	前の項目をゼロ回または 1 回繰り返します。
{m}	前の項目をちょうど m 回だけ繰り返します。
{m,}	前の項目を m 回またはそれ以上の回数繰り返します。
{m,n}	前の項目を少なくとも m 回、多くても n 回繰り返します。
()	グループ項目を括弧で囲んで、単一の論理項目にします。
[...]	角括弧式は、POSIX 正規表現の場合のように、文字クラスを指定します。

例

次の表に、SIMILAR TO を使用したパターンマッチングの例を示します。

式	戻り値
'abc' SIMILAR TO 'abc'	True
'abc' SIMILAR TO '_b_'	True
'abc' SIMILAR TO '_A_'	False
'abc' SIMILAR TO '%(b|d)%'	True
'abc' SIMILAR TO '(b|c)%'	False
'AbcAbcdefgefg12efgefg12' SIMILAR TO '((Ab)?c)+d((efg)+(12))+'	True
'aaaaaab11111xy' SIMILAR TO 'a{6}_ [0-9]{5}(x|y){2}'	True
'$0.87' SIMILAR TO '$[0-9]+(.[0-9][0-9])?'	True

次の例では、名前に「E」または「H」が含まれる市を見つけます。

SELECT DISTINCT city FROM users
WHERE city SIMILAR TO '%E%|%H%' ORDER BY city LIMIT 5;

      city
-----------------
 Agoura Hills
 Auburn Hills
 Benton Harbor
 Beverly Hills
 Chicago Heights

次の例では、デフォルトのエスケープ文字列 ('\\') を使用して「_」を含む文字列を検索します。

SELECT tablename, "column" FROM pg_table_def
WHERE "column" SIMILAR TO '%start\\_%'
ORDER BY tablename, "column" LIMIT 5;

        tablename         |       column
--------------------------+---------------------
 stcs_abort_idle          | idle_start_time
 stcs_abort_idle          | txn_start_time
 stcs_analyze_compression | start_time
 stcs_auto_worker_levels  | start_level
 stcs_auto_worker_levels  | start_wlm_occupancy

次の例では、エスケープ文字列として '^' を指定し、エスケープ文字列を使用して「_」を含む文字列を検索します。

SELECT tablename, "column" FROM pg_table_def
WHERE "column" SIMILAR TO '%start^_%' ESCAPE '^'
ORDER BY tablename, "column" LIMIT 5;

        tablename         |       column
--------------------------+---------------------
 stcs_abort_idle          | idle_start_time
 stcs_abort_idle          | txn_start_time
 stcs_analyze_compression | start_time
 stcs_auto_worker_levels  | start_level
 stcs_auto_worker_levels  | start_wlm_occupancy