ApsaraMQ for RocketMQ:Gerenciamento de tópicos

Observações de uso

• Os tópicos não podem ser compartilhados entre instâncias. Por exemplo, um tópico criado na Instância A não pode ser utilizado na Instância B.

• O tipo do tópico deve corresponder ao tipo da mensagem. Se você criar um tópico para mensagens normais, selecione mensagem normal como tipo de mensagem. Não selecione outros tipos, como mensagem ordenada ou mensagem transacional. Uma incompatibilidade pode causar problemas, como a perda de mensagens agendadas/atrasadas durante a substituição de nós ou a migração de instâncias.

• No RocketMQ 5.x, o sistema atribui automaticamente o número de filas por tópico. Não é possível personalizar ou modificar a contagem de filas, nem visualizar esse valor pelo console ou pela API.

• O ApsaraMQ for RocketMQ não oferece suporte à criação direta de tópicos de ordem global, nem fornece um canal de aplicação especial para essa finalidade. Para obter mensagens com ordem global, crie um tópico FIFO (ordem particionada) e defina a mesma Sharding Key (por exemplo, um valor fixo) ao enviar as mensagens. Isso direciona todas as mensagens para a mesma partição, garantindo o processamento em ordem.

• O ApsaraMQ for RocketMQ 5.x não oferece suporte à criação automática de tópicos, incluindo tópicos de dead letter. Crie tópicos de dead letter explicitamente pelo console ou pela API. Esse comportamento difere da versão open source do RocketMQ, que permite a criação automática de tópicos.

Faturamento

O faturamento dos tópicos depende do método de cobrança da sua instância do ApsaraMQ for RocketMQ.

• Instâncias por assinatura e pagamento conforme o uso

  A cobrança ocorre apenas para tópicos que excedem a cota gratuita da sua instância. Nenhum custo será gerado se você permanecer dentro da cota gratuita. Para mais informações, consulte Taxas de tópicos.

• Instâncias serverless

  A cobrança é baseada na quantidade de tópicos. Para mais informações, consulte Taxas de tópicos para instâncias serverless.

Criar um tópico

1. Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.

2. Na barra de navegação superior, selecione uma região, como China (Hangzhou). Na página Instances, clique no nome da instância que deseja gerenciar.

3. No painel de navegação à esquerda, clique em Topics.

4. Na página Topics, clique em Create Topic.

5. No painel Create Topic, insira um Name e uma Description, selecione um message type e clique em OK.

   Selecione normal message, ordered message, scheduled/delayed message ou transactional message. O nome do tópico deve ter entre 1 e 60 caracteres e conter apenas letras, dígitos, hifens (-) e sublinhados (_).

Listar tópicos

1. Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.

2. Na barra de navegação superior, selecione uma região, como China (Hangzhou). Na página Instances, clique no nome da instância que deseja gerenciar.

3. No painel de navegação à esquerda, clique em Topics.

4. Na página Topics, visualize todos os tópicos da instância atual.

Visualizar detalhes do tópico

1. Na página Topics, localize o tópico desejado e clique em Details na coluna Actions.

2. Na página Topic Details, visualize as informações detalhadas do tópico.

Editar um tópico

1. Na página Topics, localize o tópico desejado e clique em Details na coluna Actions.

2. Na página Topic Details, clique na aba Basic Information. Em seguida, na seção Basic Information, clique em Edit.

3. No painel Update Topic, atualize a descrição do tópico e clique em OK.

Excluir um tópico

1. Na página Topics, localize o tópico desejado e clique em Details na coluna Actions.

2. Na página Topic Details, clique na aba Basic Information. Em seguida, na seção Basic Information, clique em Delete Topic.

3. Na caixa de diálogo Note, clique em OK.

Início rápido

Teste rapidamente o envio de mensagens normais no console do ApsaraMQ for RocketMQ. Para enviar e receber outros tipos de mensagens, utilize um SDK. Para mais informações, consulte Visão geral da referência de SDK.

1. Na página Topics, localize um tópico cujo Message Type seja normal message e clique em Details na coluna Actions.

2. Na página Topic Details, clique em Quick Start.

3. No painel Start Message Production and Consumption, execute uma das seguintes ações:

   • Console:

     Insira o Message Body, a Message Key e a Message Tag e clique em OK.

   • SDK:

     Visualize os exemplos de código para diferentes SDKs e siga as instruções para enviar e receber mensagens.

Visualizar o painel

O painel exibe métricas essenciais sobre a produção de mensagens e os clientes produtores. Para mais informações, consulte painel.

1. Na página Topics, localize o tópico desejado e clique em Details na coluna Actions.

2. Na página Topic Details, clique na aba Dashboard.

Mais operações

Para obter informações sobre como importar e exportar tópicos, consulte Importar e exportar tópicos.

Perguntas frequentes

P: O que devo fazer se receber um InternalError ou uma mensagem indicando que MessageType está ausente ao criar um tópico usando a Alibaba Cloud CLI?

Ao criar um tópico usando a Alibaba Cloud CLI, o parâmetro MessageType é obrigatório e não possui valor padrão. Valores válidos: NORMAL, FIFO, DELAY. Se você omitir esse parâmetro, a criação do tópico falhará ou retornará um InternalError.

P: O que devo fazer se a chamada da API OnsTopicStatus retornar um erro BIZ_RESOURCE_NOT_EXISTS?

Esse erro geralmente indica que o tópico alvo não existe na instância especificada. Siga os passos abaixo para solucionar o problema:

• Verifique se o ID da instância e o nome do tópico usados na chamada da API estão corretos.

• Confirme se o tópico alvo existe na instância especificada.

• Lembre-se de que os tópicos não podem ser utilizados entre instâncias diferentes.

P: Como consulto os registros de operação e o operador de um tópico RocketMQ excluído?

Faça login no console do ActionTrail e pesquise pelo nome do evento OnsTopicDelete ou ConsoleTopicDelete. Filtre por região para visualizar os registros de exclusão e as informações da conta do operador.

P: O que devo fazer se receber um erro de incompatibilidade de tipo de mensagem quando vários projetos têm produtores para o mesmo tópico FIFO?

Esse erro não está relacionado à coexistência de múltiplos projetos. A causa raiz é que o tópico está configurado como FIFO (mensagens ordenadas), mas o cliente envia mensagens identificadas como NORMAL (mensagens normais). Para resolver esse problema:

1. Verifique a definição da mensagem e o método de envio no seu código.

2. Certifique-se de estar usando a API correta para envio de mensagens FIFO.

3. Valide se os atributos da mensagem atendem aos requisitos FIFO.

4. Garanta que o tipo do tópico e o tipo da mensagem sejam consistentes.

Documentos relacionados

Também é possível gerenciar tópicos chamando estas operações de API:

• CreateTopic

• UpdateTopic

• DeleteTopic

• ListTopics

• GetTopic