sys.database_mirroring (Transact-SQL)

Contains one row for each database in the instance of SQL Server. If the database is not ONLINE or database mirroring is not enabled, the values of all columns except database_id will be NULL.

To see the row for a database other than master or tempdb, you must either be the database owner or have at least ALTER ANY DATABASE or VIEW ANY DATABASE server-level permission or CREATE DATABASE permission in the master database.

Note

If a database does not participate in mirroring, all columns prefixed with mirroring_ are NULL.

Column name

Data type

Description

database_id

int

ID of the database. Is unique within an instance of SQL Server.

mirroring_guid

uniqueidentifier

ID of the mirroring partnership.

NULL= Database is inaccessible or is not mirrored.

Note:

If the database does not participate in mirroring, all columns prefixed with mirroring_ are NULL.

mirroring_state

tinyint

State of the mirror database and of the database mirroring session.

0 = Suspended

1 = Disconnected from the other partner

2 = Synchronizing

3 = Pending Failover

4 = Synchronized

NULL = Database is inaccessible or is not mirrored.

mirroring_state_desc

nvarchar(60)

Description of the state of the mirror database and of the database mirroring session, can be one of:

DISCONNECTED

SYNCHRONIZED

SYNCHRONIZING

PENDING_FAILOVER

SUSPENDED

NULL

For more information, see Mirroring States.

mirroring_role

tinyint

Current role of the local database plays in the database mirroring session.

1 = Principal

2 = Mirror

NULL = Database is inaccessible or is not mirrored.

mirroring_role_desc

nvarchar(60)

Description of the role the local database plays in mirroring, can be one of:

PRINCIPAL

MIRROR

mirroring_role_sequence

int

The number of times that mirroring partners have switched the principal and mirror roles due to a failover or forced service.

NULL = Database is inaccessible or is not mirrored.

mirroring_safety_level

tinyint

Safety setting for updates on the mirror database:

0 = Unknown state

1 = Off [asynchronous]

2 = Full [synchronous]

NULL = Database is inaccessible or is not mirrored.

mirroring_safety_level_desc

tinyint

Transaction safety setting for the updates on the mirror database, can be one of:

UNKNOWN

OFF

FULL

NULL

mirroring_safety_sequence

int

Update the sequence number for changes to transaction safety level.

NULL = Database is inaccessible or is not mirrored.

mirroring_partner_name

nvarchar(128)

Server name of the database mirroring partner.

NULL = Database is inaccessible or is not mirrored.

mirroring_partner_instance

nvarchar(128)

The instance name and computer name for the other partner. Clients require this information to connect to the partner if it becomes the principal server.

NULL = Database is inaccessible or is not mirrored.

mirroring_witness_name

nvarchar(128)

Server name of the database mirroring witness

NULL = No witness exists.

mirroring_witness_state

tinyint

State of the witness in the database mirroring session of the database, can be one of:

0 = Unknown

1= Connected

2 = Disconnected

NULL = No witness exists, the database is not online, or the database is not mirrored.

mirroring_witness_state_desc

nvarchar(60)

Description of state, can be one of:

UNKNOWN

CONNECTED

DISCONNECTED

NULL

mirroring_failover_lsn

numeric(25,0)

Log sequence number (LSN) of the latest transaction log record that is guaranteed to be hardened to disk on both partners. After a failover, the mirroring_failover_lsn is used by the partners as the point of reconciliation at which the new mirror server begins to synchronize the new mirror database with the new principal database.

mirroring_connection_timeout

int

Mirroring connection time out in seconds. This is the number of seconds to wait for reply from partner or witness before considering them unavailable. The default time-out value is 10 seconds.

NULL = Database is inaccessible or is not mirrored.

mirroring_redo_queue

int

Maximum amount of log to be redone on the mirror. If mirroring_redo_queue_type is set to UNLIMITED, which is the default setting, this column is NULL. If the database is not online, this column is also NULL.

Otherwise, this column contains the maximum amount of log in megabytes. When the maximum is reached, the log is temporarily stalled on the principal as the mirror server catches up. This feature limits failover time.

For more information, see Estimating the Interruption of Service During Role Switching.

mirroring_redo_queue_type

nvarchar(60)

UNLIMITED indicates that mirroring will not inhibit the redo queue. This is the default setting.

MB for maximum size of the redo queue in mega bytes. Note that if the queue size was specified as kilobytes or gigabytes, the SQL Server 2005 Database Engine converts the value into megabytes.

If the database is not online, this column is NULL.

See Also

Reference

Catalog Views (Transact-SQL)
ALTER DATABASE (Transact-SQL)
sys.database_mirroring_witnesses (Transact-SQL)
sys.database_mirroring_endpoints (Transact-SQL)
Databases and Files Catalog Views (Transact-SQL)

Other Resources

Setting Database Options
Querying the SQL Server System Catalog FAQ

Help and Information

Getting SQL Server 2005 Assistance

Change History

Release	History
14 April 2006	Changed content: Clarified the description of mirroring_state value 1.