ALTER DATABASE (Transact-SQL) 文件和文件组选项

修改与数据库关联的文件和文件组。 在数据库中添加或删除文件和文件组,并更改数据库或其文件和文件组的属性。 有关其他 ALTER DATABASE 选项,请参阅 ALTER DATABASE

有关语法约定的详细信息,请参阅 Transact-SQL 语法约定

选择一个产品

在下面的行中,选择你感兴趣的产品名称,系统将只显示该产品的信息。

* SQL Server *  

 

语法

ALTER DATABASE database_name
{
    <add_or_modify_files>
  | <add_or_modify_filegroups>
}

<add_or_modify_files>::=
{
    ADD FILE <filespec> [ ,...n ]
        [ TO FILEGROUP { filegroup_name } ]
  | ADD LOG FILE <filespec> [ ,...n ]
  | REMOVE FILE logical_file_name
  | MODIFY FILE <filespec>
}

<filespec>::=
(
    NAME = logical_file_name
    [ , NEWNAME = new_logical_name ]
    [ , FILENAME = {'os_file_name' | 'filestream_path' | 'memory_optimized_data_path' } ]
    [ , SIZE = size [ KB | MB | GB | TB ] ]
    [ , MAXSIZE = { max_size [ KB | MB | GB | TB ] | UNLIMITED } ]
    [ , FILEGROWTH = growth_increment [ KB | MB | GB | TB| % ] ]
    [ , OFFLINE ]
)

<add_or_modify_filegroups>::=
{
    | ADD FILEGROUP filegroup_name
        [ CONTAINS FILESTREAM | CONTAINS MEMORY_OPTIMIZED_DATA ]
    | REMOVE FILEGROUP filegroup_name
    | MODIFY FILEGROUP filegroup_name
        { <filegroup_updatability_option>
        | DEFAULT
        | NAME = new_filegroup_name
        | { AUTOGROW_SINGLE_FILE | AUTOGROW_ALL_FILES }
        }
}
<filegroup_updatability_option>::=
{
    { READONLY | READWRITE }
    | { READ_ONLY | READ_WRITE }
}

参数

<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 中引用文件时所用的逻辑名称。

警告

删除具有与其关联的 FILE_SNAPSHOT 备份的数据库文件将会成功,但不会删除任何关联的快照,以免使引用该数据库文件的备份失效。 将截断该文件,但不会以物理方式将其删除,以保持 FILE_SNAPSHOT 备份不受影响。 有关详细信息,请参阅使用 Microsoft Azure Blob 存储执行 SQL Server 备份和还原适用于:SQL Server(SQL Server 2016 (13.x) 及更高版本)。

MODIFY FILE 指定应修改的文件。 一次只能更改一个 <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 数据的所有访问均将失败。

注意

<add_or_modify_files> 选项在包含的数据库中不可用。

<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' | 'memory_optimized_data_path'} 指定操作系统(物理)文件名。

' os_file_name ' 对于标准 (ROWS) 文件组,这是在创建文件时操作系统所使用的路径和文件名。 该文件必须驻留在安装 SQL Server 的服务器上。 在执行 ALTER DATABASE 语句前,指定的路径必须已经存在。

注意

当为文件指定了 UNC 路径时,无法设置 SIZEMAXSIZEFILEGROWTH 参数。

系统数据库不能位于 UNC 共享目录中。

不应将数据文件放在压缩文件系统中,除非这些文件是只读辅助文件或该数据库是只读的。 日志文件一定不要放在压缩文件系统中。

如果文件位于原始分区上,则 os_file_name 必须仅指定现有原始分区的驱动器号。 每个原始分区上只能存放一个文件。

'filestream_path' 对于 FILESTREAM 文件组,FILENAME 指向将存储 FILESTREAM 数据的路径。 在最后一个文件夹之前的路径必须存在,但不能存在最后一个文件夹。 例如,如果指定路径 C:\MyFiles\MyFilestreamData,则 C:\MyFiles 必须存在才能运行 ALTER DATABASE,但 MyFilestreamData 文件夹不能存在。

备注

SIZE 和 FILEGROWTH 属性不适用于 FILESTREAM 文件组。

' memory_optimized_data_path ' 对于内存优化文件组,FILENAME 指向将存储内存优化数据的路径。 在最后一个文件夹之前的路径必须存在,但不能存在最后一个文件夹。 例如,如果指定路径 C:\MyFiles\MyData,则 C:\MyFiles 必须存在才能运行 ALTER DATABASE,但 MyData 文件夹不能存在。

必须在同一语句中创建文件组和文件 (<filespec>)。

备注

