• Article

FileGroups Collection

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The FileGroups collection contains FileGroup objects that reference the filegroups of a Microsoft SQL Server database.

SQL-DMO object model that shows the current object

Properties

Count Property

Remarks

SQL Server filegroups can be used to associate the operating system files used to maintain database data. Filegroups can simplify administrative tasks such as backup and restore operations. By default, a SQL Server database is created on exactly one filegroup called PRIMARY.

With the FileGroups collection, you can:

  • Create a new SQL Server filegroup.

  • Remove a SQL Server filegroup.

When using the Item or Remove method, the FileGroups collection supports member identification using either name or ordinal reference syntax. For example:

Set oFileGroup = oDatabase.FileGroups("PRIMARY")

Or

Set oFileGroup = oDatabase.FileGroups(1)

Note

Using the FileGroups collection to create or remove SQL Server database filegroups requires appropriate privilege. The SQL Server login used for SQLServer object connection must be a member of one of the fixed roles sysadmin or diskadmin.