ApsaraMQ for RocketMQ:Gestión de temas

Notas de uso

• Los temas no se pueden utilizar entre instancias. Por ejemplo, un tema creado en la Instancia A no se puede usar en la Instancia B.

• El tipo de tema debe coincidir con el tipo de mensaje. Por ejemplo, si crea un tema para mensajes normales, seleccione mensaje normal como tipo de mensaje. No seleccione otros tipos, como mensaje ordenado o mensaje transaccional. Una discrepancia puede causar problemas, como la pérdida de mensajes programados o diferidos durante el reemplazo de nodos o la migración de instancias.

• En RocketMQ 5.x, el sistema asigna automáticamente el número de colas por tema. No puede personalizar ni modificar el recuento de colas, ni tampoco visualizarlo mediante la consola o la API.

• ApsaraMQ for RocketMQ no admite la creación directa de temas de orden global, ni proporciona un canal de aplicación especial para este fin. Para lograr mensajes con orden global, cree un tema FIFO (orden por partición) y establezca la misma Sharding Key (por ejemplo, un valor fijo) al enviar los mensajes. Esto enruta todos los mensajes a la misma partición para su procesamiento en orden.

• ApsaraMQ for RocketMQ 5.x no admite la creación automática de temas, incluidos los temas de letras muertas. Debe crear los temas de letras muertas explícitamente a través de la consola o la API. Esto difiere de la versión de código abierto de RocketMQ, que sí admite la creación automática de temas.

Facturación

La facturación de los temas depende del método de facturación de su instancia de ApsaraMQ for RocketMQ.

• Instancias de suscripción y pay-as-you-go

  Solo se le cobra por los temas que excedan la cuota gratuita de su instancia. No se generan cargos si se mantiene dentro de la cuota gratuita. Para obtener más información, consulte Topic fees.

• Instancias serverless

  Se le cobra según el número de temas. Para obtener más información, consulte Topic fees for serverless instances.

Crear un tema

1. Inicie sesión en la consola de ApsaraMQ for RocketMQ. En el panel de navegación izquierdo, haga clic en Instances.

2. En la barra de navegación superior, seleccione una región, como China (Hangzhou). En la página Instances, haga clic en el nombre de la instancia que desea gestionar.

3. En el panel de navegación izquierdo, haga clic en Topics.

4. En la página Topics, haga clic en Create Topic.

5. En el panel Create Topic, introduzca un Name y una Description, seleccione un message type y luego haga clic en OK.

   Puede seleccionar normal message, ordered message, scheduled/delayed message o transactional message. El nombre del tema debe tener entre 1 y 60 caracteres, y solo puede contener letras, dígitos, guiones (-) y guiones bajos (_).

Listar temas

1. Inicie sesión en la consola de ApsaraMQ for RocketMQ. En el panel de navegación izquierdo, haga clic en Instances.

2. En la barra de navegación superior, seleccione una región, como China (Hangzhou). En la página Instances, haga clic en el nombre de la instancia que desea gestionar.

3. En el panel de navegación izquierdo, haga clic en Topics.

4. En la página Topics, puede ver todos los temas de la instancia actual.

Ver detalles del tema

1. En la página Topics, busque el tema objetivo y haga clic en Details en la columna Actions.

2. En la página Topic Details, puede consultar los detalles del tema.

Editar un tema

1. En la página Topics, busque el tema objetivo y haga clic en Details en la columna Actions.

2. En la página Topic Details, haga clic en la pestaña Basic Information. Luego, en la sección Basic Information, haga clic en Edit.

3. En el panel Update Topic, actualice la descripción del tema y haga clic en OK.

Eliminar un tema

1. En la página Topics, busque el tema objetivo y haga clic en Details en la columna Actions.

2. En la página Topic Details, haga clic en la pestaña Basic Information. Luego, en la sección Basic Information, haga clic en Delete Topic.

3. En el cuadro de diálogo Note, haga clic en OK.

Inicio rápido

Puede probar rápidamente el envío de mensajes normales en la consola de ApsaraMQ for RocketMQ. Para enviar y recibir otros tipos de mensajes, utilice un SDK. Para obtener más información, consulte SDK reference overview.

1. En la página Topics, busque un tema cuyo Message Type sea normal message y haga clic en Details en la columna Actions.

2. En la página Topic Details, haga clic en Quick Start.

3. En el panel Start Message Production and Consumption, realice una de las siguientes acciones:

   • Console:

     Introduzca el Message Body, la Message Key y la Message Tag, y luego haga clic en OK.

   • SDK:

     Consulte los ejemplos de código para los diferentes SDK y siga las instrucciones para enviar y recibir mensajes.

Ver el panel

El panel muestra métricas clave sobre la producción de mensajes y los clientes productores. Para obtener más información, consulte dashboard.

1. En la página Topics, busque el tema objetivo y haga clic en Details en la columna Actions.

2. En la página Topic Details, haga clic en la pestaña Dashboard.

Más operaciones

Para obtener información sobre cómo importar y exportar temas, consulte Import and export topics.

Preguntas frecuentes

P: ¿Qué debo hacer si obtengo un InternalError o un mensaje que indica que falta MessageType al crear un tema mediante Alibaba Cloud CLI?

Cuando crea un tema mediante Alibaba Cloud CLI, el parámetro MessageType es obligatorio y no tiene valor predeterminado. Valores válidos: NORMAL, FIFO, DELAY. Si omite este parámetro, la creación del tema fallará o devolverá un InternalError.

P: ¿Qué debo hacer si la llamada a la API OnsTopicStatus devuelve un error BIZ_RESOURCE_NOT_EXISTS?

Este error generalmente significa que el tema objetivo no existe en la instancia especificada. Realice los siguientes pasos de solución de problemas:

• Compruebe que el ID de instancia y el nombre del tema utilizados en la llamada a la API sean correctos.

• Asegúrese de que el tema objetivo exista en la instancia especificada.

• Tenga en cuenta que los temas no se pueden utilizar entre instancias.

P: ¿Cómo consulto los registros de operación y el operador de un tema de RocketMQ eliminado?

Inicie sesión en la consola de ActionTrail y busque el nombre del evento OnsTopicDelete o ConsoleTopicDelete. Filtre por región para ver los registros de eliminación y la información de la cuenta del operador.

P: ¿Qué debo hacer si obtengo un error de discrepancia de tipo de mensaje cuando varios proyectos tienen productores para el mismo tema FIFO?

Este error no está relacionado con la coexistencia de múltiples proyectos. La causa principal es que el tema está configurado como FIFO (mensajes ordenados), pero el cliente envía mensajes identificados como NORMAL (mensajes normales). Para resolver este problema:

1. Revise la definición del mensaje y el método de envío en su código.

2. Asegúrese de estar utilizando la API correcta para el envío de mensajes FIFO.

3. Compruebe que los atributos del mensaje cumplan con los requisitos de FIFO.

4. Verifique que el tipo de tema y el tipo de mensaje sean consistentes.

Documentos relacionados

También puede gestionar temas llamando a estas operaciones de API:

• CreateTopic

• UpdateTopic

• DeleteTopic

• ListTopics

• GetTopic