SIZE、MAXSIZE 和 FILEGROWTH 属性不适用于 MEMORY_OPTIMIZED_DATA 文件组。

有关内存优化文件组的详细信息,请参阅内存优化文件组

SIZE size 指定文件大小。 SIZE 不适用于 FILESTREAM 文件组。

size 文件的大小。

与 ADD FILE 一起指定时,size 是文件的初始大小。 与 MODIFY FILE 一起指定时,size 是文件的新大小,而且必须大于文件的当前大小。

如果没有为主文件提供 size,SQL Server 会使用 model 数据库中主文件的大小。 如果指定了辅助数据文件或日志文件,但未指定该文件的 size,数据库引擎会以 1 MB 作为该文件的大小。

后缀 KB、MB、GB 和 TB 可用于指定千字节、兆字节、千兆字节或兆兆字节。 默认值为 MB。 指定整数,不包含小数。 若要指定兆字节的分数,请通过将数字乘以 1024 将该值转换为千字节。 例如,应指定 1536 KB 而不是 1.5MB (1.5 x 1024 = 1536)。

注意

以下情况无法设置 SIZE

  • 为文件指定了 UNC 路径时
  • 用于 FILESTREAMMEMORY_OPTIMIZED_DATA 文件组时

MAXSIZE { max_size| UNLIMITED } 指定文件可增大到的最大文件大小。

max_size 最大的文件大小。 后缀 KB、MB、GB 和 TB 可用于指定千字节、兆字节、千兆字节或兆兆字节。 默认值为 MB。 指定整数,不包含小数。 如果未指定 max_size,文件大小将一直增长到磁盘变满为止。

UNLIMITED 指定文件将增长到磁盘充满。 在 SQL Server 中,指定为不限制增长的日志文件的最大大小为 2 TB,而数据文件的最大大小为 16 TB。 为 FILESTREAM 容器指定此选项时,没有最大大小。 它将继续增大,直到磁盘已满。

注意

当为文件指定了 UNC 路径时无法设置 MAXSIZE

FILEGROWTH growth_increment 指定文件的自动增量。 文件的 FILEGROWTH 设置不能超过 MAXSIZE 设置。 FILEGROWTH 不适用于 FILESTREAM 文件组。

growth_increment 每次需要新空间时为文件添加的空间量。

该值可以 MB、KB、GB、TB 或百分比 (%) 为单位指定。 如果未在数量后面指定 MB、KB 或 %,则默认值为 MB。 如果指定 %,则增量大小为发生增长时文件大小的指定百分比。 指定的大小舍入为最接近的 64 KB 的倍数。

如果值为 0,则表明自动增长被设置为关闭,且不允许增加空间。

如果未指定 FILEGROWTH,则默认值为:

版本 默认值
自 SQL Server 2016 (13.x) 起 数据 64 MB。 日志文件 64 MB。
自 SQL Server 2005 (9.x) 起 数据 1 MB。 日志文件 10%。
SQL Server 2005 (9.x) 之前 数据 10%。 日志文件 10%。

备注

以下情况无法设置 FILEGROWTH

  • 为文件指定了 UNC 路径时
  • 用于 FILESTREAMMEMORY_OPTIMIZED_DATA 文件组时

OFFLINE 将文件设置为脱机并使文件组中的所有对象都不可访问。

注意

仅当文件已损坏但可以还原时,才能使用该选项。 对于设置为 OFFLINE 的文件,只有通过从备份中还原该文件,才能将其设置为联机。 有关还原单个文件的详细信息,请参阅 RESTORE

<filespec> 选项在包含的数据库中不可用。

<add_or_modify_filegroups>::=

在数据库中添加、修改或删除文件组。

ADD FILEGROUP filegroup_name 向数据库中添加文件组。

CONTAINS FILESTREAM 指定文件组在文件系统中存储 FILESTREAM 二进制大型对象 (BLOB)。

CONTAINS MEMORY_OPTIMIZED_DATA

适用于:SQL Server(SQL Server 2014 (12.x) 及更高版本)

指定文件组在文件系统中存储内存优化数据。 有关详细信息,请参阅内存中 OLTP - 内存中优化。 每个数据库只允许一个 MEMORY_OPTIMIZED_DATA 文件组。 在创建内存优化表时,文件组不能为空。 其中必须至少包含一个文件。 filegroup_name 引用一个路径。 在最后一个文件夹之前的路径必须存在,但不能存在最后一个文件夹。

REMOVE FILEGROUP filegroup_name 从数据库中删除文件组。 除非文件组为空,否则无法将其删除。 首先从文件组中删除所有文件。 有关详细信息,请参阅本主题前面的“REMOVE FILE logical_file_name”。

注意

