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.
O que é uma instância infantil?
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 restauração. Uma janela de restauração especifica o intervalo de tempo (2 a 35 dias) a partir do qual você pode realizar a recuperação pontual. A janela de restauração é definida ao criar uma instância de banco de dados. É possível criar uma instância secundária a qualquer momento dentro desta janela de restauração, sem aguardar o Snapshot manual ou as exportações completas do banco de dados.
Depois de criar uma instância secundária, ela estará disponível para consulta até ser excluída. Não há expiração automática vinculada à janela de restauração do pai. Isso garante que você sempre tenha acesso aos dados pontuais nos quais a instância secundária foi criada, mesmo que a janela de restauração do pai tenha expirado.
As instâncias infantis são isoladas do pai. Qualquer leitura ou gravação que você realizar em uma instância secundária não terá efeito na instância de origem. As modificações feitas em uma instância secundária usam copy-on-write para que as alterações sejam armazenadas como um “delta”. Isso mantém os dados não modificados compartilhados e minimiza o armazenamento extra.
Quando você deve criar uma instância secundária?
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 pela sua janela de restauração) para validar alterações no 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.
Criar uma instância secundária a partir de uma instância do banco de dados principal
Para criar uma instância de banco de dados secundária a partir de um pai, configure a janela de restauração na instância principal para definir o período de tempo disponível para recuperação de dados. Em seguida, você pode criar uma instância secundária especificando seu ponto de restauração preferido.
Etapa 1: configurar a janela de restauração em uma instância do banco de dados principal
Os valores válidos para a janela de restauração são de 2 a 35 dias, inclusive. O período de inscrição para o “ default ” é de 7 dias. Você pode especificar a janela de restauração em uma instância de banco de dados ao criar a instância. Consulte Criar uma instância de banco de dados.
Utilize a interface do usuário ou a API para modificar a janela de restauração de uma instância de banco de dados:
- UI
- curl
- Clique em Computação na barra lateral do workspace.
- Clique em Lakebase Postgres 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 restauraçã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
As funções e permissões de uma instância secundária são as mesmas das principais no ponto de restauração escolhido. Isso pode fazer com que os usuários tenham privilégios que não correspondem aos privilégios atualmente concedidos na instância principal. visualizar as funções de identidade do Databricks e revogar quaisquer privilégios desatualizados na instância secundária.
Crie uma instância secundária ativando Criar do pai durante a criação regular da instância de banco de dados. Consulte Criar e gerenciar uma instância de banco de dados.
- UI
- curl
- Python SDK
- CLI
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 na janela de restauração de uma instância de banco de dados. A instância secundária contém todos os dados nesse momento específico.
- log N úmero de sequência de log específico: Cria uma instância filha a partir de um número de sequência de log (LSN) específico do WAL (write-ahead-log ) na janela de restauração. O PostgreSQL utiliza o WAL para suportar a 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.
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", "lsn":"0/2A156E"}}'
from databricks.sdk import WorkspaceClient
from databricks.sdk.service.database import DatabaseInstance
# Initialize the Workspace client
w = WorkspaceClient()
parent_instance_name = "test-child"
instance_name = "test"
# Create a child instance using the most recent data from a database instance.
instance = w.database.create_database_instance(
DatabaseInstance(
name="my-database-instance",
capacity="CU_1",
parent_instance_ref={
"name": parent_instance_name
}
)
)
# Create a child instance with data from a specific date and time, specified in UTC.
instance = w.database.create_database_instance(
DatabaseInstance(
name=instance_name,
capacity="CU_1",
parent_instance_ref={
"name": parent_instance_name,
"branch_timestamp": "2025-05-23T17:21:00Z"
}
)
)
# Create a child instance with data from a specific WAL LSN of a database instance.
instance = w.database.create_database_instance(
DatabaseInstance(
name=instance_name,
capacity="CU_1",
parent_instance_ref={
"name": parent_instance_name,
"lsn": "0/2A156E"
}
)
)
# Create a database instance from the most recent data of a parent instance
databricks database create-database-instance my-database-instance \
--capacity CU_1 \
--parent-instance-ref '{"name": "my-parent-instance"}'
# Create a database instance from a specific date and time, specified in UTC
databricks database create-database-instance \
--json '{
"name": "my-database-instance",
"capacity": "CU_2",
"parent_instance_ref": {
"name": "my-parent-instance",
"branch_timestamp": "2025-05-23T17:21:00Z"
}
}'
# Create a database instance from a specific WAL LSN of a parent instance
databricks database create-database-instance \
--json '{
"name": "my-database-instance",
"capacity": "CU_2",
"parent_instance_ref": {
"name": "my-parent-instance",
"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.
- As instâncias secundárias são projetadas para testes ou recuperação de curto prazo. Modificações significativas na criança ou nos pais podem fazer com que o sistema reduza o compartilhamento de dados e mantenha uma cópia completa para a criança. O uso e o custo do armazenamento podem crescer para se igualar aos de uma instância de banco de dados independente.