日々の記録 別館

バイナリ形式COPY文の怪

ちょっと仕事の関係でバイナリフォーマットをCOPYしようと思って気がついたこと。
(環境はPostgreSQL 9.1.2)

PostgreSQLのCOPY文ではOPTIONでFOMATの指定が可能なのだが、text, csvは普通に記述できるけど、binaryを書くとsyntaxエラーになってしまう。(´・ω・｀)

db=# COPY foo FROM STDIN WITH ( FORMAT binary );
ERROR:  syntax error at or near "binary"

もちろんtextやcsvはそのまま記述可能。

db=# COPY foo FROM STDIN WITH ( FORMAT text );
Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself.
>>

binaryの場合は二重引用符で引用しないと駄目っぽい。

db=# COPY foo FROM STDIN WITH ( FORMAT "binary" ););
Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself.
>>

これは一体どういうことなのか・・・。PostgreSQL文書のCOPYのページにも、特にbinaryのときには二重引用符で引用しなければならない、とは記述がない。
ちょいと不思議な気がしたので、PostgreSQL文書のSQLキーワードのページを見ると・・・

binary	予約（関数または型として使用可）
csv	未予約
text	未予約

となっている。そう、binaryだけキーワードの扱いが違うのだ。
逆に言えば、csvやtextというトークンは実はそのまま名標に書けるということだ。どういうことかと言うと、csvという名前のカラムやtextという名前のテーブルが作成できるということ。binaryという名前は引用しないとそういうことは出来ない。

こうなった経緯は良くわからなかったが、PostgreSQL - bugs - COPY .... WITH (FORMAT binary) causes syntax error at or near "binary" | Threaded Viewを流し読みした感じでは旧バージョン(7.3以前)との互換性などが関係しているようだ。

過去の経緯はともかくとして、とりあえずのPostgreSQL文書COPYのページには「binaryは二重引用符で括らないと駄目よ」という注意書きを書いて欲しいなあと思うのであった。

Permalink | コメント(2) | トラックバック(0) | 14:27