ALTER DATABASE の File および Filegroup オプション (Transact-SQL)

<add_or_modify_files>::=

追加、削除、または変更するファイルを指定します。

• database_name
  変更するデータベースの名前を指定します。

• ADD FILE
  データベースにファイルを追加します。

  • TO FILEGROUP { filegroup_name }
    指定されたファイルを追加するファイル グループを指定します。現在のファイル グループ、および現在の既定のファイル グループを表示するには、sys.filegroups カタログ ビューを使用してください。

• ADD LOG FILE
  指定されたデータベースにログ ファイルを追加します。

• REMOVE FILE logical_file_name
  SQL Server インスタンスから論理ファイルの説明を削除し、物理ファイルを削除します。ファイルが空でない場合は削除できません。

  • logical_file_name
    ファイルを参照するときに SQL Server で使用される論理名を指定します。

• MODIFY FILE
  変更するファイルを指定します。一度に 1 つの <filespec> プロパティだけを変更できます。変更するファイルを識別するには、<filespec> に NAME を指定する必要があります。SIZE を指定する場合、ファイルの現在のサイズより新しいサイズの方が大きくなければなりません。

  データ ファイルまたはログ ファイルの論理名を変更するには、変更するファイルの論理名を NAME 句で指定し、NEWNAME 句にそのファイルの新しい論理名を指定します。次に例を示します。

  MODIFY FILE ( NAME = logical_file_name, NEWNAME = new_logical_name ) 
  

  データ ファイルまたはログ ファイルを別の場所に移動するには、NAME 句にファイルの現在の論理名を指定し、FILENAME 句に新しいパスとオペレーティング システム ファイル名を指定します。次に例を示します。

  MODIFY FILE ( NAME = logical_file_name, FILENAME = ' new_path/os_file_name ' )
  

  フルテキスト カタログを移動する場合は、FILENAME 句に新しいパスだけを指定します。オペレーティング システム ファイル名は指定しないでください。

  詳細については、「データベース ファイルの移動」を参照してください。

  FILESTREAM ファイル グループの場合、NAME をオンラインで変更できます。FILENAME はオンラインで変更できますが、コンテナーを物理的に再配置し、サーバーをシャットダウンして再起動するまで、変更は有効になりません。

  FILESTREAM ファイルを OFFLINE に設定できます。FILESTREAM ファイルをオフラインにすると、その親ファイル グループがオフラインとして内部的にマークされるため、そのファイル グループ内の FILESTREAM データへのアクセスはすべて失敗します。

<filespec>::=

ファイル プロパティを制御します。

• NAME logical_file_name
  ファイルの論理名を指定します。

  • logical_file_name
    ファイルを参照するときに SQL Server インスタンスで使用される論理名を指定します。

• NEWNAME new_logical_file_name
  ファイルの新しい論理名を指定します。

  • new_logical_file_name
    既存の論理ファイル名と置換する新しい名前を指定します。論理ファイル名は、データベース内で一意であり、識別子の規則に従っている必要があります。この名前は、文字定数、Unicode 定数、標準の識別子、区切られた識別子のいずれでもかまいません。詳細については、「オブジェクト名としての識別子の使用」を参照してください。

