Skip to content

Commit

Permalink
Fix formatting in admin/cte-materialization.rst (#24347)
Browse files Browse the repository at this point in the history
  • Loading branch information
steveburnett authored Jan 21, 2025
1 parent 7ee76de commit 097f566
Showing 1 changed file with 23 additions and 23 deletions.
46 changes: 23 additions & 23 deletions presto-docs/src/main/sphinx/admin/cte-materialization.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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.

Expand All @@ -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.
Expand All @@ -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.

Expand All @@ -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.
Expand All @@ -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.
Expand All @@ -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.

Expand All @@ -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.

Expand All @@ -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.

Expand Down

0 comments on commit 097f566

Please sign in to comment.