4.1. 語彙の構成

4.1.2.1. 文字列定数

SQLにおける文字列定数は、単一引用符（'）で括られた任意の文字の並びです。 例えば、'This is a string'です。 文字列定数内の単一引用符の記述方法は、2つ続けて単一引用符を記述することです。 例えば、'Dianne''s horse'です。 二重引用符(")とは同一ではない点に注意してください。

2つの文字列定数が、少なくとも1つの改行を含んだ空白で区切られている場合は、2つの定数は連結されて、あたかも1つの定数として書かれたように効率的に処理されます。 例を示します。

SELECT 'foo'
'bar';

は、

SELECT 'foobar';

と同じです。しかし、

SELECT 'foo'      'bar';

は有効な構文ではありません （このちょっとした奇妙な振舞いはSQLで決められているもので、PostgreSQLではこの標準に従っています）。

PostgreSQLでは、また、"エスケープ"文字定数をを受け付けます。 これは標準SQLの拡張です。 エスケープ文字定数は、開始単一引用符の直前にE(大文字でも小文字でもかまいません)を記述することで指定されます。 例えばE'foo'です。 （複数行に渡るエスケープ文字定数では、最初の開始引用符の前にのみEを記述してください。） エスケープ文字列の中では、バックスラッシュ文字（\）によりC言語のようなバックスラッシュシーケンスが始まります。 バックスラッシュと続く文字の組み合わせが特別なバイト値を表現します。 \bは後退（バックスペース）を、\fは改頁を、\nは改行を、\rは復帰（キャリッジリターン）を、\tはタブを表します。 また、\digitsという形式もサポートし、digitsは8進数バイト値を表します。 \xhexdigitsという形式では、hexdigitsは16進数バイト値を表します。 （作成するバイトの並びがサーバの文字セット符号化方式として有効かどうかはコード作成者の責任です。） ここに示した以外のバックスラッシュの後の文字はそのまま解釈されます。 したがって、バックスラッシュ文字を含めるには、2つのバックスラッシュ（\\）を記述してください。 また、通常の''という方法以外に、\'と記述することで単一引用符をエスケープ文字列に含めることができます。

文字列定数内にはコード0の文字を含めることはできません。

4.1.2.2. ドル記号で引用符付けされた文字列定数

SQLにおける文字列定数の指定構文はたいていの場合便利ですが、対象とする文字列内に多くの単一引用符やバックスラッシュがあると、それらを全て二重にしなければなりませんので理解しづらくなります。 こうした状況においても問い合わせの可読性をより高めるためにPostgreSQLは、"ドル引用符付け"という他の文字列定数の指定方法を提供します。 ドル引用符付けされた文字列定数は、ドル記号（$）、省略可能な0個以上の文字からなる"タグ"、ドル記号、文字列定数を構成する任意の文字の並び、ドル記号、この引用符付けの始めに指定したものと同じタグ、ドル記号から構成されます。 例えば、"Dianne's horse"という文字列をドル引用符付けを使用して指定する方法には、以下の2つがあります。

$$Dianne's horse$$
$SomeTag$Dianne's horse$SomeTag$

ドル引用符付けされた文字列は既にエスケープされていますので、文字列定数は全てそのまま記述することができます。 その並びが開始タグに一致しない限り、バックスラッシュもドル記号も特別なものではありません。

各入れ子レベルに異なるタグを付けることで、ドル引用符付けされた文字列を入れ子にすることができます。 これは、関数定義を作成する時に非常によく使用されます。 以下に例を示します。

$function$
BEGIN
    RETURN ($1 ~ $q$[\t\r\n\v\\]$q$);
END;
$function$

ここで、$q$[\t\r\n\v\\]$q$は、ドル引用符付けされた[\t\r\n\v\\]リテラル文字列を表し、PostgreSQLがこの関数本体を実行する時に認識されます。 しかし、この並びは、外側のドル引用符用の区切り文字$function$に一致しませんので、外側の文字列を対象としている場合は単なる文字の並びとなります。

もしあれば、ドル引用符付けされた文字列のタグは、引用符付けされていない識別子と同じ規則に従います。 ただし、タグにはドル記号を含めることはできません。 タグは大文字小文字を区別します。 したがって、$tag$String content$tag$は正しいのですが、$TAG$String content$tag$は間違いです。

キーワードや識別子の後にドル引用符付けされた文字列を続ける場合は、空白でそれを区切らなければなりません。 さもないと、ドル引用符の区切り文字は、直前の識別子の一部として解釈されます。