• FILENAME { 'os_file_name' | 'filestream_path' }
  オペレーティング システムの (物理) ファイル名を指定します。

  • ' os_file_name '
    標準の (ROWS) ファイル グループの場合、ファイルの作成時にオペレーティング システムで使用されるパスとファイル名を指定します。ファイルは、SQL Server がインストールされているサーバー上に存在する必要があります。ALTER DATABASE ステートメントを実行するには、指定したパスが実際に存在するパスであることが必要です。

    ファイルに対して UNC パスが指定されている場合、SIZE、MAXSIZE、および FILEGROWTH パラメーターは設定できません。

    注
    システム データベースを UNC 共有ディレクトリに置くことはできません。

    データ ファイルが読み取り専用のセカンダリ ファイルであるか、データベースが読み取り専用である場合を除き、データ ファイルを圧縮ファイル システム上には置かないでください。ログ ファイルは、圧縮ファイル システム上に置くことはできません。詳細については、「読み取り専用のファイル グループと圧縮」を参照してください。

    ファイルが未処理のパーティション上にある場合、os_file_name には、未処理になっている既存のパーティションのドライブ文字のみを指定する必要があります。未処理の各パーティションに配置できるファイルは、それぞれ 1 ファイルだけです。

  • 'filestream_path'
    FILESTREAM ファイル グループの場合、FILENAME は FILESTREAM データが格納されるパスを参照します。最後のフォルダーまでのパスは存在する必要がありますが、最後のフォルダーは存在していてはいけません。たとえば、パス C:\MyFiles\MyFilestreamData を指定する場合は、ALTER DATABASE を実行するとき、C:\MyFiles は既に存在している必要がありますが、MyFilestreamData フォルダーは存在してはなりません。

    ファイル グループとファイル (<filespec>) は、同じステートメントで作成する必要があります。ファイル (<filespec>) は、FILESTREAM ファイル グループごとに 1 つしか指定できません。

    SIZE、MAXSIZE、FILEGROWTH の各プロパティは、FILESTREAM ファイル グループには適用されません。

• SIZE size
  ファイルのサイズを指定します。SIZE は、FILESTREAM ファイル グループには適用されません。

  • size
    ファイルのサイズです。

    ADD FILE と共に指定する場合、size はファイルの初期サイズになります。MODIFY FILE と共に指定する場合、size はファイルの新しいサイズになります。この値には、ファイルの現在のサイズより大きい値を指定する必要があります。

    プライマリ ファイルに size が指定されていない場合、SQL Server は、model データベースのプライマリ ファイルのサイズを使用します。セカンダリ データ ファイルまたはログ ファイルが指定されているにもかかわらず、そのファイルに対して size が指定されていない場合、データベース エンジンでは、そのファイルのサイズが 1 MB になります。

    KB、MB、GB、および TB の各サフィックスを使用して、キロバイト、メガバイト、ギガバイト、またはテラバイトを指定できます。既定値は MB です。整数を指定します。小数は含めないでください。小数部を持つメガバイトの値を指定するには、その値に 1024 を乗算することによって、キロバイトの単位に変換します。たとえば、1.5 MB ではなく 1536 KB と指定します (1.5 × 1024 = 1536)。

• MAXSIZE { max_size| UNLIMITED }
  ファイルのサイズを拡張する場合の最大サイズを指定します。MAXSIZE は、FILESTREAM ファイル グループには適用されません。

  • max_size
    ファイルの最大サイズです。KB、MB、GB、および TB の各サフィックスを使用して、キロバイト、メガバイト、ギガバイト、またはテラバイトを指定できます。既定値は MB です。整数を指定します。小数は含めないでください。max_size が指定されていなければ、ファイル サイズはディスクがいっぱいになるまで拡張されます。

  • UNLIMITED
    ディスクがいっぱいになるまでファイルを拡張するように指定します。SQL Server では、無制限に拡張するファイル固有のログの最大サイズは 2 TB で、データ ファイルの最大サイズは 16 TB です。

• FILEGROWTH growth_increment
  ファイルを自動拡張するときの増加量を指定します。ファイルの FILEGROWTH 設定を MAXSIZE 設定より大きくすることはできません。FILEGROWTH は、FILESTREAM ファイル グループには適用されません。

  • growth_increment
    新しい領域が必要とされるたびにファイルに追加される領域の容量です。

    値は MB、KB、GB、TB または % の単位で指定できます。サフィックス MB、KB、または % を付けないで数値を指定した場合の既定値は MB です。% を指定すると、1 回の増加量は、増加時のファイル サイズに指定されたパーセンテージを掛けた値になります。指定されたサイズは、最も近い 64 KB の倍数値に丸められます。

    0 は、自動拡張がオフで、領域を追加できないことを示します。

    FILEGROWTH が指定されていない場合、既定値は、データ ファイルが 1 MB、ログ ファイルが 10% で、最小値は 64 KB になります。

    注
    SQL Server 2005 以降は、データ ファイルの既定の拡張増加量が、10% から 1 MB に変更されました。ログ ファイルの既定値は 10% のままで、変更ありません。

