FileGroup Object

SQL-DMO

SQL-DMO

FileGroup Object

The FileGroup object exposes the attributes of a Microsoft® SQL Server™ 2000 filegroup.

Properties
Default Property (FileGroup) ReadOnly Property
ID Property Size Property
Name Property  
Methods
CheckFilegroup Method EnumObjects Method
CheckFilegroupDataOnly Method Remove Method (Objects)
EnumFiles Method (FileGroup)  

Remarks

A SQL Server filegroup categorizes the operating system files containing data from a single SQL Server database to simplify database administration tasks, such as backup. A filegroup is a property of a SQL Server database and cannot contain the operating system files of more than one database, though a single database can contain more than one filegroup.

When a database is created, it is created on exactly one filegroup named PRIMARY. After database creation, filegroups can be added to the database. A filegroup name can be specified in a CREATE TABLE or CREATE INDEX statement, directing data storage for a database.

With the FileGroup object, you can:

  • Create a SQL Server filegroup.

  • Remove an existing SQL Server filegroup.

  • Manage the physical storage of a SQL Server database by adding or removing DBFile objects to the DBFiles collection.

The Name property of a FileGroup object uses the SQL Server data type sysname. The Name property must be unique within the list of filegroups of a SQL Server database.

To create a SQL Server filegroup

  1. Create a FileGroup object.

  2. Set the Name property.

  3. Add the FileGroup object to the FileGroups collection of a connected Database object.

Note  The FileGroup object is compatible with instances of SQL Server 2000 and SQL Server version 7.0. However, the FileGroup2 object extends the functionality of the FileGroup object for use with features that are new in SQL Server 2000.

See Also

CREATE INDEX

CREATE TABLE

FileGroup2 Object