ドル引用符付けは、標準SQLで定義されていません。 しかし、複雑な文字列リテラルを記述する場合は標準準拠の単一引用符構文よりも便利なことがよくあります。 特に、他の定数の内部に文字列定数を記述するような場合は役に立ちます。 こうした状況は手続き関数の定義でよく必要とされます。 単一引用符構文では、上の例のバックスラッシュはそれぞれ、4個のバックスラッシュで記述しなければなりません。 この4つのバックスラッシュは、元の文字列定数を解析する際に2つに減少され、そして、関数を実行する際に内部の文字列定数が再解析され1つに減少します。

4.1.2.3. ビット文字列定数

ビット文字列定数はB（大文字もしくは小文字）が引用符の始まりの前に付いている（間に空白はありません）通常の文字列定数のように見えます。 例えばB'1001'のようになります。 ビット文字列定数の中で許可される文字は0と1のみです。

その他にも、ビット文字列定数はX'1FF'といった具合に、先頭にX（大文字または小文字）を使用して16進表記で指定することもできます。 この表記は、各16進数値をそれぞれ4つの2進数値に置き換えたビット文字列定数と同等です。

どちらの形式のビット文字列定数でも、通常の文字列定数と同じように複数行にわたって続けて書くことができます。 ドル引用符付けはビット文字列定数では使用できません。

4.1.2.4. 数値定数

数値定数は下記の一般的な形で受け付けられます。

digits
digits.[digits][e[+-]digits]
[digits].digits[e[+-]digits]
digitse[+-]digits

ここでdigitsは1つ以上の10進数字（0〜9）です。 小数点を使用する場合は、少なくとも1つの数字が小数点の前か後になくてはなりません。 指数記号eの付く形式を使う場合にはeの後に少なくとも1つの数字がなければいけません。 空白や他の文字は、定数の中に埋め込むことはできません。 プラスまたはマイナスの符号を先頭につけても、定数の一部とはみなされないことに注意してください。 これらの符号は定数に適用される演算子とみなされます。

下記は有効な数値定数のいくつかの例です。

42
3.5
4.
.001
5e2
1.925e-3

小数点も指数も含まない数値定数の場合、まずその値がinteger型（32ビット）に適合すればinteger型であるとみなされます。 そうでない場合、bigint型（64ビット）で適合すればbigint型とみなされます。 どちらでもない場合は、numeric型とみなされます。 定数が小数点または指数あるいはその両方を含む場合は、常に最初にnumeric型であるとみなされます。

数値定数に最初に割り振られるデータ型は、型解決アルゴリズムの開始点に過ぎません。 ほとんどの場合、定数には文脈に基づいて自動的に正しい型が割り振られます。 必要であれば、特定のデータ型をキャストして、数値がそのデータ型として解釈されるように強制することができます。 例えば、以下のようにして数値をreal型（float4）として処理することができます。

REAL '1.23'  -- 文字列書式
1.23::REAL   -- （歴史的な）PostgreSQL書式

実のところ、これらは以下で説明する一般的なキャスト記法の特別な場合です。

4.1.2.5. 他の型の定数

任意の型の定数は下記の表記のいずれかを使って入力することができます。

type 'string'
'string'::type
CAST ( 'string' AS type )

文字列定数のテキストはtypeと呼ばれる型の入力変換ルーチンへと渡されます。 結果は指示された型の定数です。 明示的な型キャストは、定数がどの型でなければならないかについて曖昧な点がなければ（例えば定数が直接テーブル列に代入されている場合）省略しても構いません。 その場合自動的に型強制されます。

文字列定数は通常のSQL記法でもドル引用符付けでも記述することができます。

関数のような構文を使って型強制を指定することも可能です。

typename ( 'string' )

しかし、全ての型の名前でこの方法は使用できるというわけではありません。 詳細は項4.2.8を参照してください。

::、CAST()や関数呼び出し構文も、項4.2.8で説明する通り、任意の式の実行時の型変換を指定するために使うことができます。 しかし、構文的なあいまいさをなくすために、type 'string'という形式は単なるリテラル定数を指定する場合にのみ使うことができます。 この他type 'string'構文には、配列型では動作しないという制限があります。 配列型の定数を指定する場合は::かCAST()を使用してください。

CAST()構文はSQLに従っています。 type 'string'構文は、標準を一般化したものです。 SQLでは、この構文を数個のデータ型でのみ規定しています。 しかし、PostgreSQLではすべての型で使用することができます。 ::付きの構文は、関数呼び出し構文と同様に歴史的にPostgreSQLで使用されてきました。