CREATE | ALTER TABLE ... CONSTRAINT¶

インライン制約の構文¶

CREATE TABLE <name> ( <col1_name> <col1_type>    [ NOT NULL ] { inlineUniquePK | inlineFK }
                     [ , <col2_name> <col2_type> [ NOT NULL ] { inlineUniquePK | inlineFK } ]
                     [ , ... ] )

ALTER TABLE <name> ADD COLUMN <col_name> <col_type> [ NOT NULL ] { inlineUniquePK | inlineFK }

条件：

inlineUniquePK ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE | PRIMARY KEY }
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]

Copy

inlineFK :=
  [ CONSTRAINT <constraint_name> ]
  [ FOREIGN KEY ]
  REFERENCES <ref_table_name> [ ( <ref_col_name> ) ]
  [ MATCH { FULL | SIMPLE | PARTIAL } ]
  [ ON [ UPDATE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]
       [ DELETE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ] ]
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]

Copy

行外制約の構文¶

CREATE TABLE <name> ... ( <col1_name> <col1_type>
                         [ , <col2_name> <col2_type> , ... ]
                         [ , { outoflineUniquePK | outoflineFK } ]
                         [ , { outoflineUniquePK | outoflineFK } ]
                         [ , ... ] )

ALTER TABLE <name> ... ADD { outoflineUniquePK | outoflineFK }

条件：

outoflineUniquePK ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE | PRIMARY KEY } ( <col_name> [ , <col_name> , ... ] )
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]
  [ COMMENT '<string_literal>' ]

Copy

outoflineFK :=
  [ CONSTRAINT <constraint_name> ]
  FOREIGN KEY ( <col_name> [ , <col_name> , ... ] )
  REFERENCES <ref_table_name> [ ( <ref_col_name> [ , <ref_col_name> , ... ] ) ]
  [ MATCH { FULL | SIMPLE | PARTIAL } ]
  [ ON [ UPDATE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]
       [ DELETE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ] ]
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]
  [ COMMENT '<string_literal>' ]

Copy

制約のプロパティ¶

他のデータベースとの互換性や、ハイブリッドテーブルでの使用のために、Snowflakeは制約プロパティを提供します。制約に指定できるプロパティは、タイプによって異なります。

• 一部のプロパティはすべてのキー（一意、プライマリ、および外部）に適用されます。

• 他のプロパティは外部キーにのみ適用されます。

サポートされている制約プロパティのほとんどは、 ANSI SQL 標準プロパティですが、以下のプロパティは Snowflake 拡張です。

• ENABLE | DISABLE

• VALIDATE | NOVALIDATE

• RELY | NORELY

また、行外制約定義内でコメントを定義することもできます。 制約に対するコメント をご参照ください。

[ NOT ] ENFORCED
[ NOT ] DEFERRABLE
INITIALLY { DEFERRED | IMMEDIATE }
{ ENABLE | DISABLE }
{ VALIDATE | NOVALIDATE }
{ RELY | NORELY }

MATCH { FULL | SIMPLE | PARTIAL }
ON [ UPDATE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]
   [ DELETE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]

制約に対するコメント¶

他のデータベースオブジェクトや構築と同様に、Snowflakeは制約に対するコメントの提供をサポートしています。

• 行外制約は、制約定義内の COMMENT 句をサポートします。

  CREATE OR REPLACE TABLE uni (c1 INT, c2 int, CONSTRAINT uni1 UNIQUE(C1) COMMENT 'Unique column');
  

  Copy

• カラム定義内の COMMENT 句は、カラム自体やその制約についてコメントするために使用できます。

  CREATE OR REPLACE TABLE uni (c1 INT UNIQUE COMMENT 'Unique column', c2 int);
  

  Copy

以下の制限にご注意ください。

• COMMENT コマンドを使用して制約にコメントを設定することはできません。

• DESCRIBE TABLE コマンドは列に定義されたコメントを表示しますが、制約に定義されたコメントは表示しません。制約に関するコメントを見るには、 TABLE_CONSTRAINTS ビュー または REFERENTIAL_CONSTRAINTS ビュー から選択します。

