属性参考

    redistribute-writes

    • 类型:boolean
    • 默认值:true

    此属性允许在写入数据之前重新分布数据。这可以通过在集群中的节点间散列数据来消除数据倾斜带来的性能影响。当已知输出数据集没有发生倾斜时,可以停用数据分布,以避免在网络上散列和重分布所有数据的开销。也可以使用redistribute_writes会话属性在每个查询基础上指定。

    内存管理属性

    query.max-memory-per-node

    • 类型:data size
    • 默认值:JVM max memory * 0.1

    此属性是查询在工作节点上可以使用的最大用户内存量。用户内存是在执行期间为用户查询直接归属或可控制的事物分配的。例如,在执行期间构建的哈希表使用的内存、排序期间使用的内存等。当任何工作节点上的查询的用户内存分配达到此限制时,该工作节点将被杀死。

    query.max-total-memory-per-node

    • 类型:data size
    • 默认值:JVM max memory * 0.3

    此属性是查询在工作节点上可以使用的最大用户和系统内存量。系统内存是在执行期间为用户查询无法直接归属或可控制的事物分配的。例如,由读取器、写入器、网络缓冲区等分配的内存。当任何工作节点上的查询所分配的用户和系统内存的总和达到此限制时,该工作节点将被杀死。query.max-total-memory-per-node的值必须大于query.max-memory-per-node

    query.max-memory

    • 类型:data size
    • 默认值:20GB

    此属性是查询在整个集群上可以使用的最大用户内存量。用户内存是在执行期间为用户查询直接归属或可控制的事物分配的。例如,在执行期间构建的哈希表使用的内存、排序期间使用的内存等。当一个跨所有工作节点的查询的用户内存分配达到此限制时,该工作节点将被杀死。

    query.max-total-memory

    • 类型:data size
    • 默认值:query.max-memory * 2

    此属性是查询在整个集群上可以使用的最大用户和系统内存量。系统内存是在执行期间为用户查询无法直接归属或可控制的事物分配的。例如,由读取器、写入器、网络缓冲区等分配的内存。当一个跨所有工作节点的查询所分配的用户和系统内存的总和达到此限制时,该工作节点将被杀死。query.max-total-memory的值必须大于query.max-memory

    memory.heap-headroom-per-node

    • 类型:data size
    • 默认值:JVM max memory * 0.3

    此属性是在JVM堆中为openLooKeng不跟踪的分配留作裕量/缓冲区的内存量。

    溢出属性

    experimental.spill-enabled

    • 类型:boolean
    • 默认值:false

    尝试将内存溢出到磁盘,以避免超出查询的内存限制。

    溢出是将内存卸载到磁盘。此过程允许内存占用大的查询,代价是执行时间变慢。聚合、联接(内联接和外联接)、排序和窗口函数支持溢出。此属性不会减少其他联接类型所需的内存使用。

    注意,这是一个实验特性,应谨慎使用。

    此配置属性可由spill_enabled会话属性重写。

    experimental.spill-order-by

    • 类型:boolean
    • 默认值:true

    尝试将内存溢出到磁盘,以避免在运行排序运算符时超出查询的内存限制。此属性必须与experimental.spill-enabled属性一起使用。

    此配置属性可由spill_order_by会话属性重写。

    experimental.spill-window-operator

    • 类型:boolean
    • 默认值:true

    尝试将内存溢出到磁盘,以避免在运行窗口运算符时超出查询的内存限制。此属性必须与experimental.spill-enabled属性一起使用。

    此配置属性可由spill_window_operator会话属性重写。

    experimental.spiller-spill-path

    • 类型:string
    • **无默认值。**启用溢出时必须设置。

    溢出内容写入的目录。该属性可以是一个逗号分隔的列表,以同时溢出到多个目录,这有助于利用系统中安装的多个驱动器。

    不建议溢出到系统驱动器上。最重要的是,不要溢出到写入JVM日志的驱动器,因为磁盘过度使用可能导致JVM长时间暂停,从而导致查询失败。

    experimental.spiller-max-used-space-threshold

    • 类型:double
    • 默认值:0.9

    如果指定溢出路径的磁盘空间使用率高于此阈值,则该溢出路径将不适用于溢出。

    experimental.spiller-threads

    • 类型:integer
    • 默认值:4

    溢出线程数。如果默认值不能使底层溢出设备饱和(例如,在使用RAID时),增大该值。

    experimental.max-spill-per-node

    • 类型:data size
    • 默认值:100 GB

    单个节点上所有查询使用的最大溢出空间。

    experimental.query-max-spill-per-node

    • 类型:data size
    • 默认值:100 GB

    单个查询在单个节点上使用的最大溢出空间。

    • 类型:data size
    • 默认值:4 MB

    取消溢出单个聚合运算符实例所使用的内存限制。

    experimental.spill-compression-enabled

    experimental.spill-encryption-enabled

    • 类型:boolean
    • 默认值:false

    允许使用随机生成的密钥(每个溢出文件)来加密和解密溢出到磁盘的数据。

    在openLooKeng节点之间为查询的不同阶段交换数据。调整这些属性可有助于解决节点间通信问题或提高网络利用率。

    exchange.client-threads

    • 类型:integer
    • 最小值:1
    • 默认值:25

    exchange.concurrent-request-multiplier

    • 类型:integer
    • 最小值:1
    • 默认值:

    确定相对于可用缓冲区内存的并发请求数的乘数。根据每个请求的平均缓冲区使用量乘以该乘数,使用可适合可用缓冲区空间的客户端数量的启发式方法来确定最大请求数。例如,如果已经使用了exchange.max-buffer-size32 MB20 MB,每个请求的平均大小为2MB,则客户端的最大数量为multiplier * ((32MB - 20MB) / 2MB) = multiplier * 6。调整此值可以调整启发式,可能会增加并发度并提高网络利用率。

    exchange.max-buffer-size

    • 类型:data size
    • 默认值:32MB

    交换客户端中保存处理前从其他节点取出的数据的缓冲区大小。较大的缓冲区可以提高较大集群的网络吞吐量,从而减少查询处理时间,但会减少可用于其他用途的内存量。

    exchange.max-response-size

    • 类型:data size
    • 最小值:1MB
    • 默认值:16MB

    交换请求返回的最大响应大小。响应将被放置在交换客户机缓冲区中,该缓冲区在交换的所有并发请求之间共享。

    如果网络延迟较高,增大该值可以提高网络吞吐量。减小该值可以提高大型集群的查询性能,因为它减少了由于交换客户端缓冲区保存了较多任务(而不是保存较少任务中的较多数据)的响应而导致的倾斜。

    sink.max-buffer-size

    • 类型:data size
    • 默认值:32MB

    上游任务等待拉取任务数据的输出缓冲区大小。如果任务输出是经过哈希分区的,那么缓冲区将在所有分区的使用者之间共享。如果网络延迟较高或集群中有多个节点,增加此值可以提高在阶段之间传输的数据的网络吞吐量。

    任务属性

    task.concurrency

    • 类型:integer
    • 限制:必须是2的幂。
    • 默认值:16

    并行运算符(如联接和聚合)的默认本地并发度。该值应根据查询并发度和工作节点资源使用情况向上或向下调整。对于同时运行许多查询的集群来说,该值越低越好,因为所有正在运行的查询都已经利用了集群,所以增加更多的并发度将由于上下文切换和其他开销而导致速度变慢。对于一次只运行一个或较少查询的集群,该值越高越好。也可以使用task_concurrency会话属性在每个查询基础上指定。

    task.http-response-threads

    • 类型:integer
    • 最小值:1
    • 默认值:100

    可以创建用于处理HTTP响应的最大线程数。线程是按需创建的,在空闲时被清理。因此,如果待处理的请求数量很少,则不会产生大量开销。在并发查询数高的集群上或在有数百或数千个工作节点的集群上,更多的线程可能会有帮助。

    task.http-timeout-threads

    • 最小值:1
    • 默认值:3

    生成HTTP响应时用于处理超时的线程数。如果所有线程都频繁使用,则应增大此值。这可以通过io.prestosql.core.server:name=AsyncHttpExecutionMBean:TimeoutExecutor JMX对象进行监视。如果ActiveCount始终与PoolSize相同,则增加线程数。

    task.info-update-interval

    • 类型:duration
    • 最小值:1ms
    • 最大值:10s
    • 默认值:3s

    控制任务信息的时效性,用于调度。较大的值可以降低协调节点CPU负载,但可能导致次优的拆分调度。

    task.max-partial-aggregation-memory

    • 类型:data size
    • 默认值:16MB

    分布式聚合时部分聚合结果的最大大小。增大此值可以允许在刷新之前在本地保留更多的组,从而减少网络传输和CPU利用率,但要以增加内存利用率为代价。

    task.max-worker-threads

    • 类型:integer
    • 默认值:Node CPUs * 2

    设置工作节点用来处理拆分的线程数。如果工作节点CPU利用率较低且所有线程都在使用,则增加此数量可以提高吞吐量,但会导致堆空间使用率增加。设置过高的值可能会由于上下文切换而导致性能下降。通过io.prestosql.core.execution.executor:name=TaskExecutor.RunningSplits JXM对象的RunningSplits属性可以获得活动线程的数量。

    task.min-drivers

    • 类型:integer
    • 默认值:task.max-worker-threads * 2

    工作节点上运行中的叶子拆分的目标个数。这是一个最小值,因为每个叶任务至少保证只少3个运行拆分。还保证运行非叶子任务,以防止死锁。较低的值可能提高对新任务的响应能力,但可能导致资源利用不足。较高的值可以提高资源利用率,但会占用额外的内存。

    • 类型:integer
    • 限制:必须是2的幂。
    • 默认值:1

    每个工作节点每个查询的并发写入器线程数。增加该值可以提高写入速度,尤其在查询不是I/O绑定并且可以利用额外的CPU进行并行写入时。(某些连接器由于压缩或其他原因,在写入时可能会在CPU上出现瓶颈).设置该值过高可能导致集群因资源使用率过高而过载。也可以使用task_writer_count会话属性在每个查询基础上指定。

    节点调度器属性

    node-scheduler.max-splits-per-node

    • 类型:integer
    • 默认值:100

    每个工作节点可以运行的拆分总数的目标值。

    如果要批量提交查询(例如,定期运行大量报告),或者对于产生许多拆分且快速完成的连接器,建议使用较高的值。增加此值可以确保工作节点有足够的拆分来充分利用,从而改善查询延迟。

    设置此值过高将浪费内存,并可能导致性能降低,因为拆分在工作节点之间不平衡。理想情况下,应该设置始终至少有一个拆分等待处理,但不要更高。

    node-scheduler.max-pending-splits-per-task

    node-scheduler.min-candidates

    • 类型:integer
    • 最小值:1
    • 默认值:10

    选择拆分的目标节点时节点调度器将评估的最小候选节点数。将此值设置过低可能会使无法在所有工作节点之间适当平衡。将此值设置过高可能会增加查询延迟,并增加协调器CPU使用率。

    node-scheduler.network-topology

    • 类型:string
    • **允许值:**legacyflat
    • 默认值:legacy

    设置调度拆分时使用的网络拓扑。legacy调度拆分时忽略拓扑。flat会尝试在数据所在的主机上调度拆分,为本地拆分预留50%的工作队列。对于分布式存储与openLooKeng worker运行在相同节点上的集群,推荐使用flat

    node-scheduler.enable-split-cache-map

    • 类型:boolean
    • 默认值:true

    此属性启用SplitCacheAwareNodeSelector。拆分缓存感知节点选择器跟踪所有拆分以及以前调度过拆分的节点。在后续的查询执行中,使用拆分缓存映射来调度同一节点上的任务。但是,拆分缓存映射只有在执行缓存表查询之后才有效。

    optimizer.dictionary-aggregation

    • 类型:
    • 默认值:false

    对字典上的聚合启用优化。也可以使用dictionary_aggregation会话属性在每个查询基础上指定。

    optimizer.optimize-hash-generation

    • 类型:boolean
    • 默认值:true

    在执行期间的早期为分布、联接和聚合计算哈希代码,允许在查询的后期在操作之间共享结果。这可以通过避免多次计算相同的哈希来降低CPU使用率,但代价是为哈希进行额外的网络传输。在大多数情况下,这将减少整个查询处理时间。也可以使用optimize_hash_generation会话属性在每个查询基础上指定。

    在使用时禁用此属性通常很有帮助,这样可以使查询计划更易读。

    optimizer.optimize-metadata-queries

    • 类型:boolean
    • 默认值:false

    通过使用存储为元数据的值来启用对一些聚合的优化。这允许openLooKeng在恒定的时间内执行一些简单的查询。目前,该优化适用于分区键的maxminapprox_distinct,以及其它对输入(包括DISTINCT聚集)的基数不敏感的聚集。使用此属性可以大大加快某些查询的速度。

    optimizer.push-aggregation-through-join

    • 类型:boolean
    • 默认值:true

    如果聚合位于外联接上,并且来自联接外部的所有列都在分组子句中,则聚合被推送到外联接之下。这种优化对于相关的标量子查询尤其有用,这些子查询通过外联接被重写为聚合。例如:

    启用此优化可以减少联接需要处理的数据量,从而大大加快查询速度。 但是,此优化可能会减慢一些具有非常选择性联接的查询。也可以使用push_aggregation_through_join会话属性在每个查询基础上指定。

    optimizer.push-table-write-through-union

    • 类型:boolean
    • 默认值:true

    在写入数据的查询中使用UNION ALL时,对写入进行并行化。这提高了在UNION ALL查询中写入输出表的速度,因为这些写入在收集结果时不需要额外的同步。当写入速度尚未饱和时,启用此优化可以提高UNION ALL速度。但是,此优化可能会减慢负载已经很重的系统中的查询。也可以使用push_table_write_through_union会话属性在每个查询基础上指定。

    optimizer.join-reordering-strategy

    • 类型:string
    • **允许值:**AUTOMATICELIMINATE_CROSS_JOINSNONE
    • 默认值:ELIMINATE_CROSS_JOINS

    要使用的联接重新排序策略。 NONE维持查询中列出的表的顺序。 ELIMINATE_CROSS_JOINS重新排序联接,以尽可能消除交叉联接,否则保持原始查询顺序。当重新排序连接时,该值还尽可能地保持原来的表顺序。AUTOMATIC枚举可能的顺序并使用基于统计的成本估计来确定最小成本顺序。如果统计数据不可用,或者由于任何原因无法计算成本,则使用ELIMINATE_CROSS_JOINS策略。也可以使用join_reordering_strategy会话属性在每个查询基础上指定。

    optimizer.max-reordered-joins

    • 类型:integer
    • 默认值:9

    当optimizer.join-reordering-strategy设置为基于成本时,此属性确定可一次重新排序的最大联接数。

    警告

    可能的连接顺序数随着关系数的增大而增大,因此增加此值会导致严重的性能问题。

    正则表达式函数属性

    下列属性允许调优regexp

    regex-library

    • 类型:string
    • **允许值:**JONIRE2J
    • 默认值:JONI

    用于正则表达式函数的库。一般来说,JONI对于一般用途的速度要快一些,但是对于某些表达式模式可能需要指数级的时间。RE2J使用不同的算法保证线性时间,但通常速度较慢。

    re2j.dfa-states-limit

    • 类型:integer
    • 最小值:2
    • 默认值:2147483647

    RE2J在为正则表达式匹配构建快速但可能占用大量内存的确定性有限自动机(DFA)时所使用的最大状态数。如果达到限制,RE2J将回落到使用速度较慢但较少内存密集型非确定性有限自动机(NFA)的算法。减小此值会降低正则表达式搜索的最大内存占用,但会牺牲速度。

    • 类型:integer
    • 最小值:0
    • 默认值:5

    在RE2J使用较慢但较少内存密集型的NFA算法对所有后续输入进行搜索前,如果DFA算法达到状态限制,RE2J将重试该算法的次数。如果遇到给定输入行的极限值可能是离群值,那么你希望能够使用更快的DFA算法来处理后续行。如果你也有可能达到匹配后续行的限制,那么你应该从头开始使用正确的算法,以避免浪费时间和资源。处理的行数越多,该值应该越大。

    启发式索引属性

    启发式索引是外部索引模块,可用于筛选连接器级别的行。Bitmap、Bloom、MinMaxIndex是openLooKeng提供的索引列表。到目前为止,启发式索引仅用于Hive连接器,特别是ORC格式。

    • hetu.filter.enabled

      类型:boolean 默认值:false 此属性启用启发式索引。

    • hetu.filter.cache.max-indices-number

      类型:integer 默认值:10,000,000 缓存索引文件可以提供更好的性能,索引文件是只读的,很少被修改。缓存节省了从索引存储读取文件的时间。部分缓存此属性控制可以缓存的索引文件的最大数量。当超过限制时,基于LRU的现有条目将从缓存中移除,新条目将添加到缓存中。

    • hetu.filter.plugins

      类型:string 此属性用于定义支持启发式索引所需的插件的位置。属性接受多个插件,由逗号分隔。

    • hetu.filter.indexstore.uri

      类型:string 默认值:/opt/hetu/indices/ 存放所有索引文件的目录。每个索引将存储在自己的子目录中。

    HDFS索引存储的属性。一些例子如下:

    hetu.filter.indexstore.hdfs.config.resource hetu.filter.indexstore.hdfs.authentication.type hetu.filter.indexstore.hdfs.krb5.keytab.path hetu.filter.indexstore.hdfs.krb5.conf.path hetu.filter.indexstore.hdfs.krb5.principal

    本地索引存储的属性。