diff --git a/presto-docs/src/main/sphinx/admin/cte-materialization.rst b/presto-docs/src/main/sphinx/admin/cte-materialization.rst index 9b169f02cee2c..2cf18ad23a3bf 100644 --- a/presto-docs/src/main/sphinx/admin/cte-materialization.rst +++ b/presto-docs/src/main/sphinx/admin/cte-materialization.rst @@ -22,9 +22,9 @@ The following configurations and session properties enable CTE materialization a ``cte-materialization-strategy`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``string`` - * **Allowed values:** ``ALL``, ``NONE``, ``HEURISTIC``, ``HEURISTIC_COMPLEX_QUERIES_ONLY`` - * **Default value:** ``NONE`` +* **Type:** ``string`` +* **Allowed values:** ``ALL``, ``NONE``, ``HEURISTIC``, ``HEURISTIC_COMPLEX_QUERIES_ONLY`` +* **Default value:** ``NONE`` Specifies the strategy for materializing Common Table Expressions (CTEs) in queries. @@ -41,9 +41,9 @@ Use the ``cte_materialization_strategy`` session property to set on a per-query ``cte-heuristic-replication-threshold`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``integer`` - * **Minimum value:** ``0`` - * **Default value:** ``4`` +* **Type:** ``integer`` +* **Minimum value:** ``0`` +* **Default value:** ``4`` When ``cte-materialization-strategy`` is set to ``HEURISTIC`` or ``HEURISTIC_COMPLEX_QUERIES_ONLY``, then CTEs will be materialized if they appear in a query at least ``cte-heuristic-replication-threshold`` number of times. @@ -52,8 +52,8 @@ Use the ``cte_heuristic_replication_threshold`` session property to set on a per ``query.cte-partitioning-provider-catalog`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``string`` - * **Default value:** ``system`` +* **Type:** ``string`` +* **Default value:** ``system`` The name of the catalog that provides custom partitioning for CTE materialization. This setting specifies which catalog should be used for CTE materialization. @@ -63,8 +63,8 @@ Use the ``cte_partitioning_provider_catalog`` session property to set on a per-q ``cte-filter-and-projection-pushdown-enabled`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``boolean`` - * **Default value:** ``true`` +* **Type:** ``boolean`` +* **Default value:** ``true`` Flag to enable or disable the pushdown of common filters and projects into the materialized CTE. @@ -73,8 +73,8 @@ Use the ``cte_filter_and_projection_pushdown_enabled`` session property to set o ``hive.cte-virtual-bucket-count`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``integer`` - * **Default value:** ``128`` +* **Type:** ``integer`` +* **Default value:** ``128`` The number of buckets to be used for materializing CTEs in queries. This setting determines how many buckets are used when materializing the CTEs, potentially affecting the performance of queries involving CTE materialization. @@ -87,9 +87,9 @@ Use the ``hive.cte_virtual_bucket_count`` session property to set on a per-query ``hive.temporary-table-storage-format`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``string`` - * **Allowed values:** ``PAGEFILE``, ``ORC``, ``DWRF``, ``ALPHA``, ``PARQUET``, ``AVRO``, ``RCBINARY``, ``RCTEXT``, ``SEQUENCEFILE``, ``JSON``, ``TEXTFILE``, ``CSV`` - * **Default value:** ``ORC`` +* **Type:** ``string`` +* **Allowed values:** ``PAGEFILE``, ``ORC``, ``DWRF``, ``ALPHA``, ``PARQUET``, ``AVRO``, ``RCBINARY``, ``RCTEXT``, ``SEQUENCEFILE``, ``JSON``, ``TEXTFILE``, ``CSV`` +* **Default value:** ``ORC`` This setting determines the data format for temporary tables generated by CTE materialization. The recommended value is ``PAGEFILE`` :doc:`/develop/serialized-page`, as it is the most performant, since it avoids serialization and deserialization during reads and writes, allowing for direct storage of Presto pages. @@ -99,9 +99,9 @@ Use the ``hive.temporary_table_storage_format`` session property to set on a per ``hive.temporary-table-compression-codec`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``string`` - * **Allowed values:** ``SNAPPY``, ``NONE``, ``GZIP``, ``LZ4``, ``ZSTD`` - * **Default value:** ``SNAPPY`` +* **Type:** ``string`` +* **Allowed values:** ``SNAPPY``, ``NONE``, ``GZIP``, ``LZ4``, ``ZSTD`` +* **Default value:** ``SNAPPY`` This property defines the compression codec to be used for temporary tables generated by CTE materialization. @@ -110,9 +110,9 @@ Use the ``hive.temporary_table_compression_codec`` session property to set on a ``hive.bucket-function-type-for-cte-materialization`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``string`` - * **Allowed values:** ``HIVE_COMPATIBLE``, ``PRESTO_NATIVE`` - * **Default value:** ``PRESTO_NATIVE`` +* **Type:** ``string`` +* **Allowed values:** ``HIVE_COMPATIBLE``, ``PRESTO_NATIVE`` +* **Default value:** ``PRESTO_NATIVE`` This setting specifies the Hash function type for CTE materialization. @@ -121,8 +121,8 @@ Use the ``hive.bucket_function_type_for_cte_materialization`` session property t ``query.max-written-intermediate-bytes`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - * **Type:** ``DataSize`` - * **Default value:** ``2TB`` +* **Type:** ``DataSize`` +* **Default value:** ``2TB`` This setting defines a cap on the amount of data that can be written during CTE Materialization. If a query exceeds this limit, it will fail.