EXPORT_CATALOG

This function and EXPORT_OBJECTS return equivalent output.

Generates a SQL script for recreating a physical schema design on another cluster.

The SQL script conforms to the following requirements:

  • Only includes objects to which the user has access.
  • Orders CREATE statements according to object dependencies so they can be recreated in the correct sequence. For example, if a table is in a non-PUBLIC schema, the required CREATE SCHEMA statement precedes the CREATE TABLE statement. Similarly, a table's CREATE ACCESS POLICY statement follows the table's CREATE TABLE statement.
  • If possible, creates projections with their KSAFE clause, if any, otherwise with their OFFSET clause.

Syntax

EXPORT_CATALOG ( [ '[destination]' [, 'scope'] ] )

Arguments

If you omit all arguments, this function exports to standard output all objects to which you have access.

destination

Specifies where to send output, one of the following:

  • Empty string, writes the script to standard output.
  • Path and name of an SQL output file, valid only for superusers. If you specify a file that does not exist, the function creates one. If you specify only a file name, Vertica creates it in the catalog directory. If the file already exists, the function silently overwrites its contents.

scope

Determines what to export. Within the specified scope, EXPORT_CATALOG exports all the objects to which you have access:

  • DESIGN: Exports all catalog objects, including schemas, tables, constraints, views, access policies, projections, SQL macros, and stored procedures.
  • DESIGN_ALL: Deprecated.
  • TABLES: Exports all tables and their access policies. See also EXPORT_TABLES.
  • DIRECTED_QUERIES: Exports all directed queries that are stored in the database. For details, see Managing Directed Queries.

Default: DESIGN

Privileges

None

Examples

Example

See Exporting the Catalog.