Edit of ALTER TABLE - Firebird Wiki

[[FrontPage]]へ~
-[[リファレンスガイド]]へ~
--[[Firebird SQLリファレンス]]へ~
&br;
----
*Firebird SQL リファレンス:ALTER TABLE, CREATE DOMAIN, ALTER DOMAIN, DROP DOMAIN [#kcb4e585]

#contents

----
&br;
&aname(alter_table);
*ALTER TABLE [#z6a25d65]
　テーブルに変更を加えます。列や制約の追加・削除・変更が行えます。
SQL,DSQL,isqlで使用できます。~
　この文書は、公開されているIB6のSQLレファレンスを基とし、1.5.1までの
各リリースノートにおける追加内容に関して反映・統合されています。~

**構文 [#ffcf3b20]

ALTER TABLE table <operation> [, <operation> …];

<operation> = {ADD <col_def>
     | ADD <tconstraint>
     | ALTER [COLUMN] column_name <alt_col_clause>
     | DROP col
     | DROP CONSTRAINT constraint}

<alt_col_clause> = {TO new_col_name
     | TYPE new_col_datatype
     | POSITION new_col_position}

&br;
列の定義:
 <col_def> = col {<datatype> | COMPUTED [BY] (<expr>) | domain}
     [DEFAULT {literal | NULL | USER}]
     [NOT NULL] [<col_constraint>] [COLLATE collation]

&br;
データタイプ:
 <datatype> =
     {SMALLINT | INTEGER | BIGINT | FLOAT | DOUBLE PRECISION}
         [<array_dim>]
     | {DATE | TIME | TIMESTAMP} [<array_dim>]
     | {DECIMAL | NUMERIC} [(precision [, scale])] [<array_dim>]
     | {CHAR | CHARACTER | CHARACTER VARYING | VARCHAR} [(int)]
         [<array_dim>] [CHARACTER SET charname]
     | {NCHAR | NATIONAL CHARACTER | NATIONAL CHAR}
         [VARYING] [(int)] [<array_dim>]
     | BLOB [SUB_TYPE {int | subtype_name}] [SEGMENT SIZE int]
         [CHARACTER SET charname]
     | BLOB [(seglen [, subtype])]

<array_dim> = [[x:]y [, [x:]y …]]

&br;
列制約:
 <col_constraint> = [CONSTRAINT constraint]
     { UNIQUE
         | PRIMARY KEY
         | REFERENCES other_table [(other_col [, other_col …])]
             [ON DELETE {NO ACTION|CASCADE|SET DEFAULT|SET NULL}]
             [ON UPDATE {NO ACTION|CASCADE|SET DEFAULT|SET NULL}]
         | CHECK (<search_condition>)
     }

&br;
表制約:
 <tconstraint> = [CONSTRAINT constraint]
     { {PRIMARY KEY | UNIQUE} (col [, col …])
     | FOREIGN KEY (col [, col …]) REFERENCES other_table
         [ON DELETE {NO ACTION|CASCADE|SET DEFAULT|SET NULL}]
         [ON UPDATE {NO ACTION|CASCADE|SET DEFAULT|SET NULL}]
     | CHECK (<search_condition>)}

&br;
 <search_condition> = <val> <operator> {<val> | (<select_one>)}
     | <val> [NOT] BETWEEN <val> AND <val>
     | <val> [NOT] LIKE <val> [ESCAPE <val>]
     | <val> [NOT] IN (<val> [, <val> …] | <select_list>)
     | <val> IS [NOT] NULL
     | <val> {>= | <=}
     | <val> [NOT] {= | < | >}
     | {ALL | SOME | ANY} (<select_list>)
     | EXISTS (<select_expr>)
     | SINGULAR (<select_expr>)
     | <val> [NOT] CONTAINING <val>
     | <val> [NOT] STARTING [WITH] <val>
     | (<search_condition>)
     | NOT <search_condition>
     | <search_condition> OR <search_condition>
     | <search_condition> AND <search_condition>

<val> = {
        col [<array_dim>] | :variable
        | <constant> | <expr> | <function>
        | udf ([<val> [, <val> …]])
        | NULL | USER | RDB$DB_KEY | ?
     }
     [COLLATE collation]

<constant> = num | 'string' | charsetname 'string'

<operator> = {= | < | > | <= | >= | !< | !> | <> | !=}

<expr> = １つの値を返すSQL式

<select_one> = １つの列・値を返すSELECT

<select_list> = １つの列で、0あるいは複数行のリストを返すSELECT

<select_expr> = 0あるいは複数行の値のリストを返すSELECT
&br;

&br;
※　DSQLで使用する場合、終端文字のセミコロンは不要です。
isql及びC/C++の埋め込みSQLでは行の終わりを示すために終端文字は必要です。
&br;

-文法の補足~
　基本的には、[[CREATE TABLE>CREATE TABLE#create_table]] と同様なことが
多いので、不明瞭な場合はそちらを参照して下さい。~
&br;

--BLOB列に対するCOLLATE~
　BLOBの列に対してはCOLLATEを指定することは出来ません。~
&br;

--配列(<array_dim>)~
　配列を宣言する場合最も外側のブラケットを含まなければなりません。
例えば、次の文では、長さ6文字の文字列で構成される5×5の二次元配列になります。
 my_array = varchar(6)[5,5]
　添え字の開始値が１以外の配列を指定するにはコロン(:)を使用してください。
次の例では、10で始まり20で終わる整数型の配列となります。
 my_array = integer[10:20]
&br;

**詳細の説明 [#i2a3ffd5]
　ALTER TABLE により、既存のテーブル(表)の構造を変更することが出来ます。
また、１つの ALTER TABLE 文により、複数の追加や削除を行えます。~
&br;
-テーブルに対して ALTER TABLE を実行できるのは、作成者、SYSDBAユーザー、
もしくは OS の管理者権限を持ったユーザーのみです。~
&br;
-操作の指定が、テーブルのPRIMARY KEYやUNIQUE制約などに当たる場合、
ALTER TABLEは失敗します。例えば、次のような削除を行った場合です。
--指定列に UNIQUE,PRIMARY,FOREIGN KEY 制約がある場合。
--指定列が(訳注:他の列の)CHECK制約で使用されている場合。
--指定列が、評価式や計算型の列で使用されている場合。
--指定列が、ビューなど他のデータベースオブジェクトから参照されている場合。
-列の削除(DROP)を行った場合、格納されたデータはすべて失われます。~
&br;

-参照制約に関して~
--FOREIGN KEY による参照制約においてデータの完全性維持を保証するために、
すべての REFERENCES 文に対して ON UPDATE や ON DELETE オプションを指定
しましょう。
--ON UPDATE,ON DELETEの指定を行わなかった場合、列を削除する前に制約の削除や
計算型の列の削除を行わなければなりません。
FOREIGN KEY(外部キー)で参照されている PRIMARY KEY や UNIQUE 制約を削除する
前には、必ずそれらを参照している FOREIGN KEY を削除する必要があります。
--テーブル所有者(作成者)の GRANT により、あるテーブルに対する REFFERENCES
特権を与えられているならば、そのテーブルに対する FOREIGN KEY による参照制約
を作成することが出来ます。他のユーザーが外部キーを設定されたテーブルを更新
する場合、参照するプライマリーなキーテーブルに対する REFERENCES もしくは
SELECT 特権を持っている必要があります。
--ドメイン指定にもCHECK制約を加えられますが、その変更にサブクエリを使用して
いるものに対しCHECK制約を設定する場合、制約妨害を引き起こす可能性があります。
--オプションで、列制限に名前を指定することが可能です。名前を指定しない場合
は、システムは、自動的生成される名前を割当てます。(訳注:システムテーブルの
RDB$RELATION_CONSTRAINTS に格納される一意な名前を割当てます。)
制約に名前を指定しておけば、変更や削除により制約妨害のエラーメッセージに
名前が出るので、原因の特定が容易になります。~
&br;

**用例 [#fd23d411]
すべて isql での例です。テーブルCOUNTRYに対して処理を行います。~
&br;
-テーブルに対する列の追加と削除を行っています。CURRENCY列のデータはすべて
失われます。

ALTER TABLE COUNTRY
   ADD CAPITAL VARCHAR(25),
   DROP CURRENCY;

&br;
-２つの列を追加していますが、片方には UNIQUE 制約を付与しています。

ALTER TABLE COUNTRY
   ADD CAPITAL VARCHAR(25) NOT NULL UNIQUE,
   ADD LARGEST_CITY VARCHAR(25) NOT NULL;

&br;
-LARGEST_CITY 列の名前を BIGGEST_CITY に変更します。

ALTER TABLE COUNTRY ALTER LARGEST_CITY TO BIGGEST_CITY;
&br;

**参照 [#i230729d]
　[[ALTER DOMAIN>#alter_domain]] , [[CREATE DOMAIN>#create_domain]] ,
[[CREATE TABLE>CREATE TABLE#create_table]]~
&br;
　これ以上の情報が欲しい場合は、Embedded SQL Guide の altering tables
の項を参照して下さい。~

&br;
&br;
----
&br;
&br;
&aname(create_domain);
*CREATE DOMAIN [#x5df2d22]
　データベースでグローバルな、列定義を作成します。
SQL,DSQL,isql で使用できます。~
　この文書は、公開されているIB6のSQLレファレンスを基とし、1.5.1までの
各リリースノートにおける追加内容に関して反映・統合されています。~

**構文 [#e0c67f8a]

CREATE DOMAIN domain [AS] <datatype>
     [DEFAULT {literal | NULL | USER}]
     [NOT NULL] [CHECK (<dom_search_condition>)]
     [COLLATE collation];

<datatype> =
     {SMALLINT | INTEGER | BIGINT | FLOAT | DOUBLE PRECISION}
         [<array_dim>]
     | {DATE | TIME | TIMESTAMP} [<array_dim>]
     | {DECIMAL | NUMERIC} [(precision [, scale])] [<array_dim>]
     | {CHAR | CHARACTER | CHARACTER VARYING | VARCHAR} [(int)]
         [<array_dim>] [CHARACTER SET charname]
     | {NCHAR | NATIONAL CHARACTER | NATIONAL CHAR}
         [VARYING] [(int)] [<array_dim>]
     | BLOB [SUB_TYPE {int | subtype_name}] [SEGMENT SIZE int]
         [CHARACTER SET charname]
     | BLOB [(seglen [, subtype])]

<array_dim> = [[x:]y [, [x:]y …]]

<dom_search_condition> = {
     VALUE <operator> value
     | VALUE [NOT] BETWEEN value AND value
     | VALUE [NOT] LIKE value [ESCAPE value]
     | VALUE [NOT] IN (value [, value …])
     | VALUE IS [NOT] NULL
     | VALUE [NOT] CONTAINING value
     | VALUE [NOT] STARTING [WITH] value
     | (<dom_search_condition>)
     | NOT <dom_search_condition>
     | <dom_search_condition> OR <dom_search_condition>
     | <dom_search_condition> AND <dom_search_condition>
 }

<operator> = {= | < | > | <= | >= | !< | !> | <> | !=}

&br;
-文法の補足~
--BLOB列に対するCOLLATE~
　BLOBの列に対してはCOLLATEを指定することは出来ません。~
&br;
--配列(<array_dim>)~
　配列を宣言する場合最も外側のブラケットを含まなければなりません。
例えば、次の文では、長さ6文字の文字列で構成される5×5の二次元配列になります。
 my_array = varchar(6)[5,5]
　添え字の開始値が１以外の配列を指定するにはコロン(:)を使用してください。
次の例では、10で始まり20で終わる整数型の配列となります。
 my_array = integer[10:20]

**詳細の説明 [#c2795d25]
　CREATE DOMAIN により、CREATE TABLE や ALTER TABLE で使用できる、継承可能な
列定義のテンプレートを作成します。ドメイン定義には、以下のものを含むことが
出来ます。
--データ型
--デフォルト値(オプション)
--NULL値禁止(オプション)
--CHECK制約(オプション)
--コレーションオーダー(オプション)

&br;
　ドメイン定義での CHECK 制約は、ドメインに入力された値がdom_search_condition
の条件で真のときに値が入力可能となります。CHECK制約は、他のドメインや列の値を
参照することは出来ません。~
※ドメイン定義の中で制約と矛盾のあるものを作成しないように注意してください。
例えば、NOT NULL 制約があるのにデフォルト値が NULL であるものなどです。~
&br;

ドメイン定義で、CHAR や VARCHAR のようなテキスト用データ型の場合、
CHARACTER SET 節によりキャラクタセットの指定が出来ます。指定を行わなかった
場合、ドメインはデータベースのデフォルトキャラクタセットを使用します。~
&br;

デフォルトキャラクタセットを指定しない場合、それはNONEと設定されます。
NONEが設定された場合、特定のキャラクタセットがないと仮定されます。つまり
格納したデータがそのままの形で格納されます。~
　NONEと設定された列には、あるゆるキャラクタセットのデータが格納できます。
しかし、そこにロードされたデータを、キャラクタセットが指定された別の列に
対してロードすることは出来ません。このようなことを行った場合、文字変換が
正しく行われずにエラーが発生するかもしれません。~
&br;

COLLATE節は、CHAR、VARCHAR、BLOB(テキスト)などのテキスト用列のための
コレーションオーダー(訳注:ソート時の順序に影響する)を指定します。指定は、
列が"持っている"キャラクタセット(データベースのデフォルトキャラクタセット
もしくは列の型定義時に指定したキャラクタセット)のみが指定できます。~
&br;

列の定義にドメインを使用した場合、どれはドメインのすべての特性を継承
します。そのとき、ドメインのデフォルト値、コレーション、NOT NULL の設定
は新しいものに変更(上書き)することが可能です。また、その列に対して追加の
CHECK制約を設定することも出来ます。~
&br;

**用例 [#yc75766b]
すべて isqlでの例です。~
&br;
-デフォルト値9999で、VALUE>1000というCHECK制約付きのドメインを作成します。
ここでのVALUEは、その列に設定しようとしている値を示すプレースホルダーです。
 CREATE DOMAIN CUSTNO
   AS INTEGER
   DEFAULT 9999
   CHECK (VALUE > 1000);

&br;
-指定した４つの値以外は入らないドメインを作成します。
 CREATE DOMAIN PRODTYPE
   AS VARCHAR(12)
   CHECK (VALUE IN ('software', 'hardware', 'other', 'N/A'));

&br;
-CHAR データ型の配列が定義されたドメインを作成します。
 CREATE DOMAIN DEPTARRAY AS CHAR(31) [4:5];

-一連の動作のサンプルです。デフォルト値として現在のユーザー名が格納される
ドメイン作成後に、そのドメインを使用してテーブルを作成、値を入力しています。
 CREATE DOMAIN USERNAME AS VARCHAR(20) DEFAULT USER;
 
 CREATE TABLE ORDERS (ORDER_DATE DATE, ENTERED_BY USERNAME,
   ORDER_AMT DECIMAL(8,2));
 
 INSERT INTO ORDERS (ORDER_DATE, ORDER_AMT)
   VALUES ('1-MAY-93', 512.36);
　INSERT の実行により、列 ENTERRED_BY には、データベースエンジンにより自動的
に現在のユーザー名が設定されます。現在のユーザー名が JSMITH であった場合、
SELECTでは次のような行が表示されるはずです。~
&br;
SELECT:
 SELECT * FROM ORDERS;
行表示:
 1-MAY-93 JSMITH 512.36

&br;
-TEXTサブタイプを持つBLOBのドメイン作成しています。キャラクタセットの指定も
行っています。
 CREATE DOMAIN DESCRIPT AS
   BLOB SUB_TYPE TEXT SEGMENT SIZE 80
   CHARACTER SET SJIS;
&br;

**参照 [#x4952adf]
　[[ALTER DOMAIN>#alter_domain]] , [[ALTER TABLE>#alter_table]] ,
[[CREATE TABLE>CREATE TABLE#create_table]] , [[DROP DOMAIN>#drop_domain]]~
&br;
　これ以上の情報が欲しい場合は、Data Definition Guideの
character set specification([[キャラクタセット・データ型・権限]]) と、
collation orders を参照して下さい。

&br;
&br;
----
&br;
&br;
&aname(alter_domain);
*ALTER DOMAIN [#iaf0cb1f]
　ドメインの定義内容を変更します。
SQL,DSQL,isql で使用できます。

**構文 [#kbfec3f9]

ALTER DOMAIN name {
     SET DEFAULT {literal | NULL | USER}
     | DROP DEFAULT
     | ADD [CONSTRAINT] CHECK (<dom_search_condition>)
     | DROP CONSTRAINT | new_col_name
     | TYPE datatype
 };

<operator> = {= | < | > | <= | >= | !< | !> | <> | !=}

&br;
※　DSQLで使用する場合、終端文字のセミコロンは不要です。
isql及びC/C++の埋め込みSQLでは行の終わりを示すために終端文字は必要です。
&br;

**詳細の説明 [#ld39eb0f]
　ALTER DOMAIN により、既存ドメインの NOT NULL 設定などの内容を変更できます。
ドメインに対して行われる変更は、テーブルレベルで上書きされていない限り、
すべてのテーブルのドメインを指定した列に対して影響を及ぼします。~
※ドメインのデータ型や NOT NULL の設定を変更した場合、ドメインは削除した後に
再作成と同様なことが行われます。~
&br;
　ドメインの内容変更が出来るのは、作成者またはSYDBAユーザー、またはOSの管理者
権限を持ったユーザーのみです。~
&br;

**用例 [#hca2413a]
isqlでの例です。作成したドメインのデフォルト値設定を 9,999 に変更しています。

CREATE DOMAIN CUSTNO AS INTEGER CHECK (VALUE > 1000);
 
 ALTER DOMAIN CUSTNO SET DEFAULT 9999;

**参照 [#u25ee149]
　[[CREATE DOMAIN>#create_domain]] ,
[[CREATE TABLE>CREATE TABLE#create_table]] ,
[[DROP DOMAIN>#drop_domain]]~
&br;
　すべての情報を得るためには、Data Definition Guide の、creating domains と
using them to create column definitions を参照して下さい。~

&br;
&br;
----
&br;
&br;
&aname(drop_domain);
*DROP DOMAIN [#i1934cde]
　データベースからドメインを削除します。
SQL,DSQL,isql で使用できます。~

**構文 [#dcb7b6fe]

DROP DOMAIN name;

&br;
※　DSQLで使用する場合、終端文字のセミコロンは不要です。
isql及びC/C++の埋め込みSQLでは行の終わりを示すために終端文字は必要です。
&br;
|引数|説明|h
|name|既存のドメイン名|
&br;

**詳細の説明 [#i0be99ba]
　DROP DOMAIN により、既存のドメインをデータベースから削除します。~
&br;
　ドメインが現在列の定義で使用されている場合、DROP 操作は失敗します。
このような場合は、ALTER TABLEによりドメインを使用している列を取り除いた後
に DROP DOMAIN を実行する必要があります。~
&br;
　ドメインを削除が出来るのは、作成者またはSYDBAユーザー、またはOSの管理者
権限を持ったユーザーのみです。~
&br;

**用例 [#mcee74ac]
　isql でドメインの削除をします。

DROP DOMAIN COUNTRYNAME;
&br;

**参照 [#q4d4e86d]
　[[ALTER DOMAIN>#alter_domain]] , [[ALTER TABLE>#alter_table]] ,
[[CREATE DOMAIN>#create_domain]]~
&br;

タイムスタンプを変更しない

テキスト整形のルールを表示する

Edit of ALTER TABLE[TOC]