Compartir a través de


sys.dm_hs_database_replicas (Transact-SQL)

se aplica a: de Azure SQL Database

La sys.dm_hs_database_replicas función de administración dinámica (DMF) devuelve información sobre las réplicas secundarias de Hiperescala de Azure SQL Database de una base de datos hiperescala determinada.

Syntax

sys.dm_hs_database_replicas ( 
{ database_id | NULL }                                     
)                             

Arguments

ID de base de datos

database_id es un entero que representa el identificador de base de datos, sin ningún valor predeterminado. Las entradas válidas son un identificador de base de datos o NULL.

Cuando se proporciona sys.dm_hs_database_replicas , database_id devuelve una fila para esa base de datos específica.

Cuando no se proporciona o cuando NULL se proporciona, para una base de datos única, devuelve una fila para la base de datos actual. Para una base de datos de un grupo elástico, devuelve filas para todas las bases de datos del grupo donde el autor de la llamada tiene permisos suficientes.

Se puede especificar la función integrada DB_ID .

Tabla devuelta

Nombre de la columna Tipo de dato Description
replica_id uniqueidentifier Identificador de la réplica. No admite valores NULL.
replica_server_name sysname Nombre del servidor lógico donde reside la réplica. No admite valores NULL.
replica_database_name sysname Nombre de la base de datos de réplica. No admite valores NULL.
is_local bit Si la base de datos de réplica es local:
1 = La base de datos de réplica es la a la que está conectado al consultar sys.dm_hs_database_replicas.
0 = La base de datos de réplica no es la a la que está conectado.
replica_role tinyint Rol de réplica:
0 = Principal
1 = Alta disponibilidad secundaria
2 = reenviador de replicación geográfica
3 = Réplica con nombre. No admite valores NULL.
replica_role_desc nvarchar(256) Primario
Alta disponibilidad secundaria
Reenviador de replicación geográfica
Réplica con nombre. </ br/ br/ br><> no acepta valores NULL.
local_database_id int Identificador de la base de datos.
En Azure SQL Database, los valores son únicos dentro de una base de datos única o un grupo elástico, pero no dentro del servidor lógico.
parent_replica_id uniqueidentifier Solo se aplica a las réplicas de alta disponibilidad.
Identificador de la réplica primaria (por ejemplo, principal, reenviador geográfico o réplica con nombre que tiene una réplica de alta disponibilidad). Nullable.

Observaciones

La sys.dm_hs_database_replicas función de administración dinámica solo se aplica actualmente al nivel hiperescala de Azure SQL Database.

Aunque puede agregar réplicas secundarias a una réplica secundaria geográfica de la base de datos principal, sys.dm_hs_database_replicas no devuelve filas para las réplicas secundarias agregadas en la réplica secundaria geográfica cuando se consulta en la réplica principal. Debe consultar sys.dm_hs_database_replicas cuándo se conecta a una réplica secundaria geográfica para enumerar las réplicas secundarias agregadas en ella.

Permissions

Esta función de administración dinámica requiere el permiso VIEW DATABASE PERFORMANCE STATE. Para obtener más información, consulte Vistas de administración dinámica del sistema. Para consultar una base de datos agrupada, se necesita el permiso VIEW SERVER STATE. Si el autor de la llamada tiene el permiso VIEW DATABASE PERFORMANCE STATE, se devuelven las filas de las bases de datos donde se mantiene este permiso.

Examples

A. Devolver la réplica principal y todas las réplicas secundarias de una base de datos creada en el nivel Hiperescala

En el ejemplo siguiente se devuelve una fila para cada réplica secundaria agregada en la base de datos hiperescala.

SELECT replica_role_desc, replica_server_name, replica_id
FROM sys.dm_hs_database_replicas(DB_ID(N'Contosodb'));