• OFFLINE
  ファイルをオフラインに設定し、ファイル グループ内のすべてのオブジェクトをアクセス不可にします。

  注意
  このオプションは、ファイルは破損しているが、復元可能な場合にのみ使用してください。OFFLINE に設定したファイルは、そのファイルをバックアップから復元することによってのみ、オンラインに設定されます。単一ファイルの復元方法の詳細については、「RESTORE (Transact-SQL)」を参照してください。

<add_or_modify_filegroups>::=

データベースに対してファイル グループの追加、変更、または削除を行います。

• ADD FILEGROUP filegroup_name
  データベースにファイル グループを追加します。

• CONTAINS FILESTREAM
  ファイル グループで FILESTREAM バイナリ ラージ オブジェクト (BLOB) をファイル システムに格納することを指定します。

• REMOVE FILEGROUP filegroup_name
  データベースからファイル グループを削除します。ファイル グループが空でない場合は削除できません。最初に、ファイル グループからすべてのファイルを削除してください。詳細については、前の「REMOVE FILE logical_file_name」を参照してください。

• MODIFY FILEGROUP filegroup_name { <filegroup_updatability_option> | DEFAULT | NAME = new_filegroup_name }
  ファイル グループに変更を加えます。ここでは、状態を READ_ONLY または READ_WRITE に設定したり、ファイル グループをデータベースの既定のファイル グループに指定したり、ファイル グループ名を変更することができます。

  • <filegroup_updatability_option>
    ファイル グループに読み取り専用、または読み取り/書き込みのプロパティを設定します。

  • DEFAULT
    既定のデータベース ファイル グループを filegroup_name に変更します。データベース内の 1 つのファイル グループだけを、既定のファイル グループにすることができます。詳細については、「ファイルおよびファイル グループについて」を参照してください。

  • NAME = new_filegroup_name
    ファイル グループ名を new_filegroup_name に変更します。

<filegroup_updatability_option>::=

ファイル グループに読み取り専用、または読み取り/書き込みのプロパティを設定します。

• READ_ONLY | READONLY
  ファイル グループが読み取り専用であることを指定します。この中のオブジェクトを更新することはできません。プライマリ ファイル グループを読み取り専用にすることはできません。この状態を変更するには、データベースに対する排他的アクセスが必要になります。詳細については、SINGLE_USER 句を参照してください。

  読み取り専用データベースのデータを変更することはできないため、次のようになります。

  • システム起動時に自動復旧がスキップされます。

  • データベースの圧縮が不可能になります。

  • 読み取り専用データベースでは、ロックは発生しません。これにより、クエリのパフォーマンスが向上することがあります。

  注
  キーワード READONLY は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では READONLY の使用は避け、現在 READONLY を使用しているアプリケーションは修正するようにしてください。代わりに、READ_ONLY を使用してください。

• READ_WRITE | READWRITE
  ファイル グループを READ_WRITE に指定します。ファイル グループ内のオブジェクトを更新できます。この状態を変更するには、データベースに対する排他的アクセスが必要になります。詳細については、SINGLE_USER 句を参照してください。

  注
  キーワード READWRITE は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では READWRITE の使用は避け、現在 READWRITE を使用しているアプリケーションは修正するようにしてください。代わりに、READ_WRITE を使用してください。

これらのオプションの状態を確認するには、sys.databases カタログ ビューの is_read_only 列、または DATABASEPROPERTYEX 関数の Updateability プロパティを調べてください。