sp_bindrule (Transact-SQL)

  • [アーティクル]

ルールを列または別名データ型にバインドします。

重要な注意事項重要

この機能は、Microsoft SQL Server の将来のバージョンで削除されます。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションはできるだけ早く修正してください。代わりに UNIQUE 制約と CHECK 制約を使用してください。 CHECK 制約は、CREATE TABLE ステートメントまたは ALTER TABLE ステートメントの CHECK キーワードを使用して作成されます。

トピック リンク アイコン Transact-SQL 構文表記規則

構文

sp_bindrule [ @rulename = ] 'rule' , 
     [ @objname = ] 'object_name' 
     [ , [ @futureonly = ] 'futureonly_flag' ]

引数

  • [ @rulename=] 'rule'
    CREATE RULE ステートメントによって作成されたルールの名前です。 rule のデータ型は nvarchar(776) で、既定値はありません。

  • [ @objname=] 'object_name'
    ルールがバインドされるテーブルと列、または別名データ型です。 ルールは text、ntext、image、varchar(max)、nvarchar(max)、varbinary(max)、xml、CLR ユーザー定義型、または timestamp 列にはバインドできません。 ルールは、計算列にバインドすることはできません。

    object_name のデータ型は nvarchar(776) で、既定値はありません。 object_name が 1 部構成の名前の場合は、別名データ型として解決されます。 2 部構成または 3 部構成の名前の場合は、最初にテーブルおよび列として解決されます。この解決が失敗すると、別名データ型として解決されます。 既定では、既存の別名データ型の列は、別のルールを直接その列にバインドしない限り rule の値を継承します。

    注意注

    object_name には、角かっこ [ および ] を区切り記号識別子の文字として含めることができます。 詳細については、「データベース識別子」を参照してください。
    注意注

    別名データ型を使用する式に対して作成されたルールは、列または別名データ型にバインドできますが、参照されてもコンパイルできません。 別名データ型に対して作成されたルールは使用しないでください。

  • [ @futureonly= ] 'futureonly_flag'
    ルールを別名データ型にバインドするときにのみ使用されます。 future_only_flag のデータ型は varchar(15) で、既定値は NULL です。 このパラメーターを futureonly に設定すると、別名データ型の既存の列では新しいルールを継承しません。 futureonly_flag が NULL の場合、新しいルールは、現在ルールが割り当てられていない別名データ型の列、または別名データ型の既存のルールを使用している列にバインドされます。

リターン コード値

成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。

説明

sp_bindrule を使用すると、既存のルールをバインド解除せずに、新しいルールを列または別名データ型にバインドできます。ただし、できるだけ CHECK 制約を使用してください。 元のルールは無効になります。 既に CHECK 制約のある列にルールをバインドすると、すべての制限が評価されます。 SQL Server データ型にはルールをバインドできません。

ルールは、バインド時ではなく INSERT ステートメントを試行したときに設定されます。 numeric データ型の列には、文字ルールをバインドすることはできますが、INSERT 操作を行うことはできません。

futureonly_flag が futureonly として指定されていない限り、別名データ型の既存の列は新しいルールを継承します。 別名データ型が定義された新しい列は、常にルールを継承します。 しかし、ALTER TABLE ステートメントの ALTER COLUMN 句によって、列のデータ型をルールがバインドされた別名データ型に変更すると、データ型にバインドしているルールはその列に継承されません。 sp_bindrule を使用して、明示的にルールを列にバインドする必要があります。

列にルールをバインドすると、関連情報が sys.columns テーブルに登録されます。 別名データ型にルールをバインドすると、関連情報が sys.types テーブルに登録されます。

権限

テーブル列にルールをバインドするには、そのテーブルに対する ALTER 権限が必要です。 別名データ型にルールをバインドするには、その別名データ型に対する CONTROL 権限、またはそのデータ型の属するスキーマに対する ALTER 権限が必要です。

使用例

A. 列にルールをバインドする

CREATE RULE ステートメントを使用して today という名前のルールが現在のデータベースで作成されているものとします。次の例では、Employee テーブルの HireDate 列に、このルールをバインドします。 行が Employee テーブルに追加されると、HireDate 列のデータは today ルールと照らし合わせてチェックされます。

USE master;
GO
EXEC sp_bindrule 'today', 'HumanResources.Employee.HireDate'

B. 別名データ型にルールをバインドする

rule_ssn という名前のルールがあり、ssn という名前の別名データ型があるものとします。次の例では、rule_ssn を ssn にバインドします。 CREATE TABLE ステートメントで、ssn 型の列は rule_ssn ルールを継承します。 futureonly_flag に futureonly が指定されている場合や ssn にルールが直接バインドされている場合を除き、ssn 型の既存の列も rule_ssn ルールを継承します。 列にバインドされているルールは、データ型にバインドされているルールより常に優先します。

USE master;
GO
EXEC sp_bindrule 'rule_ssn', 'ssn'

C. futureonly_flag を使用する

次の例では、rule_ssn ルールを別名データ型 ssn にバインドします。 futureonly が指定されているため、ssn 型の既存の列は影響を受けません。

USE master;
GO
EXEC sp_bindrule rule_ssn, 'ssn', 'futureonly'

D. 区切られた識別子を使用する

次の例では、object_name パラメーターでの区切られた識別子の使い方を示します。

USE master;
GO
CREATE TABLE [t.2] (c1 int) 
-- Notice the period as part of the table name.
EXEC sp_bindrule rule1, '[t.2].c1' 
-- The object contains two periods; 
-- the first is part of the table name 
-- and the second distinguishes the table name from the column name.

関連項目

参照

システム ストアド プロシージャ (Transact-SQL)

データベース エンジンのストアド プロシージャ (Transact-SQL)

CREATE RULE (Transact-SQL)

DROP RULE (Transact-SQL)

sp_unbindrule (Transact-SQL)

システム ストアド プロシージャ (Transact-SQL)