• 列および制約定義内の COMMENT 句は、等号 （=） をサポートしていません。指定しません。

  COMMENT = 'My comment'
  

  Copy

  前の例で示した構文を使います。

  COMMENT 'My comment'
  

  Copy

使用上の注意¶

• NOT NULL 列が NULL 値を許可しないことを指定します。

  • 標準的なSnowflakeテーブルでは、これが唯一の制約です。 参照整合性制約 をご参照ください。

  • 列定義内のインライン制約としてのみ指定できます。

  • デフォルトでは、列に NULL 値を許可します。

• 複数列の制約（例: 複合一意キーまたは主キー）は、アウトラインでのみ定義できます。

• インラインまたはアウトラインの外部キーを定義する場合、外部キー列と参照先テーブルの主キー列の署名（つまり、名前とデータ型）が完全に一致すれば、参照先テーブルの列名を指定する必要はありません。

• 外部キーを作成する場合、 REFERENCES 句の列は、主キーの列と同じ順序でリストする必要があります。例:

  CREATE TABLE parent ... CONSTRAINT primary_key_1 PRIMARY KEY (c_1, c_2) ...
  CREATE TABLE child  ... CONSTRAINT foreign_key_1 FOREIGN KEY (...) REFERENCES parent (c_1, c_2) ...
  

  Copy

  どちらの場合も、列の順序は c_1, c_2 です。外部キーの列の順序が異なっていた場合（例: c_2, c_1）、外部キーを作成する試みは失敗していました。

アクセス制御の要件¶

主キー制約または一意制約を作成する場合：

• 制約を追加するために既存のテーブルを変更する場合、 OWNERSHIP 権限を持つロールを使用する必要があります。

• 新しいテーブルを作成する際には、テーブルが作成されるスキーマで CREATE TABLE 権限を持つロールを使用する必要があります。

外部キー制約を作成する場合：

• テーブルで OWNERSHIP 権限を持つロールを使用することも必要です。

• 一意/キーテーブルで REFERENCES 権限を持つロールを使用することも必要です。

GRANT <権限> および REVOKE <権限> コマンドを使用して、ロールへのREFERENCES権限の付与および取り消しができます。

GRANT REFERENCES ON TABLE <pk_table_name> TO ROLE <role_name>

REVOKE REFERENCES ON TABLE <pk_table_name> FROM ROLE <role_name>

Copy

標準テーブルを使った例¶

ハイブリッド・テーブルを使用した制約の例については、 CREATE HYBRID TABLE をご参照ください。

以下の例は、テーブルの作成中に単純な NOT NULL 制約を作成し、テーブルの変更中に別の NOT NULL 制約を作成する方法を示しています。

テーブルを作成し、同時に制約を作成します。

CREATE TABLE table1 (col1 INTEGER NOT NULL);

テーブルを変更して、制約付きの列を追加します。

ALTER TABLE table1 ADD COLUMN col2 VARCHAR NOT NULL;

次の例では、列の意図が一意の値を保持することを指定していますが、制約が実際に適用されていないことを明確にします。この例は、制約の名前（この場合は「uniq_col3」）の指定方法も示しています。

ALTER TABLE table1 
  ADD COLUMN col3 VARCHAR NOT NULL CONSTRAINT uniq_col3 UNIQUE NOT ENFORCED;

以下は、主キー制約を持つ親テーブルと、最初のテーブルの主キー制約と同じ列を指す外部キー制約を持つ別のテーブルを作成します。

CREATE TABLE table2 (
  col1 INTEGER NOT NULL,
  col2 INTEGER NOT NULL,
  CONSTRAINT pkey_1 PRIMARY KEY (col1, col2) NOT ENFORCED
);
CREATE TABLE table3 (
  col_a INTEGER NOT NULL,
  col_b INTEGER NOT NULL,
  CONSTRAINT fkey_1 FOREIGN KEY (col_a, col_b) REFERENCES table2 (col1, col2) NOT ENFORCED
);