Crie uma instância secundária

info

Visualização

Esse recurso está em Public Preview nas seguintes regiões: us-east-1, us-west-2, eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, us-east-2, ap-south-1.

Esta página explica como criar uma instância secundária a partir de uma instância existente do banco de dados Lakebase.

Uma instância secundária é um clone de cópia na gravação da instância original do banco de dados. Ele pode ser criado a partir do momento atual ou de um ponto no tempo histórico dentro da janela de retenção.

Uma janela de retenção especifica o intervalo de tempo durante o qual você pode realizar a recuperação pontual. O senhor pode criar uma instância secundária a qualquer momento dentro dessa janela de retenção, sem esperar pela exportação manual do Snapshot ou do banco de dados completo. A instância secundária contém os dados como eles existiam no momento especificado.

A criação de uma instância secundária é útil nos seguintes cenários:

• Recuperação de perda acidental de dados: Se uma tabela crítica foi descartada às 10h23 de ontem, o senhor pode gerar uma instância secundária definida para 10h22 para extrair apenas os dados ausentes e merge recuperá-los.
• Ambientes de teste e controle de qualidade: Clone um ambiente semelhante ao de produção a partir de qualquer ponto nos últimos X dias (conforme definido por sua janela de retenção) para validar alterações de esquema ou executar testes de integração.
• Conformidade e auditoria: provisionamento de uma instância secundária que reflete o estado do banco de dados em uma data anterior para auditorias internas, reconciliações financeiras ou análise forense.

Etapa 1: configurar a janela de retenção em uma instância de banco de dados

Os valores válidos para a janela de retenção estão entre 2 e 35 dias, inclusive. A janela do site default é de 7 dias. Você pode especificar a janela de retenção em uma instância de banco de dados durante a criação da instância. Consulte Criar uma instância de banco de dados.

Você pode modificar a janela de retenção de uma instância de banco de dados atualizando a instância do banco de dados. Use a UI ou a API para executar as seguintes etapas:

UI

1. Clique em Computação na barra lateral do workspace.
2. Clique em Database instances (Instâncias de banco de dados ) tab.
3. Selecione a instância do banco de dados que você deseja atualizar.
4. Clique em Editar no canto superior direito.
5. Em Janela de restauração (dias) , defina o número de dias para a janela de retenção.
6. Clique em Salvar .

curl

Bash

curl -s -X PATCH --header "Authorization: Bearer ${DATABRICKS_TOKEN}" $DBR_URL/database/instances/my-instance -d '{"retention_window_in_days": 14}'

Etapa 2: criar uma instância secundária

Você pode criar uma instância secundária a partir de uma instância de banco de dados existente. O senhor pode gerenciar uma instância filha como faria com uma instância normal de banco de dados. Consulte Criar e gerenciar uma instância de banco de dados.

UI

Com a opção Criar a partir do pai ativada, há dois parâmetros adicionais a serem especificados:

• Nome da instância principal: o nome da instância principal a partir da qual você deseja criar um banco de dados secundário.
• Inclua dados dos pais até: O ponto histórico específico do qual você deseja dados.
  • Point-in-time atual: isso cria uma instância secundária com os dados mais recentes de uma instância de banco de dados.
  • Data e hora específicas: isso cria uma instância secundária em um momento específico dentro da janela de retenção de uma instância de banco de dados. A instância secundária contém todos os dados nesse momento específico.
  • Número de sequência de log específico: log Cria uma instância filha a partir de um determinado número de sequência (LSN) de registrolog (WAL) na janela de retenção. O PostgreSQL usa o WAL para dar suporte à recuperação e atribui um LSN a cada registro WAL. A instância secundária contém todos os dados desse WAL LSN. Para obter mais informações sobre WALs, consulte WAL internals. Para obter o valor atual do LSN, consulte Funções de controle de backup.

curl

Crie uma instância secundária usando os dados mais recentes de uma instância de banco de dados.

Bash

curl -s -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" $DBR_URL/database/instances -d '{"name": "test", "capacity": "CU_2", "parent_instance_ref": {"name": "test-child"}}'

Crie uma instância secundária com dados de uma data e hora específicas, especificadas em UTC.

Bash

curl -s -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" $DBR_URL/database/instances -d '{"name": "test", "capacity": "CU_2", "parent_instance_ref": {"name": "test-child", "branch_timestamp":"2025-05-23T17:21:00Z"}}'

Crie uma instância secundária com dados de um WAL LSN específico de uma instância de banco de dados.

Bash

curl -s -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" $DBR_URL/database/instances -d '{"name": "test", "capacity": "CU_2", "parent_instance_ref": {"name": "test-child", "branch_lsn":"0/2A156E"}}'

Limitações

• Somente uma instância secundária pode ser criada por vez para uma instância de banco de dados.
• As instâncias principais não podem ser excluídas, a menos que a instância secundária seja excluída.