Amazon Redshift: 検索パス(search_path)とSQL実行時のスキーマ名指定有無の関連性について

超小ネタ＆うっかりすると混乱を招く事もあるな〜と思い、備忘録としてこのエントリを書き出しておきます。Amazon Redshiftの『検索パス』にまつわるお話です。

検索パス(search_path)にまつわるお話

言いたい事はタイトルで言い切った感があるので、そこに至った経緯を。

Amazon Redshiftでは、『検索パス(search_path)』という設定項目があります。この情報は、Redshiftクラスタがスキーマを探す際にその内容と順番を定義しておくものとなります。

• Amazon Redshiftで新規追加したスキーマを検索パスに含める ｜ Developers.IO

上記エントリでも言及しているように、新しくスキーマを作成した際はそのスキーマも定義しておかないと何かと不便ですよ、というのはまずあるかなと思います。

検索パス(search_path)の設定とスキーマ名の未指定で起こりうる問題

そして、今回遭遇したケースがここで紹介する内容となります。

パラメータグループ新規作成時、またデフォルトのパラメータグループについては、以下の様にスキーマが定義されており、

# show search_path;
  search_path                               
---------------
 $user, public
(1 row)

特に意識しなければ、新規にスキーマを作成した後は以下のようにpublicスキーマの後に新たにスキーマを追記しておくと思います。

# show search_path;
      search_path                               
---------------------------
 $user, public, cm_public
(1 row)

ですがここで、publicスキーマより前に別のスキーマ名が設定がされており、

# show search_path;
      search_path                               
---------------------------
 cm_public, $user, public
(1 row)

且つ、テーブル作成等でスキーマが指定されていないとどうなるでしょうか？

CREATE TABLE testtable (
  id INT NOT NULL,
  name VARCHAR(10) NOT NULL
);

実行者的にはスキーマ未指定=publicだと思っていても、以下の様にpublicスキーマでは無く、cm_publicスキーマにテーブルが作成されてしまうのです。

# SELECT COUNT(*) FROM public.testtable;
ERROR:  relation "public.testtable" does not exist
# SELECT COUNT(*) FROM testtable;
 count 
-------
     0
(1 行)
# \d testtable;
            テーブル "cm_public.testtable"
  列  |      型               |  修飾語  
------------------------------+--------------+----------
 id   | integer               | not null
 name | character varying(50) | not null

AWSの公式ドキュメントにも、以下のような記載があります。参照だけでなく、あらゆる場面でスキーマが未指定だった場合にこの情報を辿る訳ですね。

• スキーマ - Amazon Redshift

勉強になりました！

まとめ

という訳でまとめ。

 　　　　　　r　‐､
　 　　　　　| ○ | 　　　 　  r‐‐､ 　　　　良い子の諸君！
　　　　　_,;ﾄ - ｲ、　　　　　∧l☆│ ∧ 　　
　　　 （⌒`　　　 ⌒ヽ　　　/,ﾄ.-ｲ/,l　　RedshiftにSQLアクセスする際は
　　　　|ヽ　 ~~⌒γ⌒）　r'⌒｀!´ `⌒）　ちゃんとスキーマ名も付与しておこう。
　　　 │　ヽー―'^ー-'　（  ⌒γ⌒~~　/| 　
　　　 │　　〉　　　| │　|｀ー^ｰ―  r'| 　search_pathの状況によっては
　　　 │　 /───────|  | |/ |  l　 ﾄ､|　 意図しない結果を招く事もあるぞ。
　　　|　 irｰ-､ ｰ　,}  |　 / 　　　i 　　
　　　| /　　　｀X´　ヽ 　/ 　 入　 |

追記：

半ば勢いで書いてしまいましたが、1つのクラスタで複数環境を整え(開発/検証/本番)、それらの環境間での利便性を考えて敢えてスキーマ名を指定しないケース、また『DDL系のものはスキーマ名を付けるけどそれ以外は...』というケースもある事を考えると、この辺りはトレードオフを考えて...というのもあるかも知れません。こういうケースもあるよ、という事でこのネタは心の片隅に置いといてもらえますと幸いです。