Todos os produtos
Search

Este produto

    ApsaraMQ for Kafka:Criar tópicos automaticamente

    Central de documentação

    ApsaraMQ for Kafka:Criar tópicos automaticamente

    Última atualização: Jul 20, 2026

    Em cenários de migração para a cloud e testes, ative a criação automática de tópicos para criá-los programaticamente, sem usar o console.

    Pré-requisitos

    Adquira e implante uma instância do Message Queue for Apache Kafka que atenda aos seguintes requisitos:

    Item

    Descrição

    Status

    Running

    Version

    A versão principal é 2.2.0 ou superior, e a versão secundária é a mais recente.
    Nota

    Visualize o status e a versão da sua instância na seção Basic Information, na página Instance Details do console do Message Queue for Apache Kafka.

    Observações de uso

    • Importante: Este recurso destina-se exclusivamente a cenários de migração e testes. Recomendamos fortemente não ativar a criação automática de tópicos em ambientes de produção. Caso seja indispensável ativá-la em produção, evite utilizá-la para services críticos.

    • Em instâncias da Professional Edition com ACL ativado, não é possível criar um tópico automaticamente apenas enviando uma mensagem.

    Procedimento

    1. Faça login no console do ApsaraMQ for Kafka. Na página Overview, selecione uma região na seção Resource Distribution.

    2. Na página Instances, clique em nome da instância desejada.

    3. Na página Instance Details, na seção Configuration Information, ative a chave Automatic Topic Creation.

      Nota

      Regras de nomenclatura para tópicos criados automaticamente:

      • O nome deve ter entre 3 e 64 caracteres.

      • São permitidos apenas letras, dígitos, hifens (-) e sublinhados (_), sendo obrigatória a presença de pelo menos uma letra ou dígito.

      Em instâncias da Standard Edition com esse recurso ativado, o envio de uma mensagem para um tópico inexistente aciona sua criação automática. O novo tópico passa então a aparecer no console.

    Perguntas frequentes

    É possível criar tópicos automaticamente?

    Sim, mas essa prática é fortemente desencorajada. No Message Queue for Apache Kafka, gerencie tópicos pelo console e pela OpenAPI. Evite ativar a criação automática em ambientes de produção pelos motivos abaixo:

    • A criação automática não oferece controle granular de permissões nem auditoria de operações sobre recursos, o que gera riscos de segurança e governança.

    • Pode provocar consumo descontrolado de recursos, afetando a estabilidade do sistema.

    • Não há garantia de sucesso na criação automática; falhas podem interromper seus services. Para mais detalhes, consulte What should I do if automatic topic creation fails?

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

    Ative este recurso apenas para casos específicos, como migrações rápidas para a cloud e testes. Não o utilize fora desses contextos.

    Como lidar com falhas na criação automática de tópicos

    Caso a criação automática de tópicos falhe, tente as soluções a seguir:

    • Se precisar criar poucos tópicos, prefira fazê-lo manualmente pelo console ou via OpenAPI.

    • Verifique os logs ou investigue o problema com base nas possíveis causas listadas abaixo:

      • Operações inválidas: Uma operação incorreta pode impedir a criação ou o uso adequado do tópico, impactando seus services. Exemplos incluem:

        • Nome de tópico inválido: O nome especificado pela aplicação não respeita as convenções de nomenclatura — por exemplo, contém caracteres proibidos ou ultrapassa o limite de caracteres.

        • Configuração de tópico inválida: O mecanismo do broker foi selecionado incorretamente, ou as cotas de tópicos ou partições são insuficientes.

        • ACL ativado: Com o recurso de ACL habilitado, o envio de mensagens não cria tópicos automaticamente.

      • Fatores externos: Instabilidade de rede, atualizações de servidores, manutenção da plataforma de gerenciamento ou falhas em instâncias ECS podem aumentar significativamente o tempo de criação e causar falhas.

      • Conflitos entre services: A criação automática pode gerar conflitos de nomes entre services, misturando dados. Esses problemas são difíceis de detectar e corrigir, podendo resultar em perda irreversível de dados.

      • Problemas de latência: Criar um tópico sob demanda demora muito mais do que usar um já existente, o que pode causar breves interrupções no service.

      • Limites de cota: A criação falha quando a cota de tópicos ou partições é excedida.

    Referências