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

Important

Esta funcionalidade está em Pré-visualização Privada. Para experimentar, contacte o seu contacto do Azure Databricks.

Esta página fornece uma referência para a states tabela no replication esquema do sistema, que acompanha o estado de replicação do Azure Databricks managed disaster recovery (DR). Cada linha é um evento de estado para um grupo de failover, emitido periodicamente e sempre que o grupo de failover muda. Use esta tabela para monitorizar o estado atual e histórico de replicação dos seus grupos de failover, incluindo o atraso de replicação e quaisquer erros que estejam a bloquear a replicação de pelo menos um ativo.

Caminho da tabela: system.replication.states

Referência do esquema da tabela de estados

A states tabela usa o seguinte esquema:

Nome da coluna Tipo de dados Description Example
event_id cadeia (de caracteres) Identificador único para o evento de estado. ca886134-876c-4671-a38b-332edf48c602
event_time carimbo de data/hora Carimbo temporal de quando o evento foi emitido. 2024-01-05T00:00:00.000+00:00
account_id cadeia (de caracteres) ID da conta a que pertence o grupo de failover. ca886134-876c-4671-a38b-332edf48c602
failover_group_name cadeia (de caracteres) Nome totalmente qualificado do grupo de failover. accounts/account1/failover-group/group1
replication_state cadeia (de caracteres) Estado da replicação quando o evento foi emitido. Os valores possíveis são INITIALIZING, REPLICATING, CREATED, UPDATED, DELETED, FAILOVER_STARTED, FAILOVER_FINISHED, e FAILOVER_ABORTED. REPLICATING
errors matriz Quando replication_state é REPLICATING, uma lista agregada dos erros que bloqueiam 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. Ver referência a Erros. Ver 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 fonte até à réplica. 2323
effective_primary_region cadeia (de caracteres) A região principal do grupo de failover no momento em que o evento foi emitido. us-west-2
managed_assets estrutura Os ativos geridos pelo grupo de failover quando o evento foi emitido. Consulte a referência de ativos geridos. Ver referência de ativos geridos

Referência de erros

A errors coluna contém um array dos erros que bloqueiam a replicação. Cada elemento do array é uma estrutura com os seguintes campos:

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

Referência de ativos geridos

A managed_assets coluna é uma estrutura que descreve os ativos geridos pelo grupo de failover quando o evento foi emitido. Contém os seguintes campos:

Nome do campo Tipo de dados Description
metastores matriz Os metastores geridos pelo grupo de failover.
workspace_sets matriz Os conjuntos de espaço de trabalho geridos pelo grupo de failover. Cada entrada contém name (string) e workspace_ids (array).
catalogs matriz Os catálogos geridos pelo grupo de failover. Cada entrada contém name (string).

Considerações ao ler a tabela

Tenha em atenção o seguinte ao analisar a states tabela:

  • Os dados podem demorar até 3 horas a ser preenchidos após um evento ocorrer.
  • A tabela contém eventos para todos os grupos de failover na conta Azure Databricks.

Exemplos de consultas

A consulta seguinte devolve o estado de replicação mais recente para um dado grupo de failover, incluindo o seu atual replication_state, o atraso 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 seguinte devolve a distribuição do atraso de replicação para um dado 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
  • Last updated on