CREATE DEFAULT (Transact-SQL)
デフォルトと呼ばれるオブジェクトを作成します。 デフォルト (既定値) は、列または別名データ型にバインドされると、明示的な指定がない場合にオブジェクトのバインド先の列 (別名データ型の場合はすべての列) に挿入される値を指定します。
.gif "重要な注意事項") 重要 |
|---|
この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。代わりに、ALTER TABLE または CREATE TABLE の DEFAULT キーワードを使用して作成された既定の定義を使用してください。 |
.gif "トピック リンク アイコン")
構文
CREATE DEFAULT [ schema_name . ] default_name
AS constant_expression [ ; ]
引数
schema_name
デフォルトが所属するスキーマの名前を指定します。default_name
デフォルトの名前です。 デフォルトの名前は、識別子のルールに従っている必要があります。 デフォルトの所有者名の指定は省略可能です。constant_expression
定数値のみを含む式を指定します (列名や他のデータベース オブジェクト名を含めることはできません)。 別名データ型を含んでいるものを除き、任意の定数、組み込み関数、または計算式を使用できます。 ユーザー定義関数は使用できません。 文字および日付定数は単一引用符 (') で囲んでください。金額、整数、および浮動小数点定数には引用符は必要ありません。 binary 型データには先頭に 0x を、金額には先頭に円記号 (\) を指定します。 既定値と列のデータ型には互換性があることが必要です。
説明
デフォルト名は現在のデータベース内でのみ作成できます。 データベース内では、デフォルトの名前はスキーマごとに一意であることが必要です。 デフォルトを作成したら、sp_bindefault を使用してデフォルトを列または別名データ型にバインドします。
デフォルトとバインド先の列に互換性がない場合、既定値の挿入を試みると SQL Server ではエラー メッセージが表示されます。 たとえば、numeric 型の列のデフォルトに "N/A" を使用することはできません。
バインドしてある列より既定値が長い場合、値は切り捨てられます。
CREATE DEFAULT ステートメントは、単一のバッチ内で他の Transact-SQL ステートメントと組み合わせることはできません。
同じ名前の新しいデフォルトを作成するときは、まず sp_unbindefault を実行して現在のデフォルトのバインドを解除し、そのデフォルトを削除する必要があります。
列が既定値とそれに関連するルールの両方を持つ場合、既定値はそのルールに従っている必要があります。 ルールに矛盾するデフォルトは挿入できません。挿入を試行すると、そのたびに SQL Server ではエラー メッセージが表示されます。
列にバインドされているとき、既定値は次の場合に挿入されます。
値が明示的に挿入されていない場合。
DEFAULT VALUES キーワードまたは DEFAULT キーワードを INSERT と組み合わせて使用し、既定値を挿入した場合。
列の作成時に NOT NULL が指定されていて、その列のデフォルトが作成されていない場合は、ユーザーによってその列にエントリが入力されないとエラー メッセージが表示されます。 次の表は、デフォルトの有無と、NULL または NOT NULL として定義された列の関係を示しています。 表中の各エントリは結果を示しています。
列の定義 |
入力なし、デフォルトなし |
入力なし、デフォルトあり |
NULL を入力、デフォルトなし |
NULL を入力、デフォルトあり |
|---|---|---|---|---|
NULL |
NULL |
既定値 |
NULL |
NULL |
NOT NULL |
エラー |
既定値 |
エラー |
エラー |
デフォルトの名前を変更するには、sp_rename を使用します。 デフォルトに関するレポートを表示するには、sp_help を使用します。
権限
CREATE DEFAULT を実行するには、ユーザーは少なくとも現在のデータベース内では CREATE DEFAULT 権限を、デフォルトが作成されるスキーマに対しては ALTER 権限を持つ必要があります。
使用例
A. 単純な文字のデフォルトを作成する
次の例では、"unknown" という文字のデフォルトを作成します。
USE AdventureWorks2012;
GO
CREATE DEFAULT phonedflt AS 'unknown';
B. デフォルトをバインドする
次の例では、例 A で作成したデフォルトをバインドします。 デフォルトが有効になるのは、Contact テーブルの Phone 列にエントリが指定されていない場合のみです。 エントリの省略は、INSERT ステートメントで NULL を明示的に指定する場合とは異なることに注意してください。
phonedflt というデフォルトは存在しないので、次の Transact-SQL ステートメントは失敗します。 次の例は、説明用のものです。
USE AdventureWorks2012;
GO
sp_bindefault 'phonedflt', 'Person.PersonPhone.PhoneNumber';