FileTable の作成、変更、および削除

[アーティクル]
06/13/2017

新しい FileTable の作成や、既存の FileTable の変更または削除を行う方法について説明します。

FileTable の作成

FileTable は、定義済みおよび固定のスキーマがある特殊なユーザーテーブルです。このスキーマは、FILESTREAM データ、ファイルとディレクトリの情報、およびファイルの属性を格納します。 FileTable スキーマの詳細については、「 FileTable Schema」を参照してください。

Transact-SQL または SQL Server Management Studioを使用して、新しい FileTable を作成することができます。 FileTable には固定スキーマがあるため、列の一覧を指定する必要はありません。 FileTable を作成するため、簡単な構文を指定することができます。

ディレクトリ名。 FileTable フォルダー階層において、このテーブルレベルのディレクトリは、データベースレベルで指定されたデータベースディレクトリの子になると同時に、テーブルに格納されるファイルまたはデータベースの親になります。
FileTable の Name 列のファイル名に対して使用される照合順序の名前。
自動的に作成される 3 つの主キーと一意の制約で使用する名前。

方法: FileTable を作成する

Transact-SQL を使用して FileTable を作成する
AS FileTable オプションを使用して CREATE TABLE (Transact-SQL) ステートメントを呼び出して FileTable を作成します。 FileTable には固定スキーマがあるため、列の一覧を指定する必要はありません。新しい FileTable には次の設定を指定できます。

FILETABLE_DIRECTORY。 FileTable に格納されたすべてのファイルおよびディレクトリのルートディレクトリとなるディレクトリを指定します。この名前は、データベース内のすべての FileTable ディレクトリ名の中で一意である必要があります。一意性の比較では、現在の照合順序の設定とは関係なく、大文字と小文字は区別されません。
- この値は、 nvarchar(255) のデータ型であり、 Latin1_General_CI_AS_KS_WSの固定の照合順序を使用します。
- 指定するディレクトリ名は、ファイルシステムの有効なディレクトリ名に関する要件を満たしている必要があります。
- この名前は、データベース内のすべての FileTable ディレクトリ名の中で一意である必要があります。一意性の比較では、現在の照合順序の設定とは関係なく、大文字と小文字は区別されません。
- FileTable を作成するときにディレクトリ名を指定しなかった場合は、FileTable そのものの名前がディレクトリ名として使用されます。
FILETABLE_COLLATE_FILENAME。 FileTable の Name 列に適用される照合順序の名前を指定します。
1. 指定した照合順序は、Windows のファイル名のセマンティクスに準拠するために、 大文字と小文字を区別しない 設定にする必要があります。
2. FILETABLE_COLLATE_FILENAMEの値を指定しない場合、または、 database_defaultを指定した場合は、現在のデータベースの照合順序が列に継承されます。現在のデータベースの照合順序で大文字と小文字が区別される場合は、エラーが発生し、 CREATE TABLE 操作は失敗します。
自動的に作成される 3 つの主キーと一意の制約で使用する名前を指定することもできます。名前を指定しなかった場合、このトピックで後述するように、システムで名前が自動生成されます。
- FILETABLE_PRIMARY_KEY_CONSTRAINT_NAME
- FILETABLE_STREAMID_UNIQUE_CONSTRAINT_NAME
- FILETABLE_FULLPATH_UNIQUE_CONSTRAINT_NAME

使用例

次の例では、新しい FileTable を作成し、 FILETABLE_DIRECTORY と FILETABLE_COLLATE_FILENAMEの両方に対してユーザー定義の値を指定します。

CREATE TABLE DocumentStore AS FileTable  
    WITH (   
          FileTable_Directory = 'DocumentTable',  
          FileTable_Collate_Filename = database_default  
         );  
GO

次の例も、新しい FileTable を作成するものです。ユーザー定義の値が指定されていないため、 FILETABLE_DIRECTORY の値が FileTable の名前に、 FILETABLE_COLLATE_FILENAME の値が database_default になります。また、主キーと一意の制約にはシステムで生成された名前が指定されます。

CREATE TABLE DocumentStore AS FileTable;  
GO

SQL Server Management Studio を使用して FileTable を作成する
オブジェクトエクスプローラーで、選択したデータベースのオブジェクトを展開し、 [テーブル] フォルダーを右クリックして [新しい FileTable] をクリックします。

このオプションを選択すると、新しいスクリプトウィンドウが開き、FileTable を作成するためにカスタマイズして実行できる Transact-SQL スクリプトテンプレートが表示されます。 [クエリ] メニューの [テンプレートパラメーターの値の指定] オプションを使用すると、スクリプトを簡単にカスタマイズできます。

FileTable を作成するための要件と制限