除非 FILESTREAM 垃圾回收器已从 FILESTREAM 容器中删除所有文件,否则删除 FILESTREAM 容器的 ALTER DATABASE REMOVE FILE 操作将失败并返回错误。 请参阅本主题后面的删除 FILESTREAM 容器部分。

MODIFY FILEGROUP filegroup_name { <filegroup_updatability_option> | DEFAULT | NAME =new_filegroup_name } 通过将状态设置为 READ_ONLY 或 READ_WRITE、将文件组设置为数据库的默认文件组或者更改文件组名称来修改文件组。

<filegroup_updatability_option> 对文件组设置只读或读/写属性。

DEFAULT 将默认数据库文件组改为 filegroup_name。 数据库中只能有一个文件组作为默认文件组。 有关详细信息,请参阅 数据库文件和文件组

NAME = new_filegroup_name 将文件组名称改为 new_filegroup_name。

AUTOGROW_SINGLE_FILE 适用于:SQL Server(SQL Server 2016 (13.x) 及更高版本)

当文件组中的某个文件达到自动增长阈值时,只有该文件会增长。 这是默认值。

AUTOGROW_ALL_FILES

适用于:SQL Server(SQL Server 2016 (13.x) 及更高版本)

当文件组中的某个文件达到自动增长阈值时,文件组中的所有文件都会增长。

注意

这是 TempDB 的默认值。

<filegroup_updatability_option>::=

对文件组设置只读或读/写属性。

READ_ONLY | READONLY 指定文件组为只读。 不允许更新其中的对象。 主文件组不能设置为只读。 若要更改此状态,您必须对数据库有独占访问权限。 有关详细信息,请参阅 SINGLE_USER 子句。

因为只读数据库不允许数据修改,所以将发生以下情况:

  • 系统启动时,将跳过自动恢复。
  • 不能收缩数据库。
  • 在只读数据库中不会进行锁定。 这可以加快查询速度。

备注

Microsoft SQL Server 的未来版本将删除 READONLY 关键字。 请避免在新的开发工作中使用 READONLY,并计划修改当前使用 READONLY 的应用程序。 请改用 READ_ONLY

READ_WRITE | READWRITE 指定组是 READ_WRITE。 允许更新文件组中的对象。 若要更改此状态,您必须对数据库有独占访问权限。 有关详细信息,请参阅 SINGLE_USER 子句。

注意

Microsoft SQL Server 的未来版本将删除 READWRITE 关键字。 请避免在新的开发工作中使用 READWRITE,并计划将当前使用 READWRITE 的应用程序修改为使用 READ_WRITE

提示

可通过查看 sys.databases 目录视图中的is_read_only 列,或者查看 DATABASEPROPERTYEX 函数的 Updateability 属性,来确定这些选项的状态。

备注

若要减小数据库的大小,请使用 DBCC SHRINKDATABASE

BACKUP 语句正在运行时,不能添加或删除文件。

可以为每个数据库指定最多 32,767 个文件和 32,767 个文件组。

从 SQL Server 2005 (9.x) 开始,对数据库文件状态(例如,联机或脱机)的维护是独立于数据库状态的。 有关详细信息,请参阅文件状态

  • 文件组中文件的状态决定整个文件组的可用性。 文件组中的所有文件都必须联机,文件组才可用。
  • 如果文件组脱机,则使用 SQL 语句访问文件组的所有尝试都会失败并报告错误。 在为 SELECT 语句生成查询计划时,查询优化器会避免使用驻留在脱机文件组中的非聚集索引和索引视图。 这样,这些语句就会成功。 但是,如果脱机文件组包含目标表的堆或聚集索引,SELECT 语句将失败。 此外,如果 INSERTUPDATEDELETE 语句修改的表的索引包含在脱机文件组中,这些语句将失败。

如果为该文件指定了 UNC 路径,则无法设置 SIZE、MAXSIZE 和 FILEGROWTH 参数。

无法为内存优化文件组设置 SIZE 和 FILEGROWTH 参数。

Microsoft SQL Server 的未来版本将删除 READONLY 关键字。 请避免在新的开发工作中使用 READONLY,并计划修改当前使用 READONLY 的应用程序。 请改用 READ_ONLY

Microsoft SQL Server 的未来版本将删除 READWRITE 关键字。 请避免在新的开发工作中使用 READWRITE,并计划将当前使用 READWRITE 的应用程序修改为使用 READ_WRITE

移动文件

您可通过在 FILENAME 中指定新位置来移动系统或用户定义的数据和日志文件。 这在下列情况下可能很有用:

  • 故障恢复。 例如,数据库处于可疑模式或因硬件故障而关闭。
  • 预先安排的重定位。
  • 为预定的磁盘维护操作而进行的重定位。

