Migrar para Escalonamento automático

As instâncias provisionadas do Lakebase foram migradas para o Autoscaling, unificando o Lakebase em uma única plataforma de Autoscaling.

• Novas instâncias são criadas como projetos de dimensionamento automático. Desde 12 de março de 2026, novas instâncias do Lakebase são criadas como projetos de dimensionamento automático, não instâncias provisionadas.
• Atualização de instâncias provisionadas existentes para dimensionamento automático. Todas as instâncias existentes com Lakebase Provisioned foram atualizadas para a plataforma de Autoscaling.

Novas instâncias são criadas em projetos de escalonamento automático

Quando você cria uma nova instância do Lakebase, ela agora é criada como um projeto de dimensionamento automático do Lakebase e aparece na página dimensionamento automático no aplicativo Lakebase, não na página Provisionada . As instâncias provisionadas existentes não são afetadas e continuam em execução exatamente como antes.

Na página Dimensionamento Automático , os novos projetos são marcados com um ícone de informações.

Passe o mouse sobre o ícone para ver uma dica de ferramenta explicando que o projeto foi criado usando a API da instância do banco de dados e que ele dá suporte às APIs de Instância de Banco de Dados e Postgres.

O que isso significa para você

• Criação de instância do Lakebase. Qualquer nova instância do Lakebase é criada como um projeto de dimensionamento automático do Lakebase e aparece na página dimensionamento automático no aplicativo Lakebase. Você pode gerenciar esses projetos com a API da instância do banco de dados e a API do Postgres.
• Criar botão na interface do usuário. O botão Criar (inclusive na guia Provisionado) agora abre o fluxo de criação do projeto de dimensionamento automático.
• Recursos de dimensionamento automático. Novos projetos obtêm recursos de dimensionamento automático, incluindo computação de dimensionamento automático, escala para zero (habilitada por padrão com um tempo limite de inatividade de 24 horas), ramificação e restauração instantânea. Você pode acessar esses recursos da interface do usuário de dimensionamento automático do Lakebase e da API do Postgres quando estiver pronto.
• As instâncias provisionadas existentes permanecem inalteradas. Eles permanecem na página Provisionado na UI com o mesmo comportamento de antes. Instâncias provisionadas, cadeias de conexão e APIs continuam funcionando.
• Sua automação existente continua funcionando. As automações existentes continuam funcionando sem modificação, mas novas instâncias são criadas como projetos de dimensionamento automático.

APIs

As novas instâncias criadas por meio da API de instância de banco de dados dão suporte a ambas as APIs, portanto, a automação existente continua sem modificação.

A automação de DABs existentes usando database_instances continua a funcionar. No entanto, novas instâncias criadas por database_instances são criadas como projetos de dimensionamento automático. Para um novo trabalho do Lakebase, Azure Databricks recomenda usar postgres_projects em vez disso. Consulte os recursos do pacote.

Diferenças para novas instâncias do Lakebase

Tamanho da computação

As instâncias do Lakebase criadas como projetos de dimensionamento automático usam CUs (unidades de computação de dimensionamento automático) em vez de unidades de capacidade provisionadas do Lakebase. Quando você cria um projeto usando a API de instância de banco de dados, o Lakebase mapeia a unidade de capacidade provisionada selecionada para um intervalo mínimo e máximo de CUs de escalonamento automático da seguinte forma:

Por exemplo, se a automação criar instâncias do Lakebase com capacidade 1, novos projetos de dimensionamento automático do Lakebase serão criados com configurações CU mínima 4 e CU máxima 8 . Você pode alterar min/max mais tarde usando a API do Postgres ou na interface do usuário de dimensionamento automático do Lakebase.

Escala para zero

O ponto de extremidade de leitura/gravação para novos projetos tem escala para zero habilitada por padrão, com um tempo limite de inatividade de 24 horas, logo, a computação será suspensa automaticamente depois de 24 horas de inatividade para reduzir custos. Você pode ajustar o tempo limite ou desabilitar a escala para zero para manter a computação sempre em execução, na interface do usuário de dimensionamento automático do Lakebase ou usando a API do Postgres. Consulte Reduzir até zero para obter detalhes.

Janela de histórico

No Lakebase Provisioned (instâncias de banco de dados), a janela de restauração pode ser configurada para 35 dias. No Dimensionamento Automático do Lakebase (novos projetos), a configuração da janela de histórico tem um máximo de 30 dias.

