No Message Queue for Apache RocketMQ, o tópico é a categoria principal das mensagens. O Message Queue for Apache RocketMQ utiliza o modelo de publicação-assinatura, em que produtores publicam mensagens em tópicos e consumidores assinam esses tópicos para recebê-las. Este artigo descreve como criar, excluir, atualizar e visualizar tópicos no console do Message Queue for Apache RocketMQ.
Observações de uso
Os tópicos são isolados por instância e não podem ser usados entre instâncias diferentes. Por exemplo, um tópico criado na instância A não pode ser usado na instância B.
O tipo de mensagem do tópico deve corresponder às mensagens que ele processará. Se você criar um tópico para enviar e receber mensagens normais, defina o tipo de mensagem como Normal Message. Não use esse tópico para outros tipos, como mensagens ordenadas particionadas ou transacionais. Caso contrário, problemas podem ocorrer, como perda de mensagens agendadas durante a substituição de nós ou migração da instância.
Faturamento
O Message Queue for Apache RocketMQ cobra uma taxa de uso de recursos por tópico, mesmo que o tópico não esteja em uso. Recomendamos excluir tópicos não utilizados. Para mais informações, consulte Detalhes de preços de mensagens e Faturamento da Enterprise Platinum Edition.
Convenções de nomenclatura de tópicos
O nome do tópico deve ter de 3 a 64 caracteres e conter apenas letras, dígitos, hifens (-) e sublinhados (_).
Se a instância do tópico tiver um namespace, o nome deverá ser exclusivo nessa instância e não poderá coincidir com um nome de tópico ou ID de grupo existente. Nomes podem ser duplicados em instâncias diferentes. Por exemplo, um tópico na instância A pode ter o mesmo nome de um tópico ou de um ID de grupo na instância B.
Se a instância do tópico não tiver um namespace, o nome deverá ser globalmente exclusivo em todas as instâncias e regiões, sem coincidir com qualquer nome de tópico ou ID de grupo existente.
Para verificar se uma instância tem um namespace, acesse a página Instance Details no console do Message Queue for Apache RocketMQ e visualize a seção Basic Information.
Criar um tópico
Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.
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.
No painel de navegação à esquerda, clique em Topics. No canto superior esquerdo da página, clique em Create Topic.
-
No painel Create Topic, insira um Name e uma Description, selecione um Message Type para o tópico e clique em OK.
ImportanteUm tópico processa apenas o tipo de mensagem especificado durante sua criação. Se você criar um tópico com o tipo de mensagem definido como Normal Message, poderá usá-lo somente para enviar e receber mensagens normais. Não use este tópico para mensagens ordenadas. Para mais informações, consulte Tipos de mensagem.
O Name deve ter de 3 a 64 caracteres e conter apenas letras, dígitos, hifens (-) e sublinhados (_). O Commodity Type é definido automaticamente como pay-as-you-go. O Message Type inclui quatro opções: Normal Message, Transactional Message, Partitioned Ordered Message e Scheduled/Delayed Message.
Excluir um tópico
Após a exclusão de um tópico, os produtores e consumidores associados param de funcionar imediatamente. Os metadados do tópico e os dados das mensagens também são excluídos e não podem ser restaurados. Prossiga com cautela.
Na página Instances, clique no nome da instância desejada. No painel de navegação à esquerda, clique em Topics.
Na lista de tópicos, localize o tópico que deseja excluir. Na coluna Actions, clique em More e selecione Delete no menu suspenso.
Na caixa de diálogo de confirmação, clique em OK.
Atualizar um tópico
Na página Instances, clique no nome da instância desejada. No painel de navegação à esquerda, clique em Topics.
Na lista de tópicos, localize o tópico que deseja atualizar. Na coluna Actions, clique em Details para abrir a página Topic Details.
Na seção Basic Information, clique em Edit ao lado de Topic Description. Insira a nova descrição e clique em OK.
Visualizar um tópico
Na página Instances, clique no nome da instância desejada. No painel de navegação à esquerda, clique em Topics.
Na lista de tópicos, clique no nome do tópico ou em Details na coluna Actions correspondente.
APIs relacionadas
Você também pode usar as seguintes operações de API para gerenciar tópicos:
Criar um tópico: OnsTopicCreate
Excluir um tópico: OnsTopicDelete
Consultar uma lista de tópicos: OnsTopicList
Consultar o número total de mensagens em um tópico e sua última hora de atualização: OnsTopicStatus
Consultar as assinaturas de um tópico: OnsTopicSubDetail