Crie uma instância secundária
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
- curl
- Clique em Computação na barra lateral do workspace.
- Clique em Database instances (Instâncias de banco de dados ) tab.
- Selecione a instância do banco de dados que você deseja atualizar.
- Clique em Editar no canto superior direito.
- Em Janela de restauração (dias) , defina o número de dias para a janela de retenção.
- Clique em Salvar .
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
- curl
Com a opção Criar do pai ativada, há dois parâmetros adicionais:
- 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. Consulte a documentação do Postgres.
Crie uma instância secundária usando os dados mais recentes de uma instância de banco de dados.
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.
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.
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.