Referência da tabela do sistema de replicação

Importante

Este recurso está em Versão prévia privada. Para experimentá-lo, entre em contato com o representante do Azure Databricks.

Esta página fornece uma referência para a states tabela no esquema do replication sistema, que rastreia o status de replicação de Azure Databricks recuperação de desastre gerenciada (DR). Cada linha é um evento de status para um grupo de failover, emitido periodicamente e sempre que o grupo de failover é alterado. Use esta tabela para monitorar o status de replicação atual e histórico de seus grupos de failover, incluindo o atraso de replicação e quaisquer erros que estejam bloqueando a replicação de pelo menos um ativo.

Caminho da tabela: system.replication.states

Referência de esquema de tabela de estados

A states tabela usa o seguinte esquema:

Nome da coluna Tipo de dados Descrição Example
event_id cadeia Identificador exclusivo para o evento de status. ca886134-876c-4671-a38b-332edf48c602
event_time carimbo de data/hora Carimbo de data/hora de quando o evento foi emitido. 2024-01-05T00:00:00.000+00:00
account_id cadeia ID da conta à qual o grupo de failover pertence. ca886134-876c-4671-a38b-332edf48c602
failover_group_name cadeia Nome totalmente qualificado do grupo de failover. accounts/account1/failover-group/group1
replication_state cadeia Estado da replicação quando o evento foi emitido. Os valores possíveis sãoINITIALIZING, , REPLICATING, CREATED, UPDATED, DELETED, FAILOVER_STARTED, e FAILOVER_FINISHEDFAILOVER_ABORTED. REPLICATING
errors matriz Quando replication_state é REPLICATING, uma lista agregada dos erros que estão bloqueando a replicação de pelo menos um ativo, incluindo quantos ativos cada erro afeta. Caso contrário, os erros que causaram a falha da operação. Consulte a referência de Erros. Consulte a referência de erros
replication_lag_ms long Milissegundos desde a última replicação bem-sucedida quando o evento foi emitido. Um null valor indica que pelo menos um ativo nunca foi replicado da origem para a réplica. 2323
effective_primary_region cadeia A região primária do grupo de failover no momento em que o evento foi emitido. us-west-2
managed_assets struct Os ativos gerenciados pelo grupo de failover quando o evento foi emitido. Consulte a referência de ativos gerenciados. Consulte a referência de ativos gerenciados

Referência de erros

A errors coluna contém uma matriz dos erros que estão bloqueando a replicação. Cada elemento da matriz é um struct com os seguintes campos:

Nome do campo Tipo de dados Descrição
error struct Detalhes sobre o erro. Contém error_class (cadeia de caracteres), um nome de classe para o erro; parameters (mapa), parâmetros chave-valor com detalhes sobre o erro; e message (cadeia de caracteres), uma mensagem de erro legível por humanos.
affected_assets_counts matriz Uma entrada por tipo de ativo afetado. Cada entrada contém asset_type (cadeia de caracteres), o tipo do ativo afetado e failing_count (longo), o número de ativos desse tipo que o erro afeta.

Referência de ativos gerenciados

A managed_assets coluna é um struct que descreve os ativos gerenciados pelo grupo de failover quando o evento foi emitido. Ela contém os seguintes campos:

Nome do campo Tipo de dados Descrição
metastores matriz Os metastores gerenciados pelo grupo de failover.
workspace_sets matriz Os conjuntos de workspaces gerenciados pelo grupo de failover. Cada entrada contém name (cadeia de caracteres) e workspace_ids (matriz).
catalogs matriz Os catálogos gerenciados pelo grupo de failover. Cada entrada contém name (cadeia de caracteres).

Considerações ao ler a tabela

Anote o seguinte ao analisar a states tabela:

  • Os dados podem levar até 3 horas para serem preenchidos após a ocorrência de um evento.
  • A tabela contém eventos para todos os grupos de failover na conta Azure Databricks.

Consultas de exemplo

A consulta a seguir retorna o status de replicação mais recente para um determinado grupo de failover, incluindo seu atual replication_state, retardo de replicação e quaisquer erros de bloqueio:

SELECT
  event_time,
  replication_state,
  replication_lag_ms,
  errors
FROM system.replication.states
WHERE failover_group_name = :failover_group_name
ORDER BY event_time DESC
LIMIT 1

A consulta a seguir retorna a distribuição do atraso de replicação para um determinado grupo de failover:

SELECT histogram_numeric(replication_lag_ms, 20) AS replication_lag_distribution
FROM system.replication.states
WHERE failover_group_name = :failover_group_name