Versão do PostgreSQL

Novos projetos criados por meio da API da instância do banco de dados ou da interface do usuário do Lakehouse/Provisionado usam o PostgreSQL 16, alinhado com o Lakebase Provisionado. Isso significa que a automação usando a API de instância de banco de dados cria projetos com a mesma versão do PostgreSQL (16) de antes. O padrão para projetos criados usando a interface do usuário de dimensionamento automático ou a API do Postgres é o PostgreSQL 17.

Detalhes da conexão e nomes de host

Os detalhes da conexão para novos projetos usam um formato de nome de host diferente do Lakebase Provisionado. As instâncias provisionadas usam um nome de host global (nenhuma região no nome do host). Projetos recém-criados usam um nome de host regional (região incluída). Os pontos de extremidade de leitura e gravação e somente leitura usam o formato de nome de host regional para novos projetos.

Provisionado (hostname global):

host=instance-a1b2c3d4-e5f6-7890-abcd-ef1234567890.database.cloud.databricks.com

Dimensionamento automático (nome do host regional):

host=ep-example-endpoint-a1b2c3d4.database.<region>.cloud.databricks.com

O nome do host regional inclui o código de região para sua nuvem e região (por exemplo, us-east-1 no AWS ou eastus no Azure).

Link Privado

O Dimensionamento Automático do Lakebase usa dois pontos de extremidade de Link Privado: Link Privado front-end para acesso à API (conectividade no nível do espaço de trabalho, inalterada) e Link Privado de entrada para serviços de alto desempenho (Link Privado de entrada para serviços de alto desempenho) para conexões cliente Postgres. Se você precisa de Link Privado de entrada para serviços com uso intensivo de desempenho depende de como seus aplicativos se conectam.

Permissões (ACLs)

As permissões em novas instâncias do Lakebase são armazenadas no recurso ACL do projeto Lakebase. Você pode gerenciá-los por meio da Permissions API padrão com request_object_type=database-projects, pela IU de escalonamento automático do Lakebase ou pela API do Postgres. A automação existente que usa a API de instância do banco de dados continua funcionando porque essas chamadas são encaminhadas por proxy para o mesmo recurso database-projects. As leituras e gravações permanecem consistentes em ambas as superfícies da API.

nomes de projeto e nomes de instância

Quando você cria uma instância do Lakebase por meio da API da instância do banco de dados ou da interface do usuário do Lakehouse/Provisionado, o nome da instância que você especifica se torna a ID do projeto (project_id) do projeto de dimensionamento automático do Lakebase resultante. O ramo raiz é sempre criado com o identificador production.

Os nomes de instância e as IDs do projeto devem ser compatíveis com DNS. A unicidade do ID do projeto não faz distinção entre maiúsculas e minúsculas, o que significa que você não pode ter ABC e abc como IDs de projeto no mesmo espaço de trabalho. Ao usar a API do Postgres, use a ID do projeto em letras minúsculas. A criação falhará se a ID do projeto colidir com uma ID de projeto existente.

Os projetos também têm um nome de exibição (display_name), que é independente da ID do projeto e não está sujeito ao requisito de conformidade de DNS.

Na API do Postgres, o recurso de projeto name é retornado no formato de caminho projects/{project_id} (por exemplo, projects/my-instance), em vez do nome simples da instância usado pela API de instância de banco de dados. Consulte Listar projetos.

Ramificação e renomeação de projeto

Assim como os nomes de instância, as IDs do projeto e as IDs de branch não podem ser alteradas após a criação. No entanto, os projetos também têm um nome de exibição (display_name) que você pode atualizar a qualquer momento.

Instâncias de banco de dados secundárias

Para instâncias de banco de dados filho (uma instância filho corresponde a uma ramificação no projeto de dimensionamento automático):

