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

Important

O DR gerido é de acesso restrito. Candidate-se ao acesso através da sua equipa de contas Azure Databricks. O Azure Databricks ativa o DR gerido na sua conta depois de ser aceite.

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

Como ler o estado da replicação

Os eventos de estado são emitidos a intervalos regulares. Cada evento reporta o estado agregado do grupo de failover, o atraso atual e quaisquer erros que estejam a bloquear a replicação de pelo menos um ativo. Não lista quais os objetos individuais que se replicaram com sucesso.

Quando replication_lag_ms não nullé , tudo o que não está coberto por um erro nesse evento foi replicado até esse lag. Outros ativos dentro do âmbito continuam a replicar e mantêm-se atualizados até ao lag, mesmo quando o errors array não está vazio. Durante INITIAL_REPLICATION, antes de todos os ativos dentro do âmbito terem sido replicados uma vez, replication_lag_ms pode ser null: o evento ainda pode listar erros de bloqueio, mas ainda não mede a completude.

Os tipos de ativos que o DR gerido não suporta de todo não aparecem na tabela, nem como sucesso nem como erro. A ausência deles não significa que tenham replicado. Consulte Limitações. Ativos dentro do âmbito que utilizam uma funcionalidade não suportada, como filtros de linhas, máscaras de coluna ou controlo de acesso baseado em atributos (ABAC), aparecem na tabela como falhas.

Para confirmar que existe um ativo específico no secundário, inspecione o objeto aí. Como os catálogos secundários dentro do âmbito são apenas de leitura, o Azure Databricks recomenda um espaço de trabalho separado para monitores de leitura na região secundária. Veja Configurar replicação.

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 INITIAL_REPLICATION, ACTIVE, CREATED, UPDATED, DELETED, FAILOVER_STARTED, FAILOVER_FINISHED, e FAILOVER_ABORTED.	ACTIVE
errors	matriz	Quando replication_state é INITIAL_REPLICATION ou ACTIVE, uma lista agregada dos erros que bloqueiam a replicação de pelo menos um ativo, incluindo quantos ativos cada erro afeta. Ver referência a Erros.	Ver referência de Erros
replication_lag_ms	long	Milissegundos desde a última replicação bem-sucedida de todos os ativos dentro do âmbito quando o evento foi emitido. Um null valor indica que pelo menos um ativo nunca foi replicado da fonte até à réplica. Um valor crescente significa que a DR não consegue replicar pelo menos um ativo dentro do âmbito, mas as alterações a outros ativos dentro do âmbito continuam a ser replicadas.	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
metastore_ids	matriz	Os IDs dos 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