diff --git a/presto-docs/src/main/sphinx/admin/properties-session.rst b/presto-docs/src/main/sphinx/admin/properties-session.rst index 17c940dcddcb9..548d4fe88793e 100644 --- a/presto-docs/src/main/sphinx/admin/properties-session.rst +++ b/presto-docs/src/main/sphinx/admin/properties-session.rst @@ -50,7 +50,7 @@ The corresponding configuration property is :ref:`admin/properties:\`\`join-dist ^^^^^^^^^^^^^^^^^^^^^^^ * **Type:** ``boolean`` -* **Default value:** ``true`` +* **Default value:** ``false`` This property enables redistribution of data before writing. This can eliminate the performance impact of data skew when writing by hashing it @@ -58,8 +58,27 @@ across nodes in the cluster. It can be disabled when it is known that the output data set is not skewed in order to avoid the overhead of hashing and redistributing all the data across the network. +When both ``scale_writers`` and ``redistribute_writes`` are set to ``true``, +``scale_writers`` takes precedence. + The corresponding configuration property is :ref:`admin/properties:\`\`redistribute-writes\`\``. +``scale_writers`` +^^^^^^^^^^^^^^^^^ + +* **Type:** ``boolean`` +* **Default value:** ``true`` + +This property enables dynamic scaling of writer tasks based on throughput. When enabled, +Presto automatically adjusts the number of writer tasks to use the minimum necessary +for optimal performance. This can improve resource utilization by scaling out writers +only when needed based on data throughput. + +When both ``scale_writers`` and ``redistribute_writes`` are set to ``true``, +``scale_writers`` takes precedence. + +The corresponding configuration property is :ref:`admin/properties:\`\`scale-writers\`\``. + ``task_writer_count`` ^^^^^^^^^^^^^^^^^^^^^ diff --git a/presto-docs/src/main/sphinx/admin/properties.rst b/presto-docs/src/main/sphinx/admin/properties.rst index b99d048c96cac..56d8eda7c8b0b 100644 --- a/presto-docs/src/main/sphinx/admin/properties.rst +++ b/presto-docs/src/main/sphinx/admin/properties.rst @@ -49,7 +49,7 @@ The corresponding session property is :ref:`admin/properties-session:\`\`join_di ^^^^^^^^^^^^^^^^^^^^^^^ * **Type:** ``boolean`` -* **Default value:** ``true`` +* **Default value:** ``false`` This property enables redistribution of data before writing. This can eliminate the performance impact of data skew when writing by hashing it @@ -57,8 +57,27 @@ across nodes in the cluster. It can be disabled when it is known that the output data set is not skewed in order to avoid the overhead of hashing and redistributing all the data across the network. +When both ``scale-writers`` and ``redistribute-writes`` are set to ``true``, +``scale-writers`` takes precedence. + The corresponding session property is :ref:`admin/properties-session:\`\`redistribute_writes\`\``. +``scale-writers`` +^^^^^^^^^^^^^^^^^ + +* **Type:** ``boolean`` +* **Default value:** ``true`` + +This property enables dynamic scaling of writer tasks based on throughput. When enabled, +Presto automatically adjusts the number of writer tasks to use the minimum necessary +for optimal performance. This can improve resource utilization by scaling out writers +only when needed based on data throughput. + +When both ``scale-writers`` and ``redistribute-writes`` are set to ``true``, +``scale-writers`` takes precedence. + +The corresponding session property is :ref:`admin/properties-session:\`\`scale_writers\`\``. + ``check-access-control-on-utilized-columns-only`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^