有关详细信息,请参阅移动数据库文件

初始化文件

默认情况下,在执行下列操作之一时,将通过在文件中填充零来初始化数据和日志文件。

  • 创建数据库。
  • 向现有数据库添加文件。
  • 增加现有文件的大小。
  • 还原数据库或文件组。

可以在瞬间对数据文件进行初始化。 这样,可以快速执行这些文件操作。 有关详细信息,请参阅 数据库文件初始化

删除 FILESTREAM 容器

即使已使用“DBCC SHRINKFILE”操作清空 FILESTREAM 容器,但出于各种系统维护原因,数据库可能仍然需要保留对已删除文件的引用。 sp_filestream_force_garbage_collection 会运行 FILESTREAM 垃圾回收器以删除这些文件,以便可安全地执行此操作。 除非 FILESTREAM 垃圾回收器已从 FILESTREAM 容器中删除所有文件,否则 ALTER DATABASE REMOVE FILE 操作将无法删除 FILESTREAM 容器并返回错误。 建议使用以下过程删除 FILESTREAM 容器。

  1. 运行带有 EMPTYFILE 选项的 DBCC SHRINKFILE,将此容器的活动内容移动到其他容器。
  2. 确保已在 FULL 或 BULK_LOGGED 恢复模型中执行日志备份。
  3. 确保复制日志读取器作业已运行(如果相关)。
  4. 运行 sp_filestream_force_garbage_collection 以强制垃圾回收器删除此容器中不再需要的任何文件。
  5. 执行带有 REMOVE FILE 选项的 ALTER DATABASE,以删除此容器。
  6. 再重复一次步骤 2 到 4,以完成垃圾回收。
  7. 使用 ALTER Database...REMOVE FILE 删除此容器。

示例

A. 向数据库中添加文件

以下示例将一个 5 MB 的数据文件添加到 AdventureWorks2022 数据库。

USE master;
GO
ALTER DATABASE AdventureWorks2022
ADD FILE
(
    NAME = Test1dat2,
    FILENAME = 'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\DATA\t1dat2.ndf',
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
);
GO

B. 向数据库中添加由两个文件组成的文件组

以下示例在 AdventureWorks2022 数据库中创建文件组 Test1FG1,然后将两个 5 MB 的文件添加到该文件组。

USE master
GO
ALTER DATABASE AdventureWorks2022
ADD FILEGROUP Test1FG1;
GO
ALTER DATABASE AdventureWorks2022
ADD FILE
(
    NAME = test1dat3,
    FILENAME = 'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\DATA\t1dat3.ndf',
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
),  
(  
    NAME = test1dat4,
    FILENAME = 'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\DATA\t1dat4.ndf',
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
)  
TO FILEGROUP Test1FG1;
GO

C. 向数据库中添加两个日志文件

以下示例将两个 5 MB 的日志文件添加到 AdventureWorks2022 数据库。

USE master;
GO
ALTER DATABASE AdventureWorks2022
ADD LOG FILE
(
    NAME = test1log2,
    FILENAME = 'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\DATA\test2log.ldf',
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
),
(
    NAME = test1log3,
    FILENAME = 'C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\DATA\test3log.ldf',
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
);
GO

D. 从数据库中删除文件

以下示例删除示例 B 中添加的一个文件。

USE master;
GO
ALTER DATABASE AdventureWorks2022
REMOVE FILE test1dat4;
GO

E. 修改文件

以下示例增加示例 B 中添加的一个文件的大小。带有 MODIFY FILE 命令的 ALTER DATABASE 只能增大文件大小,因此,如果需要缩小文件大小,则需使用 DBCC SHRINKFILE。

USE master;
GO

ALTER DATABASE AdventureWorks2022
MODIFY FILE
(NAME = test1dat3,
SIZE = 200MB);
GO

此示例将数据文件的大小缩小为 100 MB,然后指定该数量的大小。

USE AdventureWorks2022;
GO

DBCC SHRINKFILE (AdventureWorks2022_data, 100);
GO

USE master;
GO
ALTER DATABASE AdventureWorks2022
MODIFY FILE
(NAME = test1dat3,
SIZE = 200MB);
GO

F. 将文件移至新位置

以下示例将在示例 A 中创建的 Test1dat2 文件移至新目录中。

注意

必须先将该文件实际移至新目录中,然后才能运行此示例。 然后,停止和启动 SQL Server 的实例,或使 AdventureWorks2022 数据库 OFFLINE 再 ONLINE,以实施更改。

USE master;
GO
ALTER DATABASE AdventureWorks2022
MODIFY FILE
(
    NAME = Test1dat2,
    FILENAME = N'c:\t1dat2.ndf'
);
GO

