DESIGNER_ADD_DESIGN_TABLES

Adds the specified tables to a design. You must run DESIGNER_ADD_DESIGN_TABLES before adding design queries to the design. If no tables are added to the design, Vertica does not accept design queries.

Behavior Type

Immutable

Syntax

DESIGNER_ADD_DESIGN_TABLES ( 'design‑name', '[ table‑spec[,…] ]' [, 'analyze‑statistics'] )

Parameters

design‑name Name of the Database Designer design.
table‑spec[,…]

One or more comma-delimited arguments that specify which tables to add to the design, where each table‑spec argument can specify tables as follows:

  • [schema.]table
    Add table to the design.
  • schema.*
    Add all tables in schema.

If set to an empty string, Vertica adds all tables in the database to which the user has access.

analyze‑statistics

Boolean that optionally specifies whether to run ANALYZE_STATISTICS after adding the specified tables to the design, by default set to false.

Accurate statistics help Database Designer optimize compression and query performance. Updating statistics takes time and resources.

Privileges

One of the following:

  • Superuser
  • DBDUSER who created the design, has USAGE privilege on the design table schema, and owns the design table. 

Examples

The following example adds to design VMART_DESIGN all tables from schemas online_sales and store, and analyzes statistics for those tables:

=> SELECT DESIGNER_ADD_DESIGN_TABLES('VMART_DESIGN', 'online_sales.*, store.*','true');
 DESIGNER_ADD_DESIGN_TABLES
----------------------------
                          7
(1 row)

See Also

Running Database Designer Programmatically