Vertica Analytics Platform Version 9.2.x Documentation

Auto-Projections

Auto-projections are superprojections that Vertica automatically generates for tables, both temporary and persistent. The following rules apply to all auto-projections:

  • Vertica creates the auto-projection in the same schema as the table.
  • Auto-projections conform to encoding, sort order, segmentation, and K-safety as specified in the table's creation statement.
  • If the table creation statement contains an AS SELECT clause, Vertica uses some properties of the projection definition's underlying query.

Auto-Projection Triggers

The conditions for creating auto-projections differ, depending on whether the table is temporary or persistent:

Table type Auto-projection trigger
Temporary CREATE TEMPORARY TABLE statement unless it includes NO PROJECTION.
Persistent CREATE TABLE statement contains one of these clauses:

If none of these conditions is true, Vertica automatically creates a superprojection (if one does not already exist) only when you first load data into the table with INSERT or COPY.

Default Segmentation and Sort Order

If CREATE TABLE or CREATE TEMPORARY TABLE omits a segmentation (SEGMENTED BY or UNSEGMENTED) or ORDER BY clause, Vertica segments and sorts auto-projections as follows:

  1. If the table creation statement omits a segmentation (SEGMENTED BY or UNSEGMENTED) clause, Vertica checks configuration parameter SegmentAutoProjection to determine whether to create an auto projection that is segmented or unsegmented. By default, this parameter is set to 1 (enable).
  2. If SegmentAutoProjection is enabled and a table's creation statement also omits an ORDER BY clause, Vertica segments and sorts the table's auto-projection according to the table's manner of creation:
    • If CREATE [TEMPORARY] TABLE contains an AS SELECT clause and the query output is segmented, the auto-projection uses the same segmentation. If the result set is already sorted, the projection uses the same sort order.
    • In all other cases, Vertica evaluates table column constraints to determine how to sort and segment the projection, as shown below:

    ConstraintsSorted by:Segmented by:
    Primary key Primary keyPrimary key
    Primary and foreign keys

    1.  Foreign keys
    2.  Primary key

    Primary key
    Foreign keys only

    1.  Foreign keys
    2.  Remaining columns excluding LONG data types, up to the limit set in configuration parameter MaxAutoSortColumns (by default 8).

    All columns excluding LONG data types, up to the limit set in configuration parameter MaxAutoSegColumns (by default 8).

    Vertica orders segmentation according to data type size, as follows:

    1.  Small (< 8 byte) data type columns
    2.  Large (>8 byte) data type columns

    NoneAll columns excluding LONG data types, in the order specified by CREATE TABLE.