G. 将 tempdb 移至新位置

以下示例将 tempdb 从其在磁盘上的当前位置移至另一个磁盘位置。 由于每次启动 MSSQLSERVER 服务时都会重新创建 tempdb,因此您不必实际移动数据和日志文件。 在步骤 3 中重新启动服务时,将创建这些文件。 在重新启动该服务之前,tempdb 将继续在现有位置发挥作用。

  1. 确定 tempdb 数据库的逻辑文件名称以及这些文件在磁盘上的当前位置。

    SELECT name, physical_name
    FROM sys.master_files
    WHERE database_id = DB_ID('tempdb');
    GO
    
  2. 使用 ALTER DATABASE更改每个文件的位置。

    USE master;
    GO
    ALTER DATABASE tempdb
    MODIFY FILE (NAME = tempdev, FILENAME = 'E:\SQLData\tempdb.mdf');
    GO
    ALTER DATABASE tempdb
    MODIFY FILE (NAME = templog, FILENAME = 'E:\SQLData\templog.ldf');
    GO
    
  3. 停止再重新启动 SQL Server的实例。

  4. 验证文件更改。

    SELECT name, physical_name
    FROM sys.master_files
    WHERE database_id = DB_ID('tempdb');
    
  5. 将 tempdb.mdf 和 templog.ldf 文件从其原始位置中删除。

H. 使文件组成为默认文件组

以下示例使示例 B 中创建的 Test1FG1 文件组成为默认文件组。 然后,默认文件组被重置为 PRIMARY 文件组。 请注意,必须使用括号或引号分隔 PRIMARY

USE master;
GO
ALTER DATABASE AdventureWorks2022
MODIFY FILEGROUP Test1FG1 DEFAULT;
GO
ALTER DATABASE AdventureWorks2022
MODIFY FILEGROUP [PRIMARY] DEFAULT;
GO

I. 使用 ALTER DATABASE 添加文件组

以下示例将一个包含 FILEGROUP 子句的 FILESTREAM 添加到 FileStreamPhotoDB 数据库。

--Create and add a FILEGROUP that CONTAINS the FILESTREAM clause.
ALTER DATABASE FileStreamPhotoDB
ADD FILEGROUP TodaysPhotoShoot
CONTAINS FILESTREAM;
GO

--Add a file for storing database photos to FILEGROUP
ALTER DATABASE FileStreamPhotoDB
ADD FILE
(
  NAME= 'PhotoShoot1',
  FILENAME = 'C:\Users\Administrator\Pictures\TodaysPhotoShoot.ndf'
)
TO FILEGROUP TodaysPhotoShoot;
GO

以下示例将一个包含 FILEGROUP 子句的 MEMORY_OPTIMIZED_DATA 添加到 xtp_db 数据库。 该文件组存储内存优化数据。

--Create and add a FILEGROUP that CONTAINS the MEMORY_OPTIMIZED_DATA clause.
ALTER DATABASE xtp_db
ADD FILEGROUP xtp_fg
CONTAINS MEMORY_OPTIMIZED_DATA;
GO

--Add a file for storing memory optimized data to FILEGROUP
ALTER DATABASE xtp_db
ADD FILE
(
  NAME='xtp_mod',
  FILENAME='d:\data\xtp_mod'
)
TO FILEGROUP xtp_fg;
GO

J. 更改文件组,以便当文件组中的某个文件达到自动增长阈值时,文件组中的所有文件都会增长

以下示例会生成所需的 ALTER DATABASE 语句,以使用 AUTOGROW_ALL_FILES 设置修改读写文件组。

--Generate ALTER DATABASE ... MODIFY FILEGROUP statements
--so that all read-write filegroups grow at the same time.
SET NOCOUNT ON;

DROP TABLE IF EXISTS #tmpdbs
CREATE TABLE #tmpdbs (id INT IDENTITY(1,1), [dbid] INT, [dbname] sysname, isdone BIT);

DROP TABLE IF EXISTS #tmpfgs
CREATE TABLE #tmpfgs (id INT IDENTITY(1,1), [dbid] INT, [dbname] sysname, fgname sysname, isdone BIT);

INSERT INTO #tmpdbs ([dbid], [dbname], [isdone])
SELECT database_id, name, 0 FROM master.sys.databases (NOLOCK) WHERE is_read_only = 0 AND state = 0;

DECLARE @dbid INT, @query VARCHAR(1000), @dbname sysname, @fgname sysname

