php kafka 创建topic,自动创建Topic

通过AdminClient.createTopics()创建Topic

注意

创建的Topic的名称需遵循消息队列Kafka版的Topic命名规则，否则Topic不会被创建。

创建的Topic的数量需遵循消息队列Kafka版实例的规格限制，否则Topic不会被创建，并抛出以下错误：Exception in thread "main" java.util.concurrent.ExecutionException: org.apache.kafka.common.errors.InvalidTopicException:

The max topic count of your instance is xxx, topic runs out.。

创建的Topic的分区总数需遵循消息队列Kafka版实例的规格限制，否则Topic不会被创建，并且抛出以下错误：Exception in thread "main" java.util.concurrent.ExecutionException: org.apache.kafka.common.errors.InvalidTopicException:

The max partition count of your instance is xxx, partition runs out.。

创建的单个Topic的分区数需小于或等于360，否则Topic不会被创建，并抛出以下错误：Exception in thread "main" java.util.concurrent.ExecutionException: org.apache.kafka.common.errors.InvalidTopicException:

The max partition count of a single topic is 360.。

必须在上一次创建Topic请求被处理完成后，提交新的创建Topic请求，否则Topic不会被创建，并抛出以下错误：org.apache.kafka.common.errors.InvalidTopicException: Try to create topic: topicA.

But some other topics are being created, please try again later.

不支持通过assignments的方式来创建。

不支持创建时配置Topic名称、存储引擎、cleanup.policy、分区数以外的参数(例如min.isr)，消息队列Kafka版会为您自动配置最优参数。

创建的Topic的备注默认为auto created by admin-client。如果配置了"cleanup.policy":"compact"，则存储引擎为Local存储，否则为云存储。

开启了ACL的消息队列Kafka版实例不支持调用AdminClient.createTopics()创建Topic。

为实例开启自动创建Topic后，您可以通过调用AdminClient.createTopics()方法创建Topic。

示例代码如下：// 以Java API为例，其余语言的API类似。

CreateTopicsOptions createTopicsOptions = new CreateTopicsOptions();

// 建议20秒以上。

createTopicsOptions.timeoutMs(20000);

// 如果仅仅用于验证，可以使用下面这行代码，Topic不会被真实创建。

// createTopicsOptions.validateOnly(true);

Collection newTopics = new ArrayList<>();

// 创建云存储引擎Topic、分区数为12、replicationFactor默认为1的Topic。

NewTopic cloudTopic = new NewTopic("cloudTopic", 12, (short) 1);

newTopics.add(cloudTopic);

// 创建存储引擎为Local存储、分区数为12, replicationFactor默认为3的Topic。

NewTopic compactLocalTopic = new NewTopic("compactLocalTopic", 12, (short) 3);

Map map = new HashMap<>();

// 配置cleanup.policy为compact。

map.put(TopicConfig.CLEANUP_POLICY_CONFIG, TopicConfig.CLEANUP_POLICY_COMPACT);

compactLocalTopic.configs(map);

newTopics.add(compactLocalTopic);

// 提交请求。

CreateTopicsResult result = adminClient.createTopics(newTopics, createTopicsOptions);

// 等待创建，创建成功后不会有任何报错；如果创建失败或者超时，这里将会报错。

result.all().get();

消息队列Kafka版控制台的Topic管理页面显示创建的Topic。