KCL 配置

允许覆盖用于 Amazon DynamoDB 租赁表的表名称。

此应用程序从其中处理记录的流的名称。

表示应用程序处理器的这种实例化的唯一标识符。此值必须唯一。

在您可以将租赁所有者视为已失败之前必须经过的毫秒数。对于拥有大量分片的应用程序，可以将分片数设置为更高的数字，以减少跟踪租约所需的 DynamoDB IOPS 数。

分片同步调用之间的时间。

如果设置，只要子租赁已开始处理，即可删除租赁。

如果设置，将忽略具有打开的分片的子分片。这主要适用于 DynamoDB Streams。

单个工作程序应接受的最大租约数。如果设置太低，则在工作程序无法处理所有分片时可能会导致数据丢失，并造成工作程序之间的租约分配不够理想。在进行配置时，应考虑总分片数、工作程序数和工作程序的处理能力。

控制租赁续订线程池的大小。您的应用程序可以容纳的租赁越多，此池应该就越大。

确定 DynamoDB 中创建的租约表的容量模式。容量模式有两个选项：按需模式 (PAY_PER_REQUEST) 和预置模式。我们建议使用默认的按需模式设置，因为这种模式可以自动扩缩以适应工作负载，而无需进行容量规划。

应用程序应在流中开始的初始位置。此值仅在创建初始租赁时使用。

InitialPositionInStream.trim_HORIZ

用于确定负载平衡算法何时应考虑在工作程序之间重新分配分片的一个百分比值。

这是 KCL 3.x 中引入的新配置。

用于抑制单次再平衡操作中将从超载工作程序转移的负载量的一个百分比值。

这是 KCL 3.x 中引入的新配置。

确定是否仍需要从超载工作程序获得额外的租约，即使这会导致占用的总租约吞吐量超过所需的吞吐量。

这是 KCL 3.x 中引入的新配置。

确定在重新分配租约和负载平衡时，KCL 是否应忽略工作程序的资源指标（例如 CPU 利用率）。如果要阻止 KCL 根据 CPU 利用率进行负载平衡，则将其设置为 TRUE。

这是 KCL 3.x 中引入的新配置。

在租约分配期间分配给工作程序的最大吞吐量。

这是 KCL 3.x 中引入的新配置。

控制工作程序之间的租约移交行为。设置为 true 时，KCL 将尝试通过在将租约移交给其他工作人员之前让分片 RecordProcessor 有足够的时间完成处理来优雅地转移租约。这有助于确保数据完整性和平稳过渡，但可能会增加移交时间。

如果设置为 false，则租约将立即移交，无需等待优雅 RecordProcessor 地关闭。这可以加快移交速度，但可能存在处理不完全的风险。

注意：检查点必须在的 shutdownRequested () 方法中实现， RecordProcessor 才能从优雅的租赁移交功能中受益。

这是 KCL 3.x 中引入的新配置。

指定在强制将租约转让给下一个所有者之前，等待当前分片正常关闭的最短时间（ RecordProcessor 以毫秒为单位）。

如果 processRecords 方法的典型运行时间比默认值长，可考虑增加此设置。这样可以确保在租赁转让发生之前 RecordProcessor 有足够的时间完成其处理。

这是 KCL 3.x 中引入的新配置。

允许设置 Kinesis 返回的最大记录数。

配置 GetRecords 尝试失败之间的延迟。

使用的线程池大小 GetRecords。

确定 KCL 在两次 GetRecords 调用轮询数据流数据之间等待多长时间。单位为毫秒。

如果设置，即使 Kinesis 中未提供任何记录，也会调用记录处理器。

记录处理器应轮询多少时间才能查看是否已完成父分片。单位为毫秒。

如果租赁表包含现有租赁，请禁用同步的分片数据。

FALSE

要使用的分片优先级。

NoOpShardPrioritization

确定应用程序将运行在哪个 KCL 版本兼容模式下。此配置仅适用于从之前的 KCL 版本进行迁移的情况。迁移至 3.x 时，需要将该配置设置为 CLIENT_VERSION_CONFIG_COMPATIBLE_WITH_2X。完成迁移后，即可删除此配置。

等待重试 KCL 失败任务的时间。单位为毫秒。

任务尚未完成的情况下在记录警告之前要等待的时长。

指定在发布指标之前缓冲指标的最大持续时间（以毫秒为单位）。 CloudWatch

指定发布到之前要缓冲的最大指标数 CloudWatch。

指定要启用和发布的 CloudWatch 指标的粒度级别。

可能的值：NONE、SUMMARY、DETAILED。

MetricsLevel。详细

控制 CloudWatch 指标允许的维度。

应用程序一次应尝试窃取的最大租赁数量。KCL 3.x 会忽略此配置，并根据工作程序的资源利用率重新分配租约。

控制工作程序是否应优先考虑已过期的租约（租约未续订的时间达故障转移时间的 3 倍）和新的分片租约，而不管目标租约数如何，但仍需遵守最大租约限制。KCL 3.x 会忽略此配置，并始终将过期租约分布到各个工作程序中。