Kafka 冪等性是指無論一個消息被發送多少次,它都會被 Kafka 只處理一次。在生產者端實現冪等性,可以通過以下兩種主要方式:
Kafka 0.11.0.0 及更高版本提供了冪等性生產者 API。要使用這個功能,需要在創建生產者時設置 enable.idempotence
屬性為 true
。這將為生產者分配一個唯一的 ID(PID),并在每個分區內跟蹤已發送的消息。如果檢測到重復的消息,Kafka 會將其忽略。
以下是一個使用 Java 的冪等性生產者示例:
import org.apache.kafka.clients.producer.KafkaProducer;
import org.apache.kafka.clients.producer.ProducerConfig;
import org.apache.kafka.clients.producer.ProducerRecord;
import java.util.Properties;
public class IdempotentProducer {
public static void main(String[] args) {
Properties props = new Properties();
props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9092");
props.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
props.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
props.put(ProducerConfig.ENABLE_IDEMPOTENCE_CONFIG, "true"); // 設置冪等性為 true
KafkaProducer<String, String> producer = new KafkaProducer<>(props);
for (int i = 0; i < 10; i++) {
producer.send(new ProducerRecord<>("my-topic", Integer.toString(i), Integer.toString(i)));
}
producer.close();
}
}
另一種實現冪等性的方法是使用 Kafka 的事務功能。通過將生產者配置為支持事務,可以確保一組消息要么全部成功發送,要么全部失敗。這可以通過設置 transactional.id
屬性并在發送消息時使用事務 API 來實現。
以下是一個使用 Java 的事務生產者示例:
import org.apache.kafka.clients.producer.KafkaProducer;
import org.apache.kafka.clients.producer.ProducerConfig;
import org.apache.kafka.clients.producer.ProducerRecord;
import org.apache.kafka.clients.producer.TransactionManager;
import org.apache.kafka.clients.producer.KafkaTransactionManager;
import org.apache.kafka.clients.producer.ProducerTransaction;
import java.util.Properties;
public class TransactionalProducer {
public static void main(String[] args) {
Properties props = new Properties();
props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9092");
props.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
props.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
props.put(ProducerConfig.ENABLE_IDEMPOTENCE_CONFIG, "false"); // 設置冪等性為 false
props.put(ProducerConfig.TRANSACTIONAL_ID_CONFIG, "my-transactional-id");
KafkaProducer<String, String> producer = new KafkaProducer<>(props);
TransactionManager transactionManager = new KafkaTransactionManager<>(producer);
producer.initTransactions(transactionManager);
try {
ProducerTransaction transaction = producer.beginTransaction();
for (int i = 0; i < 10; i++) {
producer.send(new ProducerRecord<>("my-topic", Integer.toString(i), Integer.toString(i)));
}
transaction.commit();
} catch (Exception e) {
producer.abortTransaction();
e.printStackTrace();
} finally {
producer.close();
}
}
}
請注意,事務生產者會降低性能,因此在不需要嚴格保證消息順序的情況下,建議使用冪等性生產者 API。