• ID da ramificação. O nome da instância filha que você especifica na API de instância do banco de dados se torna o ID da ramificação na interface do dimensionamento automático.
• Limite de ramificação. Com a API do Postgres ou a UI de escalonamento automático, você pode criar qualquer número de branches. Com a API da instância do banco de dados, você pode criar apenas uma instância pai (um ramo raiz) e uma instância filho (um ramo filho), o que corresponde ao comportamento anterior da API da instância do banco de dados.
• Etiquetas e orçamento. Marcas personalizadas e políticas de uso são herdadas da ramificação pai. Essa é uma alteração do comportamento anterior da API da instância do banco de dados, no qual as instâncias filho tinham seus próprios valores separados.
• Exclusão de uma instância filho. Se você criar ramificações adicionais usando a interface de dimensionamento automático do Lakebase ou a API do PostgreSQL em um projeto que corresponde a uma instância filha, você não poderá excluir essa instância filha através da interface do usuário ou API Provisionada do Lakehouse até que todas essas ramificações sejam excluídas. Exclua as ramificações primeiro (usando a interface do usuário de dimensionamento automático ou a API do Postgres) e, em seguida, remova a instância filho.

Branches protegidos

Se você proteger um branch em um projeto criado usando a API da instância do banco de dados (se o branch corresponde a uma instância filho ou a qualquer outro branch criado), você não poderá excluir essa instância filho ou a instância raiz (pai) por meio da interface do usuário ou API provisionada do Lakehouse/Provisionado até que o branch esteja desprotegido. Remova a proteção do branch na interface de usuário de dimensionamento automático do Lakebase primeiro, e então exclua a instância. Consulte branches protegidas.

Recursos de pré-visualização privada

Os projetos recém-criados são projetos de dimensionamento automático do Lakebase e não dão suporte a versões prévias dos recursos API de Dados provisionados pelo Lakebase ou a versões prévias dos recursos privadas Forward ETL. Elas eram ofertas à parte no Provisionado.

• Acesso à API REST (estilo PostgREST): O Lakebase Autoscaling tem sua própria API de Dados para acesso REST compatível com PostgREST (CRUD, query, RPC).

• Sincronização de dados com o Lakehouse: O dimensionamento automático do Lakebase tem Feed de Dados de Alteração do Lakebase, que é diferente do Forward ETL da versão preliminar privada no Lakebase Provisionado.

Atualização de instâncias provisionadas existentes para dimensionamento automático

O Azure Databricks atualizou todas as instâncias provisionadas pelo Lakebase para a plataforma Lakebase Autoscaling. A atualização foi concluída em julho de 2026.

A atualização é automática. As conexões são reiniciadas brevemente durante a transição. Suas cadeias de conexão existentes, chamadas à API, Pacotes de Automação Declarativa e configurações do Terraform continuam funcionando sem modificação.

Após a atualização, as seguintes alterações se aplicam:

• Dimensionamento de computação. A capacidade provisionada da instância é mapeada para um intervalo de CU mínima/máxima de dimensionamento automático. Consulte tamanho de computação para ver a tabela de mapeamento. Você pode alterar o CU mínimo/máximo depois da atualização usando a interface de escalonamento automático do Lakebase ou a API do Postgres.

• Ambas as interfaces estão disponíveis. Suas instâncias podem ser gerenciadas tanto pela nova IU de Autoscaling quanto pela já conhecida IU de Provisioned, que permanecerá disponível até 1º de setembro de 2026.

• Nome do projeto e nome de exibição. A atualização preserva a ID do projeto e a UID. O nome de exibição (display_name) recebe um (upgraded) sufixo, de modo que uma instância nomeada my-instance aparece como my-instance (upgraded) na interface do usuário de dimensionamento automático e na API do Postgres. A instância atualizada aparece na API da instância do banco de dados e na API do Postgres, com a mesma UID em cada uma.

• Nova cadeia de conexão regional. Cada instância recebe uma nova cadeia de conexão regional com ingresso otimizado. A cadeia de conexão global existente está disponível na interface do usuário de provisionada; a nova cadeia de conexão regional está disponível na interface do usuário de dimensionamento automático.

  • Cadeias de conexão existentes. As strings de conexão provisionadas (sem região) continuam funcionando no Inbound Link Privado existente e não exigem o Service Direct Link Privado.
  • Nova cadeia de conexão regional. Se usar o Link Privado e se conectar ao Lakebase fora do workspace do Azure Databricks, você deverá configurar o Link Privado de entrada para serviços de alto desempenho a fim de usar a nova cadeia de conexão regional.

• DABs e Terraform. Para usar novos recursos de dimensionamento automático, como escala para zero, atualize os pacotes a serem usados postgres_projects (consulte recursos do pacote) ou o Terraform para usar o recurso databricks_postgres_project. Para obter instruções passo a passo do Terraform, consulte Atualizar a configuração do Terraform para usar recursos de dimensionamento automático.