既存のテーブルは、変更して FileTable に変換することはできません。
データベースレベルで前もって指定する親ディレクトリには、null ではない値を指定する必要があります。データベースレベルのディレクトリを指定する方法については、「 FileTable の前提条件の有効化」を参照してください。
FileTable には、FILESTREAM 列が含まれているため、有効な FILESTREAM ファイルグループが必要です。必要に応じて、FileTable を作成する CREATE TABLE コマンドの一部として、FILESTREAM ファイルグループを指定することもできます。ファイルグループが指定されていない場合、FileTable はデータベースの既定の FILESTREAM ファイルグループを使用します。データベースに FILESTREAM ファイルグループがない場合は、エラーが発生します。
CREATE TABLE...AS FILETABLE ステートメントの一部としてテーブルの制約を作成することはできません。ただし、制約を追加するには、後で ALTER TABLE ステートメントを使用します。
tempdb データベースまたはその他のシステムデータベースに FileTable を作成することはできません。
一時テーブルとして、FileTable を作成することはできません。

FileTable の変更

FileTable は、定義済みおよび固定のスキーマがあるため、その列を追加または変更することはできません。ただし、カスタムインデックス、トリガー、制約、およびその他のオプションを FileTable に追加することはできます。

ALTER TABLE ステートメントを使用して FileTable 名前空間 (システム定義の制約を含む) を有効または無効にする方法の詳細については、「 FileTable の管理」を参照してください。

方法: FileTable のディレクトリを変更する

Transact-SQL を使用して FileTable のディレクトリを変更する
ALTER TABLE ステートメントを呼び出し、有効な新しい値を FILETABLE_DIRECTORY SET オプションに指定します。

例

ALTER TABLE filetable_name  
    SET ( FILETABLE_DIRECTORY = N'directory_name' );  
GO

SQL Server Management Studio を使用して FileTable のディレクトリを変更する
オブジェクトエクスプローラーで、FileTable を右クリックし、 [プロパティ] をクリックして、 [テーブルのプロパティ] ダイアログボックスを開きます。 [FileTable] ページで、 [FileTable ディレクトリ名] に新しい値を入力します。

FileTable を変更するための要件と制限

FILETABLE_COLLATE_FILENAMEの値を変更することはできません。
FileTable のシステムで定義された列を変更、削除、または無効にすることはできません。
新しいユーザー列、計算列、または保存される計算列を FileTable に追加することはできません。

FileTable の削除

FILETable を削除するには、 DROP TABLE (Transact-SQL) ステートメントの通常の構文を使用します。

FileTable を削除すると、次のオブジェクトも削除されます。

FileTable のすべての列に加え、インデックス、制約、トリガーなどテーブルに関連付けられているすべてのオブジェクトが削除されます。
FileTable ディレクトリと、その下位にあったサブディレクトリも、データベースの FILESTREAM ファイルとディレクトリ階層から消失します。

FileTable のファイルの名前空間内に開いているファイルハンドルがある場合、DROP TABLE コマンドは失敗します。開いているハンドルを閉じる方法の詳細については、「 FileTable の管理」を参照してください。

FileTable を作成したときに作成されるその他のデータベースオブジェクト

新しい FileTable を作成すると、システム定義のインデックスと制約もいくつか作成されます。これらのオブジェクトを変更または削除することはできません。これらは、FileTable 自体が削除されると一緒に削除されます。これらのオブジェクトの一覧を表示するには、カタログビュー sys.filetable_system_defined_objects (Transact-SQL) に対してクエリを実行します。

--View all objects for all filetables, unsorted  
SELECT * FROM sys.filetable_system_defined_objects;  
GO  
  
--View sorted list with friendly names  
SELECT OBJECT_NAME(parent_object_id) AS 'FileTable', OBJECT_NAME(object_id) AS 'System-defined Object'  
    FROM sys.filetable_system_defined_objects  
    ORDER BY FileTable, 'System-defined Object';  
GO

新しい FileTable を作成するときに作成されるインデックス
新しい FileTable を作成すると、次に示すシステム定義のインデックスも作成されます。


[列]	[インデックスの種類]
[path_locator] ASC	主キー、非クラスター化
[parent_path_locator] ASC、 [name] ASC	一意、非クラスター化
[stream_id] ASC	一意、非クラスター化

新しい FileTable を作成するときに作成される制約
新しい FileTable を作成すると、次に示すシステム定義の制約も作成されます。

制約	強制
次の列の既定の制約 creation_time is_archive is_directory is_hidden is_offline is_readonly is_system is_temporary last_access_time last_write_time path_locator stream_id	システム定義の既定の制約によって、指定した列に既定値が適用されます。
CHECK 制約	システム定義の CHECK 制約によって、次の要件が適用されます。有効なファイル名。有効なファイル属性。親オブジェクトをディレクトリにする。名前空間の階層は、ファイル操作中にロックされる。

システム定義の制約の名前付け規則
上記のシステム定義制約は、constraintType>_tablename[_<columnname>>]_<<uniquifier> という形式<で名前が付けられています。ここで、

<>constraint_typeは CK (チェック制約)、DF (既定の制約)、FK (外部キー)、PK (主キー)、または UQ (一意制約) です。
<uniquifier> は、名前を一意にするためにシステムによって生成される文字列です。この文字列には、通常、FileTable の名前と一意の識別子が含まれています。

参照

FileTable の管理

次の方法で共有

FileTable の作成、変更、および削除