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

  • [アーティクル]

適用対象:SQL Server

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

  1. FILETABLE_DIRECTORY。 FileTable に格納されたすべてのファイルおよびディレクトリのルート ディレクトリとなるディレクトリを指定します。 この名前は、データベース内のすべての FileTable ディレクトリ名の中で一意である必要があります。 一意性の比較では、現在の照合順序の設定とは関係なく、大文字と小文字は区別されません。

    • この値は、 nvarchar(255) のデータ型であり、 Latin1_General_CI_AS_KS_WSの固定の照合順序を使用します。

    • 指定するディレクトリ名は、ファイル システムの有効なディレクトリ名に関する要件を満たしている必要があります。

    • この名前は、データベース内のすべての FileTable ディレクトリ名の中で一意である必要があります。 一意性の比較では、現在の照合順序の設定とは関係なく、大文字と小文字は区別されません。

    • FileTable を作成するときにディレクトリ名を指定しなかった場合は、FileTable そのものの名前がディレクトリ名として使用されます。

  2. FILETABLE_COLLATE_FILENAME。 FileTable の Name 列に適用される照合順序の名前を指定します。

    1. 指定した照合順序は、Windows のファイル名のセマンティクスに準拠するために、 大文字と小文字を区別しない 設定にする必要があります。

    2. FILETABLE_COLLATE_FILENAMEの値を指定しない場合、または、 database_defaultを指定した場合は、現在のデータベースの照合順序が列に継承されます。 現在のデータベースの照合順序で大文字と小文字が区別される場合は、エラーが発生し、 CREATE TABLE 操作は失敗します。

  3. 自動的に作成される 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 (CHECK 制約)、DF (DEFAULT 制約)、FK (外部キー)、PK (主キー)、または UQ (一意制約) です。

  • <uniquifier> は、名前を一意にする、システムによって生成された文字列です。 この文字列には、通常、FileTable の名前と一意の識別子が含まれています。

参照

FileTable の管理