• Forward ETL (prévia privada). O recurso de visualização privada de ETL forward no Lakebase Provisioned não tem mais suporte e ficará indisponível em uma atualização futura. Para continuar sincronizando dados com o Lakehouse após a atualização, configure o Lakebase Change Data Feed na plataforma de dimensionamento automático.

• API REST, PostgREST (versão prévia privada). O recurso de visualização privada da API REST (PostgREST) no Lakebase Provisioned continua funcionando após a atualização, mas não tem mais suporte e ficará indisponível em uma atualização futura. Sua substituição, a API de Dados, está disponível na plataforma de dimensionamento automático.

• Alta disponibilidade. Se a alta disponibilidade tiver sido habilitada em sua instância provisionada, ela será mantida após a atualização.

• Melhorias no dimensionamento automático. Suas instâncias suportam recursos de autoescalonamento. O Dimensionamento Automático do Lakebase adiciona dimensionamento automático, escala para zero, restauração pontual, instantâneos, agendamento da janela de manutenção, ramificação de banco de dados e outros aprimoramentos. Para obter mais informações, consulte o Dimensionamento Automático do Lakebase.

  Observação

  A escala para zero não está habilitada por padrão para instâncias atualizadas. Ao contrário das novas instâncias, que têm a escala para zero habilitada por padrão com um tempo limite de inatividade de 24 horas, as instâncias atualizadas exigem que você habilite manualmente a escala para zero. Confira Escalar para zero.

• Cache de armazenamento otimizado. Após a atualização, o Lakebase prioriza os dados do ramo raiz do seu projeto em seu cache de armazenamento para reduzir a latência das consultas. Você pode priorizar um branch diferente após a atualização marcando-o como um branch protegido.

• Funções e bancos de dados por ramificação. O Lakebase Autoscaling tem um limite de 500 papéis do Postgres e 500 bancos de dados por ramificação. Lakebase Provisioned não tinha esse limite. A atualização é concluída normalmente para instâncias que excedem esses limites, mas você não pode criar funções ou bancos de dados adicionais posteriormente. Se você acredita que sua instância foi afetada, entre em contato com sua equipe de conta ou Azure Databricks Suporte.

• Instâncias pausadas. Após a atualização, conectar-se a uma instância pausada resulta no erro The endpoint has been disabled. Enable it using the API and retry. Para restaurar o acesso, reative o cálculo configurando spec.disabled: false com update_mask=spec.disabled. Veja Desativar ou ativar um cálculo.

• Preços. Os preços de GA do Lakebase se aplicam após a atualização. Com a computação elástica substituindo instâncias de tamanho fixo, a maioria dos clientes vê uma redução nos custos de computação. O dimensionamento automático do Lakebase também inclui preço de computação always-on. Para obter as taxas atuais, consulte a página de preços do Lakebase.

• Repositório de Recursos e Serviço de Modelos. Os Repositórios de Recursos Online do Databricks são suportados pelo Dimensionamento Automático do Lakebase. Suas cargas de trabalho existentes de serviço de recursos e serviço de modelos continuam funcionando sem necessidade de ação. As interfaces create_online_store e update_online_store não precisam ser alteradas para lojas on-line que você gerencia por meio do cliente do Feature Engineering. Consulte Repositório de Recursos e Serviço de Modelos.

• Aplicativos do Databricks. Os aplicativos que usam um recurso do Lakebase database continuam funcionando após a atualização. Os detalhes da conexão, as variáveis de ambiente e as roles do Postgres permanecem inalterados. Não altere database para postgres na configuração do aplicativo. Isso cria uma nova função Postgres e interrompe o acesso aos dados existentes. Para novos aplicativos, use app.resources.postgres. Consulte Adicionar um recurso do Lakebase a um aplicativo do Databricks.

• Agentes em Serviço de Modelo. Os agentes com conexões do Lakebase continuam funcionando após a atualização. Azure Databricks recomenda migrar agentes para os Aplicativos do Databricks para aproveitar os recursos de dimensionamento automático. Consulte Migrar um agente do Model Serving para o Databricks Apps.

Para solicitar uma atualização acelerada ou se você tiver dúvidas, entre em contato com sua equipe de conta ou Azure Databricks Suporte.

Recursos adicionais

• Lakebase
• Cadeias de conexão e sobre autenticação
• Criar um projeto