Todos os produtos
Search
Central de documentação

ApsaraMQ for Kafka:FAQ about automatic topic creation

Última atualização: Jun 27, 2026

É possível criar tópicos automaticamente?

Sim. O ApsaraMQ for Kafka oferece suporte à criação automática de tópicos. No entanto, esse recurso vem desativado por padrão. Na maioria dos casos, crie os tópicos manualmente pelo console do ApsaraMQ for Kafka ou chame operações de API.

Motivos para manter a criação automática de tópicos desativada em produção:

  • Riscos de segurança: o controle granular de permissões e a auditoria de ações em recursos ficam indisponíveis quando a criação automática de tópicos está ativada.

  • Problemas de gerenciamento de recursos: a criação automática pode gerar uso excessivo de recursos, gerenciamento ineficiente e instabilidade no sistema.

  • Falhas na criação: tópicos podem não ser criados automaticamente devido a violações de nomenclatura, limites de cota ou problemas transitórios de infraestrutura. Para mais informações, consulte Solucionar falhas na criação automática de tópicos.

Quando ativar a criação automática de tópicos

A criação automática de tópicos envolve operações fora do padrão. Restrinja seu uso a cenários que não sejam de produção:

  • Migração para a nuvem: ative temporariamente o recurso durante a migração de cargas de trabalho de um cluster Kafka autogerenciado.

  • Testes: ative o recurso em ambientes de desenvolvimento ou teste para maior praticidade.

Após ativar o recurso, utilize-o apenas nos cenários de migração e teste. Desative-o assim que a migração ou os testes forem concluídos.

Como ativar a criação automática de tópicos

Importante

Não ative este recurso para cargas de trabalho de produção. Utilize-o apenas para migração e testes.

Para obter instruções passo a passo, consulte Criar tópicos automaticamente.

Solucionar falhas na criação automática de tópicos

Se poucos tópicos não foram criados, crie-os manualmente no console do ApsaraMQ for Kafka ou chame a operação de API correspondente.

Caso muitas criações tenham falhado, verifique os logs e investigue as seguintes causas:

Nomes de tópicos inválidos

Os nomes dos tópicos devem seguir as convenções de nomenclatura. A criação falha se o nome contiver caracteres inválidos ou exceder o limite de comprimento.

Configuração incorreta ou cota insuficiente

A criação de tópicos falha se você especificar um mecanismo inadequado ou se a cota restante de tópicos ou partições for insuficiente.

Problemas de infraestrutura

Eventos transitórios, como oscilações de rede, atualizações de servidores, manutenção e atualizações do console ou falhas em instâncias do Elastic Compute Service (ECS), podem atrasar a criação de tópicos além do limiar de tempo limite e causar falhas.

Conflitos de nome

Se o sistema tentar criar um tópico com o mesmo nome de um já existente, a criação falhará. Em alguns casos, dados de ambos os tópicos podem ser registrados sem que o sistema detecte o conflito. Esse tipo de conflito raramente é recuperável e pode levar a perdas irreversíveis.

Latência no primeiro acesso

O primeiro acesso a um tópico criado automaticamente demora significativamente mais do que o acesso a um tópico existente. Esse atraso pode causar interrupções temporárias nos negócios.

Limites de cota atingidos

Não é possível criar novos tópicos depois que a instância atinge o número máximo de tópicos ou partições.

Outros motivos

Tópicos também podem falhar na criação por outros motivos não listados acima.

Se o problema persistir após a investigação, entre em contato com o suporte técnico do ApsaraMQ for Kafka.