CREATE PARTITION FUNCTION (Transact-SQL)

構文

CREATE PARTITION FUNCTION partition_function_name ( input_parameter_type )
AS RANGE [ LEFT | RIGHT ] 
FOR VALUES ( [ boundary_value [ ,...n ] ] ) 
[ ; ]

引数

• partition_function_name
  パーティション関数の名前です。パーティション関数の名前は、データベース内で一意であり、かつ識別子のルールに従っている必要があります。

• input_parameter_type
  パーティション分割に使用される列のデータ型です。text、ntext、image、xml、timestamp、varchar(max)、nvarchar(max)、varbinary(max)、別名データ型、CLR ユーザー定義データ型を除いた、すべてのデータ型をパーティション分割列として使用できます。

  パーティション分割列と呼ばれる実際の列は、CREATE TABLE ステートメントまたは CREATE INDEX ステートメントで指定します。

• boundary_value
  partition_function_name を使用するパーティション テーブルまたはインデックスの各パーティションの境界値を指定します。boundary_value が空の場合、このパーティション関数では partition_function_name を使用するテーブルまたはインデックス全体が 1 つのパーティションにマップされます。CREATE TABLE ステートメントまたは CREATE INDEX ステートメントで指定された 1 つのパーティション分割列のみが使用できます。

  boundary_value は、変数を参照できる定数式です。これには、ユーザー定義型の変数、または関数およびユーザー定義関数が含まれます。Transact-SQL 式を参照することはできません。boundary_value は、input_parameter_type に指定された対応するデータ型と同じであるか、そのデータ型に暗黙的に変換できる必要があります。また、暗黙的に変換している間は、対応する input_parameter_type と値のサイズおよび小数点以下桁数が異なる方法で切り捨てることはできません。

  注
  boundary_value に、datetime または smalldatetime 型のリテラルが含まれる場合、それらのリテラルは、セッション言語が us_english であることを前提に評価されます。ただし、この動作は廃止予定となっています。すべてのセッション言語でパーティション関数の定義が正しく認識されるようにするには、yyyymmdd 形式のようにすべての言語設定で同様に解釈される定数を使用するか、リテラルを特定の型に明示的に変換することをお勧めします。詳細については、「国際化に対応した Transact-SQL ステートメントの記述」を参照してください。サーバーのセッション言語を確認するには、SELECT @@LANGUAGE を実行してください。

• ...n
  boundary_value で与えられる値の数を指定します。999 以下の数を指定する必要があります。作成されるパーティションの数は n + 1 になります。値を順序どおり指定する必要はありません。値が順不同の場合、データベース エンジン は値を並び替えて、関数を作成し、値が順に並んでいないという警告を返します。n に重複値が含まれている場合、データベース エンジンはエラーを返します。

• LEFT | RIGHT
  データベース エンジンが境界値を左から右の昇順にソートする場合に、boundary_value [ ,...n ] が各境界値間隔のどちら側 (左または右) に属するかを指定します。指定しない場合は、LEFT が既定値です。詳細については、「例」を参照してください。

説明

パーティション関数のスコープは、関数が作成されたデータベース内に制限されます。データベース内では、パーティション関数は他の関数とは別の名前空間に配置されます。

パーティション分割列に NULL 値がある行はすべて、左端のパーティションに配置されます。ただし、NULL が境界値として指定され、RIGHT が指定された場合は除きます。この場合、左端のパーティションは空のパーティションになり、NULL 値は次のパーティションに配置されます。

権限

次のいずれかの権限を使用すると、CREATE PARTITION FUNCTION を実行できます。

• ALTER ANY DATASPACE 権限。この権限は、既定では、sysadmin 固定サーバー ロールおよび db_owner と db_ddladmin 固定データベース ロールのメンバに与えられています。

• データベースの CONTROL 権限または ALTER 権限 (パーティション関数はこのデータベース内で作成)。

• データベースのサーバーの CONTROL SERVER 権限または ALTER ANY DATABASE 権限 (パーティション関数はこのデータベースで作成)。

例

A. int 型の列に RANGE LEFT パーティション関数を作成する

CREATE PARTITION FUNCTION myRangePF1 (int)
AS RANGE LEFT FOR VALUES (1, 100, 1000);

B. int 型の列に RANGE RIGHT パーティション関数を作成する

CREATE PARTITION FUNCTION myRangePF2 (int)
AS RANGE RIGHT FOR VALUES (1, 100, 1000);

C. datetime 型の列に RANGE RIGHT パーティション関数を作成する

CREATE PARTITION FUNCTION [myDateRangePF1] (datetime)
AS RANGE RIGHT FOR VALUES ('20030201', '20030301', '20030401',
               '20030501', '20030601', '20030701', '20030801', 
               '20030901', '20031001', '20031101', '20031201');

D. char 型の列にパーティション関数を作成する

CREATE PARTITION FUNCTION myRangePF3 (char(20))
AS RANGE RIGHT FOR VALUES ('EX', 'RXE', 'XR');

関連項目

参照