SET CONSTRAINTS

名前

SET CONSTRAINTS -- 現在のトランザクションの制約検査モードを設定する

概要

SET CONSTRAINTS { ALL | name [, ...] } { DEFERRED | IMMEDIATE }

説明

SET CONSTRAINTSは、現在のトランザクションにおける制約の検査方法を設定します。 IMMEDIATE制約は、1つの文の実行が終わるごとに検査されます。 DEFERRED制約は、トランザクションがコミットされるまで検査されません。 全ての制約は、IMMEDIATEDEFERREDのどちらかのモードを持ちます。

制約にはその生成時点で、DEFERRABLE INITIALLY DEFERREDDEFERRABLE INITIALLY IMMEDIATENOT DEFERRABLEの3つのうちのいずれかの性質が与えられます。 3番目のNOT DEFERRABLE制約は、常にIMMEDIATEモードであり、SET CONSTRAINTSコマンドの影響を受けません。 DEFERRABLE INITIALLY DEFERRED制約とDEFERRABLE INITIALLY IMMEDIATE制約の2つは、トランザクションを指定されたモードで開始しますが、トランザクション内でSET CONSTRAINTSを使用するとその振舞いを変更することができます。

制約名のリストを持ったSET CONSTRAINTSが変更するのは、これらの制約のモードのみです (これらは全て遅延可能です)。 スキーマ名が指定されていない場合、最初に一致する名前を見つけ出すために現在のスキーマ検索パスが使用されます。 SET CONSTRAINTS ALLは遅延可能な全ての制約のモードを変更します。

制約のモードをDEFERREDからIMMEDIATEに変更した場合は、新しい制約モードが遡及的に有効になります。 つまりDEFERREDモードであればトランザクションの終了時に検査される未検査のデータ変更が、SET CONSTRAINTSコマンドの実行中に検査されます。 もし、この時に何らかの制約違反があった場合、SET CONSTRAINTSは失敗します (そして、制約モードは変更されません)。 したがって、SET CONSTRAINTSを利用すれば、トランザクションの特定の時点で強制的に制約の検査を実行することができます。

今のところ、外部キー制約だけがこの設定の影響を受けます。 検査制約や一意性制約の実行が遅延されることはありません。

注釈

このコマンドが変更するのは、現在のトランザクション内の制約の動作のみです。 したがって、トランザクションブロック(BEGIN/COMMITの間)の外部でこのコマンドが実行されても場合、何ら効果はありません。

互換性

このコマンドは、標準SQLで定義された動作に準拠しています。 ただし、PostgreSQLでは適用対象が外部キー制約のみという制限があります。