5.5. トピックの設定

自動作成されたトピックは、ブローカープロパティーファイルで指定できるデフォルトのトピック設定を使用します。ただし、トピックを手動で作成する場合は、作成時に設定を指定できます。また、トピックの作成後に変更することもできます。手動で作成されたトピックの主なトピック設定オプションは次のとおりです。

cleanup.policy
保持ポリシーを delete または compact に設定します。delete ポリシーは古いレコードを削除します。compact ポリシーにより、ログコンパクションが有効になります。デフォルト値は delete です。ログコンパクションの詳細は、Kafka の Web サイト を参照してください。
compression.type
保存されたメッセージに使用される圧縮を指定します。有効な値は、gzipsnappylz4uncompressed (圧縮なし)および producer (プロデューサーによって使用される圧縮コードが含まれます)です。デフォルト値は producer です。
max.message.bytes
Kafka ブローカーによって許可されるメッセージのバッチの最大サイズ(バイト単位)。デフォルト値は 1000012 です。
min.insync.replicas
書き込みが成功したとみなされるには、同期する必要のあるレプリカの最小数。デフォルト値は 1 です。
retention.ms
ログセグメントが保持される最大期間(ミリ秒単位)。この値よりも古いログセグメントが削除されます。デフォルト値は 604800000 (7 日)です。
retention.bytes
パーティションが保持する最大バイト数。パーティションサイズがこの制限を超えると、最も古いログセグメントが削除されます。-1 の値は制限なしを意味します。デフォルト値は -1 です。
segment.bytes
単一のコミットログセグメントファイルの最大サイズ(バイト単位)。セグメントのサイズが到達すると、新しいセグメントが開始されます。デフォルト値は 1073741824 バイト(1 gibibyte)です。

サポートされるすべてのトピック設定オプションの一覧は、付録B トピック設定パラメーター を参照してください。

自動作成されたトピックのデフォルトは、同様のオプションを使用して Kafka ブローカー設定に指定できます。

log.cleanup.policy
上記の cleanup.policy を参照してください。
compression.type
上記の compression.type を参照してください。
message.max.bytes
上記の max.message.bytes を参照してください。
min.insync.replicas
上記の min.insync.replicas を参照してください。
log.retention.ms
上記の retention.ms を参照してください。
log.retention.bytes
上記の retention.bytes を参照してください。
log.segment.bytes
上記の segment.bytes を参照してください。
default.replication.factor
自動的に作成されるトピックのデフォルトのレプリケーション係数。デフォルト値は 1 です。
num.partitions
自動作成されたトピックのデフォルトパーティション数。デフォルト値は 1 です。

サポートされるすべての Kafka ブローカー設定オプションのリストは、付録A ブローカー設定パラメーター を参照してください。