WHILE (SELECT COUNT(id) FROM #tmpdbs WHERE isdone = 0) > 0
BEGIN
  SELECT TOP 1 @dbname = [dbname], @dbid = [dbid] FROM #tmpdbs WHERE isdone = 0

  SET @query = 'SELECT ' + CAST(@dbid AS NVARCHAR) + ', ''' + @dbname + ''', [name], 0 FROM [' + @dbname + '].sys.filegroups WHERE [type] = ''FG'' AND is_read_only = 0;'
  INSERT INTO #tmpfgs
  EXEC (@query)

  UPDATE #tmpdbs
  SET isdone = 1
  WHERE [dbid] = @dbid
END;

IF (SELECT COUNT(ID) FROM #tmpfgs) > 0
BEGIN
  WHILE (SELECT COUNT(id) FROM #tmpfgs WHERE isdone = 0) > 0
  BEGIN
    SELECT TOP 1 @dbname = [dbname], @dbid = [dbid], @fgname = fgname FROM #tmpfgs WHERE isdone = 0

    SET @query = 'ALTER DATABASE [' + @dbname + '] MODIFY FILEGROUP [' + @fgname + '] AUTOGROW_ALL_FILES;'

    PRINT @query

    UPDATE #tmpfgs
    SET isdone = 1
    WHERE [dbid] = @dbid AND fgname = @fgname
  END
END;
GO

另请参阅

* SQL 托管实例 *
 

 

Azure SQL 托管实例

对 Azure SQL 托管实例中的数据库使用此语句。

Azure SQL 托管实例的语法

ALTER DATABASE database_name
{
    <add_or_modify_files>
  | <add_or_modify_filegroups>
}
[;]

<add_or_modify_files>::=
{
    ADD FILE <filespec> [ ,...n ]
        [ TO FILEGROUP { filegroup_name } ]
  | REMOVE FILE logical_file_name
  | MODIFY FILE <filespec>
}

<filespec>::=
(
    NAME = logical_file_name
    [ , SIZE = size [ KB | MB | GB | TB ] ]
    [ , MAXSIZE = { max_size [ KB | MB | GB | TB ] | UNLIMITED } ]
    [ , FILEGROWTH = growth_increment [ KB | MB | GB | TB| % ] ]
)

<add_or_modify_filegroups>::=
{
    | ADD FILEGROUP filegroup_name
    | REMOVE FILEGROUP filegroup_name
    | MODIFY FILEGROUP filegroup_name
        { <filegroup_updatability_option>
        | DEFAULT
        | NAME = new_filegroup_name
        | { AUTOGROW_SINGLE_FILE | AUTOGROW_ALL_FILES }
        }
}  
<filegroup_updatability_option>::=
{
    { READONLY | READWRITE }
    | { READ_ONLY | READ_WRITE }
}

参数

<add_or_modify_files>::=

指定要添加、删除或修改的文件。

database_name 要修改的数据库的名称。

ADD FILE 向数据库中添加文件。

TO FILEGROUP { filegroup_name } 指定要将指定文件添加到的文件组。 若要显示当前文件组和当前的默认文件组,请使用 sys.filegroups 目录视图。

REMOVE FILE logical_file_name 从 SQL Server 的实例中删除逻辑文件说明并删除物理文件。 除非文件为空,否则无法删除文件。

logical_file_name 在 SQL Server 中引用文件时所用的逻辑名称。

MODIFY FILE 指定应修改的文件。 一次只能更改一个 <filespec> 属性。 必须始终在 <filespec> 中指定 NAME,以标识要修改的文件。 如果指定了 SIZE,那么新大小必须比文件当前大小要大。

<filespec>::=

控制文件属性。

NAME logical_file_name 指定文件的逻辑名称。

logical_file_name 在 SQL Server 的实例中引用文件时所用的逻辑名称。

NEWNAME new_logical_file_name 指定文件的新逻辑名称。

new_logical_file_name 用于替换现有逻辑文件名称的名称。 该名称在数据库中必须唯一,并且必须符合标识符规则。 该名称可以是字符或 Unicode 常量、常规标识符或分隔标识符。

SIZE size 指定文件大小。

size 文件的大小。

与 ADD FILE 一起指定时,size 是文件的初始大小。 与 MODIFY FILE 一起指定时,size 是文件的新大小,而且必须大于文件的当前大小。

如果没有为主文件提供 size,SQL Server 会使用 model 数据库中主文件的大小。 如果指定了辅助数据文件或日志文件,但未指定该文件的 size,数据库引擎会以 1 MB 作为该文件的大小。

后缀 KB、MB、GB 和 TB 可用于指定千字节、兆字节、千兆字节或兆兆字节。 默认值为 MB。 指定整数,不包含小数。 若要指定兆字节的分数,请通过将数字乘以 1024 将该值转换为千字节。 例如,应指定 1536 KB 而不是 1.5MB (1.5 x 1024 = 1536)。

MAXSIZE { max_size| UNLIMITED } 指定文件可增大到的最大文件大小。

max_size 最大的文件大小。 后缀 KB、MB、GB 和 TB 可用于指定千字节、兆字节、千兆字节或兆兆字节。 默认值为 MB。 指定整数,不包含小数。 如果未指定 max_size,文件大小将一直增长到磁盘变满为止。

UNLIMITED 指定文件将增长到磁盘充满。 在 SQL Server 中,指定为不限制增长的日志文件的最大大小为 2 TB,而数据文件的最大大小为 16 TB。

FILEGROWTH growth_increment 指定文件的自动增量。 文件的 FILEGROWTH 设置不能超过 MAXSIZE 设置。

growth_increment 每次需要新空间时为文件添加的空间量。

该值可以 MB、KB、GB、TB 或百分比 (%) 为单位指定。 如果未在数量后面指定 MB、KB 或 %,则默认值为 MB。 如果指定 %,则增量大小为发生增长时文件大小的指定百分比。 指定的大小舍入为最接近的 64 KB 的倍数。

如果值为 0,则表明自动增长被设置为关闭,且不允许增加空间。

如果未指定 FILEGROWTH,则默认值为:

  • 数据 16 MB
  • 日志文件 16 MB

<add_or_modify_filegroups>::=

在数据库中添加、修改或删除文件组。

ADD FILEGROUP filegroup_name 向数据库中添加文件组。

下面的示例创建添加到一个添加到名为 sql_db_mi 的数据库的文件组,然后向该文件组添加一个文件。

ALTER DATABASE sql_db_mi ADD FILEGROUP sql_db_mi_fg;
GO
ALTER DATABASE sql_db_mi ADD FILE (NAME='sql_db_mi_mod') TO FILEGROUP sql_db_mi_fg;

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。 数据库中只能有一个文件组作为默认文件组。 有关详细信息,请参阅 数据库文件和文件组

NAME = new_filegroup_name 将文件组名称改为 new_filegroup_name。

AUTOGROW_SINGLE_FILE

当文件组中的某个文件达到自动增长阈值时,只有该文件会增长。 这是默认值。

AUTOGROW_ALL_FILES

当文件组中的某个文件达到自动增长阈值时,文件组中的所有文件都会增长。

<filegroup_updatability_option>::=

对文件组设置只读或读/写属性。

READ_ONLY | READONLY 指定文件组为只读。 不允许更新其中的对象。 主文件组不能设置为只读。 若要更改此状态,您必须对数据库有独占访问权限。 有关详细信息,请参阅 SINGLE_USER 子句。

因为只读数据库不允许数据修改,所以将发生以下情况:

  • 系统启动时,将跳过自动恢复。
  • 不能收缩数据库。
  • 在只读数据库中不会进行锁定。 这可以加快查询速度。

备注

Microsoft SQL Server 的未来版本将删除 READONLY 关键字。 请避免在新的开发工作中使用 READONLY,并计划修改当前使用 READONLY 的应用程序。 Use READ_ONLY instead.

READ_WRITE | READWRITE 指定组是 READ_WRITE。 允许更新文件组中的对象。 若要更改此状态,您必须对数据库有独占访问权限。 有关详细信息,请参阅 SINGLE_USER 子句。

注意

Microsoft SQL Server 的未来版本将删除 READWRITE 关键字。 请避免在新的开发工作中使用 READWRITE,并计划将当前使用 READWRITE 的应用程序修改为使用 READ_WRITE

可通过查看 sys.databases 目录视图中的is_read_only 列,或者查看 DATABASEPROPERTYEX 函数的 Updateability 属性,来确定这些选项的状态。

备注

若要减小数据库的大小,请使用 DBCC SHRINKDATABASE

BACKUP 语句正在运行时,不能添加或删除文件。

可以为每个数据库指定最多 32,767 个文件和 32,767 个文件组。

示例

A. 向数据库中添加文件

以下示例将一个 5 MB 的数据文件添加到 AdventureWorks2022 数据库。

USE master;
GO
ALTER DATABASE AdventureWorks2022
ADD FILE
(
  NAME = Test1dat2,
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
);
GO

B. 向数据库中添加由两个文件组成的文件组

以下示例在 AdventureWorks2022 数据库中创建文件组 Test1FG1,然后将两个 5 MB 的文件添加到该文件组。

USE master
GO
ALTER DATABASE AdventureWorks2022
ADD FILEGROUP Test1FG1;
GO
ALTER DATABASE AdventureWorks2022
ADD FILE
(
    NAME = test1dat3,
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
),
(
    NAME = test1dat4,
    SIZE = 5MB,
    MAXSIZE = 100MB,
    FILEGROWTH = 5MB
)  
TO FILEGROUP Test1FG1;
GO

C. 从数据库中删除文件

以下示例删除示例 B 中添加的一个文件。

USE master;
GO
ALTER DATABASE AdventureWorks2022
REMOVE FILE test1dat4;
GO

D. 修改文件

以下示例增加示例 B 中添加的一个文件的大小。带有 MODIFY FILE 命令的 ALTER DATABASE 只能增大文件大小,因此,如果需要缩小文件大小,则需使用 DBCC SHRINKFILE。

USE master;
GO

ALTER DATABASE AdventureWorks2022
MODIFY FILE
(NAME = test1dat3,
SIZE = 200MB);
GO

此示例将数据文件的大小缩小为 100 MB,然后指定该数量的大小。

USE AdventureWorks2022;
GO

DBCC SHRINKFILE (AdventureWorks2022_data, 100);
GO

USE master;
GO

ALTER DATABASE AdventureWorks2022
MODIFY FILE
(NAME = test1dat3,
SIZE = 200MB);
GO

E. 使文件组成为默认文件组

以下示例使示例 B 中创建的 Test1FG1 文件组成为默认文件组。 然后,默认文件组被重置为 PRIMARY 文件组。 请注意,必须使用括号或引号分隔 PRIMARY

USE master;
GO
ALTER DATABASE AdventureWorks2022
MODIFY FILEGROUP Test1FG1 DEFAULT;
GO
ALTER DATABASE AdventureWorks2022
MODIFY FILEGROUP [PRIMARY] DEFAULT;
GO

F. 使用 ALTER DATABASE 添加文件组

以下示例将 FILEGROUP 添加到 MyDB 数据库。

--Create and add a FILEGROUP
ALTER DATABASE MyDB
ADD FILEGROUP NewFG;
GO

--Add a file to FILEGROUP
ALTER DATABASE MyDB
ADD FILE
(
    NAME= 'MyFile',
)
TO FILEGROUP NewFG;
GO

G. 更改文件组,以便当文件组中的某个文件达到自动增长阈值时,文件组中的所有文件都会增长

以下示例会生成所需的 ALTER DATABASE 语句,以使用 AUTOGROW_ALL_FILES 设置修改读写文件组。

--Generate ALTER DATABASE ... MODIFY FILEGROUP statements
--so that all read-write filegroups grow at the same time.
SET NOCOUNT ON;

DROP TABLE IF EXISTS #tmpdbs
CREATE TABLE #tmpdbs (id INT IDENTITY(1,1), [dbid] INT, [dbname] sysname, isdone BIT);

DROP TABLE IF EXISTS #tmpfgs
CREATE TABLE #tmpfgs (id INT IDENTITY(1,1), [dbid] INT, [dbname] sysname, fgname sysname, isdone BIT);

INSERT INTO #tmpdbs ([dbid], [dbname], [isdone])
SELECT database_id, name, 0 FROM master.sys.databases (NOLOCK) WHERE is_read_only = 0 AND state = 0;

DECLARE @dbid INT, @query VARCHAR(1000), @dbname sysname, @fgname sysname

WHILE (SELECT COUNT(id) FROM #tmpdbs WHERE isdone = 0) > 0
BEGIN
    SELECT TOP 1 @dbname = [dbname], @dbid = [dbid] FROM #tmpdbs WHERE isdone = 0

    SET @query = 'SELECT ' + CAST(@dbid AS NVARCHAR) + ', ''' + @dbname + ''', [name], 0 FROM [' + @dbname + '].sys.filegroups WHERE [type] = ''FG'' AND is_read_only = 0;'
    INSERT INTO #tmpfgs
    EXEC (@query)

    UPDATE #tmpdbs
    SET isdone = 1
    WHERE [dbid] = @dbid
END;

IF (SELECT COUNT(ID) FROM #tmpfgs) > 0
BEGIN
    WHILE (SELECT COUNT(id) FROM #tmpfgs WHERE isdone = 0) > 0
    BEGIN
        SELECT TOP 1 @dbname = [dbname], @dbid = [dbid], @fgname = fgname FROM #tmpfgs WHERE isdone = 0

        SET @query = 'ALTER DATABASE [' + @dbname + '] MODIFY FILEGROUP [' + @fgname + '] AUTOGROW_ALL_FILES;'

        PRINT @query

        UPDATE #tmpfgs
        SET isdone = 1
        WHERE [dbid] = @dbid AND fgname = @fgname
    END
END;
GO

另请参阅