Skip to Main Content

Manage Topics

This article introduces the fundamental concepts of Topics, including associated constraints, and how to create, view, modify, and delete Topics.

Creating a Topic​

Procedure​

  1. Log in to the environment console and select Instance List from the left navigation bar. Then, in the instance list, click on the desired instance name to access its internal features.

  2. Select Topic from the left navigation bar, then click Create New Topic on the Topic list page.

  3. On the Create New Topic form page, enter the name, number of partitions, and message cleanup policy, then click OK to finalize the creation.

If auto-creation of Topics is enabled for the instance, Topics will automatically be triggered for creation when messages are produced or subscribed to. For production environments, it is advisable to manage Topics via the console or Kafka Admin API to prevent the risks associated with uncontrolled auto-creation.

Viewing Topic Details​

Operational Steps​

  1. Log into the environment console and select Instance List from the left navigation bar. Next, click on the name of the desired instance in the list to access its internal features.

  2. From the left navigation bar, select Topics. Then, locate the desired Topic on the Topic list page.

  3. Click on the desired Topic to view its summary information, subscription details, and related Metrics data.

Message Query​

AutoMQ Kafka allows for direct message queries through the console. The conditions and parameters for queries are as follows:

  • Based on relative time: Enables message querying by relative time across multiple partitions.

  • Based on relative offset: Supports querying messages by specifying an offset when a single partition is chosen.

Operational Steps​

  1. Sign into the environment console, select Instance List from the left navigation menu. Next, click on the desired instance name within the instance list to access its internal features.

  2. From the left navigation menu, click Topics. Then, locate the desired Topic on the Topic list page.

  3. Select the desired Topic, enter it, choose Message Query, and enter the necessary filtering criteria to search for the message list.

Delete Topic​

Once a Topic is deleted, all messages and settings associated with it will be erased and are irretrievable. Therefore, it's essential to verify that the business no longer needs the Topic before proceeding.

If auto-create Topic is enabled on the instance, producing or subscribing to messages will automatically initiate the recreation of the Topic. In production environments, managing Topics via the console or Kafka Admin API is advised to mitigate the risks associated with uncontrolled automatic creation.

Operational Steps​

  1. Log into the environment console and select Instance List from the left navigation menu. Then, in the instance list, click on the desired instance name to explore its internal features.

  2. Select Topics from the left navigation menu, and then find the specific Topic on the Topic list page.

  3. Click the operation button on the right, choose delete, and after a second confirmation, finalize the deletion.