This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Vertica system tables

Vertica provides system tables that let you monitor your database and evaluate settings of its objects.

Vertica provides system tables that let you monitor your database and evaluate settings of its objects. You can query these tables just as you do other tables, depending on privilege requirements.

See also

1 - V_CATALOG schema

The system tables in this section reside in the v_catalog schema.

The system tables in this section reside in the v_catalog schema. These tables provide information (metadata) about the objects in a database; for example, tables, constraints, users, projections, and so on.

1.1 - ACCESS_POLICY

Provides information about existing access policies.

Provides information about existing access policies.

Column Name Data Type Description
ACCESS_POLICY_OID INTEGER The unique identifier for the access policy.
TABLE_NAME VARCHAR Name of the table specified in the access policy.
IS_POLICY_ENABLED BOOLEAN Whether the access policy is enabled.
POLICY_TYPE VARCHAR

The type of access policy assigned to the table:

  • Column Policy

  • Row Policy

EXPRESSION VARCHAR The expression used when creating the access policy.
COLUMN_NAME VARCHAR The column to which the access policy is assigned. Row policies apply to all columns in the table.
TRUST_GRANTS BOOLEAN If true, GRANT statements override the access policy when determining whether a user can perform DML operations on the column or row.

Privileges

By default, only the superuser can view this table. Superusers can grant non-superusers access to this table with the following statement. Non-superusers can only see rows for tables that they own:

=> GRANT SELECT ON access_policy TO PUBLIC

Examples

The following query returns all access policies on table public.customer_dimension:

=> \x
=> SELECT policy_type, is_policy_enabled, table_name, column_name, expression FROM access_policy WHERE table_name = 'public.customer_dimension';
-[ RECORD 1 ]-----+----------------------------------------------------------------------------------------
policy_type       | Column Policy
is_policy_enabled | Enabled
table_name        | public.customer_dimension
column_name       | customer_address
expression        | CASE WHEN enabled_role('administrator') THEN customer_address ELSE '**************' END

1.2 - ALL_TABLES

Provides summary information about tables in a Vertica database.

Provides summary information about tables in a Vertica database.

Column Name Data Type Description
SCHEMA_NAME VARCHAR The name of the schema that contains the table.
TABLE_ID INTEGER Catalog-assigned numeric value that uniquely identifies the table.
TABLE_NAME VARCHAR The table name.
TABLE_TYPE VARCHAR

The type of table, which can be one of the following:

  • TABLE

  • SYSTEM TABLE

  • VIEW

  • GLOBAL TEMPORARY

  • LOCAL TEMPORARY

REMARKS VARCHAR A brief comment about the table. You define this field by using the COMMENT ON TABLE and COMMENT ON VIEW commands.

Examples

onenode=> SELECT DISTINCT table_name, table_type FROM all_tables
          WHERE table_name ILIKE 't%';
       table_name       |  table_type
------------------------+--------------
 types                  | SYSTEM TABLE
 trades                 | TABLE
 tuple_mover_operations | SYSTEM TABLE
 tables                 | SYSTEM TABLE
 tuning_recommendations | SYSTEM TABLE
 testid                 | TABLE
 table_constraints      | SYSTEM TABLE
 transactions           | SYSTEM TABLE
(8 rows)
onenode=> SELECT table_name, table_type FROM all_tables
          WHERE table_name ILIKE 'my%';
 table_name | table_type
------------+------------
 mystocks   | VIEW
(1 row)
=> SELECT * FROM all_tables LIMIT 4;
-[ RECORD 1 ]-------------------------------------------
schema_name | v_catalog
table_id    | 10206
table_name  | all_tables
table_type  | SYSTEM TABLE
remarks     | A complete listing of all tables and views
-[ RECORD 2 ]-------------------------------------------
schema_name | v_catalog
table_id    | 10000
table_name  | columns
table_type  | SYSTEM TABLE
remarks     | Table column information
-[ RECORD 3 ]-------------------------------------------
schema_name | v_catalog
table_id    | 10054
table_name  | comments
table_type  | SYSTEM TABLE
remarks     | User comments on catalog objects
-[ RECORD 4 ]-------------------------------------------
schema_name | v_catalog
table_id    | 10134
table_name  | constraint_columns
table_type  | SYSTEM TABLE
remarks     | Table column constraint information

1.3 - AUDIT_MANAGING_USERS_PRIVILEGES

Provides summary information about privileges, creating, modifying, and deleting users, and authentication changes.

Provides summary information about privileges, creating, modifying, and deleting users, and authentication changes. This table is a join of LOG_PARAMS, LOG_QUERIES, and LOG_TABLES filtered on the Managing_Users_Privileges category.

Column Name Data Type Description
ISSUED_TIME VARCHAR The time at which the query was executed.
USER_NAME VARCHAR Name of the user who issued the query at the time Vertica recorded the session.
USER_ID INTEGER Numeric representation of the user who ran the query.
HOSTNAME VARCHAR The hostname, IP address, or URL of the database server.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
AUDIT_TYPE VARCHAR

The type of operation for the audit:

  • Query

  • Parameter

  • Table

AUDIT_TAG_NAME VARCHAR The tag name for the specific parameter, query, or table.
REQUEST_TYPE VARCHAR

The type of query request. Examples include, but are not limited to:

  • QUERY

  • DDL

  • LOAD

  • UTILITY

  • TRANSACTION

  • PREPARE

  • EXECUTE

  • SET

  • SHOW

REQUEST_ID INTEGER The ID of the privilege request.
SUBJECT VARCHAR The name of the table or parameter that was queried or the subject of a query.
REQUEST VARCHAR Lists the privilege request.
SUCCESS VARCHAR Indicates whether or not the operation was successful.
CATEGORY VARCHAR The audit parent category, Managing_Users_Privileges.

1.4 - CA_BUNDLES

Stores certificate authority (CA) bundles created by CREATE CA BUNDLE.

Stores certificate authority (CA) bundles created by CREATE CA BUNDLE.

Column Name Data Type Description
OID INTEGER The object identifier.
NAME VARCHAR The name of the CA bundle.
OWNER INTEGER The OID of the owner of the CA bundle.
CERTIFICATES INTEGER The OIDs of the CA certificates inside the CA bundle.

Privileges

  • See CA bundle OID, name, and owner: Superuser or owner of the CA bundle.

  • See CA bundle contents: Owner of the bundle

Joining with CERTIFICATES

CA_BUNDLES only stores OIDs. Since operations on CA bundles require certificate and owner names, you can use the following query to map bundles to certificate and owner names:

=> SELECT user_name AS owner_name,
       owner     AS owner_oid,
       b.name    AS bundle_name,
       c.name    AS cert_name
FROM   (SELECT name,
               STRING_TO_ARRAY(certificates) :: array[INT] AS certs
        FROM   ca_bundles) b
       LEFT JOIN certificates c
              ON CONTAINS(b.certs, c.oid)
       LEFT JOIN users
              ON user_id = owner
ORDER  BY 1;

 owner_name |     owner_oid     | bundle_name  | cert_name
------------+-------------------+--------------+-----------
 dbadmin    | 45035996273704962 | ca_bundle    | root_ca
 dbadmin    | 45035996273704962 | ca_bundle    | ca_cert
(2 rows)

See also

1.5 - CATALOG_SUBSCRIPTION_CHANGES

Lists the changes made to catalog subscriptions.

Lists the changes made to catalog subscriptions.

Column Name Data Type Description
EVENT_TIMESTAMP TIMESTAMP The time a catalog subscription changed.
SESSION_ID VARCHAR A unique numeric ID assigned by the Vertica catalog, which identifies the session for which profiling information is captured. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the user.
USER_NAME VARCHAR The user who made changes to the subscriptions.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any. If a session is active but no transaction has begun, TRANSACTION_ID returns NULL.
SHARD_NAME VARCHAR The name of the shard.
SHARD_OID INTEGER The OID of the shard.
SUBSCRIBER_NODE_NAME VARCHAR The node name or names subscribed to the shard.
SUBSCRIBER_NODE_OID INTEGER The OID of the subscribing node or nodes.
OLD_STATE VARCHAR The previous state of the node subscription.
NEW_STATE VARCHAR The current state of the node subscription.
WAS_PRIMARY BOOLEAN Defines whether the node was the primary subscriber.
IS_PRIMARY BOOLEAN Defines whether the node is currently the primary subscriber.
CATALOG_VERSION INTEGER The version of the catalog at the time of the subscription change.

1.6 - CATALOG_SYNC_STATE

Shows when an Eon Mode database node synchronized its catalog to communal storage.

Shows when an Eon Mode database node synchronized its catalog to communal storage.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
SYNC_CATALOG_VERSION INTEGER The version number of the catalog being synchronized.
EARLIEST_CHECKPOINT_VERSION INTEGER The earliest checkpoint that is maintained in communal storage.
SYNC_TRAILING_INTERVAL INTEGER The difference between the global catalog version and the synchronized catalog version for a node.
LAST_SYNC_AT TIMESTAMPTZ The date and time the last time the catalog was synchronized.

1.7 - CATALOG_TRUNCATION_STATUS

Indicates how up to date the catalog is on communal storage.

Indicates how up to date the catalog is on communal storage. It is completely up to date when the current catalog version is the same as the catalog truncation version.

The catalog truncation version (CTV) is the version that Vertica cluster uses when it revives after a crash, shutdown, or hibernation. A cluster has only one CTV for all nodes in a cluster.

Column Name Data Type Description
CURRENT_CATALOG_VERSION INTEGER The version number of the catalog currently on the cluster.
TRUNCATION_CATALOG_VERSION INTEGER The version number as of the last time the catalog was synced on communal storage.

1.8 - CERTIFICATES

Stores certificates created by CREATE CERTIFICATE.

Stores certificates created by CREATE CERTIFICATE.

Column Name Data Type Description
OID INTEGER The object identifier.
NAME VARCHAR The name of the certificate.
OWNER INTEGER The owner of the object.
SIGNED_BY INTEGER The OID of the signing certificate.
PRIVATE_KEY INTEGER The OID of the certificate's private key.
START_DATE TIMESTAMPTZ When the certificate becomes valid.
EXPIRATION_DATE TIMESTAMPTZ When the certificate expires.
ISSUER VARCHAR The signing CA.
SUBJECT VARCHAR The entity for which the certificate is issued.
SERIAL VARCHAR The certificate's serial number.
x509v3_EXTENSIONS VARCHAR

Lists additional attributes specified during the certificate's creation.

For more information on extensions, see the OpenSSL documentation.

CERTIFICATE_TEXT VARCHAR The contents of the certificate.

Examples

See Generating TLS certificates and keys.

1.9 - CLIENT_AUTH

Provides information about client authentication methods.

Provides information about client authentication methods.

Higher values indicate higher priorities. Vertica tries to authenticate a user with an authentication method in order of priority from highest to lowest. For example:

  • A priority of 10 is higher than a priority of 5.

  • A priority 0 is the lowest possible value.

Column Name Data Type Description
AUTH_OID INTEGER Unique identifier for the authentication method.
AUTH_NAME VARCHAR User-given name of the authentication method.
IS_AUTH_ENABLED BOOLEAN Indicates if the authentication method is enabled.
AUTH_HOST_TYPE VARCHAR

The authentication host type, one of the following:

  • LOCAL

  • HOST

  • HOSTSSL

  • HOSTNOSSL

AUTH_HOST_ADDRESS VARCHAR If AUTH_HOST_TYPE is HOST, AUTH_HOST_ADDRESS is the IP address (or address range) of the remote host.
AUTH_METHOD VARCHAR

Authentication method to be used.

Valid values:

  • IDENT

  • GSS

  • HASH

  • LDAP

  • REJECT

  • TLS

  • TRUST

AUTH_PARAMETERS VARCHAR The parameter names and values assigned to the authentication method.
AUTH_PRIORITY INTEGER The priority specified for the authentication. Authentications with higher values are used first.
METHOD_PRIORITY INTEGER

The priority of this authentication based on the AUTH_METHOD.

Vertica only considers METHOD_PRIORITY when deciding between multiple authentication methods of equal AUTH_PRIORITY.

ADDRESS_PRIORITY INTEGER

The priority of this authentication based on the specificity of the AUTH_HOST_ADDRESS, if any. More specific IP addresses (fewer zeros) are used first.

Vertica only considers ADDRESS_PRIORITY when deciding between multiple authentication methods of equal AUTH_PRIORITY and METHOD_PRIORITY.

IS_FALLTHROUGH_ENABLED Boolean Whether authentication fallthrough is enabled.

Examples

This example shows how to get information about each client authentication method that you created:

=> SELECT * FROM client_auth;
    auth_oid   |  auth_name  | is_auth_enabled | auth_host_type | auth_host_address | auth_method | auth_parameters | auth_priority | method_priority | address_priority
-------------------+-------------+-----------------+----------------+-------------------+-------------+-----------------+---------------+-----------------+------------------
 45035996274059694 | v_gss       | True            | HOST           | 0.0.0.0/0         | GSS         |                 |             0 |               5 |               96
 45035996274059696 | v_trust     | True            | LOCAL          |                   | TRUST       |                 |             0 |               0 |                0
 45035996274059698 | v_ldap      | True            | HOST           | 10.19.133.123/    | LDAP        |                 |             0 |               5 |              128
 45035996274059700 | RejectNoSSL | True            | HOSTNOSSL      | 0.0.0.0/0         | REJECT      |                 |             0 |              10 |               96
 45035996274059702 | v_hash      | True            | LOCAL          |                   | HASH        |                 |             0 |               2 |                0
 45035996274059704 | v_tls       | True            | HOSTSSL        | 1.1.1.1/0         | TLS         |                 |             0 |               5 |               96
(6 rows)

See also

1.10 - CLIENT_AUTH_PARAMS

Provides information about client authentication methods that have parameter values assigned.

Provides information about client authentication methods that have parameter values assigned.

Column Name Data Type Description
AUTH_OID INTEGER A unique identifier for the authentication method.
AUTH_NAME VARCHAR Name that you defined for the authentication method.
AUTH_PARAMETER_NAME VARCHAR

Parameter name required by the authentication method. Some examples are:

  • system_users

  • binddn_prefix

  • host

AUTH_PARAMETER_VALUE VARCHAR Value of the specified parameter.

Examples

This example shows how to retrieve parameter names and values for all authentication methods that you created. The authentication methods that have parameters are:

  • v_ident

  • v_ldap

  • v_ldap1

=> SELECT * FROM CLIENT_AUTH_PARAMS;
     auth_oid      |   auth_name   | auth_parameter_name |    auth_parameter_value
-------------------+---------------+---------------------+------------------------------
 45035996273741304 | v_ident       | system_users        | root
 45035996273741332 | v_gss         |                     |
 45035996273741350 | v_password    |                     |
 45035996273741368 | v_trust       |                     |
 45035996273741388 | v_ldap        | host                | ldap://172.16.65.177
 45035996273741388 | v_ldap        | binddn_prefix       | cn=
 45035996273741388 | v_ldap        | binddn_suffix       | ,dc=qa_domain,dc=com
 45035996273741406 | RejectNoSSL   |                     |
 45035996273741424 | RejectWithSSL |                     |
 45035996273741450 | v_md5         |                     |
 45035996273904044 | l_tls         |                     |
 45035996273906566 | v_hash        |                     |
 45035996273910432 | v_ldap1       | host                | ldap://172.16.65.177
 45035996273910432 | v_ldap1       | basedn              | dc=qa_domain,dc=com
 45035996273910432 | v_ldap1       | binddn              | cn=Manager,dc=qa_domain,dc=com
 45035996273910432 | v_ldap1       | bind_password       | secret
 45035996273910432 | v_ldap1       | search_attribute    | cn
(17 rows)

1.11 - CLUSTER_LAYOUT

Shows the relative position of the actual arrangement of the nodes participating in the cluster and the fault groups (in an Enterprise Mode database) or subclusters (in an Eon Mode database) that affect them.

Shows the relative position of the actual arrangement of the nodes participating in the cluster and the fault groups (in an Enterprise Mode database) or subclusters (in an Eon Mode database) that affect them. Ephemeral nodes are not shown in the cluster layout ring because they hold no resident data.

Column Name Data Type Description
CLUSTER_POSITION INTEGER

Position of the node in the cluster ring, counting forward from 0.

NODE_ID INTEGER A unique numeric ID assigned by the Vertica catalog that identifies the node.
NODE_NAME VARCHAR The name of the node in the cluster ring. Only permanent nodes participating in database activity appear in the cluster layout. Ephemeral nodes are not shown in the output.
FAULT_GROUP_ID INTEGER

A unique numeric ID assigned by the Vertica catalog that identifies the fault group. This column can only have a value in an Enterprise Mode database.

FAULT_GROUP_NAME VARCHAR The name of the fault group for the node. This column can only have a value in an Enterprise Mode database.
FAULT_GROUP_TIER INTEGER

The node's depth in the fault group tree hierarchy. For example if the node:

  • Is not in a fault group, output is null

  • Is in the top level fault group, output is 0

  • Is in a fault group's child, output is 1

  • Is a fault group's grandchild, output is 2

This column can only have a value in an Enterprise Mode database.

SUBCLUSTER_ID INTEGER Unique identifier for the subcluster. This column only has a value in an Eon Mode database.
SUBCLUSTER_NAME VARCHAR The name of the subcluster containing the node. This column only has a value in an Eon Mode database.

See also

Large cluster

1.12 - COLUMNS

Provides table column information.

Provides table column information. For columns of Iceberg external tables, see ICEBERG_COLUMNS.

Column Name Data Type Description
TABLE_ID INTEGER Catalog-assigned numeric value that uniquely identifies the table.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, name of the namespace that contains the table.
TABLE_SCHEMA VARCHAR

Name of the table's schema.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_NAME VARCHAR Name of the table containing the column.
IS_SYSTEM_TABLE BOOLEAN Whether the table is a system table.
COLUMN_ID VARCHAR Catalog-assigned VARCHAR value that uniquely identifies a table column.
COLUMN_NAME VARCHAR Name of the column.
DATA_TYPE VARCHAR

Column data type.

Arrays of primitive types show the name ARRAY[type]. Other complex types show the inline name of the type, which matches the type_name value in the COMPLEX_TYPES table. For example: _ct_45035996273833610.

DATA_TYPE_ID INTEGER Catalog-assigned unique numeric ID of the data type.
DATA_TYPE_LENGTH INTEGER Maximum allowable length of the data type.
CHARACTER_MAXIMUM_LENGTH VARCHAR Maximum allowable length of a VARCHAR column.
NUMERIC_PRECISION INTEGER Number of significant decimal digits for a NUMERIC column.
NUMERIC_SCALE INTEGER Number of fractional digits for a NUMERIC column.
DATETIME_PRECISION INTEGER Declared precision for a TIMESTAMP column, or NULL if no precision was declared.
INTERVAL_PRECISION INTEGER Number of fractional digits retained in the seconds field of an INTERVAL column.
ORDINAL_POSITION INTEGER Column position respective to other columns in the table.
IS_NULLABLE BOOLEAN Whether the column can contain NULL values.
COLUMN_DEFAULT VARCHAR Expression set on a column with the DEFAULT constraint.
COLUMN_SET_USING VARCHAR Expression set on a column with the SET USING constraint.
IS_IDENTITY BOOLEAN Whether the column is an IDENTITY column.

Examples

=> SELECT table_schema, table_name, column_name, data_type, is_nullable
   FROM columns WHERE table_schema = 'store'
   AND data_type = 'Date';
 table_schema |    table_name     |      column_name       | data_type | is_nullable
--------------+-------------------+------------------------+-----------+-------------
 store        | store_dimension   | first_open_date        | Date      | f
 store        | store_dimension   | last_remodel_date      | Date      | f
 store        | store_orders_fact | date_ordered           | Date      | f
 store        | store_orders_fact | date_shipped           | Date      | f
 store        | store_orders_fact | expected_delivery_date | Date      | f
 store        | store_orders_fact | date_delivered         | Date      | f
6 rows)

In the following query, datetime_precision is NULL because the table definition declares no precision:

=> CREATE TABLE c (c TIMESTAMP);
CREATE TABLE
=> SELECT table_name, column_name, datetime_precision FROM columns
   WHERE table_name = 'c';
 table_name | column_name | datetime_precision
------------+-------------+--------------------
 c          | c           |
(1 row)

In the following example, timestamp precision is set:

=> DROP TABLE c;
=> CREATE TABLE c (c TIMESTAMP(4));
CREATE TABLE
=> SELECT table_name, column_name, datetime_precision FROM columns
   WHERE table_name = 'c';
 table_name | column_name | datetime_precision
------------+-------------+--------------------
 c          | c           |                  4

An IDENTITY column sequence is defined in a table's DDL. Column values automatically increment as new rows are added. The following query returns identity columns:

=> CREATE TABLE employees (employeeID IDENTITY, fname varchar(36), lname varchar(36));
CREATE TABLE
=> SELECT table_name, column_name, is_identity FROM columns WHERE is_identity = 't';
 table_name | column_name | is_identity
------------+-------------+-------------
 employees  | employeeID  | t
(1 row)

You can query the SEQUENCES table to get detailed information about an IDENTITY column sequence:

=> SELECT sequence_schema, sequence_name, identity_table_name, sequence_id FROM sequences WHERE identity_table_name ='employees';
 sequence_schema |      sequence_name       | identity_table_name |    sequence_id
-----------------+--------------------------+---------------------+-------------------
 public          | employees_employeeID_seq | employees           | 45035996273848816
(1 row)

For details about sequences and IDENTITY columns, see Sequences.

1.13 - COMMENTS

Returns information about comments associated with objects in the database.

Returns information about comments associated with objects in the database.

Column Name Data Type Description
COMMENT_ID INTEGER Comment's internal ID number
OBJECT_ID INTEGER Internal ID number of the object associated with the comment.
OBJECT_TYPE VARCHAR

Type of object associated with the comment, one of the following:

  • COLUMN

  • CONSTRAINT

  • FUNCTION

  • LIBRARY

  • NODE

  • PROJECTION

  • SCHEMA

  • SEQUENCE

  • TABLE

  • VIEW

OBJECT_SCHEMA VARCHAR Name of the schema containing the object.
OBJECT_NAME VARCHAR Name of the top-level object associated with the comment, such as a table or projection.
CHILD_OBJECT VARCHAR Name of the specific object associated with the comment, such as a table column. If the comment is associated with a top-level object, this value is NULL.
OWNER_ID VARCHAR Internal ID of the object's owner.
OWNER_NAME VARCHAR Object owner's name.
CREATION_TIME TIMESTAMPTZ When the comment was created.
LAST_MODIFIED_TIME TIMESTAMPTZ When the comment was last modified.
COMMENT VARCHAR Comment text.

Examples

=> COMMENT ON COLUMN public.t.x1 IS 'Column comment';

=> SELECT * FROM COMMENTS;
-[ RECORD 1 ]------+------------------------------
comment_id | 45035996273838776
object_id | 45035996273838760
object_type | COLUMN
object_schema | public
object_name | t
child_object | x1
owner_id | 45035996273704962
owner_name | dbadmin
creation_time | 2023-02-01 10:47:13.028663+08
last_modified_time | 2023-02-01 10:47:13.028663+08
comment | Column comment

1.14 - COMPLEX_TYPES

Contains information about inlined complex types.

Contains information about inlined complex types.

Each complex type in each external table has a unique type internally, even if the types are structurally the same (like two different ROW(int,int) cases). This inlined type is created when the table using it is created and is automatically dropped when the table is dropped. Inlined complex types cannot be shared or reused in other tables.

Each row in the COMPLEX_TYPES table represents one component (field) in one complex type. A ROW produces one row per field, an ARRAY produces one, and a MAP produces two.

Arrays of primitive types used in native (ROS) tables are not included in the COMPLEX_TYPES table. They are included instead in the TYPES table.

This table does not include complex types in Iceberg tables.

Column Name Data Type Description
TYPE_ID INTEGER A unique identifier for the inlined complex type.
TYPE_KIND VARCHAR The specific kind of complex type: row, array, or map.
TYPE_NAME VARCHAR The generated name of this type. All names begin with _ct_ followed by a number.
FIELD_ID INTEGER A unique identifier for the field.
FIELD_NAME VARCHAR The name of the field, if specified in the table definition, or a generated name beginning with "f".
FIELD_TYPE_NAME VARCHAR The type of the field's value.
FIELD_POSITION INTEGER The field's position in its containing complex type (0-based).
FIELD_LENGTH INTEGER Number of bytes in the field value, or -1 if the value is not a scalar type.
CHARACTER_MAXIMUM_LENGTH INTEGER Maximum allowable length of the column.
NUMERIC_PRECISION INTEGER Number of significant decimal digits.
NUMERIC_SCALE INTEGER Number of fractional digits.
DATETIME_PRECISION INTEGER For TIMESTAMP data type, returns the declared precision; returns NULL if no precision was declared.
INTERVAL_PRECISION INTEGER Number of fractional digits retained in the seconds field.

Examples

The following example shows the type and field values after defining a single external table.

=> CREATE EXTERNAL TABLE warehouse(
    name VARCHAR, id_map MAP<INT,VARCHAR>,
    data row(record INT, total FLOAT, description VARCHAR(100)),
    prices ARRAY[INT], comment VARCHAR(200), sales_total FLOAT, storeID INT)
  AS COPY FROM ... PARQUET;

=> SELECT type_id,type_kind,type_name,field_id,field_name,field_type_name,field_position
    FROM COMPLEX_TYPES ORDER BY type_id,field_name;

      type_id      | type_kind |       type_name       | field_id | field_name  | field_type_name | field_position
-------------------+-----------+-----------------------+----------+-------------+-----------------+----------------
 45035996274278280 | Map       | _ct_45035996274278280 |        6 | key         | int             |              0
 45035996274278280 | Map       | _ct_45035996274278280 |        9 | value       | varchar(80)     |              1
 45035996274278282 | Row       | _ct_45035996274278282 |        9 | description | varchar(80)     |              2
 45035996274278282 | Row       | _ct_45035996274278282 |        6 | record      | int             |              0
 45035996274278282 | Row       | _ct_45035996274278282 |        7 | total       | float           |              1
 45035996274278284 | Array     | _ct_45035996274278284 |        6 |             | int             |              0
(6 rows)

1.15 - CONSTRAINT_COLUMNS

Records information about table column constraints.

Records information about table column constraints.

Column Name Data Type Description
CONSTRAINT_ID INTEGER Unique numeric ID assigned by the Vertica catalog that identifies the constraint.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, name of the namespace that contains the table.
TABLE_SCHEMA VARCHAR

Name of the schema that contains this table.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_ID INTEGER Unique numeric ID assigned by the Vertica catalog that identifies the table.
TABLE_NAME VARCHAR Name of the table in which the column resides.
COLUMN_NAME VARCHAR Name of the column that is constrained. For check constraints, if more than one column is referenced, each appears as a separate row.
CONSTRAINT_NAME VARCHAR Constraint name for which information is listed.
CONSTRAINT_TYPE CHAR

The constraint type, one of the following:

  • c: check

  • f: foreign

  • n: not null

  • p: primary

  • u: unique

IS_ENABLED BOOLEAN Indicates whether a constraint for a primary key, unique key, or check constraint is currently enabled.
REFERENCE_TABLE_ID INTEGER Catalog-assigned integer value that uniquely identifies the referenced table
REFERENCE_TABLE_NAMESPACE VARCHAR For Eon Mode databases, references the TABLE_NAMESPACE column in the PRIMARY_KEYS table.
REFERENCE_TABLE_SCHEMA VARCHAR

Schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

REFERENCE_TABLE_NAME VARCHAR References the TABLE_NAME column in the PRIMARY_KEYS table.
REFERENCE_COLUMN_NAME VARCHAR References the COLUMN_NAME column in the PRIMARY_KEYS table.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

1.16 - CRYPTOGRAPHIC_KEYS

Stores private keys created by CREATE KEY.

Stores private keys created by CREATE KEY.

Column Name Data Type Description
OID INTEGER The object identifier.
NAME VARCHAR Name of the key.
OWNER INTEGER The owner of the object.
TYPE INTEGER

The type of key.

  • 0 = AES

  • 1 = RSA

LENGTH INTEGER The size of the key in bits.
HAS_PASSWORD BOOLEAN Whether the key has a password.
KEY VARCHAR The private key.

Examples

See Generating TLS certificates and keys.

1.17 - DATABASES

Provides information about the databases in this Vertica installation.

Provides information about the databases in this Vertica installation.

Column Name Data Type Description
DATABASE_ID INTEGER The database's internal ID number
DATABASE_NAME VARCHAR The database's name
OWNER_ID INTEGER The database owner's ID
OWNER_NAME INTEGER The database owner's name
START_TIME TIMESTAMPTZ The date and time the database last started
COMPLIANCE_MESSAGE VARCHAR Message describing the current state of the database's license compliance
EXPORT_SUBNET VARCHAR

Can be either of the following:

  • The subnet (on the public network) used by the database for import/export

  • The public address of the subnet that the Vertica native load balancing uses for load balancing

LOAD_BALANCE_POLICY VARCHAR The current native connection load balance policy, which controls whether client connection requests are redirected to other hosts in the database. See About native connection load balancing.
BACKEND_ADDRESS_FAMILY VARCHAR The Internet Protocol (IP) addressing standard used for internode communications. This value is either ipv4 or ipv6.
BRANCH_NAME VARCHAR This column is no longer used.

Examples

This example queries the databases table from a master database.

=> SELECT * FROM DATABASES;
-[ RECORD 1 ]----------+-------------------------------------------------------------
database_id            | 45035996273704976
database_name          | VMart
owner_id               | 45035996273704962
owner_name             | dbadmin
start_time             | 2017-10-22 05:16:22.066961-04
compliance_message     | The database is in compliance with respect to raw data size.
export_subnet          | 0
load_balance_policy    | none
backend_address_family | ipv4
branch_name            |

1.18 - DIRECTED_QUERIES

Returns information about directed queries.

Returns information about directed queries.

Column Name Data Type Description
QUERY_NAME VARCHAR

Directed query's unique identifier, used by statements such as ACTIVATE DIRECTED QUERY. How this identifier is set depends on how it was created:

  • Direct call to CREATE DIRECTED QUERY: Set by the user-supplied query-name argument.

  • Call to SAVE_PLANS: Concatenated from the following strings:

    save_plans_query-label_query-number_save-plans-version
    

where:

  • query-label is a LABEL hint embedded in the input query associated with this directed query. If theinput query contains no label, then this string is set to nolabel.
  • query-number is an integer in a continuous sequence between 0 and budget-query, which uniquely identifies this directed query from others in the same SAVE_PLANS-generated set.
  • [save-plans-version](/en/sql-reference/system-tables/v-catalog-schema/directed-queries/#SAVE_PLANS_VERSION) identifies the set of directed queries to which this directed query belongs.
IS_ACTIVE BOOLEAN Whether the directed query is active
VERTICA_VERSION VARCHAR Vertica version installed when this directed query was created.
COMMENT VARCHAR User-supplied or optimizer-generated comment on a directed query, up to 128 characters.
SAVE_PLANS_VERSION INTEGER

One of the following:

  • 0: Generated by a direct call to CREATE DIRECTED QUERY.
  • >0: Identifies a set of directed queries that were generated by the same call to SAVE_PLANS. All directed queries of the set share the same SAVE_PLANS_VERSION integer, which increments by 1 the previous highest SAVE_PLANS_VERSION setting. Use this identifier to activate, deactivate, and drop a set of directed queries.
USERNAME VARCHAR User that created this directed query.
CREATION_DATE VARCHAR When the directed query was created.
SINCE_DATE VARCHAR Populated by SAVE_PLANS-generated directed queries, the earliest timestamp of input queries eligible to be saved as directed queries.
INPUT_QUERY VARCHAR Input query associated with this directed query. Multiple directed queries can map to the same input query.
ANNOTATED_QUERY VARCHAR Query with embedded hints that was paired with the input query of this directed query, where the hints encapsulated the query plan saved with CREATE DIRECTED QUERY.
DIGEST INTEGER Hash of saved query plan data, used by the optimizer to map identical input queries to the same active directed query.

Privileges

Superuser

Truncated query results

Query results for the fields INPUT_QUERY and ANNOTATED_QUERY are truncated after ~32K characters. You can get the full content of both fields in two ways:

1.19 - DUAL

DUAL is a single-column "dummy" table with one record whose value is X; for example:.

DUAL is a single-column "dummy" table with one record whose value is X; for example:

=> SELECT * FROM DUAL;
 dummy
-------
 X
(1 row)

You can write the following types of queries:

=> SELECT 1 FROM dual;
 ?column?
----------
        1
(1 row)
=> SELECT current_timestamp, current_user FROM dual;
           ?column?            | current_user
-------------------------------+--------------
 2010-03-08 12:57:32.065841-05 | release
(1 row)
=> CREATE TABLE t1(col1 VARCHAR(20), col2 VARCHAR(2));
=> INSERT INTO T1(SELECT 'hello' AS col1, 1 AS col2 FROM dual);)
=> SELECT * FROM t1;
 col1  | col2
-------+------
 hello | 1
(1 row

Restrictions

You cannot create projections for DUAL.

1.20 - ELASTIC_CLUSTER

Returns information about cluster elasticity, such as whether Elastic Cluster is running.

Returns information about cluster elasticity, such as whether Elastic cluster is running.

Column Name Data Type Description
SCALING_FACTOR INTEGER This value is only meaningful when you enable local segments. SCALING_FACTOR influences the number of local segments on each node. Initially—before a rebalance runs—there are scaling_factor number of local segments per node. A large SCALING_FACTOR is good for rebalancing a potentially wide range of cluster configurations quickly. However, too large a value might lead to ROS pushback, particularly in a database with a table with a large number of partitions. See SET_SCALING_FACTOR for more details.
MAXIMUM_SKEW_PERCENT INTEGER This value is only meaningful when you enable local segments. MAXIMUM_SKEW_PERCENT is the maximum amount of skew a rebalance operation tolerates, which preferentially redistributes local segments; however, if after doing so the segment ranges of any two nodes differs by more than this amount, rebalance will separate and distribute storage to even the distribution.
SEGMENT_LAYOUT VARCHAR Current, offset=0, segment layout. New segmented projections will be created with this layout, with segments rotated by the corresponding offset. Existing segmented projections will be rebalanced into an offset of this layout.
LOCAL_SEGMENT_LAYOUT VARCHAR Similar to SEGMENT_LAYOUT but includes details that indicate the number of local segments, their relative size and node assignment.
VERSION INTEGER Number that gets incremented each time the cluster topology changes (nodes added, marked ephemeral, marked permanent, etc). Useful for monitoring active and past rebalance operations.
IS_ENABLED BOOLEAN True if Elastic Cluster is enabled, otherwise false.
IS_LOCAL_SEGMENT_ENABLED BOOLEAN True if local segments are enabled, otherwise false.
IS_REBALANCE_RUNNING BOOLEAN True if rebalance is currently running, otherwise false.

Privileges

Superuser

See also

1.21 - EPOCHS

For the most recently closed epochs, lists the date and time of the close and the corresponding epoch number of the closed epoch.

For the most recently closed epochs, lists the date and time of the close and the corresponding epoch number of the closed epoch. The EPOCHS table may return a varying number of rows depending on current commit activities.

Column Name Data Type Description
EPOCH_CLOSE_TIME DATETIME The date and time that the epoch closed.
EPOCH_NUMBER INTEGER The epoch number of the closed epoch.

Examples

=> SELECT * FROM EPOCHS;
       epoch_close_time        | epoch_number
-------------------------------+--------------
 2018-11-12 16:05:15.552571-05 |           16
(1 row)

Querying for historical data

If you need historical data about epochs and corresponding date information, query the DC_TRANSACTION_ENDS table.

=> select dc.end_epoch,min(dc.time),max(dc.time) from dc_transaction_ends dc group by end_epoch;
 end_epoch |             min               | max
-----------+-------------------------------+-------------------------------
       214 |  2018-10-12 08:05:47.02075-04 | 2018-10-15 10:22:24.015292-04
       215 | 2018-10-15 10:22:47.015172-04 | 2018-10-15 13:00:44.888984-04
                          ...
       226 | 2018-10-15 15:03:47.015235-04 | 2018-10-15 20:37:34.346667-04
       227 | 2018-10-15 20:37:47.008137-04 | 2018-10-16 07:39:00.29917-04
       228 | 2018-10-16 07:39:47.012411-04 | 2018-10-16 08:16:01.470232-04
       229 | 2018-10-16 08:16:47.018899-04 | 2018-10-16 08:21:13.854348-04
       230 | 2018-10-16 08:21:47.013767-04 | 2018-10-17 12:21:09.224094-04
       231 |  2018-10-17 12:21:09.23193-04 | 2018-10-17 15:11:59.338777-04

See also

1.22 - FAULT_GROUPS

View the fault groups and their hierarchy in the cluster.

View the fault groups and their hierarchy in the cluster.

Column Name Data Type Description
MEMBER_ID INTEGER A unique numeric ID assigned by the Vertica catalog that identifies the fault group.
MEMBER_TYPE VARCHAR The type of fault group. Values can be either NODE or FAULT GROUP.
MEMBER_NAME VARCHAR Name associated with this fault group. Values will be the node name or the fault group name.
PARENT_ID INTEGER

A unique numeric ID assigned by the Vertica catalog that identifies the parent fault group. The parent fault group can contain:

  • Nodes

  • Other fault groups

  • Nodes and other fault groups

PARENT_TYPE VARCHAR

The type of parent fault group, where the default/root parent is the DATABASE object. Can be one of the following objects:

  • FAULT GROUP

  • DATABASE

PARENT_NAME VARCHAR The name of the fault group that contains nodes or other fault groups or both nodes and fault groups.
IS_AUTOMATICALLY_GENERATED BOOLEAN If true, denotes whether Vertica Analytic Database created fault groups for you to manage the fault tolerance of control nodes in large cluster configurations. If false, denotes that you created fault groups manually. See Fault Groups for more information

Examples

Show the current hierarchy of fault groups in the cluster:

vmartdb=> SELECT member_type, member_name, parent_type, CASE
          WHEN parent_type = 'DATABASE' THEN ''
          ELSE parent_name END FROM fault_groups
          ORDER BY member_name;
 member_type | member_name           | parent_type | parent_name
-------------+-----------------------+-------------+-------------
 NODE        | v_vmart_node0001      | FAULT GROUP | two
 NODE        | v_vmart_node0002      | FAULT GROUP | two
 NODE        | v_vmart_node0003      | FAULT GROUP | three
 FAULT GROUP | one                   | DATABASE    |
 FAULT GROUP | three                 | DATABASE    |
 FAULT GROUP | two                   | FAULT GROUP | one

View the distribution of the segment layout:

vmartdb=> SELECT segment_layout from elastic_cluster;
                           segment_layout
-------------------------------------------------------------------------
 v_vmart_node0001[33.3%] v_vmart_node0003[33.3%] v_vmart_node0004[33.3%]
(1 row)

See also

1.23 - FOREIGN_KEYS

Provides foreign key information.

Provides foreign key information.

Column Name Data Type Description
CONSTRAINT_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the constraint.
CONSTRAINT_NAME VARCHAR The constraint name for which information is listed.
COLUMN_NAME VARCHAR The name of the column that is constrained.
ORDINAL_POSITION VARCHAR The position of the column within the key. The numbering of columns starts at 1.
TABLE_NAME VARCHAR The table name for which information is listed.
REFERENCE_TABLE_NAME VARCHAR References the TABLE_NAME column in the PRIMARY_KEYS table.
CONSTRAINT_TYPE VARCHAR The constraint type, f, for foreign key.
REFERENCE_COLUMN_NAME VARCHAR References the COLUMN_NAME column in the PRIMARY_KEY table.
TABLE_NAMESPACE_ID VARCHAR Unique numeric identifier for the table namespace.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, namespace that contains the table for which information is listed.
TABLE_SCHEMA VARCHAR

The schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

REFERENCE_TABLE_NAMESPACE_ID VARCHAR For Eon Mode databases, references the TABLE_NAMESPACE_ID column in the PRIMARY_KEYS table.
REFERENCE_TABLE_NAMESPACE VARCHAR For Eon Mode databases, references the TABLE_NAMESPACE column in the PRIMARY_KEYS table.
REFERENCE_TABLE_SCHEMA VARCHAR

References the TABLE_SCHEMA column in the PRIMARY_KEYS table.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

Examples

mydb=> SELECT
          constraint_name,
          table_name,
          ordinal_position,
          reference_table_name
       FROM foreign_keys ORDER BY 3;
      constraint_name      |    table_name     | ordinal_position | reference_table_name
---------------------------+-------------------+------------------+-----------------------
 fk_store_sales_date       | store_sales_fact  |                1 | date_dimension
 fk_online_sales_saledate  | online_sales_fact |                1 | date_dimension
 fk_store_orders_product   | store_orders_fact |                1 | product_dimension
 fk_inventory_date         | inventory_fact    |                1 | date_dimension
 fk_inventory_product      | inventory_fact    |                2 | product_dimension
 fk_store_sales_product    | store_sales_fact  |                2 | product_dimension
 fk_online_sales_shipdate  | online_sales_fact |                2 | date_dimension
 fk_store_orders_product   | store_orders_fact |                2 | product_dimension
 fk_inventory_product      | inventory_fact    |                3 | product_dimension
 fk_store_sales_product    | store_sales_fact  |                3 | product_dimension
 fk_online_sales_product   | online_sales_fact |                3 | product_dimension
 fk_store_orders_store     | store_orders_fact |                3 | store_dimension
 fk_online_sales_product   | online_sales_fact |                4 | product_dimension
 fk_inventory_warehouse    | inventory_fact    |                4 | warehouse_dimension
 fk_store_orders_vendor    | store_orders_fact |                4 | vendor_dimension
 fk_store_sales_store      | store_sales_fact  |                4 | store_dimension
 fk_store_orders_employee  | store_orders_fact |                5 | employee_dimension
 fk_store_sales_promotion  | store_sales_fact  |                5 | promotion_dimension
 fk_online_sales_customer  | online_sales_fact |                5 | customer_dimension
 fk_store_sales_customer   | store_sales_fact  |                6 | customer_dimension
 fk_online_sales_cc        | online_sales_fact |                6 | call_center_dimension
 fk_store_sales_employee   | store_sales_fact  |                7 | employee_dimension
 fk_online_sales_op        | online_sales_fact |                7 | online_page_dimension
 fk_online_sales_shipping  | online_sales_fact |                8 | shipping_dimension
 fk_online_sales_warehouse | online_sales_fact |                9 | warehouse_dimension
 fk_online_sales_promotion | online_sales_fact |               10 | promotion_dimension
(26 rows)

1.24 - GRANTS

Returns information about privileges that are explicitly granted on database objects.

Returns information about privileges that are explicitly granted on database objects. Information about inherited privileges is not included.

Column Name Data Type Description
GRANTEE VARCHAR The user being granted permission.
GRANTEE_ID INTEGER Catalog-assigned integer value that uniquely identifies theuser granted permissions.
GRANT_ID INTEGER Catalog-assigned integer value that uniquely identifies thegrant operation.
GRANTOR VARCHAR The user granting the permission.
GRANTOR_ID INTEGER Catalog-assigned integer value that uniquely identifies theuser who performed the grant operation.
OBJECT_ID INTEGER Catalog-assigned integer value that uniquely identifies theobject granted.
OBJECT_NAME VARCHAR The name of the object that is being granted privileges. Note that for schema privileges, the schema name appears in the OBJECT_NAME column instead of the OBJECT_SCHEMA column.
OBJECT_NAMESPACE VARCHAR For Eon Mode databases, namespace of the object that is being granted privileges.
OBJECT_SCHEMA VARCHAR

Schema of the object that is being granted privileges.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

OBJECT_TYPE VARCHAR The object type on which the grant was applied—for example, ROLE, SCHEMA, DATABASE, RESOURCEPOOL.
PRIVILEGES_DESCRIPTION VARCHAR Lists the privileges granted on an object—for example INSERT, SELECT. An asterisk in PRIVILEGES_DESCRIPTION output shows that the privilege grant included WITH GRANT OPTION.

Examples

The following query shows the privileges that are granted to user Rob or role R1. An asterisk (*) appended to a privilege indicates that the user can grant the privilege to other users:

=> SELECT grantor,privileges_description,object_name,object_type,grantee FROM grants WHERE grantee='Rob' OR grantee='R1';
 grantor |  privileges_description   | object_name | object_type  | grantee
 --------+---------------------------+-------------+--------------+---------
 dbadmin | USAGE                     | general     | RESOURCEPOOL | Rob
 dbadmin | USAGE, CREATE             | s1          | SCHEMA       | Rob
 dbadmin | INSERT*, SELECT*, UPDATE* | t1          | TABLE        | Rob
 dbadmin | SELECT                    | t1          | TABLE        | R1
 dbadmin | USAGE                     | s1          | SCHEMA       | R1
 dbadmin |                           | R1          | ROLE         | Rob
 (6 rows)

See also

1.25 - HCATALOG_COLUMNS

Describes the columns of all tables available through the HCatalog Connector.

Describes the columns of all tables available through the HCatalog Connector. Each row in this table corresponds to to a column in a table accessible through the HCatalog Connector. See Using the HCatalog Connector for more information.

Column Name Data Type Description
TABLE_SCHEMA VARCHAR(128) The name of the Vertica Analytic Database schema that contains the table containing this column
HCATALOG_SCHEMA VARCHAR(128) The name of the Hive schema or database that contains the table containing this column
TABLE_NAME VARCHAR(128) The name of the table that contains the column
IS_PARTITION_COLUMN BOOLEAN Whether the table is partitioned on this column
COLUMN_NAME VARCHAR(128) The name of the column
HCATALOG_DATA_TYPE VARCHAR(128) The Hive data type of this column
DATA_TYPE VARCHAR(128) The Vertica Analytic Database data type of this column
DATA_TYPE_ID INTEGER Numeric ID of the column's Vertica Analytic Database data type
DATA_TYPE_LENGTH INTEGER The number of bytes used to store this data type
CHARACTER_MAXIMUM_LENGTH INTEGER For string data types, the maximum number of characters it can hold
NUMERIC_PRECISION INTEGER For numeric types, the precision of the values in the column
NUMERIC_SCALE INTEGER For numeric data types, the scale of the values in the column
DATETIME_PRECISION INTEGER For datetime data types, the precision of the values in the column
INTERVAL_PRECISION INTEGER For interval data types, the precision of the values in the column
ORDINAL_POSITION INTEGER The position of the column within the table

Privileges

No explicit permissions are required; however, users see only the records that correspond to schemas they have permissions to access.

Notes

If you are using WebHCat instead of HiveServer2, querying this table results in one web service call to the WebHCat server for each table in each HCatalog schema. If you need to perform multiple queries on this table in a short period of time, consider creating a copy of the table using a CREATE TABLE AS statement to improve performance. The copy does not reflect any changes made to the schema of the Hive tables after it was created, but it is much faster to query.

Examples

The following example demonstrates finding the column information for a specific table:

=> SELECT * FROM HCATALOG_COLUMNS WHERE table_name = 'hcatalogtypes'
-> ORDER BY ordinal_position;
-[ RECORD 1 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | intcol
hcatalog_data_type       | int
data_type                | int
data_type_id             | 6
data_type_length         | 8
character_maximum_length |
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 1
-[ RECORD 2 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | floatcol
hcatalog_data_type       | float
data_type                | float
data_type_id             | 7
data_type_length         | 8
character_maximum_length |
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 2
-[ RECORD 3 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | doublecol
hcatalog_data_type       | double
data_type                | float
data_type_id             | 7
data_type_length         | 8
character_maximum_length |
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 3
-[ RECORD 4 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | charcol
hcatalog_data_type       | string
data_type                | varchar(65000)
data_type_id             | 9
data_type_length         | 65000
character_maximum_length | 65000
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 4
-[ RECORD 5 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | varcharcol
hcatalog_data_type       | string
data_type                | varchar(65000)
data_type_id             | 9
data_type_length         | 65000
character_maximum_length | 65000
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 5
-[ RECORD 6 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | boolcol
hcatalog_data_type       | boolean
data_type                | boolean
data_type_id             | 5
data_type_length         | 1
character_maximum_length |
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 6
-[ RECORD 7 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | timestampcol
hcatalog_data_type       | string
data_type                | varchar(65000)
data_type_id             | 9
data_type_length         | 65000
character_maximum_length | 65000
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 7
-[ RECORD 8 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | varbincol
hcatalog_data_type       | binary
data_type                | varbinary(65000)
data_type_id             | 17
data_type_length         | 65000
character_maximum_length | 65000
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 8
-[ RECORD 9 ]------------+-----------------
table_schema             | hcat
hcatalog_schema          | default
table_name               | hcatalogtypes
is_partition_column      | f
column_name              | bincol
hcatalog_data_type       | binary
data_type                | varbinary(65000)
data_type_id             | 17
data_type_length         | 65000
character_maximum_length | 65000
numeric_precision        |
numeric_scale            |
datetime_precision       |
interval_precision       |
ordinal_position         | 9

See also

1.26 - HCATALOG_SCHEMATA

Lists all of the schemas defined using the HCatalog Connector.

Lists all of the schemas defined using the HCatalog Connector. See Using the HCatalog Connector.

Unlike other HCatalog Connector-related system tables, this table makes no calls to Hive, so querying incurs very little overhead.

Column Name Data Type Description
SCHEMA_ID INTEGER The Vertica Analytic Database ID number for the schema
SCHEMA_NAME VARCHAR(128) The name of the schema defined in the Vertica Analytic Database catalog
SCHEMA_OWNER_ID INTEGER The ID number of the user who owns the Vertica Analytic Database schema
SCHEMA_OWNER VARCHAR(128) The username of the Vertica Analytic Database schema's owner
CREATE_TIME TIMESTAMPTZ The date and time the schema as created
HOSTNAME VARCHAR(128) The host name or IP address of the database server that holds the Hive metadata
PORT INTEGER The port number on which the metastore database listens for connections
HIVESERVER2_HOSTNAME VARCHAR(128) The host name or IP address of the HiveServer2 server for the Hive database
WEBSERVICE_HOSTNAME VARCHAR(128) The host name or IP address of the WebHCat server for the Hive database, if used
WEBSERVICE_PORT INTEGER The port number on which the WebHCat server listens for connections
WEBHDFS_ADDRESS VARCHAR (128) The host and port ("host:port") for the WebHDFS service, used for reading ORC and Parquet files
HCATALOG_SCHEMA_NAME VARCHAR(128) The name of the schema or database in Hive to which the Vertica Analytic Database schema is mapped/
HCATALOG_USER_NAME VARCHAR(128) The username the HCatalog Connector uses to authenticate itself to the Hive database.
HCATALOG_CONNECTION_TIMEOUT INTEGER The number of seconds the HCatalog Connector waits for a successful connection to the HiveServer or WebHCat server. A value of 0 means wait indefinitely.
HCATALOG_SLOW_TRANSFER_LIMIT INTEGER The lowest data transfer rate (in bytes per second) from the HiveServer2 or WebHCat server that the HCatalog Connector accepts.
HCATALOG_SLOW_TRANSFER_TIME INTEGER The number of seconds the HCatalog Connector waits before enforcing the data transfer rate lower limit by breaking the connection and terminating the query.
SSL_CONFIG VARCHAR(128) The path of the Hadoop ssl-client.xml configuration file, if using HiveServer2 with SSL wire encryption.
CUSTOM_PARTITIONS BOOLEAN Whether the Hive schema uses custom partition locations.

Privileges

No explicit permissions are required; however, users see only the records that correspond to schemas they have permissions to access.

See also

1.27 - HCATALOG_TABLE_LIST

A concise list of all tables contained in all Hive schemas and databases available through the HCatalog Connector.

A concise list of all tables contained in all Hive schemas and databases available through the HCatalog Connector. See Using the HCatalog Connector.

Column Name Data Type Description
TABLE_SCHEMA_ID INTEGER Internal ID number for the schema containing the table
TABLE_SCHEMA VARCHAR(128) Name of the Vertica Analytic Database schema through which the table is available
HCATALOG_SCHEMA VARCHAR(128) Name of the Hive schema or database containing the table
TABLE_NAME VARCHAR(128) The name of the table
HCATALOG_USER_NAME VARCHAR(128) Name of Hive user used to access the table

Privileges

No explicit permissions are required; however, users see only the records that correspond to schemas they have permissions to access.

Notes

  • Querying this table results in one call to HiveServer2 for each Hive schema defined using the HCatalog Connector. This means that the query usually takes longer than querying other system tables.

  • Querying this table is faster than querying HCATALOG_TABLES. Querying HCATALOG_TABLE_LIST only makes one HiveServer2 call per HCatalog schema versus one call per table for HCATALOG_TABLES.

Examples

The following example demonstrates defining a new HCatalog schema then querying HCATALOG_TABLE_LIST. Note that one table defined in a different HCatalog schema also appears. HCATALOG_TABLE_LIST lists all of the tables available in any of the HCatalog schemas:

=> CREATE HCATALOG SCHEMA hcat WITH hostname='hcathost'
-> HCATALOG_SCHEMA='default' HCATALOG_DB='default' HCATALOG_USER='hcatuser';
CREATE SCHEMA
=> \x
Expanded display is on.
=> SELECT * FROM v_catalog.hcatalog_table_list;
-[ RECORD 1 ]------+------------------
table_schema_id    | 45035996273748980
table_schema       | hcat
hcatalog_schema    | default
table_name         | weblogs
hcatalog_user_name | hcatuser
-[ RECORD 2 ]------+------------------
table_schema_id    | 45035996273748980
table_schema       | hcat
hcatalog_schema    | default
table_name         | tweets
hcatalog_user_name | hcatuser
-[ RECORD 3 ]------+------------------
table_schema_id    | 45035996273748980
table_schema       | hcat
hcatalog_schema    | default
table_name         | messages
hcatalog_user_name | hcatuser
-[ RECORD 4 ]------+------------------
table_schema_id    | 45035996273864948
table_schema       | hiveschema
hcatalog_schema    | default
table_name         | weblogs
hcatalog_user_name | hcatuser

See also

1.28 - HCATALOG_TABLES

Returns a detailed list of all tables made available through the HCatalog Connector.

Returns a detailed list of all tables made available through the HCatalog Connector. See Using the HCatalog Connector.

Column Name Data Type Description
TABLE_SCHEMA_ID INTEGER ID number of the schema
TABLE_SCHEMA VARCHAR(128) The name of the Vertica Analytic Database schema through which the table is available
HCATALOG_SCHEMA VARCHAR(128) The name of the Hive schema or database that contains the table
TABLE_NAME VARCHAR(128) The name of the table
HCATALOG_USER_NAME VARCHAR(128) The name of the HCatalog user whose credentials are used to access the table's data
MIN_FILE_SIZE_BYTES INTEGER The file size of the table's smallest data file, if using WebHCat; null if using HiveServer2
TOTAL_NUMBER_FILES INTEGER The number of files used to store this table's data in HDFS
LOCATION VARCHAR(8192) The URI for the directory containing this table's data, normally an HDFS URI
LAST_UPDATE_TIME TIMESTAMPTZ The last time data in this table was updated, if using WebHCat; null if using HiveServer2
OUTPUT_FORMAT VARCHAR(128) The Hive SerDe class used to output data from this table
LAST_ACCESS_TIME TIMESTAMPTZ The last time data in this table was accessed, if using WebHCat; null if using HiveServer2
MAX_FILE_SIZE_BYTES INTEGER The size of the largest data file for this table, if using WebHCat; null if using HiveServer2
IS_PARTITIONED BOOLEAN Whether this table is partitioned
PARTITION_EXPRESSION VARCHAR(128) The expression used to partition this table
TABLE_OWNER VARCHAR(128) The Hive user that owns this table in the Hive database, if using WebHCat; null if using HiveServer2
INPUT_FORMAT VARCHAR(128) The SerDe class used to read the data from this table
TOTAL_FILE_SIZE_BYTES INTEGER Total number of bytes used by all of this table's data files
HCATALOG_GROUP VARCHAR(128) The permission group assigned to this table, if using WebHCat; null if using HiveServer2
PERMISSION VARCHAR(128) The Unix file permissions for this group, as shown by the ls -l command, if using WebHCat; null if using HiveServer2

Privileges

No explicit permissions are required; however, users see only the records that correspond to schemas they have permissions to access.

See also

1.29 - ICEBERG_COLUMNS

Provides column information for Iceberg external tables.

Provides column information for Iceberg external tables. The information in this table is drawn from the Iceberg metadata files at query time.

Column Name Data Type Description
TABLE_ID INTEGER Catalog-assigned numeric value that uniquely identifies the table.
TABLE_SCHEMA VARCHAR

Name of the table's schema.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_NAME VARCHAR Name of the table containing the column.
COLUMN_ID VARCHAR Catalog-assigned VARCHAR value that uniquely identifies a table column.
COLUMN_NAME VARCHAR Name of the column.
DATA_TYPE VARCHAR Column data type.
DATA_TYPE_ID INTEGER Catalog-assigned unique numeric ID of the data type.
DATA_TYPE_LENGTH INTEGER Maximum allowable length of the data type.
CHARACTER_MAXIMUM_LENGTH VARCHAR Maximum allowable length of a VARCHAR column.
NUMERIC_PRECISION INTEGER Number of significant decimal digits for a NUMERIC column.
NUMERIC_SCALE INTEGER Number of fractional digits for a NUMERIC column.
DATETIME_PRECISION INTEGER Declared precision for a TIMESTAMP column, or NULL if no precision was declared.
INTERVAL_PRECISION INTEGER Number of fractional digits retained in the seconds field of an INTERVAL column.
IS_NULLABLE BOOLEAN Whether the column can contain NULL values.
WRITE_DEFAULT VARCHAR Field value for any records written after the field was added to the schema, if the writer does not supply the field’s value.
INITIAL_DEFAULT VARCHAR Field value for all records that were written before the field was added to the schema.

1.30 - INHERITED_PRIVILEGES

Provides summary information about privileges inherited by objects from GRANT statements on parent schemas, excluding inherited grant options.

Provides summary information about privileges inherited by objects from GRANT statements on parent schemas, excluding inherited grant options.

For information about explicitly granted permissions, see system table GRANTS.

Column Name Data Type Description
OBJECT_ID INTEGER Catalog-assigned integer value that uniquely identifies theobject inheriting the privileges.
SCHEMA_ID INTEGER Catalog-assigned integer value that uniquely identifies theparent schema.
OBJECT_NAMESPACE VARCHAR For Eon Mode databases, namespace of the table or view.
OBJECT_SCHEMA VARCHAR

Name of the parent schema of a table or view.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

OBJECT_NAME VARCHAR Name of the table or view.
OBJECT_TYPE VARCHAR

The object type, one of the following:

  • Table

  • View

  • Model

PRIVILEGES_DESCRIPTION VARCHAR Lists the privileges inherited on an object. An asterisk (*) appended to a privilege indicates that the user can grant the privilege to other users by granting the privilege on the parent schema.
PRINCIPAL VARCHAR Name of the role or user inheriting the privileges in the row.
PRINCIPAL_ID INTEGER Catalog-assigned integer value that uniquely identifies theuser inheriting the privileges.
GRANTOR VARCHAR User that granted the privileges on the parent schema to the principal.
GRANTOR_ID INTEGER Catalog-assigned integer value that uniquely identifies theuser who performed the grant operation.
GRANT_ID INTEGER Catalog-assigned integer value that uniquely identifies thegrant operation.

Examples

The following query returns the privileges that the tables and views inherit from their parent schema, customers.

=> SELECT object_schema,object_name,object_type,privileges_description,principal,grantor FROM inherited_privileges WHERE object_schema='customers';
 object_schema |  object_name    | object_type |                          privileges_description                           | principal | grantor
 --------------+-----------------+-------------+---------------------------------------------------------------------------+-----------+---------
 customers     | cust_info       | Table       | INSERT, SELECT, UPDATE, DELETE, ALTER, REFERENCES, DROP, TRUNCATE         | dbadmin   | dbadmin
 customers     | shipping_info   | Table       | INSERT, SELECT, UPDATE, DELETE, ALTER, REFERENCES, DROP, TRUNCATE         | dbadmin   | dbadmin
 customers     | cust_set        | View        | SELECT, ALTER, DROP                                                       | dbadmin   | dbadmin
 customers     | cust_info       | Table       | SELECT                                                                    | Val       | dbadmin
 customers     | shipping_info   | Table       | SELECT                                                                    | Val       | dbadmin
 customers     | cust_set        | View        | SELECT                                                                    | Val       | dbadmin
 customers     | sales_model     | Model       | USAGE, ALTER, DROP                                                        | Pooja     | dbadmin
 customers     | shipping_info   | Table       | INSERT                                                                    | Pooja     | dbadmin
 (8 rows)

See also

1.31 - INHERITING_OBJECTS

Provides information about the objects (table, view, or model) that inherit privileges from their parent schemas.

Provides information about the objects (table, view, or model) that inherit privileges from their parent schemas.

For information about the particular privileges inherited from schemas and their associated GRANT statements, see the INHERITED_PRIVILEGES table.

Column Name Data Type Description
OBJECT_ID INTEGER Catalog-assigned integer value that uniquely identifies theobject inheriting the privileges.
SCHEMA_ID INTEGER Catalog-assigned integer value that uniquely identifies theparent schema.
OBJECT_SCHEMA VARCHAR Name of the parent schema.
OBJECT_NAME VARCHAR Name of the object.
OBJECT_TYPE VARCHAR

The object type, one of the following:

  • Table

  • View

  • Model

Examples

The following query returns the tables and views that inherit their privileges from their parent schema, customers.

=> SELECT * FROM inheriting_objects WHERE object_schema='customers';
     object_id     |     schema_id     | object_schema |  object_name      | object_type
 ------------------+-------------------+---------------+-------------------+-------------
 45035996273980908 | 45035996273980902 | customers     | cust_info         | table
 45035996273980984 | 45035996273980902 | customers     | shipping_info     | table
 45035996273980980 | 45035996273980902 | customers     | cust_set          | view
 45035996273980983 | 45035996273980901 | ml_models     | clustering_model  | model
 (3 rows)

See also

1.32 - KEYWORDS

Identifies Vertica reserved and non-reserved keywords.

Identifies Vertica reserved and non-reserved keywords.

Column Name Data Type Description
KEYWORD VARCHAR Vertica-reserved or non-reserved keyword.
RESERVED VARCHAR

Indicates whether a keyword is reserved or non-reserved:

  • R: reserved

  • N: non-reserved

Examples

The following query gets all reserved keywords that begin with B:

=> SELECT * FROM keywords WHERE reserved = 'R' AND keyword ilike 'B%';
 keyword | reserved
---------+----------
 BETWEEN | R
 BIGINT  | R
 BINARY  | R
 BIT     | R
 BOOLEAN | R
 BOTH    | R
(6 rows)

See also

Keywords

1.33 - LARGE_CLUSTER_CONFIGURATION_STATUS

Shows the current cluster nodes and control node (spread hosts) designations in the Catalog so you can see if they match.

Shows the current cluster nodes and control node (spread hosts) designations in the Catalog so you can see if they match.

Column Name Data Type Description
NODE_NAME VARCHAR The name of the node in the cluster.
SPREAD_HOST_NAME VARCHAR The host name of the control node (the host that manages control message responsibilities)
CONTROL_NODE_NAME VARCHAR The name of the control node

See also

Large Cluster

1.34 - LICENSE_AUDITS

Lists the results of Vertica's license automatic compliance audits.

Lists the results of Vertica's license automatic compliance audits. See How Vertica Calculates Database Size.

Column Name Data Type Description
DATABASE_SIZE_BYTES INTEGER The estimated raw data size of the database
LICENSE_SIZE_BYTES INTEGER The licensed data allowance
USAGE_PERCENT FLOAT Percentage of the licensed allowance used
AUDIT_START_TIMESTAMP TIMESTAMPTZ When the audit started
AUDIT_END_TIMESTAMP TIMESTAMPTZ When the audit finished
CONFIDENCE_LEVEL_PERCENT FLOAT The confidence level of the size estimate
ERROR_TOLERANCE_PERCENT FLOAT The error tolerance used for the size estimate
USED_SAMPLING BOOLEAN Whether data was randomly sampled (if false, all of the data was analyzed)
CONFIDENCE_INTERVAL_LOWER_BOUND_BYTES INTEGER The lower bound of the data size estimate within the confidence level
CONFIDENCE_INTERVAL_UPPER_BOUND_BYTES INTEGER The upper bound of the data size estimate within the confidence level
SAMPLE_COUNT INTEGER The number of data samples used to generate the estimate
CELL_COUNT INTEGER The number of cells in the database
AUDITED_DATA VARCHAR The type of data audited, which includes regular (non-flex), flex, external, and total data

1.35 - LICENSES

For all licenses, provides information on license types, the dates for which licenses are valid, and the limits the licenses impose.

For all licenses, provides information on license types, the dates for which licenses are valid, and the limits the licenses impose.

Column Name Data Type Description
LICENSE_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the license.
NAME VARCHAR The license’s name. (The license name in this column could be represented by a long license key.)
LICENSEE VARCHAR The entity to which the product is licensed.
START_DATE VARCHAR The start date for which the license is valid.
END_DATE VARCHAR The end date until which the license is valid (or "Perpetual" if the license has no expiration).
LICENSETYPE VARCHAR The type of the license (for example, Premium Edition).
PARENT VARCHAR The parent license (field is blank if there is no parent).
SIZE VARCHAR The size limit for data on the license.
IS_SIZE_LIMIT_ENFORCED BOOLEAN Indicates whether the license includes enforcement of data and node limits, where t is true and f is false.
NODE_RESTRICTION VARCHAR The node limit the license imposes.
CONFIGURED_ID INTEGER A long license key.

1.36 - LOAD_BALANCE_GROUPS

Lists the objects contained by all load balance groups.

Lists the objects contained by all load balance groups. Each row in this table represents a single object that is a member of a load balance group. If a load balance group does not contain any objects, it appears once in this table with its type column set to 'Empty Group.'

Column Name Data Type Description
NAME VARCHAR The name of the load balance group
POLICY VARCHAR

The policy that sets how the group chooses the node for a connection. Contains one of the following:

  • ROUNDROBIN

  • RANDOM

  • NONE

FILTER VARCHAR The IP address range in CIDR format to select the members of a fault group that are included in the load balance group. This column only has a value if the TYPE column is 'Fault Group' or 'Subcluster.'
TYPE VARCHAR

The type of object contained in the load balance group. Contains one of:

  • Fault Group

  • Subcluster

  • Network Address Group

  • Empty Group

OBJECT_NAME VARCHAR The name of the fault group or network address included in the load balance group. This column is NULL if the group contains no objects.

Examples

=> SELECT * FROM LOAD_BALANCE_GROUPS;
     name      |   policy   |  filter   |         type          | object_name
---------------+------------+-----------+-----------------------+-------------
 group_1       | ROUNDROBIN |           | Network Address Group | node01
 group_1       | ROUNDROBIN |           | Network Address Group | node02
 group_2       | ROUNDROBIN |           | Empty Group           |
 group_all     | ROUNDROBIN |           | Network Address Group | node01
 group_all     | ROUNDROBIN |           | Network Address Group | node02
 group_all     | ROUNDROBIN |           | Network Address Group | node03
 group_fault_1 | RANDOM     | 0.0.0.0/0 | Fault Group           | fault_1
(7 rows)

See also

1.37 - LOG_PARAMS

Provides summary information about changes to configuration parameters related to authentication and security run in your database.

Provides summary information about changes to configuration parameters related to authentication and security run in your database.

Column Name Data Type Description
ISSUED_TIME VARCHAR The time at which the query was executed.
USER_NAME VARCHAR Name of the user who issued the query at the time Vertica recorded the session.
USER_ID INTEGER Numeric representation of the user who ran the query.
HOSTNAME VARCHAR The hostname, IP address, or URL of the database server.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
AUDIT_TYPE VARCHAR The type of operation for the audit, in this case, Parameter.
AUDIT_TAG_NAME VARCHAR The tag for the specific parameter.
REQUEST_TYPE VARCHAR The type of query request.
REQUEST_ID INTEGER Unique identifier of the query request in the user session.
SUBJECT VARCHAR The new value of the parameter.
REQUEST VARCHAR Lists the query request.
SUCCESS VARCHAR Indicates whether or not the operation was successful.
CATEGORY VARCHAR The audit parent category, such as Authentication.

Examples

The following example queries the LOG_PARAMS system table and shows only the most recent configuration parameter for this user under the Authentication category:

=> SELECT * FROM log_params limit 1;

--------------------------------------------------------------------------------------------------------

issued_time   | 2018-02-12 13:41:20.837452-05
user_name     | dbadmin
user_id       | 45035996273704962
hostname      | ::1:50690
session_id    | v_vmart_node0001-341751:0x13878
audit_type    | Param
audit_tag_name| SecurityAlgorithm
request_type  | UTILITY
request_id    | 8
subject       | MD5
request       | select set_config_parameter('SecurityAlgorithm','MD5',null);
success       | t
category      | Authentication
(1 row)

1.38 - LOG_QUERIES

Provides summary information about some queries related to authentication and security run in your database.

Provides summary information about some queries related to authentication and security run in your database.

Column Name Data Type Description
ISSUED_TIME VARCHAR The time at which the query was executed.
USER_NAME VARCHAR Name of the user who issued the query at the time Vertica recorded the session.
USER_ID INTEGER Numeric representation of the user who ran the query.
HOSTNAME VARCHAR The hostname, IP address, or URL of the database server.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
AUDIT_TYPE VARCHAR The type of operation for the audit, in this case, Query.
AUDIT_TAG_NAME VARCHAR The tag for the specific query.
REQUEST_TYPE VARCHAR

The type of query request. Examples include, but are not limited to:

  • QUERY

  • DDL

  • LOAD

  • UTILITY

  • TRANSACTION

  • PREPARE

  • EXECUTE

  • SET

  • SHOW

REQUEST_ID INTEGER The ID of the query request.
SUBJECT VARCHAR The subject of the query.
REQUEST VARCHAR Lists the query request.
SUCCESS VARCHAR Indicates whether or not the operation was successful.
CATEGORY VARCHAR The audit parent category, such as Managing_Users_Privileges.

Examples

The following example queries the LOG_QUERIES system table and shows only the most recent query for this user under the Managing_Users_Privileges category:

=> SELECT * FROM log_queries limit 1;
---------------------------------------------------------------------------

issued_time   | 2018-01-22 10:36:55.634349-05
user_name     | dbadmin
user_id       | 45035996273704962
hostname      |
session_id    | v_vmart_node0001-237210:0x37e1d
audit_type    | Query
audit_tag_name| REVOKE ROLE
request_type  | DDL
request_id    | 2
subject       |
request       | revoke all privileges from Joe;
success       | f
category      | Managing_Users_Privileges
(1 row)

1.39 - LOG_TABLES

Provides summary information about queries on system tables.

Provides summary information about queries on system tables.

Column Name Data Type Description
ISSUED_TIME VARCHAR Time of query execution.
USER_NAME VARCHAR Name of user who issued the query at the time Vertica recorded the session.
USER_ID INTEGER Numeric representation of the user who ran the query.
HOSTNAME VARCHAR The hostname, IP address, or URL of the database server.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
AUDIT_TYPE VARCHAR The type of operation for the audit, in this case, Table.
AUDIT_TAG_NAME VARCHAR The tag for the specific table.
REQUEST_TYPE VARCHAR The type of query request. In this case, QUERY.
REQUEST_ID INTEGER Unique identifier of the query request in the user session.
SUBJECT VARCHAR The name of the table that was queried.
REQUEST VARCHAR Lists the query request.
SUCCESS VARCHAR Indicates whether or not the operation was successful.
CATEGORY VARCHAR The audit parent category—for example, Views, Security, and Managing_Users_Privileges.

Examples

The following example shows recent queries on configuration parameters:

dbadmin=> SELECT issued_time, audit_type, request_type, subject, request, category FROM log_tables
   WHERE category ilike '%Managing_Config_Parameters%' ORDER BY issued_time DESC LIMIT 4;
-[ RECORD 1 ]+-------------------------------------------------------------------------------------
issued_time  | 2020-05-14 14:14:53.453552-04
audit_type   | Table
request_type | QUERY
subject      | vs_nodes
request      | SELECT * from vs_nodes order by name  limit 1;
category     | Managing_Config_Parameters
-[ RECORD 2 ]+-------------------------------------------------------------------------------------
issued_time  | 2020-05-14 14:14:27.546474-04
audit_type   | Table
request_type | QUERY
subject      | vs_nodes
request      | SELECT * from vs_nodes order by name ;
category     | Managing_Config_Parameters
-[ RECORD 3 ]+-------------------------------------------------------------------------------------
issued_time  | 2020-05-14 08:54:32.86881-04
audit_type   | Table
request_type | QUERY
subject      | vs_parameters_mismatch
request      | select * from configuration_parameters where parameter_name = 'MaxDepotSizePercent';
category     | Managing_Config_Parameters
-[ RECORD 4 ]+-------------------------------------------------------------------------------------
issued_time  | 2020-05-14 08:54:32.86881-04
audit_type   | Table
request_type | QUERY
subject      | vs_nodes
request      | select * from configuration_parameters where parameter_name = 'MaxDepotSizePercent';
category     | Managing_Config_Parameters

1.40 - MATERIALIZE_FLEXTABLE_COLUMNS_RESULTS

Contains the results of running the MATERIALIZE_FLEXTABLE_COLUMNS function.

Contains the results of running the MATERIALIZE_FLEXTABLE_COLUMNS function. The table contains information about keys that the function evaluated. It does not contain information about all keys.

Column Name Data Type Description
TABLE_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the table.
TABLE_SCHEMA VARCHAR The schema name for which information is listed.
TABLE_NAME VARCHAR The table name for which information is listed.
CREATION_TIME VARCHAR Timestamp when the key was materialized.
KEY_NAME VARCHAR Name of the key from the VMap column that was materialized.
STATUS VARCHAR

Status of the materialized column, one of the following:

  • ADDED

  • EXISTS

  • ERROR

MESSAGE BOOLEAN

Message associated with the status in the previous column, one of the following:

  • Added successfully

  • Column of same name already exists in table definition

  • Add operation failed

  • No data type guess provided to add column

Examples

=> \x
Expanded display is on.
=> SELECT table_id, table_schema, table_name, key_name, status, message FROM MATERIALIZE_FLEXTABLE_COLUMNS_RESULTS
WHERE table_name = 'mountains_hybrid';
-[ RECORD 1 ]+-------------------------------------------------------
table_id     | 45035996273708192
table_schema | public
table_name   | mountains_hybrid
key_name     | type
status       | ADDED
message      | Added successfully
-[ RECORD 2 ]+-------------------------------------------------------
table_id     | 45035996273708192
table_schema | public
table_name   | mountains_hybrid
key_name     | height
status       | ADDED
message      | Added successfully
-[ RECORD 3 ]+-------------------------------------------------------
table_id     | 45035996273708192
table_schema | public
table_name   | mountains_hybrid
key_name     | name
status       | EXISTS
message      | Column of same name already exists in table definition

1.41 - MODELS

Lists details about the machine-learning models in the database.

Lists details about the machine-learning models in the database.

Column Name Data Type Description
MODEL_ID INTEGER The model's internal ID.
MODEL_NAME VARCHAR(128) The name of the model.
SCHEMA_ID INTEGER The schema's internal ID.
SCHEMA_NAME VARCHAR(128) The name of the schema.
OWNER_ID INTEGER The model owner's ID.
OWNER_NAME VARCHAR(128) The user who created the model.
CATEGORY VARCHAR(128) The type of model. By default, models created in Vertica are assigned to the Vertica_Models category.
MODEL_TYPE VARCHAR(128) The type of algorithm used to create the model.
IS_COMPLETE VARCHAR(128) Denotes whether the model is complete and ready for use in machine learning functions. This field is usually false when the model is being trained. Once the training is complete, the field is set to true.
CREATE_TIME TIMESTAMPTZ The time the model was created.
SIZE INTEGER The size of the model in bytes.
IS_INHERIT_PRIVILEGES BOOLEAN Whether the model inherits the privileges of its parent schema.

Examples

=> SELECT * FROM models;
-[ RECORD 1 ]---------+------------------------------
model_id              | 45035996273850350
model_name            | xgb_iris
schema_id             | 45035996273704984
schema_name           | public
owner_id              | 45035996273704962
owner_name            | dbadmin
category              | VERTICA_MODELS
model_type            | XGB_CLASSIFIER
is_complete           | t
create_time           | 2022-11-29 13:38:59.259531-05
size                  | 11018
is_inherit_privileges | f
-[ RECORD 2 ]---------+------------------------------
model_id              | 45035996273866816
model_name            | arima_weather
schema_id             | 45035996273704984
schema_name           | public
owner_id              | 45035996273704962
owner_name            | dbadmin
category              | VERTICA_MODELS
model_type            | ARIMA
is_complete           | t
create_time           | 2023-03-31 13:13:06.342661-05
size                  | 2770
is_inherit_privileges | f

1.42 - NAMESPACES

Lists details about the namespaces in an Eon Mode database.

Lists details about the namespaces in an Eon Mode database.

Column Name Data Type Description
NAMESPACE_OID INTEGER Catalog-assigned numeric value that uniquely identifies the namesapce.
NAMESPACE_NAME VARCHAR Name of the namespace
IS_DEFAULT BOOLEAN Whether the namespace is the default namespace of the database.
DEFAULT_SHARD_COUNT VARCHAR Shard count of the namespace.

Example

List the details of all namespaces in your database:

=> SELECT * FROM NAMESPACES;
   namespace_oid   |  namespace_name   | is_default | default_shard_count
-------------------+-------------------+------------+---------------------
 45035996273704988 | default_namespace | t          |                   9
 32582959204859183 | analytics         | f          |                  12
(2 rows)

1.43 - NETWORK_ADDRESSES

Lists information about the network addresses defined in your database using the CREATE NETWORK ADDRESS statement.

Lists information about the network addresses defined in your database using the CREATE NETWORK ADDRESS statement.

Column Name Data Type Description
NAME VARCHAR The name of the network address.
NODE VARCHAR The name of the node that owns the network address.
ADDRESS VARCHAR The network address's IP address. This address can be either in IPv4 or IPv6 format.
PORT INT The network address's port number.
ADDRESS_FAMILY VARCHAR The format of the network address's IP address. This values is either 'ipv4' or 'ipv6'.
IS_ENABLED BOOLEAN Whether the network address is enabled. You can disable network addresses to prevent their use. If the address is disabled, the value in this column is False.
IS_AUTO_DETECTED BOOLEAN Whether Vertica created the network address automatically.

Examples

=> \x
Expanded display is on.

=> SELECT * FROM v_catalog.network_addresses;
-[ RECORD 1 ]----+-----------------
name             | node01
node             | v_vmart_node0001
address          | 10.20.100.247
port             | 5433
address_family   | ipv4
is_enabled       | t
is_auto_detected | f
-[ RECORD 2 ]----+-----------------
name             | node02
node             | v_vmart_node0002
address          | 10.20.100.248
port             | 5433
address_family   | ipv4
is_enabled       | t
is_auto_detected | f
-[ RECORD 3 ]----+-----------------
name             | node03
node             | v_vmart_node0003
address          | 10.20.100.249
port             | 5433
address_family   | ipv4
is_enabled       | t
is_auto_detected | f

See also

1.44 - NODE_SUBSCRIPTION_CHANGE_PHASES

In an Eon Mode database, stores information about changes to node's shard subscriptions.

In an Eon Mode database, stores information about changes to node's shard subscriptions.

Column Name Data Type Description
node_name VARCHAR Name of the node
subscription_change_type VARCHAR The change being made to the subscription
session_id INTEGER ID of the session in which the change was initiated
transaction_id INTEGER ID of the transaction in which the change was initiated
user_id INTEGER ID of user that initiated the change
user_name VARCHAR Name of user that initiated the change
subscription_oid INTEGER Session object ID
subscriber_node_oid INTEGER Object ID of node that requested the subscription
subscriber_node_name VARCHAR Name of the node that requested the subscription
shard_oid INTEGER Object ID of the shard to which the node is subscribed
shard_name VARCHAR Name of the shard to which the node is subscribed
min_time TIMESTAMPTZ Start time of the subscription change
max_time TIMESTAMPTZ Completion time of the subscription change
source_node_oid INTEGER Object ID of the node from which catalog objects were fetched
source_node_name VARCHAR Name of the node from which catalog objects were fetched
num_objs_affected INTEGER Number of catalog objects affected by the subscription change
action VARCHAR Description of the action taken
new_content_size INTEGER Total size of the catalog objects that were fetched for the subscription change
phase_limit_reached BOOLEAN Reached maximum number of retries?
START_TIME TIMESTAMPTZ When the subscription change started
END_TIME TIMESTAMPTZ When the subscription change was finished
retried BOOLEAN Retry of subscription phase?
phase_result VARCHAR

Outcome of the subscription change, one of the following:

  • Success

  • Failure

Examples

=> SELECT NODE_NAME, SUBSCRIPTION_CHANGE_TYPE, SHARD_NAME,
   ACTION  FROM node_subscription_change_phases
   ORDER BY start_time ASC LIMIT 10;

      NODE_NAME       | SUBSCRIPTION_CHANGE_TYPE | SHARD_NAME  |         ACTION
----------------------+--------------------------+-------------+------------------------
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0007 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0010 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0004 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0005 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | replica     | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0005 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0006 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0008 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0011 | COLLECT SHARD METADATA
 v_verticadb_node0001 | CREATE SUBSCRIPTION      | segment0002 | COLLECT SHARD METADATA

1.45 - NODE_SUBSCRIPTIONS

Lists information about database node subscriptions to shards.

Eon Mode only

Lists information about database node subscriptions to shards.

Column Name Data Type Description
SUBSCRIPTION_OID INTEGER Subscription OID
NODE_OID INTEGER Subscribed node OID
NODE_NAME VARCHAR Name of the node
SHARD_OID INTEGER OID of the shard to which the node is subscribed
SHARD_NAME VARCHAR Name of the shard to which the node is subscribed
SUBSCRIPTION_STATE VARCHAR Node's current subscription state
FROM _VERSION INTEGER Deprecated
IS_PRIMARY BOOLEAN Specifies whether the node is currently the primary subscriber.
IS_RESUBSCRIBING BOOLEAN

Indicates whether a subscription is resubscribing to a node:

  • t (true): A subscription is resubscribing, only applies to PENDING subscriptions created during the cluster or node startup.

  • f (false): A subscription is not resubscribing, applies to PENDING subscriptions created with REBALANCE_SHARDS that transitioned to an ACTIVE state.

CREATOR_TID INTEGER ID of transaction that created this subscription
SUBSCRIBED_TO_METADATA_AT INTEGER Deprecated
IS_PARTICIPATING_PRIMARY BOOLEAN Whether this node is the participating primary subscriber for the shard. If true, the node listed in NODE_NAME is the only one that reads from and writes to communal storage for this shard in the subcluster. Other nodes in the subcluster that subscribe to the same shard receive data from this node via peer-to-peer transfers.

Examples

The following example queries the NODE_SUBSCRIPTIONS table in a database with two three-node subclusters (a primary and a secondary) in a 12-shard database.

=> SELECT node_name, shard_name, subscription_state, is_primary,
          is_participating_primary AS is_p_primary
       FROM NODE_SUBSCRIPTIONS ORDER BY node_name, shard_name;

      node_name       | shard_name  | subscription_state | is_primary | is_p_primary
----------------------+-------------+--------------------+------------+--------------
 v_verticadb_node0001 | replica     | ACTIVE             | t          | t
 v_verticadb_node0001 | segment0001 | ACTIVE             | t          | t
 v_verticadb_node0001 | segment0003 | ACTIVE             | f          | f
 v_verticadb_node0001 | segment0004 | ACTIVE             | t          | t
 v_verticadb_node0001 | segment0006 | ACTIVE             | f          | f
 v_verticadb_node0001 | segment0007 | ACTIVE             | t          | t
 v_verticadb_node0001 | segment0009 | ACTIVE             | f          | f
 v_verticadb_node0001 | segment0010 | ACTIVE             | t          | t
 v_verticadb_node0001 | segment0012 | ACTIVE             | f          | f
 v_verticadb_node0002 | replica     | ACTIVE             | f          | t
 v_verticadb_node0002 | segment0001 | ACTIVE             | f          | f
 v_verticadb_node0002 | segment0002 | ACTIVE             | t          | t
 v_verticadb_node0002 | segment0004 | ACTIVE             | f          | f
 v_verticadb_node0002 | segment0005 | ACTIVE             | t          | t
 v_verticadb_node0002 | segment0007 | ACTIVE             | f          | f
 v_verticadb_node0002 | segment0008 | ACTIVE             | t          | t
 v_verticadb_node0002 | segment0010 | ACTIVE             | f          | f
 v_verticadb_node0002 | segment0011 | ACTIVE             | t          | t
 v_verticadb_node0003 | replica     | ACTIVE             | f          | t
 v_verticadb_node0003 | segment0002 | ACTIVE             | f          | f
 v_verticadb_node0003 | segment0003 | ACTIVE             | t          | t
 v_verticadb_node0003 | segment0005 | ACTIVE             | f          | f
 v_verticadb_node0003 | segment0006 | ACTIVE             | t          | t
 v_verticadb_node0003 | segment0008 | ACTIVE             | f          | f
 v_verticadb_node0003 | segment0009 | ACTIVE             | t          | t
 v_verticadb_node0003 | segment0011 | ACTIVE             | f          | f
 v_verticadb_node0003 | segment0012 | ACTIVE             | t          | t
 v_verticadb_node0004 | replica     | ACTIVE             | f          | t
 v_verticadb_node0004 | segment0001 | ACTIVE             | f          | t
 v_verticadb_node0004 | segment0003 | ACTIVE             | f          | f
 v_verticadb_node0004 | segment0004 | ACTIVE             | f          | t
 v_verticadb_node0004 | segment0006 | ACTIVE             | f          | f
 v_verticadb_node0004 | segment0007 | ACTIVE             | f          | t
 v_verticadb_node0004 | segment0009 | ACTIVE             | f          | f
 v_verticadb_node0004 | segment0010 | ACTIVE             | f          | t
 v_verticadb_node0004 | segment0012 | ACTIVE             | f          | f
 v_verticadb_node0005 | replica     | ACTIVE             | f          | t
 v_verticadb_node0005 | segment0001 | ACTIVE             | f          | f
 v_verticadb_node0005 | segment0002 | ACTIVE             | f          | t
 v_verticadb_node0005 | segment0004 | ACTIVE             | f          | f
 v_verticadb_node0005 | segment0005 | ACTIVE             | f          | t
 v_verticadb_node0005 | segment0007 | ACTIVE             | f          | f
 v_verticadb_node0005 | segment0008 | ACTIVE             | f          | t
 v_verticadb_node0005 | segment0010 | ACTIVE             | f          | f
 v_verticadb_node0005 | segment0011 | ACTIVE             | f          | t
 v_verticadb_node0006 | replica     | ACTIVE             | f          | t
 v_verticadb_node0006 | segment0002 | ACTIVE             | f          | f
 v_verticadb_node0006 | segment0003 | ACTIVE             | f          | t
 v_verticadb_node0006 | segment0005 | ACTIVE             | f          | f
 v_verticadb_node0006 | segment0006 | ACTIVE             | f          | t
 v_verticadb_node0006 | segment0008 | ACTIVE             | f          | f
 v_verticadb_node0006 | segment0009 | ACTIVE             | f          | t
 v_verticadb_node0006 | segment0011 | ACTIVE             | f          | f
 v_verticadb_node0006 | segment0012 | ACTIVE             | f          | t
(54 rows)

1.46 - NODES

Lists details about the nodes in the database.

Lists details about the nodes in the database.

Column Name Data Type Description
NODE_NAME VARCHAR(128) The name of the node.
NODE_ID INTEGER Catalog-assigned integer value that uniquely identifies the node.
NODE_STATE VARCHAR(128)

The node's current state, one of the following:

  • UP

  • DOWN

  • READY

  • UNSAFE

  • SHUTDOWN

  • SHUTDOWN_ERROR

  • RECOVERING

  • RECOVER_ERROR

  • RECOVERED

  • INITIALIZING

  • STANDBY

  • NEEDS_CATCHUP

IS_PRIMARY BOOLEAN Whether the node is a primary or secondary node. Primary nodes are the only ones Vertica considers when determining the K-Safety of an Eon Mode database. The node inherits this property from the subcluster that contains it.
IS_READONLY BOOLEAN Whether the node is in read-only mode or not. This column is TRUE if the Eon Mode database is read-only due to the loss of quorum or primary shard coverage. See Database Read-Only Mode.
NODE_ADDRESS VARCHAR(80) The host address of the node.
NODE_ADDRESS_FAMILY VARCHAR(10) The IP Version of the node_address. For example, ipv4.
EXPORT_ADDRESS VARCHAR(8192) The IP address of the node (on the public network) used for import/export operations and native load-balancing.
EXPORT_ADDRESS_FAMILY VARCHAR(10) The IP Version of the export_address. For example, ipv4.
CATALOG_PATH VARCHAR(8192) The absolute path to the catalog on the node.
NODE_TYPE VARCHAR(9) The type of the node. For more information on the types of nodes, refer to Setting node type.
IS_EPHEMERAL BOOLEAN (Deprecated) True if this node has been marked as ephemeral. (in preparation for removing it from the cluster).
STANDING_IN_FOR VARCHAR(128) The name of the node that this node is currently replacing.
SUBCLUSTER_NAME VARCHAR(128) In an Eon Mode database, the name of the subcluster that contains the node. Nodes belong to exactly one subcluster.
SANDBOX VARCHAR(128) In an Eon Mode database, the name, if any, of the sandbox to which the node belongs. NULL if the node is not a member of an active sandbox.
LAST_MSG_FROM_NODE_AT TIMESTAMPTZ The date and time the last message was received from this node.
NODE_DOWN_SINCE TIMESTAMPTZ The amount of time that the replaced node has been unavailable.
BUILD_INFO VARCHAR(128) The version of the Vertica server binary the node is running.

Example

=> SELECT NODE_NAME, NODE_STATE, IS_PRIMARY, IS_READONLY, NODE_TYPE,
          SUBCLUSTER_NAME FROM NODES ORDER BY NODE_NAME ASC;
      NODE_NAME       | NODE_STATE | IS_PRIMARY | IS_READONLY | NODE_TYPE |  SUBCLUSTER_NAME
----------------------+------------+------------+-------------+-----------+--------------------
 v_verticadb_node0001 | UP         | t          | f           | PERMANENT | default_subcluster
 v_verticadb_node0002 | UP         | t          | f           | PERMANENT | default_subcluster
 v_verticadb_node0003 | UP         | t          | f           | PERMANENT | default_subcluster
 v_verticadb_node0004 | UP         | f          | f           | PERMANENT | analytics
 v_verticadb_node0005 | UP         | f          | f           | PERMANENT | analytics
 v_verticadb_node0006 | UP         | f          | f           | PERMANENT | analytics
(6 rows)

1.47 - ODBC_COLUMNS

Provides table column information.

Provides table column information. The format is defined by the ODBC standard for the ODBC SQLColumns metadata. Details on the ODBC SQLColumns format are available in the ODBC specification: http://msdn.microsoft.com/en-us/library/windows/desktop/ms711683%28v=vs.85%29.aspx.

Column Name Data Type Description
SCHEMA_NAME VARCHAR Name of the schema in which the column resides. If the column does not reside in a schema, this field is empty.
TABLE_NAME VARCHAR Name of the table in which the column resides.
COLUMN_NAME VARCHAR Name of the column.
DATA_TYPE INTEGER Data type of the column. This can be an ODBC SQL data type or a driver-specific SQL data type. This column corresponds to the ODBC_TYPE column in the TYPES table.
DATA_TYPE_NAME VARCHAR Driver-specific data type name.
COLUMN_SIZE INTEGER ODBC-defined data size of the column.
BUFFER_LENGTH INTEGER Transfer octet length of a column is the maximum number of bytes returned to the application when data is transferred to its default C data type. See http://msdn.microsoft.com/en-us/library/windows/desktop/ms713979%28v=vs.85%29.aspx
DECIMAL_DIGITS INTEGER Total number of significant digits to the right of the decimal point. This value has no meaning for non-decimal data types.
NUM_PREC_RADIX INTEGER Radix Vertica reports decimal_digits and columns_size as. This value is always 10, because it refers to a number of decimal digits, rather than a number of bits.
NULLABLE BOOLEAN Whether the column can contain null values.
REMARKS VARCHAR Textual remarks for the column.
COLUMN_DEFAULT VARCHAR Default value of the column.
SQL_TYPE_ID INTEGER SQL data type of the column.
SQL_DATETIME_SUB VARCHAR Subtype for a datetime data type. This value has no meaning for non-datetime data types.
CHAR_OCTET_LENGTH INTEGER Maximum length of a string or binary data column.
ORDINAL_POSITION INTEGER Position of the column in the table definition.
IS_NULLABLE VARCHAR Values can be YES or NO, determined by the value of the NULLABLE column.
IS_IDENTITY BOOLEAN Whether the column is an IDENTITY column.

1.48 - PASSWORD_AUDITOR

Stores information about user accounts, account expirations, and password hashing algorithms.

Stores information about user accounts, account expirations, and password hashing algorithms.

Column Name Data Type Description
USER_ID INTEGER Unique ID for the user.
USER_NAME VARCHAR Name of the user.
ACCTEXPIRED BOOLEAN Indicates if the user's password expires. 'f' indicates that it does not expire. 't' indicates that it does expire.
SECURITY_ALGORITHM VARCHAR

User-level security algorithm for hash authentication.

Valid values:

  • 'NONE' (Default. Algorithm specified by SYSTEM_SECURITY_ALGORITHM is used.)

  • 'SHA512'

  • 'MD5'

SYSTEM_SECURITY_ALGORITHM VARCHAR

System-level security algorithm for hash authentication.

Valid values:

  • 'SHA512' (Default)

  • 'MD5'

EFFECTIVE_SECURITY_ALGORITHM VARCHAR

The resulting security algorithm, depending on the values of SECURTY_ALGORITHM and SYSTEM_SECURITY_ALGORITHM.

For details, see Password hashing algorithm.

CURRENT_SECURITY_ALGORITHM VARCHAR

The security algorithm used to hash the user's current password. This can differ from the EFFECTIVE_SECURITY_ALGORITHM if a user hasn't reset their password since a change in the EFFECTIVE_SECURITY_ALGORITHM.

Valid values:

  • 'NONE' (Default. Algorithm specified by SYSTEM_SECURITY_ALGORITHM is used.)

  • 'SHA512'

  • 'MD5'

1.49 - PASSWORDS

Contains information on current user passwords.

Contains information on current user passwords. This table also includes information on past passwords if any Profiles have PASSWORD_REUSE_TIME or PASSWORD_REUSE_MAX parameters set. See CREATE PROFILE for details.

Column Name Data Type Description
USER_ID INTEGER The ID of the user who owns the password.
USER_NAME VARCHAR The name of the user who owns the password.
PASSWORD VARCHAR The hashed password.
PASSWORD_CREATE_TIME DATETIME The date and time when the password was created.
IS_CURRENT_PASSWORD BOOLEAN Denotes whether this is the user's current password. Non-current passwords are retained to enforce password reuse limitations.
PROFILE_ID INTEGER The ID number of the profile to which the user is assigned.
PROFILE_NAME VARCHAR The name of the profile to which the user is assigned.
PASSWORD_REUSE_MAX VARCHAR The number password changes that must take place before an old password can be reused.
PASSWORD_REUSE_TIME VARCHAR The amount of time that must pass before an old password can be reused.
SALT VARCHAR A hex string used to hash the password.

Examples

The following query returns the SHA-512 hashed password and salt of user 'u1'.

=> SELECT user_name, password, salt FROM passwords WHERE user_name='u1';
 user_name |                         password                       |               salt
-----------+--------------------------------------------------------+----------------------------------
 u1        | sha512f3f802f1c56e2530cd9c3164cc7b8002ba444c0834160f10 | f05e9d859fb441f9f612f8a787bfc872
(1 row)

1.50 - PRIMARY_KEYS

Provides primary key information.

Provides primary key information.

Column Name Data Type Description
CONSTRAINT_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the constraint.
CONSTRAINT_NAME VARCHAR The constraint name for which information is listed.
COLUMN_NAME VARCHAR The column name for which information is listed.
ORDINAL_POSITION VARCHAR The position of the column within the key. The numbering of columns starts at 1.
TABLE_NAME VARCHAR The table name for which information is listed.
CONSTRAINT_TYPE VARCHAR The constraint type, p, for primary key.
IS_ENABLED` BOOLEAN Indicates if a table column constraint for a PRIMARY KEY is enabled by default. Can be t (True) or f (False).
TABLE_NAMESPACE_ID VARCHAR For Eon Mode databases, unique numeric identifier of the namespace that contains the table.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, name of the namespace that contains the table.
TABLE_SCHEMA VARCHAR

The schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

1.51 - PROFILE_PARAMETERS

Defines what information is stored in profiles.

Defines what information is stored in profiles.

Column Name Data Type Description
PROFILE_ID INTEGER The ID of the profile to which this parameter belongs.
PROFILE_NAME VARCHAR The name of the profile to which this parameter belongs.
PARAMETER_TYPE VARCHAR The policy type of this parameter (password_complexity, password_security, etc.)
PARAMETER_NAME VARCHAR The name of the parameter.
PARAMETER_LIMIT VARCHAR The parameter's value.

1.52 - PROFILES

Provides information about password policies that you set using the CREATE PROFILE statement.

Provides information about password policies that you set using the CREATE PROFILE statement.

Column Name Data Type Description
PROFILE_ID INTEGER Unique identifier for the profile.
PROFILE_NAME VARCHAR Profile name.
PASSWORD_LIFE_TIME VARCHAR Number of days before the user's password expires. After expiration, the user is forced to change passwords during login or warned that their password has expired if password_grace_time is set to a value other than zero or unlimited.
PASSWORD_MIN_LIFE_TIME VARCHAR The number of days a password must be set before it can be reset.
PASSWORD_MIN_CHAR_CHANGE VARCHAR The minimum number of characters that must be different from the previous password when performing a password reset.
PASSWORD_GRACE_TIME VARCHAR Number of days users are allowed to log in after their passwords expire. During the grace time, users are warned about their expired passwords when they log in. After the grace period, the user is forced to change passwords if he or she hasn't already.
PASSWORD_REUSE_MAX VARCHAR Number of password changes that must occur before the current password can be reused.
PASSWORD_REUSE_TIME VARCHAR Number of days that must pass after setting a password before it can be used again.
FAILED_LOGIN_ATTEMPTS VARCHAR Number of consecutive failed login attempts that triggers Vertica to lock the account.
PASSWORD_LOCK_TIME VARCHAR Number of days an account is locked after being locked due to too many failed login attempts.
PASSWORD_MAX_LENGTH VARCHAR Maximum number of characters allowed in a password.
PASSWORD_MIN_LENGTH VARCHAR Minimum number of characters required in a password.
PASSWORD_MIN_LETTERS VARCHAR The minimum number of letters (either uppercase or lowercase) required in a password.
PASSWORD_MIN_LOWERCASE_LETTERS VARCHAR The minimum number of lowercase.
PASSWORD_MIN_UPPERCASE_LETTERS VARCHAR The minimum number of uppercase letters required in a password.
PASSWORD_MIN_DIGITS VARCHAR The minimum number of digits required in a password.
PASSWORD_MIN_SYMBOLS VARCHAR The minimum of symbols (for example, !, #, $, etc.) required in a password.

Notes

Non-superusers querying this table see only the information for the profile to which they are assigned.

See also

1.53 - PROJECTION_CHECKPOINT_EPOCHS

Provides details on checkpoint epochs, applies only to Enterprise Mode.

Provides details on checkpoint epochs, applies only to Enterprise Mode.

Column Name Data Type Description
NODE_ID INTEGER Unique numeric identifier of this projection's node.
NODE_NAME VARCHAR Name of this projection's node.
PROJECTION_SCHEMA_ID INTEGER Unique numeric identifier of the projection schema.
PROJECTION_SCHEMA VARCHAR Name of the projection schema.
PROJECTION_ID INTEGER Unique numeric identifier of this projection.
PROJECTION_NAME VARCHAR Name of this projection.
IS_UP_TO_DATE BOOLEAN Specifies whether the projection is up to date and available to participate in query execution.
CHECKPOINT_EPOCH INTEGER Checkpoint epoch of the projection on the corresponding node. Data up to and including this epoch is in persistent storage, and can be recovered in the event of node failure.
WOULD_RECOVER BOOLEAN

Determines whether data up to and including CHECKPOINT_EPOCH can be used to recover from an unclean shutdown:

  • t: CHECKPOINT_EPOCH is less than the cluster's Last Good Epoch, so data up to and including this epoch can be used during recovery.

  • f: Vertica must use Last Good Epoch to recover data for this projection.

See also: GET_LAST_GOOD_EPOCH

IS_BEHIND_AHM BOOLEAN

Specifies whether CHECKPOINT_EPOCH is less than the AHM (ancient history mark). If set to t (true), data for this projection cannot rolled back.

See also: GET_AHM_EPOCH

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Examples

=> SELECT node_name, projection_schema, projection_name, is_up_to_date, checkpoint_epoch FROM projection_checkpoint_epochs
    WHERE projection_name ilike 't1_b%' ORDER BY projection_name, node_name;
    node_name     | projection_schema | projection_name | is_up_to_date | checkpoint_epoch
------------------+-------------------+-----------------+---------------+------------------
 v_vmart_node0001 | public            | t1_b1           | t             |              965
 v_vmart_node0002 | public            | t1_b1           | t             |              965
 v_vmart_node0003 | public            | t1_b1           | t             |              965
 v_vmart_node0001 | public            | t1_b0           | t             |              965
 v_vmart_node0002 | public            | t1_b0           | t             |              965
 v_vmart_node0003 | public            | t1_b0           | t             |              965
(6 rows)

dbadmin=> INSERT INTO t1 VALUES (100, 101, 102);
 OUTPUT
--------
      1
(1 row)

dbadmin=> COMMIT;
COMMIT
dbadmin=> SELECT node_name, projection_schema, projection_name, is_up_to_date, checkpoint_epoch FROM projection_checkpoint_epochs
           WHERE projection_name ILIKE 't1_b%' ORDER BY projection_name, node_name;
    node_name     | projection_schema | projection_name | is_up_to_date | checkpoint_epoch
------------------+-------------------+-----------------+---------------+------------------
 v_vmart_node0001 | public            | t1_b1           | t             |              966
 v_vmart_node0002 | public            | t1_b1           | t             |              966
 v_vmart_node0003 | public            | t1_b1           | t             |              966
 v_vmart_node0001 | public            | t1_b0           | t             |              966
 v_vmart_node0002 | public            | t1_b0           | t             |              966
 v_vmart_node0003 | public            | t1_b0           | t             |              966
(6 rows)

1.54 - PROJECTION_COLUMNS

Provides information about projection columns, such as encoding type, sort order, type of statistics, and the time at which columns statistics were last updated.

Provides information about projection columns, such as encoding type, sort order, type of statistics, and the time at which columns statistics were last updated.

Column Name Data Type Description
PROJECTION_ID INTEGER Catalog-assigned numeric value that uniquely identifies the projection.
PROJECTION_NAME VARCHAR The projection name for which information is listed.
PROJECTION_COLUMN_NAME VARCHAR The projection column name.
COLUMN_POSITION INTEGER The ordinal position of a projection's column used in the CREATE PROJECTION statement.
SORT_POSITION INTEGER The projection's column sort specification, as specified in CREATE PROJECTION .. ORDER BY clause. If the column is not included in the projection's sort order, SORT_POSITION output is NULL.
COLUMN_ID INTEGER A unique numeric object ID (OID) that identifies the associated projection column object and is assigned by the Vertica catalog. This field is helpful as a key to other system tables.
DATA_TYPE VARCHAR Matches the corresponding table column data type (see V_CATALOG.COLUMNS). DATA_TYPE is provided as a complement to ENCODING_TYPE.
ENCODING_TYPE VARCHAR The encoding type defined on the projection column.
ACCESS_RANK INTEGER The access rank of the projection column. See the ACCESSRANK parameter in the CREATE PROJECTION statement for more information.
GROUP_ID INTEGER A unique numeric ID (OID) that identifies the group and is assigned by the Vertica catalog.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, name of the namespace that contains the projection.
TABLE_SCHEMA VARCHAR

The name of the schema in which the projection is stored.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_ID INTEGER Catalog-assigned numeric value that uniquely identifies the table.
TABLE_NAME VARCHAR The table name that contains the projection.
TABLE_COLUMN_ID VARCHAR Catalog-assigned VARCHAR value that uniquely identifies a table column.
TABLE_COLUMN_NAME VARCHAR The projection's corresponding table column name.
STATISTICS_TYPE VARCHAR

The type of statistics the column contains:

STATISTICS_UPDATED_TIMESTAMP TIMESTAMPTZ The time at which the columns statistics were last updated by ANALYZE_STATISTICS. By querying this column, along with STATISTICS_TYPE and PROJECTION_COLUMN_NAME, you can identify projection columns whose statistics need updating. See also system table PROJECTIONS.
IS_EXPRESSION BOOLEAN Indicates whether this projection column is calculated with an expression. For aggregate columns, IS_EXPRESSION is always true.
IS_AGGREGATE BOOLEAN Indicates whether the column is an aggregated column in a live aggregate projection. IS_AGGREGATE is always false for Top-K projection columns.
PARTITION_BY_POSITION INTEGER Position of that column in the PARTITION BY and GROUP BY clauses, if applicable.
ORDER_BY_POSITION INTEGER Set only for Top-K projections, specifies the column's position in the ORDER BY clause, as defined in the projection definition's window partition clause. If the column is omitted from the ORDER BY clause, ORDER_BY_POSITION output is NULL.
ORDER_BY_TYPE INTEGER

Type of sort order:

  • ASC NULLS FIRST

  • ASC NULLS LAST

  • DESC NULLS FIRST

  • DESC NULLS LAST

COLUMN_EXPRESSION VARCHAR Expression that calculates the column value.

Examples

See Statistics Data in PROJECTION_COLUMNS

See also

1.55 - PROJECTION_DELETE_CONCERNS

Lists projections whose design are liable to cause performance issues when deleting data.

Lists projections whose design are liable to cause performance issues when deleting data. This table is generated by calling the EVALUATE_DELETE_PERFORMANCE function. See Optimizing DELETE and UPDATE for more information.

Column Name Data Type Description
PROJECTION_ID INTEGER The ID number of the projection
PROJECTION_SCHEMA VARCHAR The schema containing the projection
PROJECTION_NAME VARCHAR The projection's name
CREATION_TIME TIMESTAMPTZ When the projection was created
LAST_MODIFIED_TIME TIMESTAMPTZ When the projection was last modified
COMMENT VARCHAR A comment describing the potential delete performance issue.

1.56 - PROJECTIONS

Provides information about projections.

Provides information about projections.

Column Name Data Type Description
PROJECTION_SCHEMA_ID INTEGER A unique numeric ID that identifies the specific schema that contains the projection and is assigned by the Vertica catalog.
PROJECTION_SCHEMA VARCHAR

The name of the schema that contains the projection.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

PROJECTION_NAMESPACE_NAME VARCHAR For Eon Mode databases, name of the namespace that contains the projection.
PROJECTION_ID INTEGER A unique numeric ID that identifies the projection and is assigned by the Vertica catalog.
PROJECTION_NAME VARCHAR The projection name for which information is listed.
PROJECTION_BASENAME VARCHAR

The base name used for other projections:

  • For auto-created projections, identical to ANCHOR_TABLE_NAME.

  • For a manually-created projection, the name specified in the CREATE PROJECTION statement.

OWNER_ID INTEGER A unique numeric ID that identifies the projection owner and is assigned by the Vertica catalog.
OWNER_NAME VARCHAR The name of the projection's owner.
ANCHOR_TABLE_ID INTEGER The unique numeric identification (OID) of the projection's anchor table.
ANCHOR_TABLE_NAME VARCHAR The name of the projection's anchor table.
NODE_ID INTEGER A unique numeric ID (OID) for any nodes that contain any unsegmented projections.
NODE_NAME VARCHAR The names of any nodes that contain the projection. This column returns information for unsegmented projections only.
IS_PREJOIN BOOLEAN Deprecated, always set to f (false).
CREATED_EPOCH INTEGER The epoch in which the projection was created.
CREATE_TYPE VARCHAR

The method in which the projection was created:

  • CREATE PROJECTION: A custom projection created using CREATE PROJECTION.

  • CREATE TABLE: A superprojection that was automatically created when its associated table was created using CREATE TABLE.

  • ALTER TABLE: The system automatically created the key projection in response to a non-empty table.

  • CREATE TABLE WITH PROJ CLAUSE: A superprojection that was automatically created using CREATE TABLE.

  • DELAYED_CREATION: A superprojection that was automatically created when data was loaded for the first time into a new table.

  • DESIGNER: A projection created by Database Designer.

  • SYSTEM TABLE: A projection that was automatically created for a system table.

Rebalancing does not change the CREATE_TYPE value for a projection.

VERIFIED_FAULT_TOLERANCE INTEGER The projection K-safe value. This value can be greater than the database K-safety value (if more replications of a projection exist than are required to meet the database K-safety). This value cannot be less than the database K-safe setting.
IS_UP_TO_DATE BOOLEAN Specifies whether projection data is up to date. Only up-to-date projections are available to participate in query execution.
HAS_STATISTICS BOOLEAN

Specifies whether there are statistics for any column in the projection. HAS_STATISTICS returns true only when all non-epoch columns for a table or table partition have full statistics. For details, see Collecting table statistics and Collecting partition statistics.

IS_SEGMENTED BOOLEAN Specifies whether the projection is segmented.
SEGMENT_EXRESSION VARCHAR

The segmentation expression used for the projection. In the following example for the clicks_agg projection, the following values:

hash(clicks.user_id, (clicks.click_time)::date)

indicate that the projection was created with the following expression:

SEGMENTED BY HASH(clicks.user_id, (clicks.click_time)::date)

SEGMENT_RANGE VARCHAR

The percentage of projection data stored on each node, according to the segmentation expression. For example, segmenting a projection by the HASH function on all nodes results in a SEGMENT_RANGE value such as the following:

implicit range: node01[33.3%] node02[33.3%] node03[33.3%]

IS_SUPER_PROJECTION BOOLEAN Specifies whether a projection is a superprojection.
IS_KEY_CONSTRAINT_PROJECTION BOOLEAN

Indicates whether a projection is a key constraint projection:

  • t: A key constraint projection that validates a key constraint. Vertica uses the projection to efficiently enforce at least one enabled key constraint.

  • f: Not a projection that validates a key constraint.

HAS_EXPRESSIONS BOOLEAN Specifies whether this projection has expressions that define the column values. HAS_EXPRESSIONS is always true for live aggregate projections.
IS_AGGREGATE_PROJECTION BOOLEAN Specifies whether this projection is a live aggregate projection.
AGGREGATE_TYPE VARCHAR

Specifies the type of live aggregate projection:

  • GROUPBY

  • TOPK

IS_SHARED BOOLEAN Indicates whether the projection is located on shared storage.
PARTITION_RANGE_MIN VARCHAR Populated only if a projection specifies a partition range, the lowest and highest partition keys of the range.
PARTITION_RANGE_MAX
PARTITION_RANGE_MIN_EXPRESSION VARCHAR Populated only if a projection specifies partition range, the minimum and maximum range expressions as defined in the projection DDL.
PARTITION_RANGE_MAX_EXPRESSION

Examples

The following projection defines a range of orders placed since the first of the current year:

=> CREATE PROJECTION ytd_orders AS SELECT * FROM store_orders ORDER BY order_date
    ON PARTITION RANGE BETWEEN date_trunc('year',now())::date AND NULL;

Given that range, the PARTITION_RANGE_MIN and PARTITION_RANGE_MAX columns in the PROJECTIONS table contain the following values:

=> SELECT projection_name partition_range_min, partition_range_min, partition_range_max 
    FROM projections WHERE projection_name ILIKE 'ytd_orders%';
 partition_range_min | partition_range_min | partition_range_max
---------------------+---------------------+---------------------
 ytd_orders_b1       | 2024-01-01          | infinity
 ytd_orders_b0       | 2024-01-01          | infinity
(2 rows)

The following projection defines a range of orders placed since the third quarter of last year:

=> CREATE PROJECTION q3_td AS SELECT * FROM store_orders ORDER BY order_date
    ON PARTITION RANGE BETWEEN add_months(date_trunc('year',now()), -3)::date AND NULL;

Given that definition, the PARTITION_RANGE_MIN_EXPRESSION and PARTITION_RANGE_MAX_EXPRESSION columns in the PROJECTIONS table contain the following values:

=> SELECT projection_name, partition_range_min_expression, partition_range_max_expression 
    FROM projections WHERE projection_name ILIKE 'Q3_td%';
 projection_name |       partition_range_min_expression        | partition_range_max_expression
-----------------+---------------------------------------------+--------------------------------
 q3_td_b1        | add_months(date_trunc('year', now()), (-3)) | NULL
 q3_td_b0        | add_months(date_trunc('year', now()), (-3)) | NULL

See also

PROJECTION_COLUMNS

1.57 - REGISTERED_MODELS

Lists details about registered machine learning models in the database.

Lists details about registered machine learning models in the database. The table lists only registered models for which the caller has USAGE privileges.

For a table that lists all models, registered and unregistered, see MODELS.

Column Name Data Type Description
REGISTERED_NAME VARCHAR The abstract name to which the model is registered. This REGISTERED_NAME can represent a group of models for a higher-level application, where each model in the group has a unique version number.
REGISTERED_VERSION INTEGER The unique version number of the model under its specified REGISTERED_NAME.
STATUS INTEGER

The status of the registered model, one of the following:

  • under_review: Status assigned to newly registered models.

  • staging: Model is targeted for A/B testing against the model currently in production.

  • production: Model is in production for its specified application. Only one model can be in production for a given registered_name at one time.

  • archived: Status of models that were previously in production. Archived models can be returned to production at any time.

  • declined: Model is no longer in consideration for production.

  • unregistered: Model is removed from the versioning environment. The model does not appear in the REGISTERED_MODELS system table.

REGISTERED_TIME VARCHAR The time at which the model was registered.
MODEL_ID INTEGER The model's internal ID.
SCHEMA_NAME VARCHAR The name of the schema that contains the model.
MODEL_NAME VARCHAR The name of the model. [schema_name.]model_name can be used to uniquely identify a model, as can the combination of its REGISTERED_NAME and REGISTERED_VERSION.
MODEL_TYPE VARCHAR The type of algorithm used to create the model.
CATEGORY VARCHAR

The category of the model, one of the following:

  • VERTICA_MODELS

  • PMML

  • TENSORFLOW

By default, models created in Vertica are assigned to the VERTICA_MODELS category.

Example

If a user with the MLSUPERVISOR role queries REGISTERED_MODELS, all registered models are listed:

=> SELECT * FROM REGISTERED_MODELS;
  registered_name | registered_version |    status    |        registered_time        |      model_id     | schema_name |    model_name     |      model_type       |    category
------------------+--------------------+--------------+-------------------------------+-------------------+-------------+-------------------+-----------------------+----------------
 linear_reg_app   |                  2 | UNDER_REVIEW | 2023-01-29 09:09:00.082166-04 | 45035996273714020 | public      | linear_reg_spark1 | PMML_REGRESSION_MODEL | PMML
 linear_reg_app   |                  1 | PRODUCTION   | 2023-01-24 06:19:04.553102-05 | 45035996273850350 | public      | native_linear_reg | LINEAR_REGRESSION     | VERTICA_MODELS
 logistic_reg_app |                  2 | PRODUCTION   | 2023-01-25 08:45:11.279013-02 | 45035996273855542 | public      | log_reg_cgd       | LOGISTIC_REGRESSION   | VERTICA_MODELS
 logistic_reg_app |                  1 | ARCHIVED     | 2023-01-22 04:29:25.990626-02 | 45035996273853740 | public      | log_reg_bfgs      | LOGISTIC_REGRESSION   | VERTICA_MODELS
(4 rows)

See also

1.58 - RESOURCE_POOL_DEFAULTS

Returns default parameter settings for built-in and user-defined resource pools.

Returns default parameter settings for built-in and user-defined resource pools. Use ALTER RESOURCE POOL to restore resource pool parameters to their default settings.

For information about valid parameters for built-in resource pools and their default settings, see Built-in resource pools configuration.

To obtain a resource pool's current settings, query system table RESOURCE_POOLS.

Privileges

None

1.59 - RESOURCE_POOLS

Displays settings for built-in and user-defined resource pools.

Displays settings for built-in and user-defined resource pools. For information about defining resource pools, see CREATE RESOURCE POOL and ALTER RESOURCE POOL.

Column Name Data Type Description
POOL_ID INTEGER Unique identifier for the resource pool
NAME VARCHAR The name of the resource pool.
SUBCLUSTER_OID INTEGER Unique identifier for a subcluster-specific resource pool. For global resource pools, 0 is returned.
SUBCLUSTER_NAME VARCHAR Specifies the subcluster that the subcluster-specific resource pool belongs to.If there are subcluster-specific resource pools with the same name on separate subclusters, multiple entries are returned. For global resource pools, this column is blank.
IS_INTERNAL BOOLEAN Specifies whether this pool is a built-in pool.
MEMORYSIZE VARCHAR The amount of memory allocated to this resource pool.
MAXMEMORYSIZE VARCHAR Value assigned as the maximum size this resource pool can grow by borrowing memory from the GENERAL pool.
MAXQUERYMEMORYSIZE VARCHAR The maximum amount of memory allocated by this pool to process any query.
EXECUTIONPARALLELISM INTEGER Limits the number of threads used to process any single query issued in this resource pool.
PRIORITY INTEGER Specifies priority of queries in this pool when they compete for resources in the GENERAL pool.
RUNTIMEPRIORITY VARCHAR

The run-time priority defined for this pool, indicates how many run-time resources (CPU, I/O bandwidth) the Resource Manager should dedicate to running queries in the resource pool. Valid values are:

  • HIGH

  • MEDIUM (default)

  • LOW

These values are relative to each other. Queries with a HIGH run-time priority are given more CPU and I/O resources than those with a MEDIUM or LOW run-time priority.

RUNTIMEPRIORITYTHRESHOLD INTEGER Limits in seconds how soon a query must finish before the Resource Manager assigns to it the resource pool's RUNTIMEPRIORITY setting.
QUEUETIMEOUT INTEGER INTERVAL The maximum length of time requests can wait for resources to become available before being rejected, specified in seconds or as an interval. This value is set by the pool's QUEUETIMEOUT parameter.
PLANNEDCONCURRENCY INTEGER The preferred number of queries that execute concurrently in this resource pool, specified by the pool's PLANNEDCONCURRENCY parameter.
MAXCONCURRENCY INTEGER The maximum number of concurrent execution slots available to the resource pool, specified by the poolMAXCONCURRENCY parameter.
RUNTIMECAP INTERVAL The maximum time a query in the pool can execute.
SINGLEINITIATOR BOOLEAN Set for backward compatibility.
CPUAFFINITYSET VARCHAR

The set of CPUs on which queries associated with this pool are executed. For example:

  • 0, 2-4 : Specifies CPUs 0, 2, 3, and 4

  • 25%: A percentage of available CPUs, rounded down to whole CPUs.

CPUAFFINITYMODE VARCHAR

Specifies whether to share usage of the CPUs assigned to this resource pool by CPUAFFINITYSET, one of the following:

  • SHARED: Queries that run in this pool share its CPUAFFINITYSET CPUs with other Vertica resource pools.

  • EXCLUSIVE: Dedicates CPUAFFINITYSET CPUs to this resource pool only, and excludes other Vertica resource pools. If CPUAFFINITYSET is set as a percentage, then that percentage of CPU resources available to Vertica is assigned solely for this resource pool.

  • ANY: Queries in this resource pool can run on any CPU.

CASCADETO VARCHAR A secondary resource pool for executing queries that exceed the RUNTIMECAP setting of this resource pool.
CASCADETOSUBCLUSTERPOOL BOOLEAN Specifies whether this resource pool cascades to a subcluster-level resource pool.

1.60 - ROLES

Contains the names of all roles the user can access, along with any roles that have been assigned to those roles.

Contains the names of all roles the user can access, along with any roles that have been assigned to those roles.

Column Name Data Type Description
ASSIGNED_ROLES VARCHAR

The names of any roles that have been granted to this role. By enabling the role, the user also has access to the privileges of these additional roles.

NAME VARCHAR The name of a role that the user can access.
ROLE_ID INTEGER Catalog-assigned integer value that uniquely identifies therole.
LDAP_DN VARCHAR Indicates whether or not the Vertica Analytic Database role maps to an LDAP Link group. When the column is set to dn, the Vertica role maps to LDAP Link.
LDAP_URI_HASH VARCHAR The URI hash number for the LDAP role.
IS_ORPHANED_FROM_LDAP VARCHAR

Indicates if the role is disconnected (orphaned) from LDAP, valid values are:

t - role is orphaned

f - role is not orphaned

For more information see Troubleshooting LDAP link issues

See also

1.61 - ROUTING_RULES

Lists the routing rules that map incoming IP addresses to a load balancing group.

Lists the routing rules that map incoming IP addresses to a load balancing group.

Column Name Data Type Description
NAME VARCHAR The name of the routing rule.
SOURCE_ADDRESS VARCHAR The IP address range in CIDR format that this rule applies to.
DESTINATION_NAME VARCHAR The load balance group that handles connections for this rule.

Examples

=> SELECT * FROM routing_rules;
-[ RECORD 1 ]----+-----------------
name             | internal_clients
source_address   | 192.168.1.0/24
destination_name | group_1
-[ RECORD 2 ]----+-----------------
name             | etl_rule
source_address   | 10.20.100.0/24
destination_name | group_2
-[ RECORD 3 ]----+-----------------
name             | subnet_192
source_address   | 192.0.0.0/8
destination_name | group_all
-[ RECORD 4 ]----+--------------
name             | all_ipv6
source_address   | 0::0/0
destination_name | default_ipv6

See also

1.62 - SCHEDULER_TIME_TABLE

Contains information about scheduled tasks.

Contains information about scheduled tasks.

This table is local to the active scheduler node (ASN) and is only populated when queried from that node. To get the ASN, use ACTIVE_SCHEDULER_NODE:

=> SELECT active_scheduler_node();
 active_scheduler_node
-----------------------
 initiator
(1 row)
Column Name Data Type Description
SCHEDULE_NAME VARCHAR The name of the schedule.
SCHEMA_NAME VARCHAR The schedule's schema.
OWNER VARCHAR The owner of the schedule.
ATTACHED_TRIGGER VARCHAR The trigger attached to the schedule. For details, see Scheduled execution.
ENABLED BOOLEAN Whether the schedule is enabled.
DATE_TIME_TYPE VARCHAR

The format for the scheduled event, one of the following:

  • CRON

  • DATE_TIME_LIST

DATE_TIME_STRING VARCHAR

The string used to schedule the event, one of the following:

  • A cron expression

  • A comma-separated list of timestamps

Examples

To view scheduled tasks, execute the following statement on the ASN:

=> SELECT * FROM scheduler_time_table;
  schedule_name |        attached_trigger        | scheduled_execution_time 
----------------+--------------------------------+--------------------------
 daily_1am      | log_user_actions               | 2022-06-01 01:00:00-00
 logging_2022   | refresh_logs                   | 2022-06-01 12:00:00-00

1.63 - SCHEMATA

Provides information about schemas in the database.

Provides information about schemas in the database.

Column Name Data Type Description
SCHEMA_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the specific schema.
SCHEMA_NAME VARCHAR

Schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

SCHEMA_NAMESPACE_NAME VARCHAR For Eon Mode databases, name of the namespace that contains the schema.
SCHEMA_OWNER_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the owner who created the schema.
SCHEMA_OWNER VARCHAR Name of the owner who created the schema.
SYSTEM_SCHEMA_CREATOR VARCHAR Creator information for system schema or NULL for non-system schema
CREATE_TIME TIMESTAMPTZ Time when the schema was created.
IS_SYSTEM_SCHEMA BOOLEAN Indicates whether the schema was created for system use, where t is true and f is false.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

1.64 - SEQUENCES

Displays information about sequences.

Displays information about sequences.

Column Name Data Type Description
SEQUENCE_NAMESPACE VARCHAR For Eon Mode databases, name of the namespace that contains the sequence.
SEQUENCE_SCHEMA VARCHAR

The name of the schema that contains the sequence.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

SEQUENCE_NAME VARCHAR

One of the following:

  • User-assigned name of a sequence created with CREATE SEQUENCE

  • Auto-generated name assigned by Vertica for the sequence of an IDENTITY table column

OWNER_NAME VARCHAR

One of the following:

  • Owner of the named sequence

  • Owner of the table where an IDENTITY column is defined

IDENTITY_TABLE_NAME VARCHAR Set only for IDENTITY column sequences, name of the column table.
SESSION_CACHE_COUNT INTEGER Count of values cached in a session.
ALLOW_CYCLE BOOLEAN Whether values cycle when a sequence reaches its minimum or maximum value, as set by CREATE SEQUENCE parameter CYCLE|NO CYCLE.
OUTPUT_ORDERED BOOLEAN Values guaranteed to be ordered, always false.
INCREMENT_BY INTEGER Value by which sequences are incremented or decremented.
MINIMUM INTEGER Minimum value the sequence can generate.
MAXIMUM INTEGER Maximum value the sequence can generate.
CURRENT_VALUE INTEGER How many sequence numbers are distributed among all cluster nodes.
SEQUENCE_SCHEMA_ID INTEGER Unique numeric catalog ID of the sequence schema.
SEQUENCE_ID INTEGER Unique numeric catalog ID of the sequence.
OWNER_ID INTEGER Unique numeric catalog ID of the user who created the sequence.
IDENTITY_TABLE_ID INTEGER Set only for IDENTITY column sequences, unique numeric catalog ID of the column table.

Examples

Create a sequence:

=> CREATE SEQUENCE my_seq MAXVALUE 5000 START 150;
CREATE SEQUENCE

Return information about this sequence:

=> SELECT sequence_schema, sequence_name, owner_name, session_cache_count, increment_by, current_value FROM sequences;
 sequence_schema |      sequence_name       | owner_name | session_cache_count | increment_by | current_value
-----------------+--------------------------+------------+---------------------+--------------+--------------
 public          | my_seq                   | dbadmin    |              250000 |            1 |           149
(2 rows)

IDENTITY columns are sequences that are defined in a table's DDL. IDENTITY column values automatically increment as new rows are added. To identify IDENTITY columns and their tables, query the system table COLUMNS:

=> CREATE TABLE employees (employeeID IDENTITY, fname varchar(36), lname varchar(36));
CREATE TABLE
=> SELECT table_name, column_name, is_identity FROM columns WHERE is_identity = 't';
 table_name | column_name | is_identity
------------+-------------+-------------
 employees  | employeeID  | t
(1 row)

Query SEQUENCES to get detailed information about the IDENTITY column sequence in employees:

=> SELECT sequence_schema, sequence_name, identity_table_name, sequence_id FROM sequences
      WHERE identity_table_name ='employees';
 sequence_schema |      sequence_name       | identity_table_name |    sequence_id
-----------------+--------------------------+---------------------+-------------------
 public          | employees_employeeID_seq | employees           | 45035996273848816
(1 row)

Use the vsql command \ds to list all named and IDENTITY column sequences. The following results show the two sequences created previously:

=> \ds
                                                   List of Sequences
 Schema |         Sequence         | CurrentValue | IncrementBy | Minimum |       Maximum       | AllowCycle | Comment
--------+--------------------------+--------------+-------------+---------+---------------------+------------+---------
 public | employees_employeeID_seq |            0 |           1 |       1 | 9223372036854775807 | f          |
 public | my_seq                   |          149 |           1 |       1 |                5000 | f          |
(2 rows)

1.65 - SESSION_SUBSCRIPTIONS

In an Eon Mode database, lists the shard subscriptions for all nodes, and whether the subscriptions are used to resolve queries for the current session.

In an Eon Mode database, lists the shard subscriptions for all nodes, and whether the subscriptions are used to resolve queries for the current session. Nodes that will participate in resolving queries in this session have TRUE in their IS_PARTICIPATING column.

Column Name Data Type Description
NODE_OID INTEGER The OID of the subscribing node.
NODE_NAME VARCHAR The name of the subscribing node.
SHARD_OID INTEGER The OID of the shard the node subscribes to.
SHARD_NAME VARCHAR The name of the shard the node subscribes to.
IS_PARTICIPATING BOOLEAN Whether this subscription is used when resolving queries in this session.
IS_COLLABORATING BOOLEAN Whether this subscription is used to collaborate with a participating node when executing queries . This value is only true when queries are using elastic crunch scaling.

Examples

The following example demonstrates listing the subscriptions that are either participating or collaborating in the current session:

=> SELECT node_name, shard_name, is_collaborating, is_participating
        FROM V_CATALOG.SESSION_SUBSCRIPTIONS
        WHERE is_participating = TRUE OR is_collaborating = TRUE
        ORDER BY shard_name, node_name;
      node_name       | shard_name  | is_collaborating | is_participating
----------------------+-------------+------------------+------------------
 v_verticadb_node0004 | replica     | f                | t
 v_verticadb_node0005 | replica     | f                | t
 v_verticadb_node0006 | replica     | t                | f
 v_verticadb_node0007 | replica     | f                | t
 v_verticadb_node0008 | replica     | t                | f
 v_verticadb_node0009 | replica     | t                | f
 v_verticadb_node0007 | segment0001 | f                | t
 v_verticadb_node0008 | segment0001 | t                | f
 v_verticadb_node0005 | segment0002 | f                | t
 v_verticadb_node0009 | segment0002 | t                | f
 v_verticadb_node0004 | segment0003 | f                | t
 v_verticadb_node0006 | segment0003 | t                | f
(12 rows)

1.66 - SHARDS

Lists the shards in your database.

Lists the shards in your database.

Column Name Data Type Description
SHARD_OID INTEGER The OID of the shard.
SHARD_NAME VARCHAR The name of the shard.
SHARD_TYPE VARCHAR The type of the shard.
LOWER_HASH_BOUND VARCHAR The lower hash bound of the shard.
UPPER_HASH_BOUND VARCHAR The upper hash bound of the shard.
IS_REPLICATED BOOLEAN Defines if the shard is replicated.
HAS_OBJECTS BOOLEAN Defines if the shard contains objects.

Examples

=> SELECT * FROM SHARDS;
-[ RECORD 1 ]----+------------------
shard_oid        | 45035996273704980
shard_name       | replica
shard_type       | Replica
lower_hash_bound |
upper_hash_bound |
is_replicated    | t
has_objects      | t
...

1.67 - STORAGE_LOCATIONS

Provides information about storage locations, including IDs, labels, and status.

Provides information about storage locations, including IDs, labels, and status.

Column Name Data Type Description
LOCATION_ID INTEGER Catalog-assigned integer value that uniquely identifies thestorage location.
NODE_NAME VARCHAR The node name on which the storage location exists.
LOCATION_PATH VARCHAR The path where the storage location is mounted.
LOCATION_USAGE VARCHAR

The type of information stored in the location:

  • DATA: Only data is stored in the location.

  • TEMP: Only temporary files that are created during loads or queries are stored in the location.

  • DATA,TEMP: Both types of files are stored in the location.

  • USER: The storage location can be used by users without their own credentials or dbadmin access. Users gain access to data by being granted access to the user storage location.

  • CATALOG: The area is used for the Vertica catalog. This usage is set internally and cannot be removed or changed.

SHARING_TYPE VARCHAR

How this location is shared among database nodes, if it is:

  • SHARED: The path used by the storage location is used by all nodes. See the SHARED parameter to CREATE LOCATION.

  • COMMUNAL: the location is used for communal storage in Eon Mode.

  • NONE: The location is not shared among nodes.

IS_RETIRED BOOLEAN Whether the storage location has been retired. This column has a value of t (true) if the location is retired, or f (false) if it is not.
LOCATION_LABEL VARCHAR The label associated with a specific storage location, added with the ALTER_LOCATION_LABEL function.
RANK INTEGER The Access rank value either assigned or supplied to the storage location, as described in Prioritizing column access speed.
THROUGHPUT INTEGER The throughput performance of the storage location, measured in MB/sec. You can get location performance values using MEASURE_LOCATION_PERFORMANCE, and set them with the SET_LOCATION_PERFORMANCE function.
LATENCY INTEGER The measured latency of the storage location as number of data seeks per second. You can get location performance values using MEASURE_LOCATION_PERFORMANCE, and set them with the SET_LOCATION_PERFORMANCE function.
MAX_SIZE INTEGER Maximum size of the storage location in bytes.
DISK_PERCENT VARCHAR Maximum percentage of available node disk space that this storage location can use, set only if depot size is defined as a percentage, otherwise blank.

Privileges

Superuser

See also

1.68 - STORED_PROC_TRIGGERS

Contains information about Triggers.

Contains information about Triggers.

Column Name Data Type Description
TRIGGER_NAME VARCHAR The name of the trigger.
NAMESPACE_NAME VARCHAR For Eon Mode databases, the trigger's namespace.
SCHEMA_NAME VARCHAR

The trigger's schema.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

OWNER VARCHAR The owner of the trigger.
PROCEDURE_NAME VARCHAR The name of the stored procedure.
PROCEDURE_ARGS INTEGER The number of formal parameters in the stored procedure.
ENABLED BOOLEAN Whether the trigger is enabled.

Examples

To view triggers:

=> SELECT * FROM stored_proc_triggers;
  trigger_name  | schema_name |  owner  | procedure_name | procedure_args | enabled
----------------+-------------+---------+----------------+----------------+---------
 raise_trigger  | public      | dbadmin | raiseXY        | 2              | t

1.69 - SUBCLUSTER_RESOURCE_POOL_OVERRIDES

Displays subcluster-level overrides of settings for built-in global resource pools.

Displays subcluster-level overrides of settings for built-in global resource pools.

Column Name Data Type Description
POOL_OID INTEGER Unique identifier for the resource pool with settings overrides.
NAME VARCHAR The name of the built-in resource pool.
SUBCLUSTER_OID INTEGER Unique identifier for the subcluster with settings that override the global resource pool settings.
SUBCLUSTER_NAME VARCHAR The name of the subcluster with settings that overrides the global resource pool settings.
MEMORYSIZE VARCHAR The amount of memory allocated to the global resource pool.
MAXMEMORYSIZE VARCHAR Value assigned as the maximum size this resource pool can grow by borrowing memory from the GENERAL pool.
MAXQUERYMEMORYSIZE VARCHAR The maximum amount of memory allocated by this pool to process any query.

1.70 - SUBCLUSTERS

This table lists all of the subclusters defined in the database.

This table lists all of the subclusters defined in the database. It contains an entry for each node in the database listing which subcluster it belongs to. Any subcluster that does not contain a node has a single entry in this table with empty NODE_NAME and NODE_OID columns. This table is only populated if the database is running in Eon Mode.

Column Name Data Type Description
SUBCLUSTER_OID INTEGER Unique identifier for the subcluster.
SUBCLUSTER_NAME VARCHAR The name of the subcluster.
NODE_OID INTEGER The catalog-assigned ID of the node.
NODE_NAME VARCHAR The name of the node.
PARENT_OID INTEGER The unique ID of the parent of the node (the database).
PARENT_NAME VARCHAR The name of the parent of the node (the database name).
IS_DEFAULT BOOLEAN Whether the subcluster is the default cluster.
IS_PRIMARY BOOLEAN Whether the subcluster is a primary subcluster.
CONTROL_SET_SIZE INTEGER The number of control nodes defined for this subcluster. This value is -1 when the large cluster feature is not enabled, or when every node in the subcluster must be a control node. See Large cluster for more information.

Examples

=> \x
Expanded display is on.
dbadmin=> SELECT * FROM SUBCLUSTERS;
-[ RECORD 1 ]----+---------------------
subcluster_oid   | 45035996273704978
subcluster_name  | default_subcluster
node_oid         | 45035996273704982
node_name        | v_verticadb_node0001
parent_oid       | 45035996273704976
parent_name      | verticadb
is_default       | t
is_primary       | t
control_set_size | -1
-[ RECORD 2 ]----+---------------------
subcluster_oid   | 45035996273704978
subcluster_name  | default_subcluster
node_oid         | 45035996273840970
node_name        | v_verticadb_node0002
parent_oid       | 45035996273704976
parent_name      | verticadb
is_default       | t
is_primary       | t
control_set_size | -1
-[ RECORD 3 ]----+---------------------
subcluster_oid   | 45035996273704978
subcluster_name  | default_subcluster
node_oid         | 45035996273840974
node_name        | v_verticadb_node0003
parent_oid       | 45035996273704976
parent_name      | verticadb
is_default       | t
is_primary       | t
control_set_size | -1

See also

1.71 - SYSTEM_COLUMNS

Provides table column information for SYSTEM_TABLES.

Provides table column information for SYSTEM_TABLES.

Column Name Data Type Description
TABLE_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the table.
TABLE_SCHEMA VARCHAR The schema name for which information is listed.
TABLE_NAME VARCHAR The table name for which information is listed.
IS_SYSTEM_TABLE BOOLEAN Indicates whether the table is a system table, where t is true and f is false.
COLUMN_ID VARCHAR Catalog-assigned VARCHAR value that uniquely identifies a table column.
COLUMN_NAME VARCHAR The column name for which information is listed in the database.
DATA_TYPE VARCHAR The data type assigned to the column; for example VARCHAR(16).
DATA_TYPE_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the data type.
DATA_TYPE_LENGTH INTEGER The maximum allowable length of the data type.
CHARACTER_MAXIMUM_LENGTH INTEGER The maximum allowable length of the column.
NUMERIC_PRECISION INTEGER The number of significant decimal digits.
NUMERIC_SCALE INTEGER The number of fractional digits.
DATETIME_PRECISION INTEGER For TIMESTAMP data type, returns the declared precision; returns null if no precision was declared.
INTERVAL_PRECISION INTEGER The number of fractional digits retained in the seconds field.
ORDINAL_POSITION INTEGER The position of the column respective to other columns in the table.
IS_NULLABLE BOOLEAN Indicates whether the column can contain null values, where t is true and f is false.
COLUMN_DEFAULT VARCHAR The default value of a column, such as empty or expression.

1.72 - SYSTEM_TABLES

Returns a list of all system table names.

Returns a list of all system table names.

Column Name Data Type Description
TABLE_SCHEMA_ID INTEGER Catalog-assigned integer value that uniquely identifies theschema.
TABLE_SCHEMA VARCHAR

The schema name in which the system table resides, one of the following:

TABLE_ID INTEGER Catalog-assigned integer value that uniquely identifies thetable.
TABLE_NAME VARCHAR The name of the system table.
TABLE_DESCRIPTION VARCHAR A description of the system table's purpose.
IS_SUPERUSER_ONLY BOOLEAN Specifies whether the table is accessible only by superusers by default. If false, then the PUBLIC role has the privileges to access the system table.
IS_MONITORABLE BOOLEAN Specifies whether the table is accessible by a user with the SYSMONITOR role enabled.
IS_ACCESSIBLE_DURING_LOCKDOWN BOOLEAN

Specifies whether RESTRICT_SYSTEM_TABLES_ACCESS revokes privileges from PUBLIC on the system table. These privileges can be restored with RELEASE_SYSTEM_TABLES_ACCESS.

In general, this field is set to t (true) for system tables that contain information that is typically needed by most users, such as TYPES. Conversely, this field is set to f (false) for tables with data that should be restricted during lockdown, such as database settings and user information.

1.73 - TABLE_CONSTRAINTS

Provides information about table constraints.

Provides information about table constraints.

Column Name Data Type Description
CONSTRAINT_ID INTEGER Catalog-assigned integer value that uniquely identifies theconstraint.
CONSTRAINT_NAME VARCHAR The name of the constraint, if specified as UNIQUE, FOREIGN KEY, NOT NULL, PRIMARY KEY, or CHECK.
CONSTRAINT_SCHEMA_ID INTEGER Catalog-assigned integer value that uniquely identifies theschema containing the constraint.
CONSTRAINT_KEY_COUNT INTEGER The number of constraint keys.
FOREIGN_KEY_COUNT INTEGER The number of foreign keys.
TABLE_ID INTEGER Catalog-assigned integer value that uniquely identifies thetable.
TABLE_NAME VARCHAR The name of the table that contains the UNIQUE, FOREIGN KEY, NOT NULL, or PRIMARY KEY constraint
FOREIGN_TABLE_ID INTEGER The unique object ID of the foreign table referenced in a foreign key constraint (zero if not a foreign key constraint).
CONSTRAINT_TYPE CHAR

Indicates the constraint type.

Valid Values:

  • c — check

  • f — foreign

  • p — primary

  • u — unique

IS_ENABLED` BOOLEAN Indicates if a constraint for a primary key, unique key, or check constraint is currently enabled. Can be t (True) or f (False).
PREDICATE VARCHAR For check constraints, the SQL expression.

See also

ANALYZE_CONSTRAINTS

1.74 - TABLES

Provides information about all tables in the database.

Provides information about all tables in the database.

The TABLE_SCHEMA and TABLE_NAME columns are case-sensitive. To restrict a query based on those columns, use the case-insensitive ILIKE predicate. For example:

=> SELECT table_schema, table_name FROM v_catalog.tables
   WHERE table_schema ILIKE 'Store%';
Column Name Data Type Description
TABLE_SCHEMA_ID INTEGER A unique numeric ID that identifies the schema and is assigned by the Vertica catalog.
TABLE_SCHEMA VARCHAR The schema name for which information is listed.
TABLE_NAMESPACE_NAME VARCHAR For Eon Mode databases, name of the namespace to which the table belongs.
TABLE_ID INTEGER A unique numeric ID that identifies the table and is assigned by the Vertica catalog.
TABLE_NAME VARCHAR The table name for which information is listed.
OWNER_ID INTEGER A unique numeric ID that identifies the owner and is assigned by the Vertica catalog.
OWNER_NAME VARCHAR The name of the user who created the table.
IS_TEMP_TABLE BOOLEAN Whether this table is a temporary table.
IS_SYSTEM_TABLE BOOLEAN Whether this table is a system table.
FORCE_OUTER INTEGER Whether this table is joined to another as an inner or outer input. For details, see Controlling join inputs.
IS_FLEXTABLE BOOLEAN Whether the table is a Flex table.
IS_SHARED BOOLEAN Whether the table is located on shared storage. Not used for temporary tables in Eon Mode.
HAS_AGGREGATE_PROJECTION BOOLEAN Whether the table has live aggregate projections.
SYSTEM_TABLE_CREATOR VARCHAR The name of the process that created the table, such as Designer.
PARTITION_EXPRESSION VARCHAR The table's partition expression.
CREATE_TIME TIMESTAMP When the table was created.
TABLE_DEFINITION VARCHAR For external tables, the COPY FROM portion of the table definition.
RECOVER_PRIORITY INTEGER The priority rank for the table for a Recovery By Table.
STORAGE_MODE INTEGER Deprecated, always set to DIRECT.
PARTITION_GROUP_EXPRESSION VARCHAR The expression of a GROUP BY clause that qualifies a table's partition clause.
ACTIVE_PARTITION_COUNT INTEGER The table's active partition count as set by CREATE TABLE or ALTER TABLE. If null, the table gets its active partition count from the ActivePartitionCount configuration parameter. For details, see Active and inactive partitions.
IS_MERGEOUT_ENABLED BOOLEAN Whether mergeout is enabled (t) or disabled (f) on ROS containers that consolidate projection data of this table. By default, mergeout is enabled on all tables. You can disable mergeout on a table with ALTER TABLE. For details, see Disabling mergeout on specific tables.
IMMUTABLE_ROWS_SINCE_TIMESTAMP TIMESTAMPTZ Set only for immutable tables, the server system time when immutability was applied to this table. This value can help with long-term timestamp retrieval and efficient comparison.
IMMUTABLE_ROWS_SINCE_EPOCH INTEGER Set only for immutable tables, the epoch that was current when immutability was applied. This setting can help protect the table from attempts to pre-insert records with a future timestamp, so that row's epoch is less than the table's immutability epoch.
IS_EXTERNAL_ICEBERG_TABLE BOOLEAN Whether this table is an Iceberg table.

Examples

Find when tables were created:

=> SELECT table_schema, table_name, create_time FROM tables;
 table_schema |      table_name       |          create_time
--------------+-----------------------+-------------------------------
 public       | customer_dimension    | 2011-08-15 11:18:25.784203-04
 public       | product_dimension     | 2011-08-15 11:18:25.815653-04
 public       | promotion_dimension   | 2011-08-15 11:18:25.850592-04
 public       | date_dimension        | 2011-08-15 11:18:25.892347-04
 public       | vendor_dimension      | 2011-08-15 11:18:25.942805-04
 public       | employee_dimension    | 2011-08-15 11:18:25.966985-04
 public       | shipping_dimension    | 2011-08-15 11:18:25.999394-04
 public       | warehouse_dimension   | 2011-08-15 11:18:26.461297-04
 public       | inventory_fact        | 2011-08-15 11:18:26.513525-04
 store        | store_dimension       | 2011-08-15 11:18:26.657409-04
 store        | store_sales_fact      | 2011-08-15 11:18:26.737535-04
 store        | store_orders_fact     | 2011-08-15 11:18:26.825801-04
 online_sales | online_page_dimension | 2011-08-15 11:18:27.007329-04
 online_sales | call_center_dimension | 2011-08-15 11:18:27.476844-04
 online_sales | online_sales_fact     | 2011-08-15 11:18:27.49749-04
(15 rows)

Find out whether certain tables are temporary and flex tables:

=> SELECT distinct table_name, table_schema, is_temp_table, is_flextable FROM v_catalog.tables
   WHERE table_name ILIKE 't%';
  table_name  | table_schema | is_temp_table | is_flextable
--------------+--------------+---------------+-----------------
 t2_temp      | public       | t             | t
 tt_keys      | public       | f             | f
 t2_temp_keys | public       | f             | f
 t3           | public       | t             | f
 t1           | public       | f             | f
 t9_keys      | public       | f             | f
 t2_keys      | public       | f             | t
 t6           | public       | t             | f
 t5           | public       | f             | f
 t2           | public       | f             | t
 t8           | public       | f             | f
 t7           | public       | t             | f
 tt           | public       | t             | t
 t2_keys_keys | public       | f             | f
 t9           | public       | t             | t
(15 rows)

1.75 - TEXT_INDICES

Provides summary information about the text indices in Vertica.

Provides summary information about the text indices in Vertica.

Column Name Data Type Description
INDEX_ID INTEGER A unique numeric ID that identifies the index and is assigned by the Vertica catalog.
INDEX_NAME VARCHAR The name of the text index.
INDEX_SCHEMA_NAME VARCHAR The schema name of the text index.
SOURCE_TABLE_ID INTEGER A unique numeric ID that identifies the table and is assigned by the Vertica catalog.
SOURCE_TABLE_NAME VARCHAR The name of the source table used to build the index.
SOURCE_TABLE_SCHEMA_NAME VARCHAR The schema name of the source table.
TOKENIZER_ID INTEGER A unique numeric ID that identifies the tokenizer and is assigned by the Vertica catalog.
TOKENIZER_NAME VARCHAR The name of the tokenizer used when building the index.
TOKENIZER_SCHEMA_NAME VARCHAR The schema name of the tokenizer.
STEMMER_ID INTEGER A unique numeric ID that identifies the stemmer and is assigned by the Vertica catalog.
STEMMER_NAME VARCHAR The name of the stemmer used when building the index.
STEMMER_SCHEMA_NAME VARCHAR The schema name of the stemmer.
TEXT_COL VARCHAR The text column used to build the index.

1.76 - TYPES

Provides information about supported data types.

Provides information about supported data types. This table does not include inlined complex types; see COMPLEX_TYPES instead. This table does include arrays and sets of primitive types.

Column Name Data Type Description
TYPE_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the specific data type.
ODBC_TYPE INTEGER The numerical ODBC type.
ODBC_SUBTYPE INTEGER The numerical ODBC subtype, used to differentiate types such as time and interval that have multiple subtypes.
JDBC_TYPE INTEGER The numerical JDBC type.
JDBC_SUBTYPE INTEGER The numerical JDBC subtype, used to differentiate types such as time and interval that have multiple subtypes.
MIN_SCALE INTEGER The minimum number of digits supported to the right of the decimal point for the data type.
MAX_SCALE INTEGER The maximum number of digits supported to the right of the decimal point for the data type. A value of 0 is used for types that do not use decimal points.
COLUMN_SIZE INTEGER The number of characters required to display the type. See: http://msdn.microsoft.com/en-us/library/windows/desktop/ms711786%28v=VS.85%29.aspx for the details on COLUMN_SIZE for each type.
INTERVAL_MASK INTEGER For data types that are intervals, the bitmask to determine the range of the interval from the Vertica TYPE_ID. Details are available in the Vertica SDK.
TYPE_NAME VARCHAR The data type name associated with a particular data type ID.
CREATION_PARAMETERS VARCHAR A list of keywords, separated by commas, corresponding to each parameter that the application may specify in parentheses when using the name that is returned in the TYPE_NAME field. The keywords in the list can be any of the following: length, precision, or scale. They appear in the order that the syntax requires them to be used.

1.77 - USER_AUDITS

Lists the results of database and object size audits generated by users calling the AUDIT function.

Lists the results of database and object size audits generated by users calling the AUDIT function. See Monitoring database size for license compliance for more information.

Column Name Data Type Description
SIZE_BYTES INTEGER The estimated raw data size of the database
USER_ID INTEGER The ID of the user who generated the audit
USER_NAME VARCHAR The name of the user who generated the audit
OBJECT_ID INTEGER The ID of the object being audited
OBJECT_TYPE VARCHAR The type of object being audited (table, schema, etc.)
OBJECT_SCHEMA VARCHAR The schema containing the object being audited
OBJECT_NAME VARCHAR The name of the object being audited
AUDITED_SCHEMA_NAME VARCHAR

The name of the schema on which you want to query HISTORICAL data.

After running audit on a table, you can drop the table. In this case, object_schema becomes NULL.

AUDITED_OBJECT_NAME VARCHAR

The name of the object on which you want to query HISTORICAL data.

After running audit on a table, you can drop the table. In this case, object_name becomes NULL.

LICENSE_NAME VARCHAR The name of the license. After running a compliance audit, the value for this column is always vertica.
AUDIT_START_TIMESTAMP TIMESTAMPTZ When the audit started
AUDIT_END_TIMESTAMP TIMESTAMPTZ When the audit finished
CONFIDENCE_LEVEL_PERCENT FLOAT The confidence level of the size estimate
ERROR_TOLERANCE_PERCENT FLOAT The error tolerance used for the size estimate
USED_SAMPLING BOOLEAN Whether data was randomly sampled (if false, all of the data was analyzed)
CONFIDENCE_INTERVAL_LOWER_BOUND_BYTES INTEGER The lower bound of the data size estimate within the confidence level
CONFIDENCE_INTERVAL_UPPER_BOUND_BYTES INTEGER The upper bound of the data size estimate within the confidence level
SAMPLE_COUNT INTEGER The number of data samples used to generate the estimate
CELL_COUNT INTEGER The number of cells in the database

1.78 - USER_CLIENT_AUTH

Provides information about the client authentication methods that are associated with database users.

Provides information about the client authentication methods that are associated with database users. You associate an authentication method with a user using GRANT (Authentication).

Column Name Data Type Description
USER_OID INTEGER A unique identifier for that user.
USER_NAME VARCHAR Name of the user.
AUTH_OID INTEGER A unique identifier for the authentication method you are using.
AUTH_NAME VARCHAR Name that you gave to the authentication method.
GRANTED_TO BOOLEAN Name of the user with whom you have associated the authentication method using GRANT (Authentication).

1.79 - USER_CONFIGURATION_PARAMETERS

Provides information about user-level configuration parameters that are in effect for database users.

Provides information about user-level configuration parameters that are in effect for database users.

Column Name Data Type Description
USER_NAME VARCHAR Name of a database user with user-level settings.
PARAMETER_NAME VARCHAR The configuration parameter name.
CURRENT_ VALUE VARCHAR The parameter's current setting for this user.
DEFAULT_VALUE VARCHAR The parameter's default value.

Privileges

Superuser only

Examples

=> SELECT * FROM user_configuration_parameters;
 user_name |      parameter_name       | current_value | default_value
-----------+---------------------------+---------------+---------------
 Yvonne    | LoadSourceStatisticsLimit | 512           | 256
(1 row)

=> ALTER USER Ahmed SET DepotOperationsForQuery='FETCHES';
ALTER USER
=> ALTER USER Yvonne SET DepotOperationsForQuery='FETCHES';
ALTER USER
=> SELECT * FROM user_configuration_parameters;
 user_name |      parameter_name       | current_value | default_value
-----------+---------------------------+---------------+---------------
 Ahmed     | DepotOperationsForQuery   | FETCHES       | ALL
 Yvonne    | DepotOperationsForQuery   | FETCHES       | ALL
 Yvonne    | LoadSourceStatisticsLimit | 512           | 256
(3 rows)

1.80 - USER_FUNCTION_PARAMETERS

Provides information about the parameters of a C++ user-defined function (UDx).

Provides information about the parameters of a C++ user-defined function (UDx). You can only view parameters that have the Properties.visible parameter set to TRUE.

Column Name Data Type Description
NAMESPACE_NAME VARCHAR For Eon Mode databases, name of the namespace that contains the function.
SCHEMA_NAME VARCHAR(128)

The schema to which the function belongs.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

FUNCTION_NAME VARCHAR(128) The name assigned by the user to the user-defined function.
FUNCTION_TYPE VARCHAR(128) The type of user-defined function. For example, 'User Defined Function'.
FUNCTION_ARGUMENT_TYPE VARCHAR(8192) The number and data types of input arguments for the function.
PARAMETER_NAME VARCHAR(128) The name of the parameter for the user-defined function.
DATA_TYPE VARCHAR(128) The data type of the parameter.
DATA_TYPE_ID INTEGER A number specifying the ID for the parameter's data type.
DATA_TYPE_LENGTH INTEGER The maximum length of the parameter's data type.
IS_REQUIRED BOOLEAN

Indicates whether the parameter is required or not.

If set to TRUE, and you don't provide the parameter, Vertica throws an error.

CAN_BE_NULL BOOLEAN

Indicates whether the parameter can be passed as a NULL value.

If set to FALSE, you pass the parameter with a NULL value, Vertica throws an error.

COMMENT VARCHAR(128) A user-supplied description of the parameter.

Privileges

Any user can query the USER_FUNCTION_PARAMETERS table. However, users can only see table information about those UDx functions which the user has permission to use.

See also

1.81 - USER_FUNCTIONS

Returns metadata about user-defined SQL functions (which store commonly used SQL expressions as a function in the Vertica catalog) and user-defined functions.

Returns metadata about user-defined SQL functions (which store commonly used SQL expressions as a function in the Vertica catalog) and user-defined functions.

Column Name Data Type Description
SCHEMA_NAME VARCHAR The name of the schema in which this function exists.
FUNCTION_NAME VARCHAR The name assigned by the user to the SQL function or user-defined function.
PROCEDURE_TYPE VARCHAR The type of user-defined function. For example, 'User Defined Function'.
FUNCTION_RETURN_TYPE VARCHAR The data type name that the SQL function returns.
FUNCTION_ARGUMENT_TYPE VARCHAR The number and data types of parameters for the function.
FUNCTION_DEFINITION VARCHAR The SQL expression that the user defined in the SQL function's function body.
VOLATILITY VARCHAR The SQL function's volatility (whether a function returns the same output given the same input). Can be immutable, volatile, or stable.
IS_STRICT BOOLEAN Indicates whether the SQL function is strict, where t is true and f is false.
IS_FENCED BOOLEAN Indicates whether the function runs in Fenced and unfenced modes or not.
COMMENT VARCHAR A comment about this function provided by the function creator.

Notes

  • The volatility and strictness of a SQL function are automatically inferred from the function definition in order that Vertica determine the correctness of usage, such as where an immutable function is expected but a volatile function is provided.

  • The volatility and strictness of a UDx is defined by the UDx's developer.

Examples

Create a SQL function called myzeroifnull in the public schema:

=> CREATE FUNCTION myzeroifnull(x INT) RETURN INT
   AS BEGIN
     RETURN (CASE WHEN (x IS NOT NULL) THEN x ELSE 0 END);
   END;

Now query the USER_FUNCTIONS table. The query returns just the myzeroifnull macro because it is the only one created in this schema:

=> SELECT * FROM user_functions;
-[ RECORD 1 ]----------+---------------------------------------------------
schema_name            | public
function_name          | myzeroifnull
procedure_type         | User Defined Function
function_return_type   | Integer
function_argument_type | x Integer
function_definition    | RETURN CASE WHEN (x IS NOT NULL) THEN x ELSE 0 END
volatility             | immutable
is_strict              | f
is_fenced              | f
comment                |

See also

1.82 - USER_PROCEDURES

Provides information about stored procedures and external procedures.

Provides information about stored procedures and external procedures. Users can only view procedures that they can execute.

Column Name Data Type Description
PROCEDURE_NAME VARCHAR The name of the procedure.
OWNER VARCHAR The owner (definer) of the procedure.
LANGUAGE VARCHAR

The language in which the procedure is defined.

For external procedures, this will be EXTERNAL.

For stored procedures, this will be one of the supported languages.

SECURITY VARCHAR

The privileges to use when executing the procedure, one of the following:

  • DEFINER: Executes the procedure with the privileges of the owner (definer) of the procedure.

  • INVOKER: Executes the procedure with the privileges of the invoker.

For details, see Executing stored procedures.

PROCEDURE_ARGUMENTS VARCHAR The arguments of the procedure.
NAMESPACE_NAME VARCHAR For Eon Mode databases, name of the namespace that contains the procedure.
SCHEMA_NAME VARCHAR

The schema in which the procedure was defined.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

Privileges

Non-superusers can only view information on a procedure if they have:

  • USAGE privileges on the procedure's schema.

  • Ownership or EXECUTE privileges on the procedure.

Examples

=> SELECT * FROM user_procedures;
   procedure_name   |  owner  | language | security |                               procedure_arguments                                 | schema_name
--------------------+---------+----------+----------+-----------------------------------------------------------------------------------+-------------
 accurate_auc       | dbadmin | PL/vSQL  | INVOKER  | relation varchar, observation_col varchar, probability_col varchar, epsilon float | public
 conditionalTable   | dbadmin | PL/vSQL  | INVOKER  | b boolean                                                                         | public
 update_salary      | dbadmin | PL/vSQL  | INVOKER  | x int, y varchar                                                                  | public
(3 rows)

1.83 - USER_SCHEDULES

Contains information about schedules.

Contains information about schedules.

Column Name Data Type Description
SCHEDULE_NAME VARCHAR The name of the schedule.
NAMESPACE_NAME VARCHAR For Eon Mode databases, the schedule's namespace.
SCHEMA_NAME VARCHAR

The schedule's schema.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

OWNER VARCHAR The owner of the schedule.
ATTACHED_TRIGGER VARCHAR The trigger attached to the schedule, if any.
ATTACHED_TRIGGER BOOLEAN Whether the schedule is enabled.
DATE_TIME_TYPE VARCHAR

The format for the scheduled event, one of the following:

  • CRON

  • DATE_TIME_LIST

DATE_TIME_STRING VARCHAR

The string used to schedule the event, one of the following:

  • A cron expression

  • A comma-separated list of timestamps

Examples

To view schedules:

=> SELECT * FROM user_schedules;
     schedule_name     | schema_name |  owner  |        attached_trigger        | enabled | date_time_type |                date_time_string
-----------------------+-------------+---------+--------------------------------+---------+----------------+------------------------------------------------
 daily_1am             | management  | dbadmin | log_user_actions               | t       | CRON           | 0 1 * * *
 biannual_22_noon_gmt  | public      | dbadmin | refresh_logs                   | t       | DATE_TIME_LIST | 2022-01-01 12:00:00-00, 2022-06-01 12:00:00-00

1.84 - USER_TRANSFORMS

Lists the currently-defined user-defined transform functions (UDTFs).

Lists the currently-defined user-defined transform functions (UDTFs).

Column Name Data Type Description
SCHEMA_NAME VARCHAR(128) The name of the schema containing the UDTF.
FUNCTION_NAME VARCHAR(128) The SQL function name assigned by the user.
FUNCTION_RETURN_TYPE VARCHAR(128) The data types of the columns the UDTF returns.
FUNCTION_ARGUMENT_TYPE VARCHAR(8192) The data types of the columns that make up the input row.
FUNCTION_DEFINITION VARCHAR(128) A string containing the name of the factory class for the UDTF, and the name of the library that contains it.
IS_FENCED BOOLEAN Whether the UDTF runs in fenced mode.

Privileges

No explicit permissions are required; however, users see only UDTFs contained in schemas to which they have read access.

See also

1.85 - USERS

Provides information about all users in the database.

Provides information about all users in the database.

Column Name Data Type Description
USER_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the user.
USER_NAME VARCHAR The user name for which information is listed.
IS_SUPER_USER BOOLEAN A system flag, where t (true) identifies the superuser created at the time of installation. All other users are denoted by f (false).
PROFILE_NAME VARCHAR The name of the profile to which the user is assigned. The profile controls the user's password policy.
IS_LOCKED BOOLEAN Whether the user's account is locked. A locked user cannot log into the system.
LOCK_TIME TIMESTAMPTZ When the user's account was locked. Used to determine when to automatically unlock the account, if the user's profile has a PASSWORD_LOCK_TIME parameter set.
RESOURCE_POOL VARCHAR The resource pool to which the user is assigned.
MANAGED_BY_OAUTH2_AUTH_ID INTEGER The ID of the OAuth authentication record used to authenticate and provision the user, if any.
LAST_LOGIN_TIME TIMESTAMPTZ

The last time the user logged in.

MEMORY_CAP_KB VARCHAR The maximum amount of memory a query run by the user can consume, in kilobytes.
TEMP_SPACE_CAP_KB VARCHAR The maximum amount of temporary disk space a query run by the user can consume, in kilobytes.
RUN_TIME_CAP VARCHAR The maximum amount of time any of the user's queries are allowed to run.
MAX_CONNECTIONS VARCHAR The maximum number of connections allowed for this user.
CONNECTION_LIMIT_MODE VARCHAR Indicates whether the user sets connection limits through the node or in database mode.
IDLE_SESSION_TIMEOUT VARCHAR

How the user handles idle session timeout limits, one of the following:

  • unlimited: There is no idle session time limit for the user.
  • default: The user's idle session time limit is the value of the DefaultIdleSessionTimeout database parameter, or if that parameter is not set or the user is a superuser, there is no timeout limit. To view the value of DefaultIdleSessionTimeout parameter, use the SHOW DATABASE statement:
    => SHOW DATABASE DEFAULT DEFAULTIDLESESSIONTIMEOUT;
    
  • Interval literal: Interval after which the user's idle session is disconnected.
GRACE_PERIOD VARCHAR Specifies how long a user query can block on any session socket, while awaiting client input or output. If the socket is blocked for a continuous period that exceeds the grace period setting, the server shuts down the socket and throws a fatal error. The session is then terminated.
ALL_ROLES VARCHAR Roles assigned to the user. An asterisk in ALL_ROLES output means role granted WITH ADMIN OPTION. See Database Roles.
DEFAULT_ROLES VARCHAR Default roles assigned to the user. An asterisk in DEFAULT_ROLES output means role granted WITH ADMIN OPTION. See Enabling roles automatically.
SEARCH_PATH VARCHAR Sets the default schema search path for the user. See Setting search paths.
LDAP_DN VARCHAR Indicates whether or not the Vertica Analytic Database user maps to an LDAP Link user. When the column is set to dn, the Vertica user maps to LDAP Link..
LDAP_URI_HASH INTEGER The URI hash number for the LDAP user.
IS_ORPHANED_FROM_LDAP BOOLEAN

Indicates if the user is disconnected (orphaned) from LDAP, set to one of the following:

  • t: User is orphaned

  • f : User is not orphaned

For more information see Troubleshooting LDAP link issues

See also

1.86 - VIEW_COLUMNS

Provides view attribute information.

Provides view attribute information.

Column Name Data Type Description
TABLE_ID INTEGER A unique numeric ID assigned by the Vertica catalog that identifies this view.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, name of the namespace that contains the view.
TABLE_SCHEMA VARCHAR

The name of this view's schema.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_NAME VARCHAR The view name.
COLUMN_ID VARCHAR A unique VARCHAR ID, assigned by the Vertica catalog, that identifies a column in this view.
COLUMN_NAME VARCHAR The name of a column in this view.
DATA_TYPE VARCHAR The data type of a view column.
DATA_TYPE_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies a view column's data type.
DATA_TYPE_LENGTH INTEGER The data type's maximum length.
CHARACTER_MAXIMUM_LENGTH INTEGER The column's maximum length, valid only for character types.
NUMERIC_PRECISION INTEGER The column's number of significant decimal digits.
NUMERIC_SCALE INTEGER The column's number of fractional digits.
DATETIME_PRECISION INTEGER For TIMESTAMP data type, returns the declared precision; returns null if no precision was declared.
INTERVAL_PRECISION INTEGER The number of fractional digits retained in the seconds field.
ORDINAL_POSITION INTEGER The position of the column relative to other columns in the view.

See also

VIEWS

1.87 - VIEW_TABLES

Shows details about view-related dependencies, including the table that reference a view, its schema, and owner.

Shows details about view-related dependencies, including the table that reference a view, its schema, and owner.

Column Name Data Type Description
TABLE_ID INTEGER Catalog-assigned integer value that uniquely identifies theview.
TABLE_SCHEMA VARCHAR Name of the view schema.
TABLE_NAME VARCHAR Name of the view.
REFERENCE_TABLE_ID INTEGER Catalog-assigned integer value that uniquely identifies theview's source table.
REFERENCE_TABLE_SCHEMA VARCHAR Name of the view's source table schema.
REFERENCE_TABLE_NAME VARCHAR Name of the view's source table.
REFERENCE_TABLE_OWNER_ID INTEGER Catalog-assigned integer value that uniquely identifies theview owner.

1.88 - VIEWS

Provides information about all within the system.

Provides information about all views within the system. See Views for more information.

Column Name Data Type Description
TABLE_SCHEMA_ID INTEGER Catalog-assigned integer value that uniquely identifies theview schema.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, namespace that contains the view.
TABLE_SCHEMA VARCHAR

The name of the view schema.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_ID INTEGER Catalog-assigned integer value that uniquely identifies the view.
TABLE_NAME VARCHAR The view name.
OWNER_ID INTEGER Catalog-assigned integer value that uniquely identifies theview owner.
OWNER_NAME VARCHAR View owner's user name
VIEW_DEFINITION VARCHAR The query that defines the view.
IS_SYSTEM_VIEW BOOLEAN Indicates whether the view is a system view.
SYSTEM_VIEW_CREATOR VARCHAR View creator's user name.
CREATE_TIME TIMESTAMP Specifies when this view was created.
IS_LOCAL_TEMP_VIEW BOOLEAN Indicates whether this view is a temporary view stored locally.
INHERIT_PRIVILEGES BOOLEAN Indicates whether inherited privileges are enabled for this view. For details, see Setting privilege inheritance on tables and views.

See also

VIEW_COLUMNS

1.89 - WORKLOAD_ROUTING_RULES

Lists the routing rules that map workloads to a subcluster.

Lists the routing rules that map workloads to subclusters.

Column Name Data Type Description
OID INTEGER The object identifier for the routing rule.
WORKLOAD VARCHAR The name of the workload. When specified by a client (either as a connection property or as a session parameter with SET SESSION WORKLOAD), the client's queries are executed by the subcluster specified by the workload routing rule.
SUBCLUSTER_OID INTEGER The object identifier for the Subcluster.
SUBCLUSTER_NAME VARCHAR The subcluster that contains the Execution node that executes client queries for its associated workload.
PRIORITY INTEGER A non-negative INTEGER, the priority of the workload. The greater the value, the greater the priority. If a user or their role is granted multiple routing rules, the one with the greatest priority applies.

Privileges

Superuser

Examples

The following query shows two rules that define the following behavior:

  • Clients with workload reporting are routed to subcluster default_subcluster.
  • Clients with workload analytics are randomly routed to sc_01 or sc_02.
=> SELECT * FROM v_catalog.workload_routing_rules;

        oid        | workload  |  subcluster_oid   |  subcluster_name   | priority 
-------------------+-----------+-------------------+--------------------+----------
 45035996273850122 | reporting | 45035996273704962 | default_subcluster | 5
 45035996273849658 | analytics | 45035996273849568 | sc_01              | 4
 45035996273849658 | analytics | 45035996273849568 | sc_02              | 0

See also

2 - V_MONITOR schema

The system tables in this section reside in the v_monitor schema.

The system tables in this section reside in the v_monitor schema. These tables provide information about the health of the Vertica database.

2.1 - ACTIVE_EVENTS

Returns all active events in the cluster.

Returns all active events in the cluster. See Monitoring events.

Column Name Data Type Description
NODE_NAME VARCHAR The node name where the event occurred.
EVENT_CODE INTEGER A numeric ID that indicates the type of event. See Event Types for a list of event type codes.
EVENT_ID INTEGER A unique numeric ID assigned by the Vertica catalog, which identifies the specific event.
EVENT_SEVERITY VARCHAR

The severity of the event from highest to lowest. These events are based on standard syslog severity types.

  • 0—Emergency

  • 1—Alert

  • 2—Critical

  • 3—Error

  • 4—Warning

  • 5—Notice

  • 6—Informational

  • 7—Debug

EVENT_POSTED_TIMESTAMP TIMESTAMP The year, month, day, and time the event was reported. The time is posted in military time.
EVENT_EXPIRATION VARCHAR The year, month, day, and time the event expire. The time is posted in military time. If the cause of the event is still active, the event is posted again.
EVENT_CODE_DESCRIPTION VARCHAR A brief description of the event and details pertinent to the specific situation.
EVENT_PROBLEM_DESCRIPTION VARCHAR A generic description of the event.
REPORTING_NODE VARCHAR The name of the node within the cluster that reported the event.
EVENT_SENT_TO_CHANNELS VARCHAR The event logging mechanisms that are configured for Vertica. These can include vertica.log, (configured by default) syslog, and SNMP.
EVENT_POSTED_COUNT INTEGER Tracks the number of times an event occurs. Rather than posting the same event multiple times, Vertica posts the event once and then counts the number of additional instances in which the event occurs.

2.2 - ALLOCATOR_USAGE

Provides real-time information on the allocation and reuse of memory pools for a Vertica node.

Provides real-time information on the allocation and reuse of memory pools for a Vertica node.

There are two memory pools in Vertica, global and SAL. The global memory pool is related to Vertica catalog objects. The SAL memory pool is related to the system storage layer. These memory pools are physical structures from which Vertica allocates and reuses portions of memory.

Within the memory pools, there are two allocation types. Both global and SAL memory pools include chunk and object memory allocation types.

  • Chunk allocations are from tiered storage, and are grouped into sizes, in bytes, that are powers of 2.

  • Object allocations are object types, for example, a table or projection. Each object assumes a set size.

The table provides detailed information on these memory pool allocations.

Column Name Data Type Description
NODE_NAME VARCHAR The name of the node from which Vertica has collected this allocator information.
POOL_NAME VARCHAR

One of two memory pools:

  • global: Memory pool is related to Vertica catalog objects.

  • SAL: Memory pool is related to the system storage layer.

ALLOCATION_TYPE VARCHAR

One of two memory allocation types:

  • chunk: Chunk allocations are grouped into sizes that are powers of 2.

  • object: Object allocations assume a set amount of memory based upon the specific object.

UNIT_SIZE INTEGER

The size, in bytes, of the memory allocation.

For example, if the allocation type is a table (an object type), then Vertica allots 8 bytes.

FREE_COUNT INTEGER

Indicates the count of blocks of freed memory that Vertica has reserved for future memory needs.

For example, if you delete a table, Vertica reserves the 8 bytes originally allotted for the table. The 8 bytes freed become 1 unit of memory that Vertica adds to this column.

FREE_BYTES INTEGER

Indicates the number of freed memory bytes.

For example, with a table deletion, Vertica adds 8 bytes to this column.

USED_COUNT INTEGER

Indicates the count of in-use blocks for this allocation.

For example, if your database includes two table objects, Vertica adds 2 to this column.

USED_BYTES INTEGER

The number of bytes of in-use blocks of memory.

For example, if your database includes two table objects, each of which assume 8 bytes, Vertica adds 16 to this column.

TOTAL_SIZE INTEGER Indicates the number of bytes that is the sum of all free and used memory.
CAPTURE_TIME TIMESTAMPTZ Indicates the current timestamp for when Vertica collected the for this table.
ALLOCATION_NAME VARCHAR

Provides the name of the allocation type.

  • If the allocation is an object type, provides the name of the object. For example, CAT::Schema. Object types can also have the name internal, meaning that the object is an internal data structure.

    Those object types that are not internal are prefaced with either CAT or SAL. Those prefaced with CAT indicate memory from the global memory pool. SAL indicates memory from the system storage memory pool.

  • If the allocation type is chunk, indicates a power of 2 in this field to represent the number of bytes assumed by the chunk. For example, 2^5.

Sample: how memory pool memory is allotted, retained, and freed

The following table shows sample column values based upon a hypothetical example. The sample illustrates how column values change based upon addition or deletion of a table object.

  • When you add a table object (t1), Vertica assumes a UNIT_SIZE of 8 bytes, with a USED_COUNT of 1.

  • When you add a second table object (t2), the USED_COUNT increases to 2. Since each object assumes 8 bytes, USED_BYTES increases to 16.

  • When you delete one of the two table objects, Vertica USED_COUNT decreases to 1, and USED_BYTES decreases to 8. Since Vertica retains the memory for future use, FREE_BYTES increases to 8, and FREE_COUNT increases to 1.

  • Finally, when you create a new table object (t3), Vertica frees the memory for reuse. FREE_COUNT and FREE_BYTES return to 0.

Column Names Add One Table Object (t1) Add a Second Table Object (t2) Delete a Table Object (t2) Create a New Table Object (t3)
NODE_NAME v_vmart_node0001 v_vmart_node0001 v_vmart_node0001 v_vmart_node0001
POOL_NAME global global global global
ALLOCATION_TYPE object object object object
UNIT_SIZE 8 8 8 8
FREE_COUNT 0 0 1 0
FREE_BYTES 0 0 8 0
USED_COUNT 1 2 1 2
USED_BYTES 8 16 8 16
TOTAL_SIZE 8 16 16 16
CAPTURE_TIME 2017-05-24 13:28:07.83855-04 2017-05-24 14:16:04.480953-04 2017-05-24 14:16:32.077322-04 2017-05-24 14:17:07.320745-04
ALLOCATION_NAME CAT::Table CAT::Table CAT::Table CAT::Table

Examples

The following example shows one sample record for a chunk allocation type, and one for an object type.

=> \x
Expanded display is on.


=> select * from allocator_usage;
-[ RECORD 1 ]---+-----------------------------
node_name       | v_vmart_node0004
pool_name       | global
allocation_type | chunk
unit_size       | 8
free_count      | 1069
free_bytes      | 8552
used_count      | 7327
used_bytes      | 58616
total_size      | 67168
capture_time    | 2017-05-24 13:28:07.83855-04
allocation_name | 2^3
.
.
.
-[ RECORD 105 ]-+------------------------------
node_name       | v_vmart_node0004
pool_name       | SAL
allocation_type | object
unit_size       | 128
free_count      | 0
free_bytes      | 0
used_count      | 2
used_bytes      | 256
total_size      | 256
capture_time    | 2017-05-24 14:44:30.153892-04
allocation_name | SAL::WOSAlloc
.
.
.

2.3 - COLUMN_STORAGE

Returns the amount of disk storage used by each column of each projection on each node.

Returns the amount of disk storage used by each column of each projection on each node.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
COLUMN_ID INTEGER Catalog-assigned integer value that uniquely identifies thecolumn.
COLUMN_NAME VARCHAR The column name for which information is listed.
ROW_COUNT INTEGER The number of rows in the column.
USED_BYTES INTEGER The disk storage allocation of the column in bytes.
ENCODINGS VARCHAR The encoding type for the column.
COMPRESSION VARCHAR The compression type for the column. You can compare ENCODINGS and COMPRESSION columns to see how different encoding types affect column storage when optimizing for compression.
ROS_COUNT INTEGER The number of ROS containers.
PROJECTION_ID INTEGER Catalog-assigned numeric value that uniquely identifies the projection.
PROJECTION_NAME VARCHAR The associated projection name for the column.
PROJECTION_SCHEMA VARCHAR The name of the schema associated with the projection.
ANCHOR_TABLE_ID INTEGER Catalog-assigned integer value that uniquely identifies theanchor table.
ANCHOR_TABLE_NAME VARCHAR The associated table name.
ANCHOR_TABLE_SCHEMA VARCHAR

The associated table's schema name.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

ANCHOR_TABLE_NAMESPACE VARCHAR For Eon Mode databases, name of the namespace that contains the table.
ANCHOR_TABLE_COLUMN_ID VARCHAR Catalog-assigned VARCHAR value that uniquely identifies a table column.
ANCHOR_TABLE_COLUMN_NAME VARCHAR The name of the anchor table.

2.4 - COMMUNAL_CLEANUP_RECORDS

This system table lists files that Vertica considers leaked on an Eon Mode communal storage.

Eon Mode only

This system table lists files that Vertica considers leaked on an Eon Mode communal storage. Leaked files are files that are detected as needing deletion but were missed by the normal cleanup mechanisms. This information helps you determine how much space on the communal storage you can reclaim or have reclaimed by cleaning up the leaked files.

Column Name Data Type Description
detection_timestamp TIMESTAMPTZ Timestamp at which the file was detected as leaked.
location_path VARCHAR The path of communal storage location.
file_name VARCHAR The name of the leaked file.
size_in_bytes INTEGER The size of the leaked file in bytes.
queued_for_delete BOOLEAN Specifies whether the file was queued for deletion. Files queued for deletion might not be deleted right away. Also, a subsequent call to clean_communal_storage reports these files as leaked if the files hadn't already been deleted.

Examples

=> SELECT clean_communal_storage('true');
                                                                     clean_communal_storage
----------------------------------------------------------------------------------------------------------------------------------------------
 CLEAN COMMUNAL STORAGE
Total leaked files: 10
Total size: 217088
Files have been queued for deletion.
Check communal_cleanup_records for more information.
(1 row)

=> SELECT * FROM communal_cleanup_records;
      detection_timestamp      | location_path     |                       file_name                       | size_in_bytes | queued_for_delete
-------------------------------+-------------------+-------------------------------------------------------+---------------+-------------------
 2018-05-01 17:01:34.045955-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000003_0.gt |         28672 | t
 2018-05-01 17:01:34.045966-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000006_0.gt |         28672 | t
 2018-05-01 17:01:34.045952-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000001_0.gt |         36864 | t
 2018-05-01 17:01:34.045974-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000008_0.gt |         36864 | t
 2018-05-01 17:01:34.045981-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000002_0.gt |         12288 | t
 2018-05-01 17:01:34.045986-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000007_0.gt |          8192 | t
 2018-05-01 17:01:34.045991-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000010_0.gt |         16384 | t
 2018-05-01 17:01:34.046001-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000005_0.gt |         24576 | t
 2018-05-01 17:01:34.046026-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000009_0.gt |          4096 | t
 2018-05-01 17:01:34.046033-04 | s3://chumbucket/  | 020000000000000000000000000000000000000000000004_0.gt |         20480 | t
(10 rows)

See also

CLEAN_COMMUNAL_STORAGE

2.5 - COMMUNAL_TRUNCATION_STATUS

Stores information on the state of the cluster in the case of a catalog truncation event.

Eon Mode only

Stores information on the state of the cluster in the case of a catalog truncation event.

Column Name Data Type Description
CURRENT_CATALOG_VERSION VARCHAR Current value of the catalog truncation version (CTV).
CLUSTER_TRUNCATION_VERSION VARCHAR The value of the CTV from the cluster_config.json file.

Examples

=> SELECT * FROM COMMUNAL_TRUNCATION_STATUS;
current_catalog_version  | cluster_truncation_version
-------------------------+----------------------------
                    35   |                        35

2.6 - CONFIGURATION_CHANGES

Records the change history of system configuration parameters.

Records the change history of system configuration parameters. This information is useful for identifying:

  • Who changed the configuration parameter value

  • When the configuration parameter was changed

  • Whether nonstandard settings were in effect in the past

Column Name Data Type Description
EVENT_TIMESTAMP TIMESTAMPTZ Time when the row was recorded.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_ID INTEGER Identifier of the user who changed configuration parameters.
USER_NAME VARCHAR Name of the user who changed configuration parameters at the time Vertica recorded the session.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
PARAMETER VARCHAR Name of the changed parameter. See Configuration parameter management for a detailed list of supported parameters.
VALUE VARCHAR New value of the configuration parameter.

Privileges

Superuser

2.7 - CONFIGURATION_PARAMETERS

Provides information about all configuration parameters that are currently in use by the system.

Provides information about all configuration parameters that are currently in use by the system.

Column Name Data Type Description
NODE_NAME VARCHAR

Node names of the database cluster.

ALL indicates that all nodes have the same value.

PARAMETER_NAME VARCHAR The parameter name.
CURRENT_VALUE VARCHAR The parameter's current setting.
RESTART_VALUE VARCHAR The parameter's value after the next restart.
DATABASE_VALUE VARCHAR The value that is set at the database level. If no database-level value is set, the value reflects the default value.
DEFAULT_VALUE VARCHAR The parameter's default value.
CURRENT_LEVEL VARCHAR

Level at which CURRENT_VALUE is set, one of the following:

  • NODE

  • DATABASE

  • SESSION

  • DEFAULT

RESTART_LEVEL VARCHAR

Level at which the parameter will be set after the next restart, one of the following:

  • NODE

  • DATABASE

  • DEFAULT

IS_MISMATCH BOOLEAN Whether CURRENT_VALUE and RESTART_VALUE match.
GROUPS VARCHAR

A group to which the parameter belongs—for example, OptVOptions.

ALLOWED_LEVELS VARCHAR

Levels at which the specified parameter can be set, a comma-delimited list of any of the following values:

  • DATABASE

  • NODE

  • SESSION

  • USER

SUPERUSER_VISIBLE_ONLY BOOLEAN

Whether non-superusers can view all parameter settings. If true, the following columns are masked to non-superusers:

  • CURRENT_VALUE

  • RESTART_VALUE

  • DATABASE_VALUE

  • DEFAULT_VALUE

CHANGE_UNDER_SUPPORT_GUIDANCE BOOLEAN Whether the parameter is intended for use only under guidance from Vertica technical support.
CHANGE_REQUIRES_RESTART BOOLEAN Whether the configuration change requires a restart.
DESCRIPTION VARCHAR Describes the parameter's usage.

Examples

The following example shows a case where the parameter requires a restart for the new setting to take effect:

=> SELECT * FROM CONFIGURATION_PARAMETERS WHERE parameter_name = 'RequireFIPS';
-[ RECORD 1 ]-----------------+----------------------
node_name                     | ALL
parameter_name                | RequireFIPS
current_value                 | 0
restart_value                 | 0
database_value                | 0
default_value                 | 0
current_level                 | DEFAULT
restart_level                 | DEFAULT
is_mismatch                   | f
groups                        |
allowed_levels                | DATABASE
superuser_visible_only        | f
change_under_support_guidance | f
change_requires_restart       | t
description                   | Execute in FIPS mode

The following example shows a case where a non-superuser is viewing a parameter with restricted visibility:

=> \c VMart nonSuperuser
You are now connected to database "VMart" as user "nonSuperuser".
=> SELECT * FROM CONFIGURATION_PARAMETERS WHERE superuser_visible_only = 't';
-[ RECORD 1 ]-----------------+-------------------------------------------------------
node_name                     | ALL
parameter_name                | S3BucketCredentials
current_value                 | ********
restart_value                 | ********
database_value                | ********
default_value                 | ********
current_level                 | DEFAULT
restart_level                 | DEFAULT
is_mismatch                   | f
groups                        |
allowed_levels                | SESSION, DATABASE
superuser_visible_only        | t
change_under_support_guidance | f
change_requires_restart       | f
description                   | JSON list mapping S3 buckets to specific credentials.

See also

Configuration parameter management

2.8 - CPU_USAGE

Records CPU usage history on the system.

Records CPU usage history on the system.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
START_TIME TIMESTAMP Beginning of history interval.
END_TIME TIMESTAMP End of history interval.
AVERAGE_CPU_USAGE_PERCENT FLOAT Average CPU usage in percent of total CPU time (0-100) during history interval.
PHYSICAL_CORES INTEGER Number of physical cores used by the node.

Privileges

Superuser

2.9 - CRITICAL_HOSTS

Lists the critical hosts whose failure would cause the database to become unsafe and force a shutdown.

Lists the critical hosts whose failure would cause the database to become unsafe and force a shutdown.

Column Name Data Type Description
HOST_NAME VARCHAR Name of a critical host

Privileges

None

2.10 - CRITICAL_NODES

Lists the whose failure would cause the database to become unsafe and force a shutdown.

Lists the critical nodes whose failure would cause the database to become unsafe and force a shutdown.

Column Name Data Type Description
NODE_ID INTEGER Catalog-assigned integer value that uniquely identifies thenode.
NODE_NAME VARCHAR Name of a critical node.

2.11 - CRITICAL_SUBCLUSTERS

Lists the primary subclusters whose loss would cause the database to become unsafe and force it to shutdown.

Lists the primary subclusters whose loss would cause the database to become unsafe and force it to shutdown. Vertica checks this table before stopping a subcluster to ensure it will not trigger a database shutdown. If you attempt to stop or remove a subcluster in this table, Vertica returns an error message. See Starting and stopping subclusters for more information.

This table only has contents when the database is in Eon Mode and when one or more subclusters are critical.

Column Name Data Type Description
SUBCLUSTER_OID INTEGER Unique identifier for the subcluster.
SUBCLUSTER_NAME VARCHAR The name of the subcluster in a critical state.

Examples

=> SELECT * FROM critical_subclusters;
  subcluster_oid   |  subcluster_name
-------------------+--------------------
 45035996273704996 | default_subcluster
(1 row)

See also

2.12 - CURRENT_SESSION

Returns information about the current active session.

Returns information about the current active session. Use this table to find out the current session's sessionID and get the duration of the previously-run query.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node for which information is listed
USER_NAME VARCHAR Name used to log into the database, NULL if the session is internal
CLIENT_OS_HOSTNAME VARCHAR The hostname of the client as reported by their operating system.
CLIENT_HOSTNAME VARCHAR

The IP address and port of the TCP socket from which the client connection was made; NULL if the session is internal.

Vertica accepts either IPv4 or IPv6 connections from a client machine. If the client machine contains mappings for both IPv4 and IPv6, the server randomly chooses one IP address family to make a connection. This can cause the CLIENT_HOSTNAME column to display either IPv4 or IPv6 values, based on which address family the server chooses.

TYPE INTEGER

Identifies the session type, one of the following integer values:

  • 1: Client

  • 2: DBD

  • 3: Merge out

  • 4: Move out

  • 5: Rebalance cluster

  • 6: Recovery

  • 7: Refresh

  • 8: Shutdown

  • 9: License audit

  • 10: Timer service

  • 11: Connection

  • 12: VSpread

  • 13: Sub-session

  • 14: Repartition table

CLIENT_PID INTEGER Process identifier of the client process that issued this connection. This process might be on a different machine than the server.
LOGIN_TIMESTAMP TIMESTAMP When the user logged into the database or the internal session was created. This column can help identify open sessions that are idle.
SESSION_ID VARCHAR Identifier required to close or interrupt a session. This identifier is unique within the cluster at any point in time, but can be reused when the session closes.
CLIENT_LABEL VARCHAR User-specified label for the client connection that can be set when using ODBC. See Label in ODBC DSN connection properties.
TRANSACTION_START TIMESTAMP When the current transaction started, NULL if no transaction is running
TRANSACTION_ID VARCHAR Hexadecimal identifier of the current transaction, NULL if no transaction is in progress
TRANSACTION_DESCRIPTION VARCHAR Description of the current transaction
STATEMENT_START TIMESTAMP When the current statement started execution, NULL if no statement is running
STATEMENT_ID VARCHAR Unique numeric ID for the currently-running statement, NULL if no statement is being processed. Combined, TRANSACTION_ID and STATEMENT_ID uniquely identify a statement within a session.
LAST_STATEMENT_DURATION_US INTEGER Duration in microseconds of the last completed statement
CURRENT_STATEMENT VARCHAR The currently-running statement, if any. NULL indicates that no statement is currently being processed.
LAST_STATEMENT VARCHAR NULL if the user has just logged in, otherwise the currently running statement or most recently completed statement.
EXECUTION_ENGINE_PROFILING_CONFIGURATION VARCHAR See Profiling Settings below.
QUERY_PROFILING_CONFIGURATION VARCHAR See Profiling Settings below.
SESSION_PROFILING_CONFIGURATION VARCHAR See Profiling Settings below.
CLIENT_TYPE VARCHAR

Type of client from which the connection was made, one of the following:

  • ADO.NET Driver

  • ODBC Driver

  • JDBC Driver

  • vsql

CLIENT_VERSION VARCHAR Client version
CLIENT_OS VARCHAR Client operating system
CLIENT_OS_USER_NAME VARCHAR Identifies the user that logged into the database, also set for unsuccessful login attempts.
REQUESTED_PROTOCOL VARCHAR Communication protocol version that the ODBC client driver sends to Vertica server, used to support backward compatibility with earlier server versions.
EFFECTIVE_PROTOCOL VARCHAR Minimum protocol version supported by client and driver.

Profiling settings

The following columns show settings for different profiling categories:

  • EXECUTION_ENGINE_PROFILING_CONFIGURATION

  • QUERY_PROFILING_CONFIGURATION

  • SESSION_PROFILING_CONFIGURATION

These can have the following values:

  • Empty: No profiling is set

  • Session: On for current session.

  • Global: On by default for all sessions.

  • >Session, Global: On by default for all sessions, including current session.

For information about controlling profiling settings, see Enabling profiling.

2.13 - DATA_COLLECTOR

Shows settings for all components: their current retention policy properties and other data collection statistics.

Shows settings for all Data collector components: their current retention policy properties and other data collection statistics.

Data Collector is on by default. To turn it off, set configuration parameter EnableDataCollector to 0.

Column Name Data Type Description
NODE_NAME VARCHAR Node name on which data is stored.
COMPONENT VARCHAR Name of the component.
TABLE_NAME VARCHAR The data collector table name for which information is listed.
DESCRIPTION VARCHAR Short description about the component.
ACCESS_RESTRICTED BOOLEAN Indicates whether access to the table is restricted to the DBADMIN, PSEUDOSUPERUSER, or SYSMONITOR roles.
MEMORY_BUFFER_SIZE_KB INTEGER Specifies in kilobytes the maximum amount of data that is buffered in memory before moving it to disk. You can modify this value with SET_DATA_COLLECTOR_POLICY.
DISK_SIZE_KB INTEGER Specifies in kilobytes the maximum disk space allocated for this component's Data Collector table. If set to 0, the Data Collector retains only as much component data as it can buffer in memory, as specified by MEMORY_BUFFER_SIZE_KB. You can modify this value with SET_DATA_COLLECTOR_POLICY.
INTERVAL_SET BOOLEAN Boolean, specifies whether time-based retention is enabled (INTERVAL_TIME is ≥ 0).
INTERVAL_TIME INTERVAL

INTERVAL data type that specifies how long data of a given component is retained in that component's Data Collector table. You can modify this value with SET_DATA_COLLECTOR_POLICY or SET_DATA_COLLECTOR_TIME_POLICY.

For example, if you specify component TupleMoverEvents and set interval-time to an interval of two days ('2 days'::interval), the Data Collector table dc_tuple_mover_events retains records of Tuple Mover activity over the last 48 hours. Older Tuple Mover data are automatically dropped from this table.

RECORD_TOO_BIG_ERRORS INTEGER Integer that increments by one each time an error is thrown because data did not fit in memory (based on the data collector retention policy).
LOST_BUFFERS INTEGER Number of buffers lost.
LOST_RECORDS INTEGER Number of records lost.
RETIRED_FILES INTEGER Number of retired files.
RETIRED_RECORDS INTEGER Number of retired records.
CURRENT_MEMORY_RECORDS INTEGER The current number of rows in memory.
CURRENT_DISK_RECORDS INTEGER The current number of rows stored on disk.
CURRENT_MEMORY_BYTES INTEGER Total current memory used in kilobytes.
CURRENT_DISK_BYTES INTEGER Total current disk space used in kilobytes.
FIRST_TIME TIMESTAMP Timestamp of the first record.
LAST_TIME TIMESTAMP Timestamp of the last record
KB_PER_DAY FLOAT Total kilobytes used per day.

Examples

Get the current status of resource pools:

=> SELECT * FROM data_collector WHERE component = 'ResourcePoolStatus' ORDER BY node_name;
-[ RECORD 1 ]----------+---------------------------------
node_name              | v_vmart_node0001
component              | ResourcePoolStatus
table_name             | dc_resource_pool_status
description            | Resource Pool status information
access_restricted      | t
memory_buffer_size_kb  | 64
disk_size_kb           | 25600
interval_set           | f
interval_time          | 0
record_too_big_errors  | 0
lost_buffers           | 0
lost_records           | 0
retired_files          | 385
retired_records        | 3492335
current_memory_records | 0
current_disk_records   | 30365
current_memory_bytes   | 0
current_disk_bytes     | 21936993
first_time             | 2020-08-14 11:03:28.007894-04
last_time              | 2020-08-14 11:59:41.005675-04
kb_per_day             | 548726.098227313
-[ RECORD 2 ]----------+---------------------------------
node_name              | v_vmart_node0002
component              | ResourcePoolStatus
table_name             | dc_resource_pool_status
description            | Resource Pool status information
access_restricted      | t
memory_buffer_size_kb  | 64
disk_size_kb           | 25600
interval_set           | f
interval_time          | 0
record_too_big_errors  | 0
lost_buffers           | 0
lost_records           | 0
retired_files          | 385
retired_records        | 3492335
current_memory_records | 0
current_disk_records   | 28346
current_memory_bytes   | 0
current_disk_bytes     | 20478345
first_time             | 2020-08-14 11:07:12.006484-04
last_time              | 2020-08-14 11:59:41.004825-04
kb_per_day             | 548675.811828872
-[ RECORD 3 ]----------+---------------------------------
node_name              | v_vmart_node0003
component              | ResourcePoolStatus
table_name             | dc_resource_pool_status
description            | Resource Pool status information
access_restricted      | t
memory_buffer_size_kb  | 64
disk_size_kb           | 25600
interval_set           | f
interval_time          | 0
record_too_big_errors  | 0
lost_buffers           | 0
lost_records           | 0
retired_files          | 385
retired_records        | 3492335
current_memory_records | 0
current_disk_records   | 28337
current_memory_bytes   | 0
current_disk_bytes     | 20471843
first_time             | 2020-08-14 11:07:13.008246-04
last_time              | 2020-08-14 11:59:41.006729-04
kb_per_day             | 548675.63541403

See also

2.14 - DATA_LOADER_EVENTS

Lists events from all data loaders.

Lists load events from all data loaders, including the file path, whether the load succeeded, and how many times it has been retried. You must own or have any privilege (EXECUTE, ALTER, or DROP) on a data loader to see its events in this table.

To prevent unbounded growth, records in this table are purged periodically. You can set the purge frequency for individual data loaders when creating or altering the loader. See CREATE DATA LOADER and ALTER DATA LOADER. The default is 14 days.

For SQS errors that precede data load, such as authorization errors or malformed SQS events, see SQS_LISTENER_ERROR_HISTORY.

Column Name Column Type Description
DATA_LOADER_NAMESPACE VARCHAR For Eon Mode databases, namespace of the data loader that performed this load.
DATA_LOADER_SCHEMA VARCHAR

Schema for the data loader that performed this load.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

DATA_LOADER_NAME VARCHAR Name of the data loader that performed this load.
TIME_STAMP TIMESTAMPTZ Time when Vertica recorded the event.
FILE_NAME VARCHAR Path that was loaded (or attempted).
TRANSACTION_ID VARCHAR Unique identifier for the transaction in which the load occurred.
LOAD_STATUS VARCHAR OK if the load succeeded or FAIL if it did not.
ROWS_LOADED INTEGER If a single file was loaded, the number of rows. If more than one file was loaded in a single batch, this value is null. For batch loads, FILE_SIZE_BYTES can be helpful in place of row counts.
FAILURE_REASON VARCHAR If the load failed, an explanatory message.
RETRY_ATTEMPT INTEGER 0 if this was the first attempt to load the file, otherwise the number of retries including this one.
FILE_SIZE_BYTES INTEGER File size in bytes when the data loader was executed.
BATCH_ID INTEGER Identifier, unique within the transaction, for the batch this file was part of. If a file was loaded individually, this value is null.

2.15 - DATA_LOADERS

Lists all defined data loaders.

Lists all defined data loaders.

Column Name Column Type Description
NAME VARCHAR Loader name.
NAMESPACENAME VARCHAR For Eon Mode databases, namespace in which the loader is defined.
SCHEMANAME VARCHAR

Schema in which the loader is defined.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

OWNER VARCHAR Vertica user who created the loader.
COPYSTMT VARCHAR COPY statement used by this loader.
RETRYLIMIT INT Number of times to retry a failed file load. For loaders that do not specify an explicit value, this value is updated if the value of the DataLoaderDefaultRetryLimit configuration parameter changes.
HISTORYRETENTIONINTERVAL INTERVAL How long to wait before purging rows in the loader's monitoring table. See CREATE DATA LOADER.
ENABLED BOOLEAN Whether the data loader is enabled. EXECUTE DATA LOADER does not run a disabled data loader.
TRIGGER VARCHAR External trigger for this data loader, if any.

Examples

=> SELECT * FROM DATA_LOADERS;
 name | schemaname |  owner  |             copystmt              | retrylimit | historyretentioninterval | enabled | trigger
------+------------+---------+-----------------------------------+------------+---------------------------|--------+---------
 dl   | public     | dbadmin | copy sales from 's3://data/*.dat' |          3 | 14 days                   |      t |
(1 row)

2.16 - DATA_READS

Lists each storage location that a query reads in Eon Mode.

Eon Mode only

Lists each storage location that a query reads in Eon Mode. If the query fetches data from multiple locations, this table provides a row for each location per node that read data. For example, a query might run on three nodes and fetch data from the depot and communal storage. In this case, the table displays six rows for the query: three rows for each node's depot read, and three for each node's communal storage read.

Column Name Column Type Description
START_TIME TIMESTAMP When Vertica started reading data from the location.
NODE_NAME VARCHAR Name of the node that fetched the data
SESSION_ID VARCHAR Unique numeric ID assigned by the Vertica catalog, which identifies the session for which profiling information is captured. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INT Unique numeric ID assigned by the Vertica catalog, which identifies the user.
USER_NAME VARCHAR Name of the user running the query.
TRANSACTION_ID INT Identifier for the transaction within the session, if any. If a session is active but no transaction has begun, TRANSACTION_ID returns NULL.
STATEMENT_ID INT Unique numeric ID for the statement that read the data. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID and STATEMENT_ID uniquely identifies a statement within a session; these columns are useful for creating joins with other system tables.
REQUEST_ID INT ID of the data request.
LOCATION_ID INT ID of the storage location read.
LOCATION_PATH VARCHAR Path of the storage container read by the query.
BYTES_READ INT Number of bytes read by the query from this location.

Examples

=> SELECT * FROM V_MONITOR.DATA_READS WHERE TRANSACTION_ID = 45035996273707457;
-[ RECORD 1 ]--+---------------------------------------------------
start_time     | 2019-02-13 19:43:43.840836+00
node_name      | v_verticadb_node0001
session_id     | v_verticadb_node0001-11828:0x6f3
user_id        | 45035996273704962
user_name      | dbadmin
transaction_id | 45035996273707457
statement_id   | 1
request_id     | 230
location_id    | 45035996273835000
location_path  | /vertica/data/verticadb/v_verticadb_node0001_depot
bytes_read     | 329460142
-[ RECORD 2 ]--+---------------------------------------------------
start_time     | 2019-02-13 19:43:43.8421+00
node_name      | v_verticadb_node0002
session_id     | v_verticadb_node0001-11828:0x6f3
user_id        | 45035996273704962
user_name      | dbadmin
transaction_id | 45035996273707457
statement_id   | 1
request_id     | 0
location_id    | 45035996273835002
location_path  | /vertica/data/verticadb/v_verticadb_node0002_depot
bytes_read     | 329473033
-[ RECORD 3 ]--+---------------------------------------------------
start_time     | 2019-02-13 19:43:43.841845+00
node_name      | v_verticadb_node0003
session_id     | v_verticadb_node0001-11828:0x6f3
user_id        | 45035996273704962
user_name      | dbadmin
transaction_id | 45035996273707457
statement_id   | 1
request_id     | 0
location_id    | 45035996273835004
location_path  | /vertica/data/verticadb/v_verticadb_node0003_depot
bytes_read     | 329677294

2.17 - DATABASE_BACKUPS

Lists historical information for each backup that successfully completed after running the vbr utility.

Lists historical information for each backup that successfully completed after running the vbr utility. This information is useful for determining whether to create a new backup before you advance the AHM. Because this system table displays historical information, its contents do not always reflect the current state of a backup repository. For example, if you delete a backup from a repository, the DATABASE_BACKUPS system table continues to display information about it.

To list existing backups, run vbr as described in Viewing backups.

Column Name Data Type Description
BACKUP_TIMESTAMP TIMESTAMP The timestamp of the backup.
NODE_NAME VARCHAR The name of the initiator node that performed the backup.
SNAPSHOT_NAME VARCHAR The name of the backup, as specified in the snapshotName parameter of the vbr configuration file.
BACKUP_EPOCH INTEGER The database epoch at which the backup was saved.
NODE_COUNT INTEGER The number of nodes backed up in the completed backup, and as listed in the [Mappingn] sections of the configuration file.
OBJECTS VARCHAR The name of the object(s) contained in an object-level backup. This column is empty if the record is for a full cluster backup.
FILE_SYSTEM_TYPE VARCHAR The type of file system, such as Linux.

Privileges

Superuser

2.18 - DATABASE_CONNECTIONS

Lists the connections to other databases for importing and exporting data.

Lists the connections to other databases for importing and exporting data. See Moving Data Between Vertica Databases.

Column Name Data Type Description
DATABASE VARCHAR The name of the connected database
USERNAME VARCHAR The username used to create the connection
HOST VARCHAR The host name used to create the connection
PORT VARCHAR The port number used to create the connection
ISVALID BOOLEAN Whether the connection is still open and usable or not

Examples

=> CONNECT TO VERTICA vmart USER dbadmin PASSWORD '' ON '10.10.20.150',5433;
CONNECT
=> SELECT * FROM DATABASE_CONNECTIONS;
 database | username |     host     | port | isvalid
----------+----------+--------------+------+---------
 vmart    | dbadmin  | 10.10.20.150 | 5433 | t
(1 row)

2.19 - DATABASE_MIGRATION_STATUS

Provides real-time and historical data on Enterprise-to- database migration attempts.

Provides real-time and historical data on Enterprise-to-Eon database migration attempts.

Column Name Data Type Description
NODE_NAME VARCHAR Name of a node in the source Enterprise database.
TRANSACTION_ID VARCHAR Hexadecimal identifier of the migration process transaction.
PHASE VARCHAR

A stage of database migration on a given node, one of the following, listed in order of execution:

  • Catalog Conversion: Conversion of enterprise-mode catalog to Eon-compatible catalog.
  • Data Transfer: Transfer of data files and library files to communal storage

  • Catalog Transfer: Includes transfer of checkpoint and transaction log files.

STATUS VARCHAR

Specifies status of a given phase, one of the following:

  • RUNNING

  • COMPLETED

  • ABORT

ABORT indicates a given migration phase was unable to complete—for example, the client disconnected, or a network outage occurred—and the migration returned with an error. In this case, call MIGRATE_ENTERPRISE_TO_EON again to restart migration. For details, see Handling Interrupted Migration.

BYTES_TO_TRANSFER INTEGER

For each migration phase, the size of data to transfer to communal storage, set when phase status is RUNNING:

  • Catalog Conversion: 0

  • Data Transfer: Size of data files and library files

  • Catalog Transfer: Size of transaction logs

BYTES_TRANSFERRED INTEGER

For each migration phase, the size of data transfered to communal storage. This value is updated while phase status is RUNNING, and set to the total number of bytes transferred when status is COMPLETED:

  • Catalog Conversion: 0

  • Data Transfer: Size of data files and library files

  • Catalog Transfer: Size of transaction logs

COMMUNAL_STORAGE_LOCATION VARCHAR URL of targeted communal storage location
START_TIME
TIMESTAMP Demarcate the start and end of each PHASE-specified migration operation.
END_TIME

Privileges

Superuser

Examples

The following example shows data of a migration that is in progress:

=> SELECT node_name, phase, status, bytes_to_transfer, bytes_transferred, communal_storage_location FROM database_migration_status ORDER BY node_name, start_time;
     node_name    |       phase        |  status   | bytes_to_transfer | bytes_transferred | communal_storage_location
------------------+--------------------+-----------+-------------------+------------------+---------------------------
 v_vmart_node0001 | Catalog Conversion | COMPLETED |                 0 |                0 | s3://verticadbbucket/
 v_vmart_node0001 | Data Transfer      | COMPLETED |              1134 |             1134 | s3://verticadbbucket/
 v_vmart_node0001 | Catalog Transfer   | COMPLETED |              3765 |             3765 | s3://verticadbbucket/
 v_vmart_node0002 | Catalog Conversion | COMPLETED |                 0 |                0 | s3://verticadbbucket/
 v_vmart_node0002 | Data Transfer      | COMPLETED |              1140 |             1140 | s3://verticadbbucket/
 v_vmart_node0002 | Catalog Transfer   | COMPLETED |              3766 |             3766 | s3://verticadbbucket/
 v_vmart_node0003 | Catalog Conversion | COMPLETED |                 0 |                0 | s3://verticadbbucket/
 v_vmart_node0003 | Data Transfer      | RUNNING   |           5272616 |           183955 | s3://verticadbbucket/

2.20 - DELETE_VECTORS

Holds information on deleted rows to speed up the delete process.

Holds information on deleted rows to speed up the delete process.

Column Name Data Type Description
NODE_NAME VARCHAR The name of the node storing the deleted rows.
NAMESPACE_NAME VARCHAR For Eon Mode databases, namespace where the deleted rows are located.
SCHEMA_NAME VARCHAR

The name of the schema where the deleted rows are located.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

PROJECTION_NAME VARCHAR The name of the projection where the deleted rows are located.
DV_OID INTEGER The unique numeric ID (OID) that identifies this delete vector.
STORAGE_OID INTEGER The unique numeric ID (OID) that identifies the storage container that holds the delete vector.
SAL_STORAGE_ID VARCHAR Unique hexadecimal numeric ID assigned by the Vertica catalog, which identifies the storage.
DELETED_ROW_COUNT INTEGER The number of rows deleted.
USED_BYTES INTEGER The number of bytes used to store the deletion.
START_EPOCH INTEGER The start epoch of the data in the delete vector.
END_EPOCH INTEGER The end epoch of the data in the delete vector.

Examples

After you delete data from a Vertica table, that data is marked for deletion. To see the data that is marked for deletion, query the DELETE_VECTORS system table.

Run PURGE to remove the delete vectors from ROS containers.

=> SELECT * FROM test1;
 number
--------
      3
     12
     33
     87
     43
     99
(6 rows)
=> DELETE FROM test1 WHERE number > 50;
 OUTPUT
--------
      2
(1 row)
=> SELECT * FROM test1;
 number
--------
     43
      3
     12
     33
(4 rows)
=> SELECT node_name, projection_name, deleted_row_count FROM DELETE_VECTORS;
    node_name     | projection_name | deleted_row_count
------------------+-----------------+-------------------
 v_vmart_node0002 | test1_b1        |                 1
 v_vmart_node0001 | test1_b1        |                 1
 v_vmart_node0001 | test1_b0        |                 1
 v_vmart_node0003 | test1_b0        |                 1
(4 rows)
=> SELECT PURGE();
...
(Table: public.test1) (Projection: public.test1_b0)
(Table: public.test1) (Projection: public.test1_b1)
...
(4 rows)

After the ancient history mark (AHM) advances:

=> SELECT * FROM DELETE_VECTORS;
 (No rows)

See also

2.21 - DEPLOY_STATUS

Records the history of deployed Database Designer designs and their deployment steps.

Records the history of deployed Database Designer designs and their deployment steps.

Column Name Data Type Description
EVENT_TIME TIMESTAMP Time when the row recorded the event.
USER_NAME VARCHAR Name of the user who deployed a design at the time Vertica recorded the session.
DEPLOY_NAME VARCHAR Name the deployment, same as the user-specified design name.
DEPLOY_STEP VARCHAR Steps in the design deployment.
DEPLOY_STEP_STATUS VARCHAR Textual status description of the current step in the deploy process.
DEPLOY_STEP_COMPLETE_PERCENT FLOAT Progress of current step in percentage (0–100).
DEPLOY_COMPLETE_PERCENT FLOAT Progress of overall deployment in percentage (0–100).
ERROR_MESSAGE VARCHAR Error or warning message during deployment.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.22 - DEPLOYMENT_PROJECTION_STATEMENTS

Contains information about CREATE PROJECTION statements used to deploy a database design.

Contains information about CREATE PROJECTION statements used to deploy a database design. Each row contains information about a different CREATE PROJECTION statement. The function DESIGNER_RUN_POPULATE_DESIGN_AND_DEPLOY populates this table.

Column Name Column Type Description
DEPLOYMENT_ID INTEGER Unique ID that Database Designer assigned to the deployment.
DESIGN_NAME VARCHAR Unique name that the user assigned to the design.
DEPLOYMENT_PROJECTION_ID INTEGER Unique ID assigned to the output projection by Database Designer.
STATEMENT_ID INTEGER Unique ID assigned to the statement type that creates the projection.
STATEMENT VARCHAR Text for the statement that creates the projection.

2.23 - DEPLOYMENT_PROJECTIONS

Contains information about projections created and dropped during the design.

Contains information about projections created and dropped during the design. Each row contains information about a different projection. Database Designer populates this table after the design is deployed.

Column Name Column Type Description
deployment_id INTEGER Unique ID that Database Designer assigned to the deployment.
deployment_projection_id INTEGER Unique ID that Database Designer assigned to the output projection.
design_name VARCHAR Name of the design being deployed.
deployment_projection_name VARCHAR Name that Database Designer assigned to the projection.
anchor_table_schema VARCHAR

Name of the schema that contains the table the projection is based on.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

anchor_table_name VARCHAR Name of the table the projection is based on.
deployment_operation VARCHAR Action being taken on the projection, for example, add or drop.
deployment_projection_type VARCHAR

Indicates whether Database Designer has proposed new projections for this design (DBD) or is using the existing catalog design (CATALOG). The REENCODED suffix indicates that the projection sort order and segmentation are the same, but the projection columns have new encodings:

  • DBD

  • CATALOG

  • DBD_REENCODED

  • CATALOG_REENCODED

deploy_weight INTEGER Weight of this projection in creating the design. This field is always 0 for projections that have been dropped.
estimated_size_on_disk INTEGER Approximate size of the projection on disk, in MB.

2.24 - DEPOT_EVICTIONS

Records data on eviction of objects from the depot.

Eon Mode only

Records data on eviction of objects from the depot.

Column Name Data Type Description
START_TIME TIMESTAMP Demarcate the start and end of each depot eviction operation.
END_TIME
NODE_NAME VARCHAR Name of a node where the eviction occurred.
SESSION_ID VARCHAR Unique numeric ID assigned by the Vertica catalog, which identifies the session for which profiling information is captured. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the user.
USER_NAME VARCHAR The user who made changes to the depot.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any. If a session is active but no transaction has begun, TRANSACTION_ID returns NULL.
STATEMENT_ID INTEGER Unique numeric ID for the statement that caused the eviction. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID and STATEMENT_ID uniquely identifies a statement within a session; these columns are useful for creating joins with other system tables.
REQUEST_ID INTEGER Unique identifier of the query request in the user session.
STORAGE_ID VARCHAR Unique hexadecimal numeric ID assigned by the Vertica catalog, which identifies the storage.
STORAGE_OID INTEGER Numeric ID assigned by the Vertica catalog, which identifies the storage.
FILE_SIZE_BYTES INTEGER The size of the file in bytes that was evicted.
NUMBER_HITS INTEGER The number of times the file was accessed.
LAST_ACCESS_TIME TIMESTAMP The last time the file was read.
REASON VARCHAR

The reason the file was evicted, one of the following:

  • CLEAR DEPOT

  • DEPOT FILL AT STARTUP

  • DEPOT SIZE CHANGE

  • DROP OBJECT

  • DROP SUBSCRIPTION

  • EVICTION DUE TO NEW

  • LOAD

  • PEER TO PEER FILL

  • QUERY

IS_PINNED BOOLEAN Whether the object has a pinning policy.
IS_ANTI_PINNED BOOLEAN Whether the object has an anti-pinning policy.

Examples

=> SELECT * FROM V_MONITOR.DEPOT_EVICTIONS LIMIT 2;
-[ RECORD 1 ]----+-------------------------------------------------
start_time       | 2019-02-20 15:32:26.765937+00
end_time         | 2019-02-20 15:32:26.766019+00
node_name        | v_verticadb_node0001
session_id       | v_verticadb_node0001-8997:0x3e
user_id          | 45035996273704962
user_name        | dbadmin
transaction_id   | 45035996273705450
statement_id     | 1
request_id       | 406
storage_id       | 0000000000000000000000000000000000a000000001fbf6
storage_oid      | 45035996273842065
file_size_bytes  | 61
number_hits      | 1
last_access_time | 2019-02-20 15:32:26.668094+00
reason           | DROP OBJECT
is_pinned        | f
-[ RECORD 2 ]----+-------------------------------------------------
start_time       | 2019-02-20 15:32:26.812803+00
end_time         | 2019-02-20 15:32:26.812866+00
node_name        | v_verticadb_node0001
session_id       | v_verticadb_node0001-8997:0x3e
user_id          | 45035996273704962
user_name        | dbadmin
transaction_id   | 45035996273705453
statement_id     | 1
request_id       | 409
storage_id       | 0000000000000000000000000000000000a000000001fbf6
storage_oid      | 45035996273842079
file_size_bytes  | 91
number_hits      | 1
last_access_time | 2019-02-20 15:32:26.770807+00
reason           | DROP OBJECT
is_pinned        | f

2.25 - DEPOT_FETCH_QUEUE

Lists all pending depot requests for queried file data to fetch from communal storage.

Eon Mode only

Lists all pending depot requests for queried file data to fetch from communal storage.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that requested the fetch.
SAL_STORAGE_ID VARCHAR Unique hexadecimal numeric ID assigned by the Vertica catalog, which identifies the storage.
TRANSACTION_ID INTEGER Identifies the transaction that contains the fetch-triggering query.
SOURCE_FILE_NAME VARCHAR Full path in communal storage of the file to fetch.
DESTINATION_FILE_NAME VARCHAR Destination path of the file to fetch.

Examples

=> \x
Expanded display is on.
=> SELECT * FROM depot_fetch_queue;
-[ RECORD 1 ]----------+-------------------------------------------------------------
node_name              | v_example_db_node0002
sal_storage_id         | 029b6fac864e1982531dcde47d00edc500d000000001d5e7
transaction_id         | 45035996273705983
source_file_name       | s3://mydata/mydb/14a/029b6fac864e1982531dcde47d00edc500d000
                              000001d5e7_0.gt
destination_file_name  | /vertica/example_db/v_example_db_node0002_depot/747/029b6fac
                              864e1982531dcde47d00edc500d000000001d5eb_0.gt
-[ RECORD 2 ]----------+-------------------------------------------------------------
node_name              | v_example_db_node0003
sal_storage_id         | 026635d69719c45e8d2d86f5a4d62c7b00b000000001d5e7
transaction_id         | 45035996273705983
source_file_name       | s3://mydata/mydb/4a5/029b6fac864e1982531dcde47d00edc500d0000
                              00001d5eb_0.gt
destination_file_name  | /vertica/example_db/v_example_db_node0002_depot/751/026635d6
                              9719c45e8d2d86f5a4d62c7b00b000000001d5e7_0.gt

2.26 - DEPOT_FETCHES

Records data of depot fetch requests.

Eon Mode only

Records data of depot fetch requests.

Column Name Data Type Description
START_TIME TIMESTAMP Demarcate the start and end of each depot fetch operation.
END_TIME
NODE_NAME VARCHAR Identifies the node that initiated fetch request.
TRANSACTION_ID INTEGER Uniquely identifies the transaction of the query that required the fetched file.
STORAGE_ID VARCHAR Unique hexadecimal numeric ID assigned by the Vertica catalog, to identify the storage.
STORAGE_OID INTEGER Numeric ID assigned by the Vertica catalog, which identifies the storage.
FILE_SIZE_BYTES INTEGER Fetch size in bytes.
SOURCE_FILE VARCHAR Source file path used, set to null if the file was fetched from a peer.
DESTINATION_FILE VARCHAR Destination file path
SOURCE_NODE VARCHAR

Source node from which the file was fetched, set to one of the following:

  • Name of the source node if file was fetched from a peer

  • Null if file was fetched from communal storage

IS_SUCCESSFUL BOOLEAN Boolean, specifies whether this fetch succeeded.
REASON VARCHAR Reason why the fetch failed, null if IS_SUCCESSFUL is true.

Examples

=> \x
Expanded display is on.

=> SELECT * FROM DEPOT_FETCHES LIMIT 2;
-[ RECORD 1 ]----+-------------------------------------------------------------
start_time       | 2019-08-30 15:16:15.125962+00
end_time         | 2019-08-30 15:16:15.126791+00
node_name        | v_verticadb_node0001
transaction_id   | 45035996273706225
storage_id       | 0239ef74126e70db410b301610f1e5b500b0000000020d65
storage_oid      | 45035996273842065
file_size_bytes  | 53033
source_file      |
destination_file | /vertica/data/verticadb/v_verticadb_node0001_depot/957/0239e
                     f74126e70db410b301610f1e5b500b0000000020d65_0.gt
source_node      | v_verticadb_node0002
is_successful    | t
reason           |
-[ RECORD 2 ]----+-------------------------------------------------------------
start_time       | 2019-08-30 15:16:15.285208+00
end_time         | 2019-08-30 15:16:15.285949+00
node_name        | v_verticadb_node0001
transaction_id   | 45035996273706234
storage_id       | 0239ef74126e70db410b301610f1e5b500b0000000020dc7
storage_oid      | 45035996273842075
file_size_bytes  | 69640
source_file      |
destination_file | /vertica/data/verticadb/v_verticadb_node0001_depot/055/0239e
                     f74126e70db410b301610f1e5b500b0000000020dc7_0.gt
source_node      | v_verticadb_node0002
is_successful    | t
reason           |

=> select node_name,transaction_id,storage_id,is_successful,reason FROM
   depot_fetches WHERE is_successful = 'f' LIMIT 3;
-[ RECORD 1 ]--+-------------------------------------------------
node_name      | v_verticadb_node0001
transaction_id | 45035996273721070
storage_id     | 0289281ac4c1f6580b95096fab25290800b0000000027d09
is_successful  | f
reason         | Could not create space in the depot
-[ RECORD 2 ]--+-------------------------------------------------
node_name      | v_verticadb_node0001
transaction_id | 45035996273721070
storage_id     | 0289281ac4c1f6580b95096fab25290800b0000000027d15
is_successful  | f
reason         | Could not create space in the depot
-[ RECORD 3 ]--+-------------------------------------------------
node_name      | v_verticadb_node0002
transaction_id | 45035996273721070
storage_id     | 02693f1c68266e38461084a840ee42aa00c0000000027d09
is_successful  | f
reason         | Could not create space in the depot

2.27 - DEPOT_FILES

Lists objects that are currently cached in the database depots.

Eon Mode only

Lists objects that are currently cached in the database depots.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the depot node.
SAL_STORAGE_ID VARCHAR Unique hexadecimal numeric ID assigned by the Vertica catalog, which identifies the storage.
STORAGE_OID INTEGER Numeric ID assigned by the Vertica catalog, which identifies the storage.
COMMUNAL_FILE_PATH VARCHAR Communal storage path to the file. On AWS, this is an S3 URI.
DEPOT_FILE_PATH VARCHAR Depot path to the file.
SHARD_NAME VARCHAR Name of the shard this file is a part of.
STORAGE_TYPE VARCHAR Type of system storing this file.
NUMBER_OF_ACCESSES INTEGER Number of times this file has been accessed.
FILE_SIZE_BYTES INTEGER How large the file is in bytes.
LAST_ACCESS_TIME TIMESTAMPTZ When the file was last accessed.
ARRIVAL_TIME TIMESTAMPTZ When Vertica loaded the file into the depot.
SOURCE VARCHAR

How the data came to be cached, one of the following:

  • LOAD

  • QUERY

  • PEER TO PEER FILL

  • DEPOT FILL AT STARTUP

IS_PINNED BOOLEAN Whether a pinning policy is set on the cached data.
IS_ANTI_PINNED BOOLEAN Whether an anti-pinning policy is set on the cached data.

Examples

=> \x
Expanded display is on.
=> SELECT * FROM depot_files LIMIT 2;

-[ RECORD 1 ]------+---------------------------------------------------------------
node_name          | v_verticadb_node0001
sal_storage_id     | 0275d4a7c99795d22948605e5940758900a000000001d1b1
storage_oid        | 45035996273842075
communal_file_path | s3://mybucket/myfolder/mydb/475/0275d4a7c99795d22948605e5940758900a000000001d1
b1/0275d4a7c99795d22948605e5940758900a000000001d1b1_
depot_file_path    | /vertica/data/verticadb/v_verticadb_node0001_depot/177/0275d4a7c99795d229486
05e5940758900a000000001d1b1/0275d4a7c99795d22948605e
shard_name         | replica
storage_type       | DFS
number_of_accesses | 0
file_size_bytes    | 456465645
last_access_time   | 2018-09-05 17:34:30.417274+00
arrival_time       | 2018-09-05 17:34:30.417274+00
source             | DEPOT FILL AT STARTUP
is_pinned          | f
-[ RECORD 2 ]------+---------------------------------------------------------------
node_name          | v_verticadb_node0001
sal_storage_id     | 0275d4a7c99795d22948605e5940758900a000000001d187
storage_oid        | 45035996273842079
communal_file_path | s3://mybucket/myfolder/mydb/664/0275d4a7c99795d22948605e5940758900a000000001d1
87/0275d4a7c99795d22948605e5940758900a000000001d187_
depot_file_path    | /vertica/data/verticadb/v_verticadb_node0001_depot/135/0275d4a7c99795d229486
05e5940758900a000000001d187/0275d4a7c99795d22948605e
shard_name         | replica
storage_type       | DFS
number_of_accesses | 0
file_size_bytes    | 40
last_access_time   | 2018-09-05 17:34:30.417244+00
arrival_time       | 2018-09-05 17:34:30.417244+00
source             | DEPOT FILL AT STARTUP
is_pinned          | f

2.28 - DEPOT_PIN_POLICIES

Lists all objects —tables, projections, and table partitions—with depot eviction policies.

Eon Mode only

Lists all objects —tables, projections, and table partitions—with depot eviction policies.

Column Name Data Type Description
NAMPESPACE_NAME VARCHAR For Eon Mode databases, object namespace.
SCHEMA_NAME VARCHAR

Object schema.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

OBJECT_NAME VARCHAR Object name.
SUBCLUSTER_NAME VARCHAR Name of the subcluster where the pinning policy is set, null if the policy is set on all database depots.
POLICY_DETAILS VARCHAR

Object type, one of the following:

  • Table

  • Projection

  • Partition

MIN_VAL VARCHAR If POLICY_DETAILS is set to Partition, the range of contiguous partition keys specified by this policy.
MAX_VAL
LOCATION_LABEL VARCHAR Depot's storage location label.
POLICY_TYPE VARCHAR Policy type set on this object (PIN or ANTI-PIN), if any.

2.29 - DEPOT_SIZES

Reports depot caching capacity on Vertica nodes.

Eon Mode only

Reports depot caching capacity on Vertica nodes.

Column Name Data Type Description
NODE_NAME VARCHAR The name of the node containing the depot.
LOCATION_OID INTEGER Catalog-assigned integer value that uniquely identifies the storage location storing the depot.
LOCATION_PATH VARCHAR The path where the depot is stored.
LOCATION_LABEL VARCHAR The label associated with the depot's storage location.
MAX_SIZE_BYTES INTEGER The maximum size the depot can contain, in bytes.
CURRENT_USAGE_BYTES INTEGER The current size of the depot, in bytes.

Examples

=> \x
Expanded display is on.
=> SELECT * FROM Depot_Sizes;

-[ RECORD 1 ]-------+---------------------------------------------------

node_name           | v_verticadb_node0003
location_oid        | 45035996273823200
location_path       | /vertica/data/verticadb/v_verticadb_node0003_depot
location_label      | auto-data-depot
max_size_bytes      | 0
current_usage_bytes | 0

-[ RECORD 2 ]-------+---------------------------------------------------
node_name           | v_verticadb_node0001
location_oid        | 45035996273823196
location_path       | /vertica/data/verticadb/v_verticadb_node0001_depot
location_label      | auto-data-depot
max_size_bytes      | 33686316032
current_usage_bytes | 206801871

-[ RECORD 3 ]-------+---------------------------------------------------
node_name           | v_verticadb_node0002
location_oid        | 45035996273823198
location_path       | /vertica/data/verticadb/v_verticadb_node0002_depot
location_label      | auto-data-depot
max_size_bytes      | 0
current_usage_bytes | 0

2.30 - DEPOT_UPLOADS

Lists details about depot uploads to communal storage.

Eon Mode only

Lists details about depot uploads to communal storage.

Column Name Data Type Description
NODE_NAME VARCHAR The name of the node on which the depot resides.
PLAN_ID VARCHAR A unique node-specific numeric ID for each plan run by the Optimizer.
SUBMIT_TIME TIMESTAMP The time the task was submitted to the uploader.
START_TIME TIMESTAMP The time the upload started.
END_TIME TIMESTAMP The time the upload ended.
SOURCE_FILE VARCHAR The source file path used.
DESTINATION_FILE VARCHAR The destination file path.
FILE_SIZE_BYTES INTEGER The size of the uploaded file, in bytes.
MEMORY_USED_KB INTEGER

The size of the uploader file buffer for the task.

Valid for a task with a RUNNING or COMPLETED status. For a RUNNING status, this shows the current file buffer size, (whatever the uploader is using, which may grow over time for large uploads).

For a COMPLETED status, this shows the largest size used in case the buffer grew during the upload.

STATUS VARCHAR

The status of the task, valid values are:

COMPLETED - the task has completed

QUEUED - the task is still in the queue, but haven't been picked up by the uploader.

RUNNING - the task is currently running and the corresponding file is uploading.

2.31 - DESIGN_QUERIES

Contains info about design queries for a given design.

Contains info about design queries for a given design. The following functions populate this table:

Column Name Column Type Description
DESIGN_ID INTEGER Unique id that Database Designer assigned to the design.
DESIGN_NAME VARCHAR Name that you specified for the design.
DESIGN_QUERY_ID INTEGER Unique id that Database Designer assigned to the design query.
DESIGN_QUERY_ID_INDEX INTEGER Database Designer chunks the query text if it exceeds the maximum attribute size before storing it in this table. Database Designer stored all chunks stored under the same value of DESIGN_QUERY_ID. DESIGN_QUERY_ID_INDEX keeps track of the order of the chunks, starting with 0 and ending in n, the index of the final chunk.
QUERY_TEXT VARCHAR Text of the query chunk, or the entire query text if it does not exceed the maximum attribute size.
WEIGHT FLOAT A value from 0 to 1 that indicates the importance of that query in creating the design. Assign a higher weight to queries that you run frequently so that Database Designer prioritizes those queries in creating the design. Default: 1.
DESIGN_QUERY_SEARCH_PATH VARCHAR The search path with which the query is to be parsed.
DESIGN_QUERY_SIGNATURE INTEGER Categorizes queries that affect the design that Database Designer creates in the same way. Database Designer assigns a signature to each query, weights one query for each signature group, depending on how many queries there are with that signature, and Database Designer considers that query when creating the design.

Example

Add queries to VMART_DESIGN and query the DESIGN_QUERIES table:


=> SELECT DESIGNER_ADD_DESIGN_QUERIES('VMART_DESIGN', '/tmp/examples/vmart_queries.sql','true');
 DESIGNER_ADD_DESIGN_QUERIES
-----------------------------
Number of accepted queries                      =9
Number of queries referencing non-design tables =0
Number of unsupported queries                   =0
Number of illegal queries                       =0
=> \x
Expanded display is on.
=> SELECT * FROM V_MONITOR.DESIGN.QUERIES
-[ RECORD 1 ]------------+-------------------
design_id                | 45035996273705090
design_name              | vmart_design
design_query_id          | 1
design_query_id_index    | 0
query_text               | SELECT fat_content
FROM (
SELECT DISTINCT fat_content
  FROM product_dimension
  WHERE department_description
  IN ('Dairy') ) AS food
  ORDER BY fat_content
  LIMIT 5;
weight                   | 1
design_query_search_path | v_dbd_vmart_design_vmart_design_ltt, "$user", public, v_catalog, v_monitor, v_internal
design_query_signature   | 45035996273724651

-[ RECORD 2]-------------+-------------------
design_query_id          | 2
design_query_id_index    | 0
query_text               | SELECT order_number, date_ordered
        FROM store.store_orders_fact orders
        WHERE orders.store_key IN (
        SELECT store_key
        FROM store.store_dimension
        WHERE store_state = 'MA')
        AND orders.vendor_key NOT IN (
        SELECT vendor_key
        FROM public.vendor_dimension
        WHERE vendor_state = 'MA')
        AND date_ordered < '2012-03-01';

weight                   | 1
design_query_search_path | v_dbd_vmart_design_vmart_design_ltt, "$user", public, v_catalog, v_monitor, v_internal
design_query_signature   | 45035996273724508
-[ RECORD 3]-------------+-------------------
...

2.32 - DESIGN_STATUS

Records the progress of a running Database Designer design or history of the last Database Designer design executed by the current user.

Records the progress of a running Database Designer design or history of the last Database Designer design executed by the current user.

Column Name Data Type Description
EVENT_TIME TIMESTAMP Time when the row recorded the event.
USER_NAME VARCHAR Name of the user who ran a design at the time Vertica recorded the session.
DESIGN_NAME VARCHAR Name of the user-specified design.
DESIGN_PHASE VARCHAR Phase of the design.
PHASE_STEP VARCHAR Substep in each design phase
PHASE_STEP_COMPLETE_PERCENT FLOAT Progress of current substep in percentage (0–100).
PHASE_COMPLETE_PERCENT FLOAT Progress of current design phase in percentage (0–100).

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Examples

The following example shows the content of the DESIGN_STATUS table of a complete Database Designer run:

=> SELECT event_time, design_name, design_phase, phase_complete_percent
   FROM v_monitor.design_status;
event_time          | design_name | design_phase                                   | phase_complete_percent
--------------------+-------------+------------------------------------------------+------------------------
2012-02-14 10:31:20 | design1     | Design started                                 |
2012-02-14 10:31:21 | design1     | Design in progress: Analyze statistics phase   |
2012-02-14 10:31:21 | design1     | Analyzing data statistics                      | 33.33
2012-02-14 10:31:22 | design1     | Analyzing data statistics                      | 66.67
2012-02-14 10:31:24 | design1     | Analyzing data statistics                      | 100
2012-02-14 10:31:25 | design1     | Design in progress: Query optimization phase   |
2012-02-14 10:31:25 | design1     | Optimizing query performance                   | 37.5
2012-02-14 10:31:31 | design1     | Optimizing query performance                   | 62.5
2012-02-14 10:31:36 | design1     | Optimizing query performance                   | 75
2012-02-14 10:31:39 | design1     | Optimizing query performance                   | 87.5
2012-02-14 10:31:41 | design1     | Optimizing query performance                   | 87.5
2012-02-14 10:31:42 | design1     | Design in progress: Storage optimization phase |
2012-02-14 10:31:44 | design1     | Optimizing storage footprint                   | 4.17
2012-02-14 10:31:44 | design1     | Optimizing storage footprint                   | 16.67
2012-02-14 10:32:04 | design1     | Optimizing storage footprint                   | 29.17
2012-02-14 10:32:04 | design1     | Optimizing storage footprint                   | 31.25
2012-02-14 10:32:05 | design1     | Optimizing storage footprint                   | 33.33
2012-02-14 10:32:05 | design1     | Optimizing storage footprint                   | 35.42
2012-02-14 10:32:05 | design1     | Optimizing storage footprint                   | 37.5
2012-02-14 10:32:05 | design1     | Optimizing storage footprint                   | 62.5
2012-02-14 10:32:39 | design1     | Optimizing storage footprint                   | 87.5
2012-02-14 10:32:39 | design1     | Optimizing storage footprint                   | 87.5
2012-02-14 10:32:41 | design1     | Optimizing storage footprint                   | 100
2012-02-14 10:33:12 | design1     | Design completed successfully                  |
(24 rows)

2.33 - DESIGN_TABLES

Contains information about all the design tables for all the designs for which you are the owner.

Contains information about all the design tables for all the designs for which you are the owner. Each row contains information about a different design table. Vertica creates this table when you run DESIGNER_CREATE_DESIGN.

Column Name Column Type Description
DESIGN_NAME VARCHAR Unique name that the user specified for the design.
DESIGN_TABLE_ID INTEGER Unique ID that Database Designer assigned to the design table.
TABLE_SCHEMA VARCHAR

Name of the schema that contains the design table.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_ID INTEGER System object identifier (OID) assigned to the design table.
TABLE_NAME VARCHAR Name of the design table.

Example

Add all the tables from the VMart database to the design VMART_DESIGN. This operation populates the DESIGN_TABLES table:


=> SELECT DESIGNER_ADD_DESIGN_TABLES('VMART_DESIGN','online_sales.*');
DESIGNER_ADD_DESIGN_TABLES
----------------------------
 3
(1 row)
=> SELECT DESIGNER_ADD_DESIGN_TABLES('VMART_DESIGN','public.*');
DESIGNER_ADD_DESIGN_TABLES
----------------------------
 9
(1 row)
=> SELECT DESIGNER_ADD_DESIGN_TABLES('VMART_DESIGN','store.*');
DESIGNER_ADD_DESIGN_TABLES
----------------------------
 3
(1 row)
=> SELECT * FROM DESIGN_TABLES;
design_name  | design_table_id | table_schema |     table_id      |      table_name
-------------+-----------------+--------------+-------------------+-----------------------
VMART_DESIGN |               1 | online_sales | 45035996373718754 | online_page_dimension
VMART_DESIGN |               2 | online_sales | 45035996373718758 | call_center_dimension
VMART_DESIGN |               3 | online_sales | 45035996373718762 | online_sales_fact
VMART_DESIGN |               4 | public       | 45035996373718766 | customer_dimension
VMART_DESIGN |               5 | public       | 45035996373718770 | product_dimension
VMART_DESIGN |               6 | public       | 45035996373718774 | promotion_dimension
VMART_DESIGN |               7 | public       | 45035996373718778 | date_dimension
VMART_DESIGN |               8 | public       | 45035996373718782 | vendor_dimension
VMART_DESIGN |               9 | public       | 45035996373718786 | employee_dimension
VMART_DESIGN |              10 | public       | 45035996373718822 | shipping_dimension
VMART_DESIGN |              11 | public       | 45035996373718826 | warehouse_dimension
VMART_DESIGN |              12 | public       | 45035996373718830 | inventory_face
VMART_DESIGN |              13 | store        | 45035996373718794 | store_dimension
VMART_DESIGN |              14 | store        | 45035996373718798 | store_sales_fact
VMART_DESIGN |              15 | store        | 45035996373718812 | store_orders_fact
        (15 rows)

2.34 - DESIGNS

Contains information about a Database Designer design.

Contains information about a Database Designer design. After you create a design and specify certain parameters for Database Designer, DESIGNER_CREATE_DESIGN creates this table in the V_MONITOR schema.

Column Name Column Type Description
DESIGN_ID INTEGER Unique ID that Database Designer assigns to this design.
DESIGN_NAME VARCHAR Name that the user specifies for the design.
KSAFETY_LEVEL INTEGER K-safety level for the design. Database Designer assigns a K-safety value of 0 for clusters with 1 or 2 nodes, and assigns a value of 1 for clusters with 3 or more nodes.
OPTIMIZATION_OBJECTIVE VARCHAR

Name of the optimization objective for the design. Valid values are:

  • QUERY

  • LOAD

  • BALANCED (default)

DESIGN_TYPE VARCHAR

Name of the design type. Valid values are:

  • COMPREHENSIVE (default)

  • INCREMENTAL

PROPOSE_SUPER_FIRST BOOLEAN Specifies to propose superprojections before projections, by default f. If DESIGN_MODE is COMPREHENSIVE, this field has no impact.
DESIGN_AVAILABLE BOOLEAN t if the design is currently available, otherwise, f (default).
COLLECTED_STATISTICS BOOLEAN t if statistics are to be collected when creating the design, otherwise, f (default).
POPULATE_DESIGN_TABLES_FROM_QUERIES BOOLEAN t if you want to populate the design tables from the design queries, otherwise, f (default).
ENCODING_DESIGN BOOLEAN t if the design is an encoding optimization design on pre-existing projections, otherwise, f (default).
DEPLOYMENT_PARALLELISM INTEGER Number of tables to be deployed in parallel when the design is complete. Default: 0
UNSEGMENTED_PROJECTIONS BOOLEAN t if you specify unsegmented projections, otherwise, f (default).
ANALYZE_CORRELATIONS_MODE INTEGER

Specifies how Database Designer should handle existing column correlations in a design and whether or not Database Designer should reanalyze existing column correlations.

  • 0: (default) Ignore column correlations when creating the design.

  • 1: Consider the existing correlations in the tables when creating the design.

  • 2: Analyze column correlations if not previously performed, and consider the column correlations when creating the design.

  • 3: Analyze all column correlations in the tables and consider them when creating the design, even if they have been analyzed previously.

2.35 - DIRECTED_QUERY_STATUS

Returns information about execution of directed queries.

Returns information about executions of directed queries.

Column Name Data Type Description
NODE_NAME VARCHAR Node on which the directed query ran.
OID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the specific directed query.
QUERY_NAME VARCHAR Directed query's unique identifier, used by statements such as ACTIVATE DIRECTED QUERY.
DIGEST INTEGER Hash of the saved query plan data, used by the optimizer to map identical input queries to the same active directed query.
HITS INTEGER Number of times this query has been executed since the last reset. Use CLEAR_DIRECTED_QUERY_USAGE to reset this counter to 0.

Privileges

Superuser

2.36 - DISK_QUOTA_USAGES

Provides information about schemas and tables that have disk quotas.

Provides information about schemas and tables that have disk quotas. Schemas and tables without quotas are not included.

Column Name Data Type Description
OBJECT_OID INTEGER Unique identifier for a schema or table.
OBJECT_NAME VARCHAR Name of the schema or table. Table names include the schema prefix.
IS_SCHEMA BOOLEAN Whether the object is a schema. If false, the object is a table.
TOTAL_DISK_USAGE_IN_BYTES
INTEGER Current usage of the object. For information about what is counted, see Disk quotas.
DISK_QUOTA_IN_BYTES INTEGER Current quota for the object.

Examples

=> SELECT * FROM DISK_QUOTA_USAGES;
    object_oid     | object_name | is_schema | total_disk_usage_in_bytes | disk_quota_in_bytes
-------------------+-------------+-----------+---------------------+---------------------
 45035996273705100 | s           | t         |                 307 |               10240
 45035996273705104 | public.t    | f         |                 614 |                1024
 45035996273705108 | s.t         | f         |                 307 |                2048
(3 rows)

2.37 - DISK_RESOURCE_REJECTIONS

Returns requests for resources that are rejected due to disk space shortages.

Returns requests for resources that are rejected due to disk space shortages. Output is aggregated by both RESOURCE_TYPE and REJECTED_REASON to provide more comprehensive information.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
RESOURCE_TYPE VARCHAR The resource request requester (example: Temp files).
REJECTED_REASON VARCHAR

One of the following:

  • Insufficient disk space

  • Failed volume

REJECTED_COUNT INTEGER Number of times this REJECTED_REASON has been given for this RESOURCE_TYPE.
FIRST_REJECTED_TIMESTAMP TIMESTAMP The time of the first rejection for this REJECTED_REASON and RESOURCE_TYPE.
LAST_REJECTED_TIMESTAMP TIMESTAMP The time of the most recent rejection for this REJECTED_REASON and RESOURCE_TYPE.
LAST_REJECTED_VALUE INTEGER The value of the most recent rejection for this REJECTED_REASON and RESOURCE_TYPE.

See also

2.38 - DISK_STORAGE

Returns the amount of disk storage used by the database on each node.

Returns the amount of disk storage used by the database on each node. Each node can have one or more storage locations, and the locations can be on different disks with separate properties, such as free space, used space, and block size. The information in this system table is useful in determining where data files reside.

All returned values for this system table are in the context of the file system of the host operating system, and are not specific to Vertica-specific space.

The storage usage annotation called CATALOG indicates that the location is used to store the catalog. Each CATALOG location is specified only when creating a new database. You cannot add a CATALOG location annotation using CREATE LOCATION, nor remove an existing CATALOG annotation.

Storage location performance

The performance of a storage location is measured with two values:

  • Throughput in MB/sec

  • Latency in seeks/sec

These two values are converted to a single number (Speed) with the following formula:

read-time = (1/throughput) + (1/latency)
  • read-time: Time to read 1MB of data

  • 1/throughput: Time to read 1MB of data

  • 1/latency: Time to seek to the data.

A disk is faster than another disk if its read-time is less.

Column Name Data Type Description
NODE_NAME VARCHAR Node name for which information is listed.
STORAGE_PATH VARCHAR Path where the storage location is mounted.
STORAGE_USAGE VARCHAR

Type of information stored in the location, one of the following:

  • DATA: Only data is stored in the location.

  • TEMP: Only temporary files that are created during loads or queries are stored in the location.

  • DATA,TEMP: Both types of files are stored in the location.

  • USER: The storage location can be used by non-dbadmin users, who are granted access to the storage location

  • CATALOG: The area is used for the Vertica catalog. This usage is set internally and cannot be removed or changed.

RANK INTEGER Integer rank assigned to the storage location based on its performance. Ranks are used to create a storage locations on which projections, columns, and partitions are stored on different disks based on predicted or measured access patterns. See Managing storage locations.
THROUGHPUT INTEGER Integer that measures a storage location's performance in MB/sec. 1/throughput is the time taken to read 1MB of data.
LATENCY INTEGER Integer that measures a storage location's performance in seeks/sec. 1/latency is the time taken to seek to the data.
STORAGE_STATUS VARCHAR

Status of the storage location, one of the following:

  • active

  • retired

DISK_BLOCK_SIZE_BYTES INTEGER Block size of the disk in bytes
DISK_SPACE_USED_BLOCKS INTEGER Number of disk blocks in use
DISK_SPACE_USED_MB INTEGER Number of megabytes of disk storage in use
DISK_SPACE_FREE_BLOCKS INTEGER Number of free disk blocks available
DISK_SPACE_FREE_MB INTEGER Number of megabytes of free storage available
DISK_SPACE_FREE_PERCENT VARCHAR Percentage of free disk space remaining

2.39 - DRAINING_STATUS

Returns the draining status of each node in a database.

Returns the draining status of each node in a database. The table also provides aggregate user session counts and information about the oldest user session connected to each node. For more information about the user sessions connected to a database, see SESSIONS.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node for which information is listed.
SUBCLUSTER_NAME VARCHAR Name of the subcluster that contains the node.
IS_DRAINING BOOLEAN True if the node is draining; otherwise, false.
COUNT_CLIENT_USER_SESSIONS INTEGER Number of user client sessions connected to the node.
OLDEST_SESSION_USER VARCHAR Name of the user with the oldest live session connected to the node. NULL if no users are connected.
OLDEST_SESSION_ID VARCHAR Identifier associated with OLDEST_SESSION_USER. This is required to close or interrupt a session. NULL if no users are connected.
OLDEST_SESSION_LOGIN_TIMESTAMP TIMESTAMP Date and time the OLDEST_SESSION_USER logged into the database. NULL if no users are connected.

2.40 - ERROR_MESSAGES

Lists system error messages and warnings Vertica encounters while processing queries.

Lists system error messages and warnings Vertica encounters while processing queries. Some errors occur when no transaction is in progress, so the transaction identifier or statement identifier columns might return NULL.

Column Name Data Type Description
EVENT_TIMESTAMP TIMESTAMPTZ Time when the row recorded the event
NODE_NAME VARCHAR Name of the node that is reporting the requested information
USER_ID INTEGER Identifier of the user who received the error message
USER_NAME VARCHAR Name of the user who received the error message when Vertica recorded the session
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
REQUEST_ID INTEGER Unique identifier of the query request in the user session
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any; otherwise NULL
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID, and REQUEST_ID uniquely identifies a statement within a session.
ERROR_LEVEL VARCHAR

Severity of the error, one of the following:

  • LOG

  • INFO

  • NOTICE

  • WARNING

  • ERROR

  • ROLLBACK

  • INTERNAL

  • FATAL

  • PANIC

ERROR_CODE INTEGER Error code that Vertica reports
MESSAGE VARCHAR Textual output of the error message
DETAIL VARCHAR Additional information about the error message, in greater detail
HINT VARCHAR

Actionable hint about the error. For example:

HINT: Set the locale in this session to en_US@collation=binary using the command "\locale en_US@collation=binary"

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.41 - EVENT_CONFIGURATIONS

Monitors the configuration of events.

Monitors the configuration of events.

Column Name Data Type Description
EVENT_ID VARCHAR The name of the event.
EVENT_DELIVERY_CHANNELS VARCHAR The delivery channel on which the event occurred.

2.42 - EXECUTION_ENGINE_PROFILES

Provides profiling information about runtime query execution.

Provides profiling information about runtime query execution. The hierarchy of IDs, from highest level to actual execution, is:

  • PATH_ID

  • BASEPLAN_ID

  • LOCALPLAN_ID

  • OPERATOR_ID

Counters (output from the COUNTER_NAME column) are collected for each actual Execution Engine (EE) operator instance.

The following columns combine to form a unique key:

  • TRANSACTION_ID

  • STATEMENT_ID

  • NODE_NAME

  • OPERATOR_ID

  • COUNTER_NAME

  • COUNTER_TAG

Column Name Data Type Description
NODE_NAME VARCHAR Node name for which information is listed.
USER_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the user.
USER_NAME VARCHAR User name for which query profile information is listed.
SESSION_ID VARCHAR Identifier of the session for which profiling information is captured. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
TRANSACTION_ID INTEGER Identifier for the transaction within the session if any; otherwise NULL.
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed.
OPERATOR_NAME VARCHAR Name of the Execution Engine (EE) component; for example, NetworkSend.
OPERATOR_ID INTEGER Identifier assigned by the EE operator instance that performs the work. OPERATOR_ID is different from LOCALPLAN_ID because each logical operator, such as Scan, may be executed by multiple threads concurrently. Each thread operates on a different operator instance, which has its own ID.
BASEPLAN_ID INTEGER Assigned by the optimizer on the initiator to EE operators in the original base (EXPLAIN) plan. Each EE operator in the base plan gets a unique ID.
PATH_ID INTEGER

Identifier that Vertica assigns to a query operation or path; for example to a logical grouping operation that might be performed by multiple execution engine operators.

For each path, the same PATH ID is shared between the query plan (using EXPLAIN output) and in error messages that refer to joins.

LOCALPLAN_ID INTEGER Identifier assigned by each local executor while preparing for plan execution (local planning). Some operators in the base plan, such as the Root operator, which is connected to the client, do not run on all nodes. Similarly, certain operators, such as ExprEval, are added and removed during local planning due to implementation details.
ACTIVITY_ID INTEGER Identifier of the plan activity.
RESOURCE_ID INTEGER Identifier of the plan resource.
COUNTER_NAME VARCHAR Name of the counter (see Counter Names below). The counter counts events for one statement.
COUNTER_TAG VARCHAR String that uniquely identifies the counter for operators that might need to distinguish between different instances. For example, COUNTER_TAG is used to identify to which of the node bytes are being sent to or received from the NetworkSend operator.
COUNTER_VALUE INTEGER Value of the counter.
IS_EXECUTING BOOLEAN Indicates whether the profile is active or completed.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Counter names

The value of COUNTER_NAME can be any of the following:

active threads
A counter of the LoadUnion operator, indicates the number of input threads (Load operators) that are currently processing input.
blocks analyzed by SIPs expression
Number of data blocks (for scan operations) or files (for load operations) analyzed by SIPS expression.
blocks filtered by SIPs expression
Number of data blocks (for scan operations) or files (for load operations) filtered by SIPS expression.
blocks filtered by SIPs value lists
Number of data blocks (for scan operations) or files (for load operations) filtered by SIPS sorted value lists.
buffers spilled
[NetworkSend] Buffers spilled to disk by NetworkSend.
bytes read from disk
[Scan] Amount of data read (locally or remotely) from ROS containers on disk.
bytes read from disk cache
[Scan] Amount of data read from cache.
bytes received
Number of bytes received over the network for query execution.
bytes sent
[NetworkSend] Size of data after encoding and compression sent over the network (actual network bytes).
bytes spilled
[NetworkSend] Bytes spilled to disk by NetworkSend.
bytes total
[SendFiles] (recover-by-container plan): Total number of bytes to send/receive.
cached storages cumulative size (bytes)
[StorageMerge] Total amount of temp space used by operator for caching.
cached storages current size (bytes)
[StorageMerge] Current amount of temp space used for caching.
cached storages peak size (bytes)
[StorageMerge] Peak amount of temp space an operator used for caching.
clock time (µs)
Real-time clock time spent processing the query, in microseconds.
clock time (µs) of UDChunker
Real-time clock time spent in the UDChunker phase of a load operation, in microseconds. Use the COUNTER_TAG column to distinguish among load sources.
clock time (µs) of UDFilter(s)
Real-time clock time spent in all UDFilter phases of a load operation, in microseconds. Use the COUNTER_TAG column to distinguish among load sources.
clock time (µs) of UDParser
Real-time clock time spent in the UDParser phase of a load operation, in microseconds. Use the COUNTER_TAG column to distinguish among load sources.
clock time (µs) of UDSource
Real-time clock time spent in the UDSource phase of a load operation, in microseconds. Use the COUNTER_TAG column to distinguish among load sources.
completed merge phases
Number of merge phases already completed by an LSort or DataTarget operator. Compare to the total merge phases. Variants on this value include join inner completed merge phases.
cumulative size of raw temp data (bytes)
Total amount of temporary data the operator has written to files. Compare to cumulative size of temp files (bytes) to understand impact of encoding and compression in an externalizing operator. Variants on this value include join inner cumulative size of raw temp files (bytes).
cumulative size of temp files (bytes)
For externalizing operators only, the total number of encoded and compressed temp data the operator has written to files. A sort operator might go through multiple merge phases, where at each pass sorted chunks of data are merged into fewer chunks. This counter remembers the cumulative size of all temp files past and present. Variants on this value include join inner cumulative size of temp files (bytes).
current allocated rid memory (bytes)
Per-rid memory tracking: current allocation amount under this rid.
current file handles
Number of files open.
current memory allocations (count)
Number of actual allocator calls made.
current memory capacity (bytes)
Amount of system memory held, which includes chunks that are only partially consumed.
current memory overhead (bytes)
Memory consumed, for example, by debug headers. (Normally no overhead.)
current memory padding (bytes)
Memory padding for free list tiers (2^n bytes).
current memory requested (bytes)
Memory actually requested by the caller.
current size of temp files (bytes)
For externalizing operators only, the current size of the encoded and compressed temp data that the operator has written to files. Variants on this value include join inner current size of temp files (bytes).
current threads
Unused.
current unbalanced memory allocations (count)
current unbalanced memory capacity (bytes)
current unbalanced memory overhead (bytes)
current unbalanced memory requested (bytes)
Pooled version of "current memory XXX" counters.
distinct value estimation time (µs)
[Analyze Statistics] Time (in microcseconds) spent to estimate number of distinct values from the sample after data is read off disk and into the statistical sample.
encoded bytes received
[NetworkRecv] Size of received data after decompressed (but still encoded) received over the network.
encoded bytes sent
[NetworkSend] Size of data sent over the network after encoding.
end time
Time (timestamp) when Vertica stopped processing the operation
estimated rows produced
Number of rows that the optimizer estimated would be produced. See rows produced for the actual number of rows that are produced.
exceptions cumulative size of raw temp data (bytes)
exceptions rows cumulative size of temp files (bytes)
exceptions rows current size of temp files (bytes)
Counters that store the total or current size of exception data.
execution time (µs)
CPU clock time spent processing the query, in microseconds.
fast aggregated rows
Number of rows being processed by fast aggregations in the hash groupby operator (no group/aggregation).
files completed
Relevant only to SendFiles/RecvFiles operators (that is, recover-by-container plan) number of files sent/received.
files total
Relevant only to SendFiles/RecvFiles operators (that is, recover-by-container plan) total number of files to send/receive.
Hadoop FS bytes read through native libhdfs++ client
[Scan, Load] Number of bytes read from an hdfs source (using libhdfs++).
Hadoop FS bytes read through webhdfs
[Scan, Load] Number of bytes read from a webhdfs source.
Hadoop FS bytes written through webhdfs
[DataTarget] Number of bytes written to webhdfs storage.
Hadoop FS hdfs:// operations that used native libhdfs++ calls
[Scan, Load, DataTarget] Number of times Vertica opened a file with an hdfs:// URL and used the native hdfs protocol
Hadoop FS hdfs:// operations that used webhdfs calls
[Scan, Load, DataTarget] Number of times Vertica opened a file with an hdfs:// URL and used the webhdfs protocol
Hadoop FS read operations through native libhdfs++ client failure count
[Scan, Load] Number of times a native libhdfs++ source encountered an error and gave up
Hadoop FS read operations through native libhdfs++ client retry count
[Scan, Load] Number of times a native libhdfs++ source encountered an error and retried
Hadoop FS read operations through webhdfs failure count
[Scan, Load] Number of times a webhdfs source encountered an error and gave up
Hadoop FS read operations through webhdfs retry count
[Scan, Load] Number of times a webhdfs source encountered an error and retried
Hadoop FS write operations through webhdfs failure count
[DataTarget] Number of times a webhdfs write encountered an error and gave up
Hadoop FS write operations through webhdfs retry count
[DataTarget] Number of times a webhdfs write encountered an error and retried
histogram creation time(µs)
[Analyze Statistics] Time spent estimating the number of distinct values from the sample after data is read off disk and into the statistical sample.
initialization time (µs)
Time in microseconds spent initializing an operator during the CompilePlan step of query processing. For example, initialization time could include the time spent compiling expressions and gathering resources.
input queue wait (µs)
Time in microseconds that an operator spends waiting for upstream operators.
input rows
Actual number of rows that were read into the operator.
input size (bytes)
Total number of bytes of the Load operator's input source, where NULL is unknown (read from FIFO).
inputs processed
Number of sources processed by a Load operator.
intermediate rows to process
Number of rows to process in a phase as determined by a sort or GROUP BY (HASH).
join inner clock time (µs)
Real clock time spent on processing the inner input of the join operator.
join inner completed mergephases
join inner cumulative size of raw temp data (bytes)
join inner cumulative size of temp files (bytes)
join inner current size of temp files (bytes)
See the completed merge phases counter.
join inner execution time (µs)
The CPU clock time spent on processing the inner input of the join operator.
join inner hash table building time (µs)
Time spent for building the hash table for the inner input of the join operator.
join inner hash table collisions
Number of hash table collisions that occurred when building the hash table for the inner input of the join operator.
join inner hash table entries
Number of hash table entries for the inner input of the join operator.
join inner total merge phases
See the completed merge phases counter.
join outer clock time (µs)
Real clock time spent on processing the outer input of the join operator (including doing the join).
join outer execution time (µs)
CPU clock time spent on processing the outer input of the join operator (including doing the join).
max sample size (rows)
[Analyze Statistics] Maximum number of rows that will be stored in the statistical sample.
memory reserved (bytes)
Memory reserved by this operator. Deprecated.
network wait (µs)
[NetworkSend, NetworkRecv] Time in microseconds spent waiting on the network.
number of bytes read from persistent storage
Estimated number of bytes read from persistent storage to process this query.
number of bytes read from depot storage
Estimated number of bytes read from the depot to process this query.
number of cancel requests received
Number of cancel requests received (per operator) when cancelling a call to the execution engine.
number of invocations
Number of times a UDSF function was invoked.
number of storage containers opened
[Scan] Number of containers opened by the operator, at least 1. If the scan operator switches containers, this counter increases accordingly. See Local caching of storage containers for details.
output queue wait (µs)
Time in microseconds that an operator spends waiting for the output buffer to be consumed by a downstream operator.
peak allocated rid memory (bytes)
Per-rid memory tracking: peak allocation amount under this rid.
peak cooperating threads
Peak number of threads which parsed (in parallel) a single load source, using "cooperative parse." counter_tag indicates the source when joining with dc_load_events.
peak file handles
peak memory allocations (count)
peak memory capacity (bytes)
peak memory overhead (bytes)
peak memory padding (bytes)
peak memory requested (bytes)
peak temp space
peak threads
peak unbalanced memory allocations (count)
peak unbalanced memory capacity (bytes)
peak unbalanced memory overhead (bytes)
peak unbalanced memory padding (bytes)
peak unbalanced memory requested (bytes)
Peak value of the corresponding "current XXX" counters.
portion offset
Offset value of a portion descriptor in an apportioned load. counter_tag indicates the source when joining with dc_load_events.
portion size
Size value of a portion descriptor in an apportioned load. counter_tag indicates the source when joining with dc_load_events.
producer stall (µs)
[NetworkSend] Time in microseconds spent by NetworkSend when stalled waiting for network buffers to clear.
producer wait (µs)
[NetworkSend] Time in microseconds spent by the input operator making rows to send.
read (bytes)
Number of bytes read from the input source by the Load operator.
receive time (µs)
Time in microseconds that a Recv operator spends reading data from its socket.
rejected data cumulative size of raw temp data (bytes)
rejected data cumulative size of temp files (bytes)
rejected data current sizeof temp files (bytes)
rejected rows cumulative size of raw temp data (bytes)
rejected rows cumulative size of temp files (bytes)
rejected rows current size of temp files (bytes)
Counters that store total or current size of rejected row numbers. Are variants of:
  • cumulative size of raw temp data (bytes)
  • cumulative size of temp files (bytes)
  • current size of temp files (bytes)
reserved rid memory (bytes)
Per-rid memory tracking: total memory reservation under this rid.
rle rows produced
Number of physical tuples produced by an operator. Complements the rows produced counter, which shows the number of logical rows produced by an operator. For example, if a value occurs 1000 rows consecutively and is RLE encoded, it counts as 1000 rows produced not only 1 rle rows produced.
ROS blocks bounded
[DataTarget] Number of ROS blocks created, due to boundary alignment with RLE prefix columns, when an EE DataTarget operator is writing to ROS containers.
ROS blocks encoded
[DataTarget] Number of ROS blocks created when an EE DataTarget operator is writing to ROS containers.
ROS bytes written
[DataTarget] Number of bytes written to disk when an EE DataTarget operator is writing to ROS containers.
rows added by predicate analysis
Number of rows in the query results that were added without individual evaluation, based on the predicate and range of possible results in a block.
rows filtered by SIPs expression
Number of rows filtered by the SIPS expression from the Scan operator.
rows filtered by query predicate
Number of rows excluded from query results because they failed a condition (predicate), for example in a WHERE clause.
rows in sample
[Analyze Statistics] Actual number of rows that will be stored in the statistical sample.
rows output by sort
[DataTarget] Number of rows sorted when an EE DataTarget operator is writing to ROS containers.
rows processed
[DataSource] Number of rows processed when an EE DataSource operator is reading from ROS containers.
rows processed by SIPs expression
Number of rows processed by the SIPS expression in the Scan operator.
rows produced
Number of logical rows produced by an operator. See also the rle rows produced counter.
rows pruned by query predicates
Number of rows discarded from query results because, based on predicates and value ranges, no row in the block could satisfy the predicate.
rows pruned by valindex
[DataSource] Number of rows it skips direct scanning with help of valindex when an EE DataSource operator is writing to ROS containers. This counter's value is not greater than "rows processed" counter.
rows read in sort
See the counter total rows read in sort.
rows received
[NetworkRecv] Number of received sent over the network.
rows rejected
Number of rows rejected by the Load operator.
rows sent
[NetworkSend] Number of rows sent over the network.
rows to process
Total number of rows to be processed in a phase, based upon the number of table accesses. Compare to the counter, rows processed. Divide the rows processed value by the rows to process value for percent completion.
rows written in join sort
Total number of rows being read out of the sort facility in Join.
rows written in sort
Number of rows read out of the sort by the SortManager. This counter and the counter total rows read from sort are typically equal.
send time (µs)
Time in microseconds that a Send operator spends writing data to its socket.
start time
Time (timestamp) when Vertica started to process the operation.
total merge phases
Number of merge phases an LSort or DataTarget operator must complete to finish sorting its data. NULL until the operator can compute this value (all data must first be ingested by the operator). Variants on this value include join inner total merge phases.
total rows read in join sort
Total number of rows being put into the sort facility in Join.
total rows read in sort total
Total number of rows ingested into the sort by the SortManager. This counter and the counter rows written in sort are typically equal.
total rows written in sort
See the counter, rows written in sort.
total sources
Total number of distinct input sources processed in a load.
unpacked (bytes)
Number of bytes produced by a compressed source in a load (for example, for a gzip file, the size of the file when decompressed).
wait clock time (µs)
StorageUnion wait time in microseconds.
written rows
[DataTarget] Number of rows written when an EE DataTarget operator writes to ROS containers

Examples

The two queries below show the contents of the EXECUTION_ENGINE_PROFILES table:

=> SELECT operator_name, operator_id, counter_name, counter_value
    FROM EXECUTION_ENGINE_PROFILES WHERE operator_name = 'Scan'
    ORDER BY counter_value DESC;
 operator_name | operator_id | counter_name |  counter_value
---------------+-------------+--------------+------------------
 Scan          |          20 | end time     | 1559929719983785
 Scan          |          20 | start time   | 1559929719983737
 Scan          |          18 | end time     | 1559929719983358
 Scan          |          18 | start time   | 1559929718069860
 Scan          |          16 | end time     | 1559929718069319
 Scan          |          16 | start time   | 1559929718069188
 Scan          |          14 | end time     | 1559929718068611
 Scan          |          18 | end time     | 1559929717579145
 Scan          |          18 | start time   | 1559929717579083
 Scan          |          16 | end time     | 1559929717578509
 Scan          |          18 | end time     | 1559929717379346
 Scan          |          18 | start time   | 1559929717379307
 Scan          |          16 | end time     | 1559929717378879
 Scan          |          16 | start time   | 1559929716894312
 Scan          |          14 | end time     | 1559929716893599
 Scan          |          14 | start time   | 1559929716893501
 Scan          |          12 | end time     | 1559929716892721
 Scan          |          16 | start time   | 1559929716666110
...

=> SELECT DISTINCT counter_name FROM execution_engine_profiles;
                    counter_name
-----------------------------------------------------
 reserved rid memory (bytes)
 rows filtered by SIPs expression
 rows output by sort
 chunk rows scanned squared
 join inner execution time (us)
 current unbalanced memory requested (bytes)
 clock time (us)
 join outer clock time (us)
 exception handling execution time (us)
 peak memory capacity (bytes)
 bytes received
 peak memory requested (bytes)
 send time (us)
 ROS blocks encoded
 current size of temp files (bytes)
 peak memory allocations (count)
 current unbalanced memory overhead (bytes)
 rows segmented
...

The following query includes the path_id column, which links the path that the query optimizer takes (via the EXPLAIN command's textual output) with join error messages.

=> SELECT operator_name, path_id, counter_name, counter_value FROM execution_engine_profiles where operator_name = 'Join';
 operator_name | path_id |                    counter_name                     |  counter_value
---------------+---------+-----------------------------------------------------+------------------
 Join          |      64 | current memory allocations (count)                  |                0
 Join          |      64 | peak memory allocations (count)                     |               57
 Join          |      64 | current memory requested (bytes)                    |                0
 Join          |      64 | peak memory requested (bytes)                       |          1698240
 Join          |      64 | current memory overhead (bytes)                     |                0
 Join          |      64 | peak memory overhead (bytes)                        |                0
 Join          |      64 | current memory padding (bytes)                      |                0
 Join          |      64 | peak memory padding (bytes)                         |           249840
 Join          |      64 | current memory capacity (bytes)                     |                0
 Join          |      64 | peak memory capacity (bytes)                        |           294912
 Join          |      64 | current unbalanced memory allocations (count)       |              145
 Join          |      64 | peak unbalanced memory allocations (count)          |              146
 Join          |      64 | current unbalanced memory requested (bytes)         |           116506
 Join          |      64 | peak unbalanced memory requested (bytes)            |          1059111
 Join          |      64 | current unbalanced memory overhead (bytes)          |             3120
 Join          |      64 | peak unbalanced memory overhead (bytes)             |             3120
...

See also

2.43 - EXTERNAL_TABLE_DETAILS

Returns the amount of disk storage used by the source files backing external tables in the database.

Returns the amount of disk storage used by the source files backing external tables in the database. The information in this system table is useful in determining Hadoop license compliance.

When computing the size of an external table, Vertica counts all data found in the location specified by the COPY FROM clause. If you have a directory that contains ORC and delimited files, for example, and you define your external table with "COPY FROM *" instead of "COPY FROM *.orc", this table includes the size of the delimited files. (You would probably also encounter errors when querying that external table.) When you query this system table Vertica does not validate your table definition; it just uses the path to find files to report.

Restrict your queries to filter by schema, table, or format to avoid expensive queries. Vertica calculates the values in this table at query time, so "SELECT *" accesses every input file contributing to every external table.

Predicates in queries may use only the TABLE_SCHEMA, TABLE_NAME, and SOURCE_FORMAT columns. Values are case-sensitive.

This table includes TEMP external tables.

This table reports only data that the current user can read. To include all the data backing external tables, either query this table as a user that has access to all HDFS data or use a session delegation token that grants this access. For more information about using delegation tokens, see Accessing kerberized HDFS data.

Column Name Data Type Description
SCHEMA_OID INTEGER The unique identification number of the schema in which the external table resides.
TABLE_NAMESPACE VARCHAR For Eon Mode databases, namespace that contains the external table.
TABLE_SCHEMA VARCHAR

The name of the schema in which the external table resides.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_OID INTEGER A unique numeric ID assigned by the Vertica catalog that identifies the table.
TABLE_NAME VARCHAR The table name.
SOURCE_FORMAT VARCHAR The data format the source file used, one of ORC, PARQUET, DELIMITED, USER DEFINED, or NULL if another format.
TOTAL_FILE_COUNT INTEGER The number of files used to store this table's data, expanding globs and partitions.
TOTAL_FILE_SIZE_BYTES INTEGER Total number of bytes used by all of this table's data files.
SOURCE_STATEMENT VARCHAR The load statement used to copy data from the source files.
FILE_ACCESS_ERROR VARCHAR The access error returned during the source statement. NULL, if there was no access error during the source statement.

2.44 - HIVE_CUSTOM_PARTITIONS_ACCESSED

This table provides information about all custom locations for Hive partition data that Vertica has accessed.

This table provides information about all custom locations for Hive partition data that Vertica has accessed. It applies when Hive uses a non-default location for partition data, the HCatalog Connector is used to access that data, and the CREATE HCATALOG SCHEMA statement for the schema sets the CUSTOM_PARTITIONS parameter.

Column Name Data Type Description
ACCESS_TIME TIMESTAMPTZ Time when Vertica accessed the partition data.
ACCESS_NODE VARCHAR(128) Name of the node that performed the access.
TRANSACTION_ID INTEGER Identifier for the query that produced the access.
FILESYSTEM VARCHAR(128) File system of the partition data. This value is the scheme portion of the URL.
AUTHORITY VARCHAR(128) If the file system is HDFS, this value is the nameservice. If the file system is S3, it is the name of the bucket.
URL VARCHAR(6400) Full path to the partition.

Privileges

No explicit permissions are required; however, users see only the records that correspond to schemas they have permissions to access.

2.45 - HOST_RESOURCES

Provides a snapshot of the node.

Provides a snapshot of the node. This is useful for regularly polling the node with automated tools or scripts.

Column Name Data Type Description
HOST_NAME VARCHAR The host name for which information is listed.
OPEN_FILES_LIMIT INTEGER The maximum number of files that can be open at one time on the node.
THREADS_LIMIT INTEGER The maximum number of threads that can coexist on the node.
CORE_FILE_LIMIT_MAX_SIZE_BYTES INTEGER The maximum core file size allowed on the node.
PROCESSOR_COUNT INTEGER The number of system processors.
PROCESSOR_CORE_COUNT INTEGER The number of processor cores in the system.
PROCESSOR_DESCRIPTION VARCHAR A description of the processor. For example: Inter(R) Core(TM)2 Duo CPU T8100 @2.10GHz (1 row)
OPENED_FILE_COUNT INTEGER The total number of open files on the node.
OPENED_SOCKET_COUNT INTEGER The total number of open sockets on the node.
OPENED_NONFILE_NONSOCKET_COUNT INTEGER The total number of other file descriptions open in which 'other' could be a directory or FIFO. It is not an open file or socket.
TOTAL_MEMORY_BYTES INTEGER The total amount of physical RAM, in bytes, available on the system.
TOTAL_MEMORY_FREE_BYTES INTEGER The amount of physical RAM, in bytes, left unused by the system.
TOTAL_BUFFER_MEMORY_BYTES INTEGER The amount of physical RAM, in bytes, used for file buffers on the system
TOTAL_MEMORY_CACHE_BYTES INTEGER The amount of physical RAM, in bytes, used as cache memory on the system.
TOTAL_SWAP_MEMORY_BYTES INTEGER The total amount of swap memory available, in bytes, on the system.
TOTAL_SWAP_MEMORY_FREE_BYTES INTEGER The total amount of swap memory free, in bytes, on the system.
DISK_SPACE_FREE_MB INTEGER The free disk space available, in megabytes, for all storage location file systems (data directories).
DISK_SPACE_USED_MB INTEGER The disk space used, in megabytes, for all storage location file systems.
DISK_SPACE_TOTAL_MB INTEGER The total free disk space available, in megabytes, for all storage location file systems.

Examples

=> SELECT * FROM HOST_RESOURCES;
-[ RECORD 1 ]------------------+------------------------------------------
host_name                      | 10.20.100.247
open_files_limit               | 65536
threads_limit                  | 3833
core_file_limit_max_size_bytes | 0
processor_count                | 2
processor_core_count           | 2
processor_description          | Intel(R) Xeon(R) CPU E5-2695 v2 @ 2.40GHz
opened_file_count              | 8
opened_socket_count            | 15
opened_nonfile_nonsocket_count | 7
total_memory_bytes             | 4018823168
total_memory_free_bytes        | 126550016
total_buffer_memory_bytes      | 191803392
total_memory_cache_bytes       | 2418753536
total_swap_memory_bytes        | 2147479552
total_swap_memory_free_bytes   | 2145771520
disk_space_free_mb             | 18238
disk_space_used_mb             | 30013
disk_space_total_mb            | 48251
-[ RECORD 2 ]------------------+------------------------------------------
host_name                      | 10.20.100.248
open_files_limit               | 65536
threads_limit                  | 3833
core_file_limit_max_size_bytes | 0
processor_count                | 2
processor_core_count           | 2
processor_description          | Intel(R) Xeon(R) CPU E5-2695 v2 @ 2.40GHz
opened_file_count              | 8
opened_socket_count            | 9
opened_nonfile_nonsocket_count | 7
total_memory_bytes             | 4018823168
total_memory_free_bytes        | 356466688
total_buffer_memory_bytes      | 327278592
total_memory_cache_bytes       | 2744279040
total_swap_memory_bytes        | 2147479552
total_swap_memory_free_bytes   | 2147479552
disk_space_free_mb             | 37102
disk_space_used_mb             | 11149
disk_space_total_mb            | 48251
-[ RECORD 3 ]------------------+------------------------------------------
host_name                      | 10.20.100.249
open_files_limit               | 65536
threads_limit                  | 3833
core_file_limit_max_size_bytes | 0
processor_count                | 2
processor_core_count           | 2
processor_description          | Intel(R) Xeon(R) CPU E5-2695 v2 @ 2.40GHz
opened_file_count              | 8
opened_socket_count            | 9
opened_nonfile_nonsocket_count | 7
total_memory_bytes             | 4018823168
total_memory_free_bytes        | 241610752
total_buffer_memory_bytes      | 309395456
total_memory_cache_bytes       | 2881675264
total_swap_memory_bytes        | 2147479552
total_swap_memory_free_bytes   | 2147479552
disk_space_free_mb             | 37430
disk_space_used_mb             | 10821
disk_space_total_mb            | 48251

2.46 - IO_USAGE

Provides disk I/O bandwidth usage history for the system.

Provides disk I/O bandwidth usage history for the system.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
START_TIME TIMESTAMP Beginning of history interval.
END_TIME TIMESTAMP End of history interval.
READ_KBYTES_PER_SEC FLOAT Counter history of the number of bytes read measured in kilobytes per second.
WRITTEN_KBYTES_PER_SEC FLOAT Counter history of the number of bytes written measured in kilobytes per second.

Privileges

Superuser

2.47 - LDAP_LINK_DRYRUN_EVENTS

Collects the results from LDAP dry run meta-functions:.

Collects the results from LDAP dry run meta-functions:

For detailed instructions on using these meta-functions, see Configuring LDAP link with dry runs.

Column Name Data Type Description
EVENT_TIMESTAMP TIMESTAMP The date and time of an LDAP server and Vertica LDAP Link interaction.
NODE_NAME VARCHAR The clerk node.
SESSION_ID VARCHAR The identification number of the LDAP Link session.
USER_ID INTEGER The unique, system-generated user identification number.
USER_NAME VARCHAR The name of the user for which the information is listed.
TRANSACTION_ID INTEGER The system-generated transaction identification number. Is NULL if a transaction id does not exist.
EVENT_TYPE VARCHAR The result of a dry run.
ENTRY_NAME VARCHAR The name of the object on which the event occurred, if applicable. For example, the event SYNC-STARTED does not use an object.
ROLE_NAME VARCHAR The name of a role.
LDAPURIHASH INTEGER The URI hash number for the LDAP user.
LDAP_URI VARCHAR The URI for the LDAP server.
BIND_DN VARCHAR The Distinguished Name used for the dry run bind.
FILTER_GROUP VARCHAR The group attribute passed to the dry run meta-functions as LDAPLinkFilterGroup.
FILTER_USER VARCHAR The user attribute passed to the dry run meta-functions as LDAPLinkFilterUser.
LINK_SCOPE VARCHAR The DN level to replicate, passed to the dry run meta-functions as LDAPLinkScope.
SEARCH_BASE VARCHAR The DN level from which LDAP Link begins the search, passed to the dry run meta-functions as LDAPLinkSearchBase.
GROUP_MEMBER VARCHAR Identifies the members of an LDAP group, passed to the dry run meta-functions as LDAPLinkGroupMembers.
GROUP_NAME VARCHAR The LDAP field to use when creating a role name in Vertica, passed to the dry run meta-functions as LDAPLinkGroupName.
LDAP_USER_NAME VARCHAR The attribute that identifies individual users, passed to the dry run meta-functions as LDAPLinkUserName.
TLS_REC_CERT VARCHAR The connection policy used for the dry run connection for certificate management. This connection policy is set through the LDAPLink TLS Configuration.
TLS_CA_CERT VARCHAR The CA certificate used for the dry run connection specified by the LDAPLink TLS Configuration.

2.48 - LDAP_LINK_EVENTS

Monitors events that occurred during an LDAP Link synchronization.

Monitors events that occurred during an LDAP Link synchronization.

Column Name Data Type Description
EVENT_TIMESTAMP TIMESTAMP The time the event occurred.
NODE_NAME VARCHAR The name of the node or nodes for which the information is listed.
SESSION_ID VARCHAR The identification number of the LDAP Link session.
USER_ID INTEGER The unique, system-generated user identification number.
USER_NAME VARCHAR The name of the user for which the information is listed.
TRANSACTION_ID INTEGER The system-generated transaction identification number. Is NULL if a transaction id does not exist.
EVENT_TYPE VARCHAR The type of event being logged, for example USER_CREATED and PROCESSING_STARTED.
ENTRY_NAME VARCHAR The name of the object on which the event occurred, if applicable. For example, the event SYNC-STARTED does not use an object.
ENTRY_OID INTEGER The unique identification number for the object on which the event occurred, if applicable.
LDAPURIHASH INTEGER The URI hash number for the LDAP user.

2.49 - LOAD_SOURCES

Like LOAD_STREAMS, monitors active and historical load metrics on each node.

Like LOAD_STREAMS, monitors active and historical load metrics on each node. The LOAD_SOURCES table breaks information down by source and portion. Rows appear in this table only for COPY operations that are profiled or run for more than one second. LOAD_SOURCES does not record information about loads from ORC or Parquet files or COPY LOCAL.

A row is added to this table when the loading of a source or portion begins. Column values related to the progress of the load are updated during the load operation.

Columns that uniquely identify the load source (the various ID and name columns) and column IS_EXECUTING always have non-NULL values.

Column Name Data Type Description
SESSION_ID VARCHAR Identifier of the session for which Vertica captures load stream information. This identifier is unique within the cluster for the current session but can be reused in a subsequent session.
TRANSACTION_ID INTEGER Identifier for the transaction within a session. If a session is active, but no transaction has begun, this value is NULL.
STATEMENT_ID INTEGER Unique numeric ID for the currently running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID uniquely identifies a statement within a session.
STREAM_NAME VARCHAR

Load stream identifier. If the user does not supply a specific name, the STREAM_NAME default value is tablename-ID, where:

  • tablename is the table into which data is being loaded.

  • ID is an integer value. ID is guaranteed to be unique within the current session on a node.

This system table includes stream names for every COPY statement that takes more than 1 second to run. The 1-second duration includes the time to plan and execute the statement.

SCHEMA_NAME VARCHAR Schema name for which load information is listed. Lets you identify two streams that are targeted at tables with the same name in different schemas. NULL, if selecting from an external table.
TABLE_OID INTEGER A unique numeric ID assigned by the Vertica catalog that identifies the table. NULL, if selecting from an external table.
TABLE_NAME VARCHAR Name of the table being loaded. NULL, if selecting from an external table.
NODE_NAME VARCHAR Name of the node loading the source.
SOURCE_NAME VARCHAR
  • Full file path if copying from a file.

  • Value returned by getUri() if the source is a user-defined source.

  • STDIN if loading from standard input.

PORTION_OFFSET INTEGER Offset of the source portion, or NULL if not apportioned.
PORTION_SIZE INTEGER Size of the source portion, or NULL if not apportioned.
IS_EXECUTING BOOLEAN Whether this source is currently being parsed, where t is true and f is false.
READ_BYTES INTEGER Number of bytes read from the input file.
ROWS_PRODUCED INTEGER Number of rows produced from parsing the source.
ROWS_REJECTED INTEGER Number of rows rejected from parsing the source. If CopyFaultTolerantExpressions is true, also includes rows rejected during expression evaluation.
INPUT_SIZE INTEGER Size of the input source in bytes, or NULL for unsized sources. For UDSources, this value is the value returned by getSize().
PARSE_COMPLETE_PERCENT INTEGER Percent of rows from the input file that have been parsed.
FAILURE_REASON VARCHAR

Indicates cause for failure, one of the following:

  • Load source aborted, error message indicates cause. For example: COPY: Could not open file [filename] for reading; Permission denied
  • Load canceled, displays error message: Statement interrupted

In all other cases, set to NULL.

PEAK_COOPERATING_THREADS INTEGER The peak number of threads parsing this source in parallel.
CLOCK_TIME_SOURCE INTEGER Displays in real-time how many microseconds (µs) have been consumed by the UDSource phase of a load operation.
CLOCK_TIME_FILTERS INTEGER Displays in real-time how many microseconds (µs) have been consumed by all UDFilter phases of a load operation.
CLOCK_TIME_CHUNKER INTEGER Displays in real-time how many microseconds (µs) have been consumed by the UDChunker phase of a load operation.
CLOCK_TIME_PARSER INTEGER Displays in real-time how many microseconds (µs) have been consumed by the UDParser phase of a load operation.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.50 - LOAD_STREAMS

Monitors active and historical load metrics for load streams.

Monitors active and historical load metrics for load streams. This is useful for obtaining statistics about how many records got loaded and rejected from the previous load. Vertica maintains system table metrics until they reach a designated size quota (in kilobytes). This quota is set through internal processes, which you cannot set or view directly.

Column Name Data Type Description
SESSION_ID VARCHAR Identifier of the session for which Vertica captures load stream information. This identifier is unique within the cluster for the current session, but can be reused in a subsequent session.
TRANSACTION_ID INTEGER Identifier for the transaction within a session. If a session is active but no transaction has begun, this is NULL.
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID uniquely identifies a statement within a session.
STREAM_NAME VARCHAR

Load stream identifier. If the user does not supply a specific name, the STREAM_NAME default value is:
tablename-ID

where tablename is the table into which data is being loaded, and ID is an integer value, guaranteed to be unique with the current session on a node.

This system table includes stream names for every COPY statement that takes more than 1-second to run. The 1-second duration includes the time to plan and execute the statement.

SCHEMA_NAME VARCHAR Schema name for which load stream information is listed. Lets you identify two streams that are targeted at tables with the same name in different schemas
TABLE_ID INTEGER Catalog-assigned numeric value that uniquely identifies the table.
TABLE_NAME VARCHAR Name of the table being loaded.
LOAD_START VARCHAR Linux system time when the load started.
LOAD_DURATION_MS NUMERIC(54,0) Duration of the load stream in milliseconds.
IS_EXECUTING BOOLEAN Indicates whether the load is executing, where t is true and f is false.
ACCEPTED_ROW_COUNT INTEGER Number of rows loaded.
REJECTED_ROW_COUNT INTEGER Number of rows rejected.
READ_BYTES INTEGER Number of bytes read from the input file.
INPUT_FILE_SIZE_BYTES INTEGER

Size of the input file in bytes.

Note: When using STDIN as input, the input file size is zero (0).

PARSE_COMPLETE_PERCENT INTEGER Percent of rows from the input file that have been parsed.
UNSORTED_ROW_COUNT INTEGER

Cumulative number rows not sorted across all projections.

Note: UNSORTED_ROW_COUNT could be greater than ACCEPTED_ROW_COUNT because data is copied and sorted for every projection in the target table.

SORTED_ROW_COUNT INTEGER Cumulative number of rows sorted across all projections.
SORT_COMPLETE_PERCENT INTEGER Percent of rows from the input file that have been sorted.

Privileges

If you have the SYSMONITOR role or are the dbadmin user, this table shows all loads. Otherwise it shows only your loads.

2.51 - LOCK_USAGE

Provides aggregate information about lock requests, releases, and attempts, such as wait time/count and hold time/count.

Provides aggregate information about lock requests, releases, and attempts, such as wait time/count and hold time/count. Vertica records:

  • Lock attempts at the end of the locking process

  • Lock releases after lock attempts are released

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information on which lock interaction occurs.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
OBJECT_NAME VARCHAR Name of object being locked; can be a table or an internal structure (projection, global catalog, or local catalog).
MODE VARCHAR Intended operations of the transaction. Otherwise, this value is NONE. For a list of lock modes and compatibility, see Lock modes.
AVG_HOLD_TIME INTERVAL Average time (measured in intervals) that Vertica holds a lock.
MAX_HOLD_TIME INTERVAL Maximum time (measured in intervals) that Vertica holds a lock.
HOLD_COUNT INTEGER Total number of times the lock was granted in the given mode.
AVG_WAIT_TIME INTERVAL Average time (measured in intervals) that Vertica waits on the lock.
MAX_WAIT_TIME INTERVAL Maximum time (measured in intervals) that Vertica waits on a lock.
WAIT_COUNT INTEGER Total number of times lock was unavailable at the time it was first requested.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

2.52 - LOCKS

Monitors lock grants and requests for all nodes.

Monitors lock grants and requests for all nodes. If no locks are active, a query on LOCKS returns no rows.

Column Name Data Type Description
NODE_NAMES VARCHAR

Comma-separated list of nodes where lock interaction occurs.

A transaction can have the same lock in the same mode in the same scope on multiple nodes. However, the transaction gets only one line in the table.

OBJECT_NAME VARCHAR Name of object to lock, either a table or an internal structure: projection, global catalog, or local catalog.
OBJECT_ID INTEGER Unique numeric ID assigned by the Vertica catalog that identifies the object to lock.
TRANSACTION_ID VARCHAR Identifier of transaction within the session, if any; otherwise NULL. Transaction IDs can be used to join other system tables.
TRANSACTION_DESCRIPTION VARCHAR Identifier of transaction and associated description. Typically, this query caused the transaction's creation.
LOCK_MODE VARCHAR Transaction's lock type.
LOCK_SCOPE VARCHAR

Expected duration of the lock after it is granted. Before the lock is granted, Vertica lists the scope as REQUESTED.

After a lock is granted, its scope is set to one of the following:

  • STATEMENT_LOCALPLAN

  • STATEMENT_COMPILE

  • STATEMENT_EXECUTE

  • TRANSACTION_POSTCOMMIT

  • TRANSACTION

All scopes other than TRANSACTION are transient and used only as part of normal query processing.

REQUEST_TIMESTAMP TIMESTAMP Time when the transaction began waiting on the lock.
GRANT_TIMESTAMP TIMESTAMP

Time the transaction acquired or upgraded the lock:

  • Return values are NULL until the grant occurs.

  • If the grant occurs immediately, values might be the same as REQUEST_TIMESTAMP.

See also

2.53 - LOG_ROTATE_EVENTS

Lists the rotation events from do_logrotate_local.

Lists the rotation events from DO_LOGROTATE_LOCAL.

Column Name Data Type Description
NODE_NAME VARCHAR The name of the node from which logs were rotated.
SUCCESS BOOLEAN Whether the call to DO_LOGROTATE_LOCAL succeeded.
MAX_SIZE INTEGER The size, in bytes, set for LogRotateMaxSize.
MAX_AGE INTEGER The age, in days, set for LogRotateMaxAge.
LOG_FILE VARCHAR The path of the original log file.
NEED_ROTATION BOOLEAN Whether the LOG_FILE needed to be rotated.
MESSAGE VARCHAR The actions performed by DO_LOGROTATE_LOCAL for LOG_FILE.

Example

To view all successful rotation events:

=> SELECT * FROM log_rotate_events WHERE need_rotation='t' AND success='t';
-[ RECORD 1 ]-+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
------------------------------------------------
node_name     | v_vmart_node0001
success       | t
max_size      | 104857600
max_age       | 7
log_file      | /scratch_b/VMart/v_vmart_node0001_catalog/vertica.log
need_rotation | t
message       | /scratch_b/VMart/v_vmart_node0001_catalog/vertica.log was rotated to /scratch_b/VMart/v_vmart_node0001_catalog/vertica.log.2023-12-08-15-18-26-965729-05.gz due to force rotation
-[ RECORD 2 ]-+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
------------------------------------------------
node_name     | v_vmart_node0001
success       | t
max_size      | 104857600
max_age       | 7
log_file      | /scratch_b/VMart/v_vmart_node0001_catalog/UDxLogs/UDxFencedProcesses.log
need_rotation | t
message       | /scratch_b/VMart/v_vmart_node0001_catalog/UDxLogs/UDxFencedProcesses.log was rotated to /scratch_b/VMart/v_vmart_node0001_catalog/UDxLogs/UDxFencedProcesses.log.2023-12-15-13-18-27-23141-05.gz due to force rotation

2.54 - LOGIN_FAILURES

This system table lists failures for each failed login attempt.

This system table lists failures for each failed login attempt. This information helps you determine if a user is having difficulty getting into the database or identify a possible intrusion attempt.

Column Name Data Type Description
LOGIN_TIMESTAMP TIMESTAMPTZ Time when Vertica recorded the login.
DATABASE_NAME VARCHAR The name of the database for the login attempt.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_NAME VARCHAR Name of the user whose login failed at the time Vertica recorded the session.
CLIENT_HOSTNAME VARCHAR Host name and port of the TCP socket from which the client connection was made. NULL if the session is internal.
CLIENT_PID INTEGER

Identifier of the client process that issued this connection.

In some cases, the client process is on a different machine from the server.

CLIENT_VERSION VARCHAR Unused.
CLIENT_OS_USER_NAME VARCHAR The name of the user that logged into, or attempted to log into, the database. This is logged even when the login attempt is unsuccessful.
AUTHENTICATION_METHOD VARCHAR

Name of the authentication method used to validate the client application or user who is trying to connect to the server using the database user name provided

Valid values:

  • Trust

  • Reject

  • GSS

  • LDAP

  • Ident

  • Hash

  • TLS

See Configuring client authentication for further information.

CLIENT_AUTHENTICATION_NAME VARCHAR Locally created name of the client authentication method.
REASON VARCHAR

Description of login failure reason.

Valid values:

  • INVALID USER

  • ACCOUNT LOCKED

  • REJECT

  • FAILED

  • INVALID AUTH METHOD

  • INVALID DATABASE

Privileges

Superuser

2.55 - MEMORY_EVENTS

Records events related to Vertica memory usage.

Records events related to Vertica memory usage.

Column Name Data Type Description
NODE_NAME VARCHAR Node where the event occurred
EVENT_TIME TIMESTAMPTZ Event start time
EVENT_TYPE VARCHAR

Type of event, one of the following:

  • MEMORY_REPORT: The Vertica memory poller created a report on memory usage, for the reason specified in EVENT_REASON. For details, see Memory usage reporting.

  • MALLOC_TRIM: Vertica ran the glibc function malloc_trim() to reclaim glibc-allocated memory. For details, see Memory trimming.

EVENT_REASON VARCHAR Reason for the event—for example, trim threshold was greater than RSS / available-memory.
EVENT_DETAILS VARCHAR Additional information about the event—for example, how much memory malloc_trim() reclaimed.
DURATION_US INTEGER Duration of the event in microseconds (µs).

Privileges

None

Examples

=> SELECT * FROM MEMORY_EVENTS;
-[ RECORD 1 ]-+-----------------------------------------------------------------
event_time    | 2019-05-02 13:17:20.700892-04
node_name     | v_vmart_node0001
event_type    | MALLOC_TRIM
event_reason  | memory_trim()
event_details | pre-trim RSS 378822656 post-trim RSS 372129792 benefit 0.0176675
duration_us   | 7724

2.56 - MEMORY_USAGE

Records system resource history for memory usage.

Records system resource history for memory usage. This is useful for comparing memory that Vertica uses versus memory in use by the entire system.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
START_TIME TIMESTAMP Beginning of history interval.
END_TIME TIMESTAMP End of history interval.
AVERAGE_MEMORY_USAGE_PERCENT FLOAT Records the average memory usage in percent of total memory (0-100) during the history interval.

Privileges

Superuser

2.57 - MERGEOUT_PROFILES

Returns information about and status of automatic mergeout operations.

Returns information about and status of automatic mergeout operations.

This table excludes operations with a REQUEST_TYPE of NO_WORK. It also excludes the operations of user-invoked mergeout functions, such as DO_TM_TASK.

Column Name Data Type Description
START_TIME TIMESTAMP When the Tuple Mover began processing storage location mergeout requests.
END_TIME TIMESTAMP When the mergeout finished.
TRANSACTION_ID INTEGER Identifier for the transaction within the session.
NODE_NAME VARCHAR Node name for which information is listed.
SCHEMA_NAME VARCHAR The schema for which information is listed.
TABLE_NAME VARCHAR The table for which information is listed.
PROJECTION_NAME VARCHAR The projection for which information is listed.
PROJECTION_OID INTEGER Projection's unique catalog identifier.
REQUEST_TYPE VARCHAR

Identifies the type of operation performed by the tuple mover. Possible values:

  • PURGE

  • MERGEOUT

  • DVMERGEOUT

EVENT_TYPE VARCHAR

Displays the status of the mergeout operation. Possible values:

  • ERROR

  • RETRY

  • REQUEST_QUEUED

  • REQUEST_COMPLETED

THREAD_ID INTEGER The ID of the thread that performed the mergeout.
STRATA_NO INTEGER The ID of the strata the ROS container belongs to.
PARTITION_KEY INTEGER The key of the partition.
CONTAINER_COUNT INTEGER The number of ROS containers in the mergeout operation.
TOTAL_SIZE_IN_BYTES INTEGER Size in bytes of all ROS containers in the mergeout operation.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Examples

To following statement returns failed mergeout operations for table public.store_orders.

=> SELECT node_name, schema_name, table_name, request_type, event_type FROM mergeout_profiles WHERE event_type='ERROR';
    node_name     | schema_name |  table_name  | request_type | event_type
------------------+-------------+--------------+--------------+------------
 v_vmart_node0002 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0002 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0001 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0001 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0003 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0003 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0003 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0002 | public      | store_orders | MERGEOUT     | ERROR
 v_vmart_node0001 | public      | store_orders | MERGEOUT     | ERROR
 (9 rows)

See also

2.58 - MODEL_STATUS_HISTORY

Lists the status history of registered machine learning models in the database, including models that have been unregistered or dropped.

Lists the status history of registered machine learning models in the database, including models that have been unregistered or dropped. Only superusers or users to whom superusers have granted sufficient privileges can query the table. Vertica recommends granting access to the MLSUPERVISOR role.

Column Name Data Type Description
REGISTERED_NAME VARCHAR Abstract name to which the model, identified by MODEL_ID, was registered at the time of the status change. This REGISTERED_NAME can represent a group of models for a higher-level application, where each model in the group has a unique version number.
REGISTERED_VERSION INTEGER Unique version number of the registered model under its specified REGISTERED_NAME.
NEW_STATUS VARCHAR New status of the registered model.
OLD_STATUS VARCHAR Old status of the registered model.
STATUS_CHANGE_TIME TIMESTAMPTZ Time at which the model status was changed.
OPERATOR_ID INTEGER Internal ID of the user who performed the status change.
OPERATOR_NAME VARCHAR Name of the user who performed the status change.
MODEL_ID INTEGER Internal ID of the model for which information is listed.
SCHEMA_NAME VARCHAR Name of the schema that contains the model. This value is NULL if the model has been dropped.
MODEL_NAME VARCHAR

Name of the model. This value is NULL if the model has been dropped.

Each existing model can be uniquely identified by either its [schema_name.]model_name or the combination of its REGISTERED_NAME and REGISTERED_VERSION.

Example

If a superuser grants SELECT access of the table to the MLSUPERVISOR role, users with that role can then query the MODEL_STATUS_HISTORY table:

-- as superuser
=> GRANT SELECT ON TABLE v_monitor.model_status_history TO MLSUPERVISOR;
WARNING 8555:  You are granting privilege on a system table used by superuser only. Revoke the grant if you are unsure
GRANT PRIVILEGE

-- as user with MLSUPERVISOR role
=> SELECT * FROM MODEL_STATUS_HISTORY;
 registered_name | registered_version |  new_status  |  old_status  |       status_change_time      | operator_id | operator_name |  model_id  | schema_name |    model_name
-----------------+--------------------+--------------+------------- +-------------------------------+-------------+---------------+------------+-------------+-------------------
 app1            |                  1 | UNDER_REVIEW | UNREGISTERED | 2023-01-29 09:09:00.082166-05 | 1224567790  | u1            | 0113756739 | public      | native_linear_reg
 app1            |                  1 | STAGING      | UNDER_REVIEW | 2023-01-29 11:33:02.052464-05 | 2341679901  | supervisor1   | 0113756739 | public      | native_linear_reg
 app1            |                  1 | PRODUCTION   | STAGING      | 2023-01-30 04:12:30.481136-05 | 2341679901  | supervisor1   | 0113756739 | public      | native_linear_reg
(3 rows)

See also

2.59 - MONITORING_EVENTS

Reports significant events that can affect database performance and functionality if you do not address their root causes.

Reports significant events that can affect database performance and functionality if you do not address their root causes.

See Monitoring events for details.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
EVENT_CODE INTEGER Numeric identifier that indicates the type of event. See Event Types in Monitoring events for a list of event type codes.
EVENT_ID INTEGER Unique numeric ID that identifies the specific event.
EVENT_SEVERITY VARCHAR

Severity of the event from highest to lowest. These events are based on standard syslog severity types:

0 – Emergency

1 – Alert

2 – Critical

3 – Error

4 – Warning

5 – Notice

6 – Info

7 – Debug

EVENT_POSTED_TIMESTAMP TIMESTAMPTZ When this event was posted.
EVENT_CLEARED_TIMESTAMP TIMESTAMPTZ

When this event was cleared.

Note: You can also query the ACTIVE_EVENTS system table to see events that have not been cleared.

EVENT_EXPIRATION TIMESTAMPTZ Time at which this event expires. If the same event is posted again prior to its expiration time, this field gets updated to a new expiration time.
EVENT_CODE_DESCRIPTION VARCHAR Brief description of the event and details pertinent to the specific situation.
EVENT_PROBLEM_DESCRIPTION VARCHAR Generic description of the event.

Privileges

Superuser

See also

ACTIVE_EVENTS

2.60 - NETWORK_INTERFACES

Provides information about network interfaces on all Vertica nodes.

Provides information about network interfaces on all Vertica nodes.

Column Name Data Type Description
NODE_ID INTEGER Unique identifier for the node that recorded the row.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
INTERFACE VARCHAR Network interface name.
IP_ADDRESS_FAMILY VARCHAR Network address family (either 'ipv4' or 'ipv6').
IP_ADDRESS VARCHAR IP address for this interface.
SUBNET VARCHAR IP subnet for this interface.
MASK VARCHAR IP network mask for this interface.
BROADCAST_ADDRESS VARCHAR IP broadcast address for this interface.

Privileges

None

Examples

=> \x
Expanded display is on.
=> SELECT * FROM network_interfaces ORDER BY node_name ASC LIMIT 14;
-[ RECORD 1 ]-----+----------------------------------------
node_id           | 45035996273704982
node_name         | v_verticadb_node0001
interface         | lo
ip_address_family | ipv6
ip_address        | ::1
subnet            | ::1
mask              | ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff
broadcast_address |
-[ RECORD 2 ]-----+----------------------------------------
node_id           | 45035996273704982
node_name         | v_verticadb_node0001
interface         | ens192
ip_address_family | ipv6
ip_address        | fd9b:1fcc:1dc4:78d3::31
subnet            | fd9b:1fcc:1dc4:78d3::
mask              | ffff:ffff:ffff:ffff::
broadcast_address |
-[ RECORD 3 ]-----+----------------------------------------
node_id           | 45035996273704982
node_name         | v_verticadb_node0001
interface         | lo
ip_address_family | ipv4
ip_address        | 127.0.0.1
subnet            | 127.0.0.0
mask              | 255.0.0.0
broadcast_address | 127.0.0.1
-[ RECORD 4 ]-----+----------------------------------------
node_id           | 45035996273704982
node_name         | v_verticadb_node0001
interface         | ens192
ip_address_family | ipv4
ip_address        | 192.168.111.31
subnet            | 192.168.111.0
mask              | 255.255.255.0
broadcast_address | 192.168.111.255
-[ RECORD 5 ]-----+----------------------------------------
node_id           | 45035996273704982
node_name         | v_verticadb_node0001
interface         | ens32
ip_address_family | ipv4
ip_address        | 10.20.110.21
subnet            | 10.20.110.0
mask              | 255.255.255.0
broadcast_address | 10.20.110.255
-[ RECORD 6 ]-----+----------------------------------------
node_id           | 45035996273704982
node_name         | v_verticadb_node0001
interface         | ens32
ip_address_family | ipv6
ip_address        | fe80::250:56ff:fe8e:61d3
subnet            | fe80::
mask              | ffff:ffff:ffff:ffff::
broadcast_address |
-[ RECORD 7 ]-----+----------------------------------------
node_id           | 45035996273704982
node_name         | v_verticadb_node0001
interface         | ens192
ip_address_family | ipv6
ip_address        | fe80::250:56ff:fe8e:2721
subnet            | fe80::
mask              | ffff:ffff:ffff:ffff::
broadcast_address |
-[ RECORD 8 ]-----+----------------------------------------
node_id           | 45035996273841968
node_name         | v_verticadb_node0002
interface         | lo
ip_address_family | ipv6
ip_address        | ::1
subnet            | ::1
mask              | ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff
broadcast_address |
-[ RECORD 9 ]-----+----------------------------------------
node_id           | 45035996273841968
node_name         | v_verticadb_node0002
interface         | ens192
ip_address_family | ipv6
ip_address        | fd9b:1fcc:1dc4:78d3::32
subnet            | fd9b:1fcc:1dc4:78d3::
mask              | ffff:ffff:ffff:ffff::
broadcast_address |
-[ RECORD 10 ]----+----------------------------------------
node_id           | 45035996273841968
node_name         | v_verticadb_node0002
interface         | lo
ip_address_family | ipv4
ip_address        | 127.0.0.1
subnet            | 127.0.0.0
mask              | 255.0.0.0
broadcast_address | 127.0.0.1
-[ RECORD 11 ]----+----------------------------------------
node_id           | 45035996273841968
node_name         | v_verticadb_node0002
interface         | ens192
ip_address_family | ipv4
ip_address        | 192.168.111.32
subnet            | 192.168.111.0
mask              | 255.255.255.0
broadcast_address | 192.168.111.255
-[ RECORD 12 ]----+----------------------------------------
node_id           | 45035996273841968
node_name         | v_verticadb_node0002
interface         | ens32
ip_address_family | ipv4
ip_address        | 10.20.110.22
subnet            | 10.20.110.0
mask              | 255.255.255.0
broadcast_address | 10.20.110.255
-[ RECORD 13 ]----+----------------------------------------
node_id           | 45035996273841968
node_name         | v_verticadb_node0002
interface         | ens32
ip_address_family | ipv6
ip_address        | fe80::250:56ff:fe8e:1787
subnet            | fe80::
mask              | ffff:ffff:ffff:ffff::
broadcast_address |
-[ RECORD 14 ]----+----------------------------------------
node_id           | 45035996273841968
node_name         | v_verticadb_node0002
interface         | ens192
ip_address_family | ipv6
ip_address        | fe80::250:56ff:fe8e:2c9c
subnet            | fe80::
mask              | ffff:ffff:ffff:ffff::
broadcast_address |

2.61 - NETWORK_USAGE

Provides network bandwidth usage history on the system.

Provides network bandwidth usage history on the system. This is useful for determining if Vertica is using a large percentage of its available network bandwidth.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
START_TIME TIMESTAMP Beginning of history interval.
END_TIME TIMESTAMP End of history interval.
TX_KBYTES_PER_SEC FLOAT Counter history of outgoing (transmitting) usage in kilobytes per second.
RX_KBYTES_PER_SEC FLOAT Counter history of incoming (receiving) usage in kilobytes per second.

Privileges

Superuser

2.62 - NODE_EVICTIONS

Monitors node evictions on the system.

Monitors node evictions on the system.

Column Name Data Type Description
EVICTION_TIMESTAMP TIMESTAMPTZ Timestamp when the eviction request was made.
NODE_NAME VARCHAR The node name logging the information.
EVICTED_NODE_NAME VARCHAR The node name of the evicted node.
EVICTED_NODE_ID INTEGER The evicted node ID.
NODE_STATE_BEFORE_EVICTION VARCHAR The previous node state at the time of eviction.

2.63 - NODE_RESOURCES

Provides a snapshot of the node.

Provides a snapshot of the node. This is useful for regularly polling the node with automated tools or scripts.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
HOST_NAME VARCHAR The hostname associated with a particular node.
NODE_IDENTIFIER VARCHAR A unique identifier for the node.
PROCESS_SIZE_BYTES INTEGER The total size of the program.
PROCESS_RESIDENT_SET_SIZE_BYTES INTEGER The total number of bytes that the process has in memory.
PROCESS_SHARED_MEMORY_SIZE_BYTES INTEGER The amount of shared memory used.
PROCESS_TEXT_MEMORY_SIZE_BYTES INTEGER The total number of text bytes that the process has in physical memory. This does not include any shared libraries.
PROCESS_DATA_MEMORY_SIZE_BYTES INTEGER The amount of physical memory, in bytes, used for performing processes. This does not include the executable code.
PROCESS_LIBRARY_MEMORY_SIZE_BYTES INTEGER The total number of library bytes that the process has in physical memory.
PROCESS_DIRTY_MEMORY_SIZE_BYTES INTEGER The number of bytes that have been modified since they were last written to disk.
SPREAD_HOST VARCHAR The node name of the spread host.
NODE_PORT VARCHAR The port used for intra-cluster communication.
DATA_PORT VARCHAR The port used by the Vertica client.
DBCLERK BOOLEAN Whether this node is the DB clerk. The DB clerk is responsible for coordinating some administrative tasks in the database.

2.64 - NODE_STATES

Monitors node recovery state-change history on the system.

Monitors node recovery state-change history on the system. Vertica returns information only on nodes whose state is currently UP. To determine which nodes are not up, query the NODES table.

Column Name Data Type Description
EVENT_TIMESTAMP TIMESTAMPTZ Time when Vertica recorded the event.
NODE_ID INTEGER Catalog-assigned integer value that uniquely identifies thenode.
NODE_NAME VARCHAR Name of the node.
NODE_STATE VARCHAR

The node's state, one of the following:

  • UP

  • DOWN

  • READY

  • UNSAFE

  • SHUTDOWN

  • SHUTDOWN_ERROR

  • RECOVERING

  • RECOVER_ERROR

  • RECOVERED

  • INITIALIZING

  • STANDBY

  • NEEDS_CATCHUP

The following flow chart details different node states:

Privileges

None

2.65 - NOTIFIER_ERRORS

Reports errors encountered by notifiers.

Reports errors encountered by notifiers.

Column Name Data Type Description
ERROR_TIME TIMESTAMPTZ The time that the error occurred.
NODE_NAME VARCHAR Name of the node that encountered the error.
NOTIFIER_NAME VARCHAR Name of the notifier that triggered the error.
DESCRIPTION VARCHAR A description of the error.

Privileges

Superuser

2.66 - OUTPUT_DEPLOYMENT_STATUS

Contains information about the deployment status of all the projections in your design.

Contains information about the deployment status of all the projections in your design. Each row contains information about a different projection. Vertica populates this table when you deploy the database design by running the function DESIGNER_RUN_POPULATE_DESIGN_AND_DEPLOY.

Column Name Column Type Description
deployment_id INTEGER Unique ID that Database Designer assigned to the deployment.
design_name VARCHAR Unique name that the user assigned to the design.
deployment_projection_id INTEGER Unique ID that Database Designer assigned to the output projection.
deployment_projection_name VARCHAR Name that Database Designer assigned to the output projection or the name of the projection to be dropped.
deployment_status VARCHAR

Status of the deployment:

  • pending

  • complete

  • needs_refresh

  • in_progress

  • error

error_message VARCHAR Text of any error that occurred when creating or refreshing the specified projection.

2.67 - OUTPUT_EVENT_HISTORY

Contains information about each stage that Database Designer performs to design and optimize your database design.

Contains information about each stage that Database Designer performs to design and optimize your database design.

Column Name Data Type Description
TIME_STAMP TIMESTAMP Date and time of the specified stage.
DESIGN_ID INTEGER Unique id that Database Designer assigned to the design.
DESIGN_NAME VARCHAR Unique name that the user assigned to the design.
STAGE_TYPE VARCHAR

Design stage that Database Designer was working on at the time indicated by the TIME_STAMP field. Possible values include:

  • Design in progress

  • Analyzing data statistics

  • Optimizing query performance

  • Optimizing storage footprint

  • All done

  • Deployment in progress

ITERATION_NUMBER INTEGER Iteration number for the Optimizing query performance stage.
TOTAL_QUERY_COUNT INTEGER Total number of design queries in the design.
REMAINING_QUERY_COUNT INTEGER Number of design queries remaining for Database Designer to process.
MAX_STEP_NUMBER INTEGER Number of steps in the current stage.
CURRENT_STEP_NUMBER INTEGER Step in the current stage being processed at the time indicated by the TIME_STAMP field.
CURRENT_STEP_DESCRIPTION VARCHAR

Name of the step that Database Designer is performing at that time indicated in the TIME_STAMP field. Possible values include:

  • Design with deployment started

  • Design in progress: Analyze statistics phase

  • design_table_name

  • projection_name

  • Design in progress: Query optimization phase

  • Extracting interesting columns

  • Enumerating sort orders

  • Setting up projection candidates

  • Assessing projection candidates

  • Choosing best projections

  • Calculating estimated benefit of best projections

  • Complete

  • Design in progress: Storage optimization phase

  • Design completed successfully

  • Setting up deployment metadata

  • Identifying projections to be dropped

  • Running deployment

  • Deployment completed successfully

TABLE_ID INTEGER Unique id that Database Designer assigned to the design table.

Examples

The following example shows the steps that Database Designer performs while optimizing the VMart example database:

=> SELECT DESIGNER_CREATE_DESIGN('VMART_DESIGN');
=> SELECT DESIGNER_ADD_DESIGN_TABLES('VMART_DESIGN','public.*');
=> SELECT DESIGNER_ADD_DESIGN_QUERIES('VMART_DESIGN','/tmp/examples/vmart_queries.sql',);
...
=> \x
Expanded display is on.
=> SELECT * FROM OUTPUT_EVENT_HISTORY;
-[ RECORD 1 ] -----------+----------------------------
time_stamp               | 2013-06-05 11:44:41.588
design_id                | 45035996273705090
design_name              | VMART_DESIGN
stage_type               | Design in progress
iteration_number         |
total_query_count        |
remaining_query_count    |
max_step_number          |
current_step_number      |
current_step_description | Design with deployment started
table id                 |
-[ RECORD 2 ] -----------+----------------------------
time_stamp               | 2013-06-05 11:44:41.611
design_id                | 45035996273705090
design_name              | VMART_DESIGN
stage_type               | Design in progress
iteration_number         |
total_query_count        |
remaining_query_count    |
max_step_number          |
current_step_number      |
current_step_description | Design in progress: Analyze statistics phase
table id                 |
-[ RECORD 3 ] -----------+----------------------------
time_stamp               | 2013-06-05 11:44:42.011
design_id                | 45035996273705090
design_name              | VMART_DESIGN
stage_type               | Analyzing statistics
iteration_number         |
total_query_count        |
remaining_query_count    |
max_step_number          | 15
current_step_number      | 1
current_step_description | public.customer_dimension
table id                 |
...
-[ RECORD 20 ] ----------+----------------------------
time_stamp               | 2013-06-05 11:44:49.324
design_id                | 45035996273705090
design_name              | VMART_DESIGN
stage_type               | Optimizing query performance
iteration_number         | 1
total_query_count        | 9
remaining_query_count    | 9
max_step_number          | 7
current_step_number      | 1
current_step_description | Extracting interesting columns
table id                 |
...
-[ RECORD 62 ] ----------+----------------------------
time_stamp               | 2013-06-05 11:51:23.790
design_id                | 45035996273705090
design_name              | VMART_DESIGN
stage_type               | Deployment in progress
iteration_number         |
total_query_count        |
remaining_query_count    |
max_step_number          |
current_step_number      |
current_step_description | Deployment completed successfully
table id                 |

2.68 - PARTITION_COLUMNS

For each projection of a partitioned table, shows the following information:.

For each projection of a partitioned table, shows the following information:

  • Disk space used by each column per node.

  • Statistics that were collected on partition columns

Disk usage

The column DISK_SPACE_BYTES shows how much disk space the partitioned data uses, including deleted data. So, if you delete rows but do not purge them, the DELETED_ROW_COUNT column changes to show the number of deleted rows in each column; however, DISK_SPACE_BYTES remains unchanged. After deleted rows are purged, Vertica,reclaims the disk space: DISK_SPACE_BYTES changes accordingly, and DELETED_ROW_COUNT is reset to 0.

For grouped partitions, PARTITION_COLUMNS shows the cumulative disk space used for each column per grouped partition. The column GROUPED_PARTITION_KEY, if not null, identifies the partition in which a given column is grouped.

Statistics

STATISTICS_TYPE always shows the most complete type of statistics that are available on a given column, irrespective of timestamp. For example, if you collect statistics for a table on all levels—table, partition, and row, STATISTICS_TYPE is set to FULL (table-level), even if partition- and row-level statistics were collected more recently.

Column Name Data Type Description
COLUMN_NAME VARCHAR Identifies a named column within the partitioned table.
COLUMN_ID INTEGER Unique numeric ID assigned by the Vertica, which identifies the column.
TABLE_NAME VARCHAR Name of the partitioned table.
PROJECTION_NAME VARCHAR Projection name for which information is listed.
PROJECTION_ID INTEGER Unique numeric ID assigned by Vertica, which identifies the projection.
NODE_NAME VARCHAR Node that hosts partitioned data.
PARTITION_KEY VARCHAR Identifies the table partition.
GROUPED_PARTITION_KEY VARCHAR Identifies the grouped partition to which a given column belongs.
ROW_COUNT INTEGER The total number of partitioned data rows for each column, including deleted rows.
DELETED_ROW_COUNT INTEGER Number of deleted partitioned data rows in each column.
DISK_SPACE_BYTES INTEGER Amount of space used by partitioned data.
STATISTICS_TYPE VARCHAR

Specifies what sort of statistics are used for this column, one of the following listed in order of precedence:

  1. FULL: Table-level statistics

  2. PARTITION: Partition-level statistics

  3. ROWCOUNT: Minimal set of statistics and aggregate row counts

STATISTICS_UPDATED_TIMESTAMP TIMESTAMPTZ Specifies when statistics of the type specified in STATISTICS_TYPE were collected for this column.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Examples

Given the following table definition:

=> CREATE TABLE messages
(
    time_interval timestamp NOT NULL,
    thread_id varchar(32) NOT NULL,
    unique_id varchar(53) NOT NULL,
    msg_id varchar(65),
    ...
    )
PARTITION BY ((messages.time_interval)::date);

a query on partition_columns might return the following (truncated) results:

=> SELECT * FROM partition_columns order by table_name, column_name;
column_name | column_id | table_name | projection_name | projection_id     | node_name        | partition_key | grouped_partition_key  | row_count | deleted_row_count | disk_space_bytes
---------------------------+----------+----------------+-------------------+------------------+---------------+------------------------+-----------+-------------------+------------------
msg_id | 45035996273743190 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-03    |                        | 6147      | 0                 | 41145
msg_id | 45035996273743190 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-15    |                        | 178       | 0                 | 65
msg_id | 45035996273743190 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-03    |                        | 6782      | 0                 | 45107
msg_id | 45035996273743190 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-04    |                        | 866       | 0                 | 5883
...

thread_id | 45035996273743186 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-03 |                        | 6147      | 0                 | 70565
thread_id | 45035996273743186 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-15 |                        | 178       | 0                 | 2429
thread_id | 45035996273743186 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-03 |                        | 6782      | 0                 | 77730
thread_id | 45035996273743186 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-04 |                        | 866       | 0                 | 10317
...

time_interval | 45035996273743184 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-03 |                    | 6147      | 0                 | 6320
time_interval | 45035996273743184 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-15 |                    | 178       | 0                 | 265
time_interval | 45035996273743184 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-03 |                    | 6782      | 0                 | 6967
time_interval | 45035996273743184 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-04 |                    | 866       | 0                 | 892
...

unique_id | 45035996273743188 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-03 |                        | 6147      | 0                 | 70747
unique_id | 45035996273743188 | messages | messages_super | 45035996273743182 | v_vmart_node0002 | 2010-07-15 |                        | 178       | 0                 | 2460
unique_id | 45035996273743188 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-03 |                        | 6782      | 0                 | 77959
unique_id | 45035996273743188 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-04 |                        | 866       | 0                 | 10332
unique_id | 45035996273743188 | messages | messages_super | 45035996273743182 | v_vmart_node0003 | 2010-07-15 |                        | 184       | 0                 | 2549
...

(11747 rows)

2.69 - PARTITION_REORGANIZE_ERRORS

new column projection_id.

Monitors all background partitioning tasks, and if Vertica encounters an error, creates an entry in this table with the appropriate information. Does not log repartitioning tasks that complete successfully.

Column Name Data Type Description
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
USER_NAME VARCHAR Name of the user who received the error at the time Vertica recorded the session.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
TABLE_NAME VARCHAR Name of the partitioned table.
PROJECTION_ID INTEGER Catalog-assigned numeric value that uniquely identifies the projection.
PROJECTION_NAME VARCHAR Projection name for which information is listed.
MESSAGE VARCHAR Textual output of the error message.
HINT VARCHAR Actionable hint about the error.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.70 - PARTITION_STATUS

For each projection of each partitioned table, shows the fraction of its data that is actually partitioned according to the current partition expression.

For each projection of each partitioned table, shows the fraction of its data that is actually partitioned according to the current partition expression. When the partitioning of a table is altered, the value in PARTITION_REORGANIZE_PERCENT for each of its projections drops to zero and goes back up to 100 when all the data is repartitioned.

Column Name Data Type Description
PROJECTION_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the projection.
TABLE_SCHEMA VARCHAR Name of the schema that contains the partitioned table.
TABLE_NAME VARCHAR Table name that is partitioned.
TABLE_ID INTEGER Unique numeric ID assigned by the Vertica, which identifies the table.
PROJECTION_SCHEMA VARCHAR Schema containing the projection.
PROJECTION_NAME VARCHAR Projection name for which information is listed.
PARTITION_REORGANIZE_PERCENT INTEGER For each projection, drops to zero and goes back up to 100 when all the data is repartitioned after the partitioning of a table has been altered. Ideally all rows will show 100 (%).

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.71 - PARTITIONS

Displays partition metadata, one row per partition key, per ROS container.

Displays partition metadata, one row per partition key, per ROS container.

Column Name Data Type Description
PARTITION_KEY VARCHAR The partition value(s).
PROJECTION_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the projection.
TABLE_SCHEMA VARCHAR

The schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

PROJECTION_NAME VARCHAR The projection name for which information is listed.
ROS_ID VARCHAR A unique numeric ID assigned by the Vertica catalog, which identifies the ROS container.
ROS_SIZE_BYTES INTEGER The ROS container size in bytes.
ROS_ROW_COUNT INTEGER Number of rows in the ROS container.
NODE_NAME VARCHAR Node where the ROS container resides.
DELETED_ROW_COUNT INTEGER The number of deleted rows in the partition.
LOCATION_LABEL VARCHAR The location label of the default storage location.

Notes

  • A many-to-many relationship exists between partitions and ROS containers. PARTITIONS displays information in a denormalized fashion.

  • To find the number of ROS containers having data of a specific partition, aggregate PARTITIONS over the partition_key column.

  • To find the number of partitions stored in a ROS container, aggregate PARTITIONS over the ros_id column.

Examples

See Viewing partition storage data.

2.72 - PROCESS_SIGNALS

Returns a history of signals that were received and handled by the Vertica process.

Returns a history of signals that were received and handled by the Vertica process. For details about signals, see the Linux documentation.

Column Name Data Type Description
SIGNAL_TIMESTAMP TIMESTAMPTZ Time when Vertica recorded the signal.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
SIGNAL_NUMBER INTEGER Signal number, refers to POSIX SIGNAL_NUMBER
SIGNAL_CODE INTEGER Signal code.
SIGNAL_PID INTEGER Linux process identifier of the signal.
SIGNAL_UID INTEGER Process ID of sending process.
SIGNAL_ADDRESS INTEGER Address at which fault occurred.

Privileges

Superuser

2.73 - PROJECTION_RECOVERIES

Retains history about projection recoveries.

Retains history about projection recoveries. Because Vertica adds an entry per recovery plan, a projection/node pair might appear multiple times in the output.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is recovering or has recovered the corresponding projection.
PROJECTION_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the projection.
PROJECTION_NAME VARCHAR Name of the projection that is being or has been recovered on the corresponding node.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any. TRANSACTION_ID initializes as NO_TRANSACTION with a value of 0. Vertica will ignore the recovery query and keep (0) if there's no action to take (no data in the table, etc). When no recovery transaction starts, ignored value appears in this table's STATUS column.
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID uniquely identifies a statement within a session.
METHOD VARCHAR

Recovery method that Vertica chooses. Possible values are:

  • incremental

  • incremental-replay-delete

  • split

  • recovery-by-container

STATUS VARCHAR

Current projection-recovery status on the corresponding node. STATUS can be "queued," which indicates a brief period between the time the query is prepared and when it runs. Possible values are:

  • queued

  • running

  • finished

  • ignored

  • error-retry

  • error-fatal

PROGRESS INTEGER

An estimate (value in the range [0,100]) of percent complete for the recovery task described by this information.

Note: The actual amount of time it takes to complete a recovery task depends on a number of factors, including concurrent workloads and characteristics of the data; therefore, accuracy of this estimate can vary.

The PROGRESS column value is NULL after the task completes.

DETAIL VARCHAR

More detailed information about PROGRESS. The values returned for this column depend on the type of recovery plan:

  • General recovery plans – value displays the estimated progress, as a percent, of the three primary parts of the plan: Scan, Sort, and Write.

  • Recovery-by-container plans – value begins with CopyStorage: and is followed by the number of bytes copied over the total number of bytes to copy.

  • Replay delete plans – value begins with Delete: and is followed by the number of deletes replayed over an estimate of the total number of deletes to replay.

The DETAIL column value becomes NULL after the recovery plan completes.

START_TIME TIMESTAMPTZ Time the recovery task described by this information started.
END_TIME TIMESTAMPTZ Time the recovery task described by this information ended.
RUNTIME_PRIORITY VARCHAR

Determines the amount of runtime resources (CPU, I/O bandwidth) the Resource Manager should dedicate to running queries in the resource pool. Valid values are:

  • HIGH

  • MEDIUM

  • LOW

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

RECOVERY_STATUS

2.74 - PROJECTION_REFRESHES

Records information about successful and unsuccessful refresh operations. PROJECTION_REFRESHES retains projection refresh data until one of the following events occurs:

  • Another refresh operation starts on a given projection.

  • CLEAR_PROJECTION_REFRESHES is called and clears data on all projections.

  • The table's storage quota is exceeded.

Column Name Data Type Description
NODE_NAME VARCHAR Node where the refresh was initiated.
PROJECTION_SCHEMA VARCHAR Name of the projection schema.
PROJECTION_ID INTEGER Catalog-assigned numeric value that uniquely identifies the projection.
PROJECTION_NAME VARCHAR Name of the refreshed projection.
ANCHOR_TABLE_NAME VARCHAR Name of the projection's anchor table.
REFRESH_STATUS VARCHAR

Status of refresh operations for this projection, one of the following:

  • Queued : Projection is queued for refresh.

  • Refreshing: Projection refresh is in progress.

  • Refreshed: Projection refresh is complete.

  • Failed: Projection refresh failed.

PERCENT_COMPLETE VARCHAR Shows the current percentage of completion for the refresh operation. When the refresh is complete, the column is set to NULL.
REFRESH_PHASE VARCHAR

Indicates how far the refresh has progressed:

  • Historical: Refresh reached the first phase and is refreshing data from historical data. This refresh phase requires the most amount of time.

  • Current: Refresh reached the final phase and is attempting to refresh data from the current epoch. To complete this phase, refresh must obtain a lock on the table. If the table is locked by another transaction, refresh is blocked until that transaction completes.

The LOCKS system table is useful for determining if a refresh is blocked on a table lock. To determine if a refresh has been blocked, locate the term "refresh" in the transaction description. A refresh has been blocked when the scope for the refresh is REQUESTED and other transactions acquired a lock on the table.

This field is NULL until the projection starts to refresh and is NULL after the refresh completes.

REFRESH_METHOD VARCHAR

Method used to refresh the projection:

  • Buddy: Projection refreshed from the contents of a buddy projection. This method maintains historical data, so the projection can be used for historical queries.

  • Scratch: Projection refreshed without using a buddy projection. This method does not generate historical data, so the projection cannot participate in historical queries on data that precedes the refresh.

  • Rebalance: If the projection is segmented, it is refreshed from scratch; if unsegmented, it is refreshed from a buddy projection.

  • Incremental: Projections of a partitioned table were refreshed one partition at a time. For details, see Refreshing projections.

REFRESH_FAILURE_COUNT INTEGER Number of times a refresh failed for the projection. REFRESH_FAILURE_COUNT does not indicate whether the projection was eventually refreshed. See REFRESH_STATUS to determine whether the refresh operation is progressing.
SESSION_ID VARCHAR Unique numeric ID assigned by the Vertica catalog, which identifies the refresh session.
REFRESH_START TIMESTAMPTZ Time the projection refresh started.
REFRESH_DURATION_SEC INTERVAL SECOND (0) How many seconds the projection refresh ran.
IS_EXECUTING BOOLEAN Differentiates active and completed refresh operations.
RUNTIME_PRIORITY VARCHAR

Determines how many run-time resources (CPU, I/O bandwidth) the Resource Manager should dedicate to running queries in the resource pool, one of the following:

  • HIGH

  • MEDIUM

  • LOW

TRANSACTION_ID INTEGER

Identifier for the transaction within the session, if any; otherwise NULL.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.75 - PROJECTION_STORAGE

Monitors the amount of disk storage used by each projection on each node.

Monitors the amount of disk storage used by each projection on each node.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
PROJECTION_ID VARCHAR Catalog-assigned numeric value that uniquely identifies the projection.
PROJECTION_NAME VARCHAR The projection name for which information is listed.
PROJECTION_SCHEMA VARCHAR The name of the schema associated with the projection.
PROJECTION_COLUMN_COUNT INTEGER The number of columns in the projection.
ROW_COUNT INTEGER The number of rows in the table's projections, including any rows marked for deletion.
USED_BYTES INTEGER Number of bytes in disk storage used to store the compressed projection data. This value should not be compared to the output of the AUDIT function, which returns the raw data size of database objects.
ROS_COUNT INTEGER The number of ROS containers in the projection.
ANCHOR_TABLE_NAME VARCHAR The associated table name for which information is listed.
ANCHOR_TABLE_SCHEMA VARCHAR The associated table schema for which information is listed.
ANCHOR_TABLE_ID INTEGER A unique numeric ID, assigned by the Vertica catalog, which identifies the anchor table.
DISK_SIZE INTEGER Size in bytes of the projection's compressed storage.

See also

2.76 - PROJECTION_USAGE

Records information about projections Vertica used in each processed query.

Records information about projections Vertica used in each processed query.

Column Name Data Type Description
QUERY_START_TIMESTAMP TIMESTAMPTZ Value of query at beginning of history interval.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_NAME VARCHAR Name of the user at the time Vertica recorded the session.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
REQUEST_ID INTEGER Unique identifier of the query request in the user session.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any; otherwise NULL.
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID, and REQUEST_ID uniquely identifies a statement within a session.
IO_TYPE VARCHAR Input/output.
PROJECTION_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the projection.
PROJECTION_NAME VARCHAR Projection name for which information is listed.
ANCHOR_TABLE_ID INTEGER Unique numeric ID assigned by the Vertica, which identifies the anchor table.
ANCHOR_TABLE_SCHEMA VARCHAR Name of the schema that contains the anchor table.
ANCHOR_TABLE_NAME VARCHAR Name of the projection's associated anchor table.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.77 - QUERY_CONSUMPTION

Summarizes execution of individual queries.

Summarizes execution of individual queries. Columns STATEMENT_ID and TRANSACTION_ID combine as unique keys to these queries. One exception applies: a query with multiple plans has as many records.

Column Name Data Type Description
START_TIME END_TIME TIMESTAMP Demarcate the start and end of query execution, whether successful or not.
SESSION_ID VARCHAR Identifies the session where profiling information was captured. This identifier is unique within the cluster at any point in time, but can be reused when the session closes.
USER_ID INTEGER Unique numeric user identifier assigned by the Vertica catalog.
USER_NAME VARCHAR User name specified by this query profile.
TRANSACTION_ID INTEGER Identifies the transaction in which the query ran.
STATEMENT_ID INTEGER Numeric identifier of this query, unique within the query transaction.
CPU_CYCLES_US INTEGER Sum, in microseconds, of CPU cycles spent by all threads to process this query.
NETWORK_BYTES_SENT NETWORK_BYTES_RECEIVED INTEGER Total amount of data sent/received over the network by execution engine operators.
DATA_BYTES_READ DATA_BYTES_WRITTEN INTEGER Total amount of data read/written by storage operators from and to disk, includes all locations: local, HDFS, S3.
DATA_BYTES_LOADED INTEGER Total amount of data loaded from external sources: COPY, external tables, and data load.
BYTES_SPILLED INTEGER Total amount of data spilled to disk—for example, by SortManager, Join, and NetworkSend operators.
INPUT_ROWS INTEGER Number of unfiltered input rows from DataSource and Load operators. INPUT_ROWS shows the number of input rows that the query plan worked with, but excludes intermediate processing. For example, INPUT_ROWS excludes how many times SortManager spilled and read the same row.
INPUT_ROWS_PROCESSED INTEGER Value of INPUT_ROWS minus what was filtered by applying query predicates (valindex) and SIPs, and rows rejected by COPY.
PEAK_MEMORY_KB INTEGER Peak memory reserved by the resource manager for this query.
THREAD_COUNT INTEGER Maximum number of threads opened to process this query.
DURATION_MS INTEGER Total wall clock time, in milliseconds, spent to process this query.
RESOURCE_POOL VARCHAR Name of the resource pool where the query was executed.
OUTPUT_ROWS INTEGER Number of rows output to the client.
REQUEST_TYPE VARCHAR Type of query—for example, QUERY or DDL.
LABEL VARCHAR Label included as a LABEL hint in this query.
IS_RETRY BOOLEAN This query was tried earlier.
SUCCESS BOOLEAN This query executed successfully.

2.78 - QUERY_EVENTS

Returns information about query planning, optimization, and execution events.

Returns information about query planning, optimization, and execution events.

Column Name Data Type Description
EVENT_TIMESTAMP TIMESTAMPTZ Time when Vertica recorded the event.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_ID INTEGER Identifier of the user for the query event.
USER_NAME VARCHAR Name of the user for which Vertica lists query information at the time it recorded the session.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
REQUEST_ID* INTEGER Unique identifier of the query request in the user session.
TRANSACTION_ID* INTEGER Identifier for the transaction within the session, if any; otherwise NULL.
STATEMENT_ID* INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed.
EVENT_CATEGORY VARCHAR Category of event: OPTIMIZATION or EXECUTION.
EVENT_TYPE VARCHAR

Type of event. For details on each type, see the following sections:

EVENT_DESCRIPTION VARCHAR Generic description of the event.
OPERATOR_NAME VARCHAR Name of the Execution Engine component that generated the event, if applicable; for example, NetworkSend. Values from the OPERATOR_NAME and PATH_ID columns let you tie a query event back to a particular operator in the query plan. If the event did not come from a specific operator, the OPERATOR_NAME column is NULL.
PATH_ID INTEGER

Unique identifier that Vertica assigns to a query operation or path in a query plan, NULL if the event did not come from a specific operaton.

For more information, see EXECUTION_ENGINE_PROFILES.

OBJECT_ID INTEGER Object identifier such as projection or table to which the event refers.
EVENT_DETAILS VARCHAR Free-form text describing the specific event.
EVENT_SEVERITY VARCHAR

Indicates severity of the event with one of the following values:

  • Informational: No action required

  • Warning: Remedial action recommended as specified in SUGGESTED_ACTION

  • Critical: Remedial action required, as specified by SUGGESTED_ACTION

SUGGESTED_ACTION VARCHAR Specifies remedial action, recommended or required as indicated by EVENT_SEVERITY.

Informational event types

CSE ANALYSIS
The optimizer performed Common subexpressions analysis
CSE ANALYSIS STATS
Time spent on Common subexpressions analysis (msec)
EXPRESSION_EVAL_ERROR
An exception occurred during evaluation of an expression
EXTERNAL_DATA_FILES_PRUNED
Vertica skipped external data files (for example, Iceberg files) that could not satisfy predicates in the query. The event details include the number and paths of pruned files.
EXTERNAL_PREDICATE_PUSHDOWN_NOT_SUPPORTED
Predicate pushdown for older Hive versions may not be supported. For more information, see Querying external tables.
FLATTENED SUBQUERIES
Subqueries flattened in FROM clause
GROUP_BY_PREPASS_FALLBACK
Vertica could not run an optimization. In-memory prepass is disabled. The projection may not be optimal.
GROUPBY PUSHDOWN
Internal to Vertica
LibHDFS++ FAILOVER RETRY
Vertica attempted to contact a NameNode on an HDFS cluster that uses High Availability NameNode and did not receive a response. Vertica retried with a different NameNode.
LibHDFS++ MANUAL FALLBACK
Vertica accessed HDFS using the hdfs URL scheme but HDFSUseWebHDFS is set. Vertica fell back to WebHDFS.
LibHDFS++ UNSUPPORTED OPERATION
Vertica accessed HDFS using the hdfs URL scheme, but the HDFS cluster uses an unsupported feature such as wire encryption or HTTPS_ONLY or the Vertica session uses delegation tokens. Vertica fell back to WebHDFS.
MERGE_CONVERTED_TO_UNION
Vertica has converted a merge operator to a union operator due to the sort order of the multi-threaded storage access stream.
NO GROUPBY PUSHDOWN
Internal to Vertica
NODE PRUNING
Vertica performed node pruning, which is similar to partition pruning, but at the node level.
ORC_FILE_INFO
A query of ORC files encountered missing information (such as time zone) or an unrecognized ORC version. For missing information, Vertica uses a default value (such as the local time zone).
ORC_SOURCE_PRUNED
An entire ORC file was pruned during predicate pushdown.
ORC_STRIPES_PRUNED
The identified stripes were pruned during predicate pushdown. If an entire ORC file was pruned, it is instead recorded with an ORC_SOURCE_PRUNED event.
OUTER OVERRIDE NOT USED
Vertica found swapping inner/outer tables in a join unnecessary because the inner/outer tables were in good order. (For example, a smaller table was used in an inner join.)
OUTER OVERRIDE USED
For efficiency and optimization, Vertica has swapped the inner/outer tables in a join. Vertica used the smaller table as the inner table.
PARQUET_ROWGROUPS_PRUNED
The identified row groups were pruned during predicate pushdown.
PARTITION_PATH_PRUNED
A path (reported in event details) was pruned.
PARTITION_PATH_REJECTED
Could not evaluate partition column predicate on a path from source list. Path will be rejected.
PARTITION_PRUNING
COPY pruned partitions. The event reports how many paths were pruned, and PARTITION_PATH_PRUNED events record more details.
PREDICATES_DISCARDED_FROM_SCAN
Some predicates have been discarded from this scan because expression analysis shows they are not needed.
REJECT_ROWNUMS_HIT_BUFFER_LIMIT
Buffering row numbers during rejection hit buffer limit
SEQUENCE CACHE REFILLED
Vertica has refilled sequence cache.
SIP_FALLBACK
This optimization did not apply to this query type.
SMALL_MERGE_REPLACED
Vertica has chosen a more efficient way to access the data by replacing a merge.
STORAGE_CONTAINERS_ELIMINATED
Vertica has performed partition pruning for the purpose of optimization.
TRANSITIVE PREDICATE
Vertica has optimized by adding predicates to joins where it makes logical sense to do so.

For example, for the statement, SELECT * FROM A, B WHERE A.a = B.a AND A.a = 1;Vertica may add a predicate B a = 1 as a filter for better storage access of table B.

TYPE_MISMATCH_COLUMNS_PARQUETPARSER
The Parquet parser used loose schema matching to load data, and could not coerce values in the Parquet data to the types defined for the table. By default the parser rejects the row. For more information, see PARQUET.
UNMATCHED_TABLE_COLUMNS_PARQUETPARSER
The Parquet parser used loose schema matching to load data, and columns in the table had no corresponding columns in the data. The columns were given values of NULL.
VALUE_TRUNCATED
A character value is too long.
WEBHDFS FAILOVER RETRY
Vertica attempted to contact a NameNode on an HDFS cluster that uses High Availability NameNode and did not receive a response. Vertica retried with a different NameNode.

Warning event types

AUTO_PROJECTION_USED
The optimizer used an auto-projection to process this query.

Recommendation: Create a projection that is appropriate for this query and others like it; consider using Database Designer to generate query-specific projections.

GROUP_BY_SPILLED
This event type is typically related to a specific type of query, which you might need to adjust.

Recommendation: Identify the type of query and make adjustments accordingly. You might need to adjust resource pools, projections, or the amount of RAM available. Try running the query on a cluster with no additional workload.

INVALID COST
When creating a query plan, the optimizer calculated an invalid cost for a path: not-a-number (NaN) value, infinity value, or negative value. The path cost was set to its default value.

No action available to users.

PATTERN_MATCH_NMEE
More than one pattern event is true for a single row

Recommendation: Modify event expressions to ensure that only one event can be true for any row. Alternatively, modify the query using a MATCH clause with ROWS MATCH FIRST EVENT.

PREDICATE OUTSIDE HISTOGRAM
A predicate value you are trying to match does not exist in a set of possible values for a specific column. For example, you try to match a VARCHAR value WHERE mystring = "ABC<newline>". In this case, the newline character throws off the predicate matching optimizations.

Recommendation: Run ANALYZE_STATISTICS on the column.

RESEGMENTED_MANY_ROWS
This event type is typically related to a specific type of query, which you might need to adjust.

Recommendation: Do projections need to be segmented in a different way to allow for join locality? Can you rewrite the query to filter out more rows at storage access time? (Typically, Vertica does so automatically through predicate pushdown.) Review your explain plan.

RLE_OVERRIDDEN
The average run counts are not large enough for Run Length Encoding (RLE). This event occurs with queries where the filtered results for certain columns do not work with RLE because cardinality is less than 10.

Recommendation: Review and rewrite your query, if necessary.

Critical event types

DELETE WITH NON OPTIMIZED PROJECTION
One or more projections do not have your delete filter column in their sort order, causing Vertica difficulty identifying ros to mark as deleted.

To resolve: Add the delete filter column to the end of every projection sort order for your target delete table.

JOIN_SPILLED
Vertica has spilled a join to disk. A join spill event slows down the subject query and all other queries as it consumes resources while using disk as virtual memory.

To resolve: Try the following:

  1. Review the explain plan. The query might be too ambitious, for example, cross joining two large tables.

  2. Consider adding the query to a lower priority pool to reduce impact on other queries.

  3. Create projections that allow for a merge join instead of a hash join.

  4. Adjust the PLANNEDCONCURRENCYresource pool so that queries have more memory to execute.

MEMORY LIMIT HIT
Indicates query complexity or, possibly, lack of available system memory.

To resolve: Consider adjusting the MAXMEMORYSIZE and PLANNEDCONCURRENCY resource pools so that the optimizer has sufficient memory. On a heavily used system, this event may occur more frequently.

NO HISTOGRAM
Indicates a table does not have an updated column histogram.

To resolve: Running the function ANALYZE_STATISTICS most often corrects this issue.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

2.79 - QUERY_METRICS

Monitors the sessions and queries running on each node.

Monitors the sessions and queries running on each node.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
ACTIVE_USER_SESSION_COUNT INTEGER The number of active user sessions (connections).
ACTIVE_SYSTEM_SESSION_COUNT INTEGER The number of active system sessions.
TOTAL_USER_SESSION_COUNT INTEGER The total number of user sessions.
TOTAL_SYSTEM_SESSION_COUNT INTEGER The total number of system sessions.
TOTAL_ACTIVE_SESSION_COUNT INTEGER The total number of active user and system sessions.
TOTAL_SESSION_COUNT INTEGER The total number of user and system sessions.
RUNNING_QUERY_COUNT INTEGER The number of queries currently running.
EXECUTED_QUERY_COUNT INTEGER The total number of queries that ran.

2.80 - QUERY_PLAN_PROFILES

Provides detailed execution status for queries that are currently running in the system.

Provides detailed execution status for queries that are currently running in the system. Output from the table shows the real-time flow of data and the time and resources consumed for each path in each query plan.

Column Name Data Type Description
TRANSACTION_ID INTEGER An identifier for the transaction within the session if any; otherwise NULL.
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID and STATEMENT_ID uniquely identifies a statement within a session; these columns are useful for creating joins with other system tables.
PATH_ID INTEGER Unique identifier that Vertica assigns to a query operation or path in a query plan. Textual representation for this path is output in the PATH_LINE column.
PATH_LINE_INDEX INTEGER Each plan path in QUERY_PLAN_PROFILES could be represented with multiple rows. PATH_LINE_INDEX returns the relative line order. You should include the PATH_LINE_INDEX column in the QUERY_PLAN_PROFILES ... ORDER BY clause so rows in the result set appear as they do in EXPLAIN-generated query plans.
PATH_IS_EXECUTING BOOLEAN Status of a path in the query plan. True (t) if the path has started running, otherwise false.
PATH_IS_COMPLETE BOOLEAN Status of a path in the query plan. True (t) if the path has finished running, otherwise false.
IS_EXECUTING BOOLEAN Status of a running query. True if the query is currently active (t), otherwise false (f).
RUNNING_TIME INTERVAL The amount of elapsed time the query path took to execute.
MEMORY_ALLOCATED_BYTES INTEGER The amount of memory the path used, in bytes.
READ_FROM_DISK_BYTES INTEGER The number of bytes the path read from disk (or the disk cache).
RECEIVED_BYTES INTEGER The number of bytes received over the network.
SENT_BYTES INTEGER Size of data sent over the network by the path.
PATH_LINE VARCHAR The query plan text string for the path, associated with the PATH ID and PATH_LINE_INDEX columns.

Privileges

Non-superusers see only the records of tables they have permissions to view.

Best practices

Table results can be very wide. For best results when you query QUERY_PLAN_PROFILES, sort on these columns:

  • TRANSACTION_ID

  • STATEMENT_ID

  • PATH_ID

  • PATH_LINE_INDEX

For example:

=> SELECT ... FROM query_plan_profiles
     WHERE ...
    ORDER BY transaction_id, statement_id, path_id, path_line_index;

Examples

See Profiling query plans

See also

2.81 - QUERY_PROFILES

Provides information about executed queries.

Provides information about executed queries.

Column Name Data Type Description
SESSION_ID VARCHAR The identification of the session for which profiling information is captured. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
TRANSACTION_ID INTEGER An identifier for the transaction within the session if any; otherwise NULL.
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID uniquely identifies a statement within a session.
IDENTIFIER VARCHAR

A string to identify the query in system tables.

Note: You can query the IDENTIFIER column to quickly identify queries you have labeled for profiling and debugging. See Labeling statements for details.

NODE_NAME VARCHAR The node name for which information is listed.
QUERY VARCHAR The query string used for the query.
QUERY_SEARCH_PATH VARCHAR A list of schemas in which to look for tables.
SCHEMA_NAME VARCHAR The schema name in which the query is being profiled, set only for load operations.
TABLE_NAME VARCHAR The table name in the query being profiled, set only for load operations.
QUERY_DURATION_US NUMERIC(18,0) The duration of the query in microseconds.
QUERY_START_EPOCH INTEGER The epoch number at the start of the given query.
QUERY_START VARCHAR The Linux system time of query execution in a format that can be used as a DATE/TIME expression.
QUERY_TYPE VARCHAR Is one of INSERT, SELECT, UPDATE, DELETE, UTILITY, or UNKNOWN.
ERROR_CODE INTEGER The return error code for the query.
USER_NAME VARCHAR The name of the user who ran the query.
PROCESSED_ROW_COUNT INTEGER The number of rows returned by the query.
RESERVED_EXTRA_MEMORY_B INTEGER

Shows how much unused memory (in bytes) remains that is reserved for a given query but is unassigned to a specific operator. This is the memory from which unbounded operators pull first.

The MEMORY_INUSE_KB column in system table RESOURCE_ACQUISITIONS shows how much total memory was acquired for each query.

If operators acquire all memory acquired for the query, the plan must request more memory from the Vertica resource manager.

IS_EXECUTING BOOLEAN Displays information about actively running queries, regardless of whether profiling is enabled.

2.82 - QUERY_REQUESTS

Returns information about user-issued query requests.

Returns information about user-issued query requests. A statement can include more than one query request; for example, adding data to a table could include a constraint check in addition to a load or insert request.

For a consolidated view with one row per statement, see STATEMENT_OUTCOMES.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that reported the requested information.
USER_NAME VARCHAR Name of the user who issued the query at the time Vertica recorded the session.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused after the session ends.
REQUEST_ID INTEGER Unique identifier of the query request in the user session.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any, otherwise NULL.
STATEMENT_ID INTEGER Unique identifier for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID, and REQUEST_ID uniquely identifies a statement within a session.
REQUEST_TYPE VARCHAR

Type of the query request. Examples include, but are not limited to:

  • QUERY
  • DDL
  • LOAD
  • UTILITY
  • TRANSACTION
  • PREPARE
  • EXECUTE
  • SET
  • SHOW
REQUEST VARCHAR Query statement.
REQUEST_LABEL VARCHAR Label of the query, if any.
SEARCH_PATH VARCHAR Contents of the search path.
MEMORY_ACQUIRED_MB FLOAT Memory acquired by this query request in megabytes.
SUCCESS BOOLEAN Whether the query request succeeded.
ERROR_COUNT INTEGER Number of errors encountered in this query request (logged in ERROR_MESSAGES).
START_TIMESTAMP TIMESTAMPTZ Beginning of history interval.
END_TIMESTAMP TIMESTAMPTZ End of history interval.
REQUEST_DURATION TIMESTAMPTZ Query request execution time in days, hours, minutes, seconds, and milliseconds.
REQUEST_DURATION_MS INTEGER Query request execution time in milliseconds.
IS_EXECUTING BOOLEAN Whether the query request is currently running.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

QUERY_PROFILES

2.83 - REBALANCE_OPERATIONS

Contains information on historic and ongoing rebalance operations.

Contains information on historic and ongoing rebalance operations.

Column Name Data Type Description
OBJECT_TYPE VARCHAR

The type of the rebalanced object:

  • Projection

  • DFSfile

OBJECT_ID INTEGER The ID of the rebalanced object.
OBJECT_NAME VARCHAR The name of the rebalanced object. Objects can be tables, projections, or other Vertica objects.
PATH_NAME VARCHAR The DFS path for unstructured data being rebalanced.
TABLE_NAME VARCHAR The name of the rebalanced table. This value is NULL for DFS files.
TABLE_SCHEMA VARCHAR

The schema of the rebalanced table. This value is NULL for DFS files.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TRANSACTION_ID INTEGER The identifier for the transaction within the session.
STATEMENT_ID INTEGER The unique numeric ID for the currently-running statement.
NODE_NAME VARCHAR Name of the rebalancing node.
OPERATION_NAME VARCHAR

Identifies the specific rebalance operation being performed, one of:

  • Refresh projection, update temporary projection name and ID to master projection name

  • Drop unsegmented replicas

  • Replicate DFS File

  • Refresh projection

  • Drop replaced or replacement projection, rename temporary projection name to original projection name

  • Update temp table segments

  • Prepare : separate

  • Move storage containers

OPERATION_STATUS VARCHAR

Specifies status of the rebalance operation, one of the followin:

  • START

  • COMPLETE

  • ABORT

IS_EXECUTING BOOLEAN TRUE: the operation is currently running.
REBALANCE_METHOD VARCHAR

The method that Vertica is using to perform the rebalance, one of the following:

  • REFRESH: New projections are created according to the new segmentation definition. Data is copied via a refresh plan from projections with the previous segmentation to the new segments. This method is used only if START_REFRESH is called, a configuration parameter is set, or K-safety changes.

  • REPLICATE: Unsegmented projection data is copied to new nodes and removed from ephemeral nodes.

  • ELASTIC_CLUSTER: The segmentation of existing segmented projections is altered to adjust to a new cluster topology and data is redistributed accordingly.

SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
OPERATION_START_TIMESTAMP TIMESTAMPTZ The time that the rebalance began.
OPERATION_END_TIMESTAMP TIMESTAMPTZ The time that the rebalance ended. If the rebalance is ongoing, this value is NULL.
ELASTIC_CLUSTER_VERSION INTEGER The Elastic Cluster has a version. Each time the cluster topology changes, this version increments.
IS_LATEST BOOLEAN True if this row pertains to the most recent rebalance activity.

Privileges

Superuser

2.84 - REBALANCE_PROJECTION_STATUS

Maintain history on rebalance progress for relevant projections.

Maintain history on rebalance progress for relevant projections.

Column Name Data Type Description
PROJECTION_ID INTEGER Identifier of the projection to rebalance.
PROJECTION_SCHEMA VARCHAR

Schema of the projection to rebalance.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

PROJECTION_NAME VARCHAR Name of the projection to rebalance.
ANCHOR_TABLE_ID INTEGER Anchor table identifier of the projection to rebalance.
ANCHOR_TABLE_NAME VARCHAR Anchor table name of the projection to rebalance.
REBALANCE_METHOD VARCHAR

Method used to rebalance the projection, one of the following:

  • REFRESH: New projections are created according to the new segmentation definition. Data is copied via a refresh plan from projections with the previous segmentation to the new segments. This method is used only if START_REFRESH is called, a configuration parameter is set, or K-safety changes.

  • REPLICATE: Unsegmented projection data is copied to new nodes and removed from ephemeral nodes.

  • ELASTIC_CLUSTER: The segmentation of existing segmented projections is altered to adjust to a new cluster topology and data is redistributed accordingly.

DURATION_SEC INTERVAL SEC Deprecated, set to NULL.
SEPARATED_PERCENT NUMERIC(5,2) Percent of storage that has been separated for this projection.
TRANSFERRED_PERCENT NUMERIC(5,2) Percent of storage that has been transferred, for this projection.
SEPARATED_BYTES INTEGER Number of bytes, separated by the corresponding rebalance operation, for this projection.
TO_SEPARATE_BYTES INTEGER Number of bytes that remain to be separated by the corresponding rebalance operation for this projection.
TRANSFERRED_BYTES INTEGER Number of bytes transferred by the corresponding rebalance operation for this projection.
TO_TRANSFER_BYTES INTEGER Number of bytes that remain to be transferred by the corresponding rebalance operation for this projection.
IS_LATEST BOOLEAN True if this row pertains to the most recent rebalance activity, where elastic_cluster_version = (SELECT version FROM v_catalog.elastic_cluster);
ELASTIC_CLUSTER_VERSION INTEGER

The elastic cluster has a version, and each time the cluster topology changes, this version is incremented. This column reflects the version to which this row of information pertains. The TO_* fields (TO_SEPARATE_* and TO_TRANSFER_*) are only valid for the current version.

To view only rows from the current, latest or upcoming rebalance operation, use:

WHERE elastic_cluster_version = (SELECT version FROM v_catalog.elastic_cluster);

Privileges

Superuser

See also

2.85 - REBALANCE_TABLE_STATUS

Maintain history on rebalance progress for relevant tables.

Maintain history on rebalance progress for relevant tables.

Column Name Data Type Description
TABLE_ID INTEGER Identifier of the table that will be, was, or is being rebalanced.
TABLE_SCHEMA VARCHAR Schema of the table that will be, was, or is being rebalanced.
TABLE_NAME VARCHAR Name of the table that will be, was, or is being rebalanced.
REBALANCE_METHOD VARCHAR

Method that will be, is, or was used to rebalance the projections of this table. Possible values are:

  • REFRESH

  • REPLICATE

  • ELASTIC_CLUSTER

DURATION_SEC INTERVAL SEC

Deprecated - populated by NULL.

Aggregate, by table_id, rebalance_method, and elastic_cluster_version, of the same in REBALANCE_PROJECTION_STATUS.

SEPARATED_PERCENT NUMERIC(5,2) Aggregate, by table_id, rebalance_method, and elastic_cluster_version, of the same in REBALANCE_PROJECTION_STATUS.
TRANSFERRED_PERCENT NUMERIC(5,2) Aggregate, by table_id, rebalance_method, and elastic_cluster_version, of the same in REBALANCE_PROJECTION_STATUS.
SEPARATED_BYTES INTEGER Aggregate, by table_id, rebalance_method, and elastic_cluster_version, of the same in REBALANCE_PROJECTION_STATUS.
TO_SEPARATE_BYTES INTEGER Aggregate, by table_id, rebalance_method, and elastic_cluster_version, of the same in REBALANCE_PROJECTION_STATUS.
TRANSFERRED_BYTES INTEGER Aggregate, by table_id, rebalance_method, and elastic_cluster_version, of the same in REBALANCE_PROJECTION_STATUS.
TO_TRANSFER_BYTES INTEGER Aggregate, by table_id, rebalance_method, and elastic_cluster_version, of the same in REBALANCE_PROJECTION_STATUS.
IS_LATEST BOOLEAN True if this row pertains to the most recent rebalance activity, where elastic_cluster_version = (SELECT version FROM v_catalog.elastic_cluster;)
ELASTIC_CLUSTER_VERSION INTEGER

The Elastic Cluster has a version, and each time the cluster topology changes, this version is incremented. This column reflects the version to which this row of information pertains. The TO_* fields (TO_SEPARATE_* and TO_TRANSFER_*) are only valid for the current version.

To view only rows from the current, latest or upcoming rebalance operation, use:

WHERE elastic_cluster_version = (SELECT version FROM v_catalog.elastic_cluster;)

start_timestamp TIMESTAMPTZ The time that the rebalance began.
end_timestamp TIMESTAMPTZ The time that the rebalance ended.

Privileges

Superuser

See also

2.86 - RECOVERY_STATUS

Provides the status of recovery operations, returning one row for each node.

Provides the status of recovery operations, returning one row for each node.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
RECOVER_EPOCH INTEGER Epoch the recovery operation is trying to catch up to.
RECOVERY_PHASE VARCHAR

Current stage in the recovery process. Can be one of the following:

  • NULL

  • current

  • historical pass X, where X is the iteration count

SPLITS_COMPLETED INTEGER Number of independent recovery SPLITS queries that have run and need to run.
SPLITS_TOTAL INTEGER Total number of SPLITS queries that ran. Each query corresponds to one row in the PROJECTION_RECOVERIES table. If SPLITS_TOTAL = 2, then there should be 2 rows added to PROJECTION_RECOVERIES, showing query details.
HISTORICAL_COMPLETED INTEGER Number of independent recovery HISTORICAL queries that have run and need to run.
HISTORICAL_TOTAL INTEGER Total number of HISTORICAL queries that ran. Each query corresponds to one row in the PROJECTION_RECOVERIES table. If HISTORICAL_TOTAL = 2, then there should be 2 rows added to PROJECTION_RECOVERIES, showing query details.
CURRENT_COMPLETED INTEGER Number of independent recovery CURRENT queries that have run and need to run.
CURRENT_TOTAL INTEGER Total number of CURRENT queries that ran. Each query corresponds to one row in the PROJECTION_RECOVERIES table. If CURRENT_TOTAL = 2, then there should be 2 rows added to PROJECTION_RECOVERIES, showing query details.
IS_RUNNING BOOLEAN True (t) if the node is still running recovery; otherwise false (f).

Privileges

None

See also

PROJECTION_RECOVERIES

2.87 - REMOTE_REPLICATION_STATUS

Provides the status of replication tasks to alternate clusters.

Provides the status of replication tasks to alternate clusters.

Column Name Data Type Description
CURRENT_EPOCH INTEGER
EPOCH INTEGER
LAST_REPLICATED_TIME TIMESTAMPTZ
OBJECTS VARCHAR
REPLICATED_EPOCH INTEGER
REPLICATION_POINT VARCHAR
SNAPSHOT_NAME VARCHAR

Privileges

None

2.88 - REPARENTED_ON_DROP

Lists re-parenting events of objects that were dropped from their original owner but still remain in Vertica.

Lists re-parenting events of objects that were dropped from their original owner but still remain in Vertica. For example, a user may leave the organization and need to be removed from the database. When the database administrator drops the user from the database, that user's objects are re-parented to another user.

In some cases, a Vertica user's objects are reassigned based on the GlobalHeirUsername parameter. In this case, a user's objects are re-parented to the user indicated by this parameter.

Column Name Data Type Description
REPARENT_TIMESTAMP TIMESTAMP The time the re-parenting event occurred.
NODE_NAME VARCHAR The name of the node or nodes on which the re-parenting occurred.
SESSION_ID VARCHAR The identification number of the re-parenting event.
USER_ID INTEGER The unique, system-generated user identification number.
USER_NAME VARCHAR The name of the user that caused the re-parenting event. For example, a dbadmin user may have dropped a user thus re-parenting that user's objects.
TRANSACTION_ID INTEGER The system-generated transaction identification number. Is NULL if a transaction id does not exist.
OLD_OWNER_NAME VARCHAR The the name of the dropped user who used to own the re-parented object.
OLD_OWNER_OID INTEGER The unique identification number of the user who used to own the re-parented object.
NEW_OWNER_NAME VARCHAR The name of the user who now owns the re-parented objects.
NEW_OWNER_OID INTEGER The unique identification number of the user who now owns the re-parented objects.
OBJ_NAME VARCHAR The name of the object being re-parented.
OBJ_OID INTEGER The unique identification number of the object being re-parented.
SCHEMA_NAME VARCHAR The name of the schema in which the object resides.
SCHEMA_OID INTEGER The unique identification number of the schema in which the re-parented object resides.

2.89 - REPLICATION_STATUS

Monitors the status of server-based data replication.

Shows the status of current and past server-based replication of data from another Eon Mode database to this database. Each row records node-specific information about a given replication. For more information about server-based replication, see Server-based replication.

Column name Data type Description
NODE_NAME VARCHAR(128) Name of the node participating in the replication.
TRANSACTION_ID INT Transaction in which the replication took place.
OPERATION_NAME VARCHAR

Name of the replication operation for which information is listed, one of the following:

  • load_snapshot_prep: Catalog files from the source database are copied to NODE_NAME and analyzed to determine which storage files need to be copied to the target database.
  • data_transfer: Storage files from the source database are copied to the target database's communal storage.
  • load_snapshot: Catalog objects loaded during load_snapshot_prep are installed on the node.
STATUS VARCHAR(8192)

State of the OPERATION_NAME operation, one of the following:

  • failed: The operation did not complete successfully.
  • completed: The operation has completed.
  • started: The operation is in progress on the node.
SENT_BYTES INT Number of bytes that the node has retrieved from the source database's communal storage.
TOTAL_BYTES_TO_SEND INT Total number of bytes the node has to retrieve from the source database's communal storage for this replication.
START_TIME TIMESTAMPTZ Start time of the replication.
END_TIME TIMESTAMPTZ Time at which the node finished transferring data for the replication.

Example

=> SELECT node_name, opeartion_name, status FROM REPLICATION_STATUS 
   ORDER BY node_name;
       node_name       |   operation_name   |  status         
-----------------------+--------------------+-----------
 v_target_db_node0001  | load_snapshot_prep | completed        
 v_target_db_node0001  | data_transfer      | completed         
 v_target_db_node0001  | load_snapshot      | completed        
 v_target_db_node0002  | load_snapshot_prep | completed        
 v_target_db_node0002  | data_transfer      | completed         
 v_target_db_node0002  | load_snapshot      | completed         
 v_target_db_node0003  | load_snapshot_prep | completed
 v_target_db_node0003  | data_transfer      | completed
 v_target_db_node0003  | load_snapshot      | completed
(9 rows)

2.90 - RESHARDING_EVENTS

Monitors historic and ongoing resharding operations.

Monitors historic and ongoing resharding operations.

Column Name Data Type Description
EVENT_TIME_STAMP TIMESTAMP Date and time of the resharding event.
NODE_NAME VARCHAR Node name for which resharding information is listed.
SESSION_ID VARCHAR Unique numeric ID assigned by the Vertica catalog that identifies the session for which resharding information is captured. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INTEGER Numeric ID of the user who ran the resharding operation.
USER_NAME VARCHAR Name of the user who ran the resharding operation.
TRANSACTION_ID INTEGER Numeric ID of the specified rehsarding transaction within the session.
RUNNING_STATUS VARCHAR

Current status of the resharding operation, one of the following strings:

  • START: The resharding operation has begun on all nodes.

  • RUNNING: The shard named OLD_SHARD_NAME is currently being resharded on the node.

  • RESHARDED: The resharding operation on the node is complete for the shard named OLD_SHARD_NAME.

  • ABORT: The resharding operation was aborted on all nodes.

  • COMPLETE: The resharding operation has completed for all nodes in the database.

OLD_SHARD_NAME VARCHAR Name of the shard to which the node was subscribed previous to the resharding operation. You can query the SHARDS system table for information about the new shard configuration.
OLD_SHARD_OID INTEGER Numeric ID of the shard to which the node was subscribed previous to the resharding operation.
OLD_SHARD_LOWER_BOUND INTEGER Lower bound of the shard to which the node was subscribed prior to the resharding operation. This value is set only if the resharding operation is complete for the shard specified by OLD_SHARD_OID.
OLD_SHARD_UPPER_BOUND INTEGER Upper bound of the shard to which the node was subscribed prior to the resharding operation. This value is set only if the resharding operation is complete for the shard specified by OLD_SHARD_OID.
CATALOG_SIZE INTEGER Catalog size (in bytes) on the node for the shard specified by OLD_SHARD_NAME. This value is provided only when the RUNNING_STATUS of the node is RUNNING or RESHARDED.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

2.91 - RESOURCE_ACQUISITIONS

Retains information about resources (memory, open file handles, threads) acquired by each running request.

Retains information about resources (memory, open file handles, threads) acquired by each running request. Each request is uniquely identified by its transaction and statement IDs within a given session.

Column Name Data Type Description
NODE_NAME VARCHAR Node name for which information is listed.
TRANSACTION_ID INTEGER Transaction identifier for this request.
STATEMENT_ID INTEGER Unique numeric ID for each statement within a transaction. NULL indicates that no statement is currently being processed.
REQUEST_TYPE VARCHAR Type of request issued to a resource pool. End users always see this column set to Reserve, to indicate that the request is query-specific.
POOL_ID /
POOL_NAME
INTEGER /
VARCHAR

Each resource pool that participated in handling this request:

  • POOL_ID: A unique numeric ID assigned by the Vertica catalog that uniquely identifies the resource pool.

  • POOL_NAME: Name of the resource pool.

THREAD_COUNT INTEGER Number of threads in use by this request.
OPEN_FILE_HANDLE_COUNT INTEGER Number of open file handles in use by this request.
MEMORY_INUSE_KB INTEGER

Total amount of memory in kilobytes acquired by this query.

Column RESERVED_EXTRA_MEMORY_B in system table QUERY_PROFILES shows how much unused memory (in bytes) remains that is reserved for a given query but is unassigned to a specific operator.

If operators for a query acquire all memory specified by MEMORY_INUSE_KB, the plan must request more memory from the Vertica Resource Manager.

QUEUE_ENTRY_TIMESTAMP TIMESTAMPTZ Timestamp when the request was queued in this resource pool.
ACQUISITION_TIMESTAMP TIMESTAMPTZ Timestamp when the request was admitted to run.
RELEASE_TIMESTAMP TIMESTAMPTZ Time when Vertica released this resource acquisition.
DURATION_MS INTEGER Duration in milliseconds of request execution. If the request cascaded across multiple resource pools, DURATION_MS applies only to this resource pool.
IS_EXECUTING BOOLEAN

Set to true if the resource pool is still executing this request. A value of false can indicate one of the following:

  • The request was completed or denied.

  • The request cascaded to another resource pool.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Queue wait time

You can calculate how long a resource pool queues a given request before it begins execution by subtracting QUEUE_ENTRY_TIMESTAMP from ACQUISITION_TIMESTAMP. For example:

 => SELECT pool_name, queue_entry_timestamp, acquisition_timestamp,
    (acquisition_timestamp-queue_entry_timestamp) AS 'queue wait'
    FROM V_MONITOR.RESOURCE_ACQUISITIONS WHERE node_name ILIKE '%node0001';

See also

2.92 - RESOURCE_POOL_MOVE

Displays the cascade event information on each node.

Displays the cascade event information on each node.

Column Name Data Type Description
NODE_NAME VARCHAR Node name for which information is listed.
MOVE_TIMESTAMP TIMESTAMPTZ Time when the query attempted to move to the target pool.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INTEGER Identifies the query event user.
USER_NAME VARCHAR Name of the user for which Vertica lists query information at the time it records the session.
TRANSACTION_ID INTEGER Transaction identifier for the request.
STATEMENT_ID INTEGER Unique numeric ID for the statement.
SOURCE_POOL_NAME VARCHAR Name of the resource pool where the query was executing when Vertica attempted the move.
TARGET_POOL_NAME VARCHAR Name of resource pool where the query attempted to move.
MOVE_CAUSE VARCHAR

Denotes why the query attempted to move.

Valid values:

  • MOVE RESOURCE POOL COMMAND

  • RUNTIMECAP EXCEEDED

SOURCE_CAP INTEGER

Effective RUNTIMECAP value for the source pool. The value represents the lowest of these three values:

  • session RUNTIMECAP

  • user RUNTIMECAP

  • source pool RUNTIMECAP

TARGET_CAP INTEGER

Effective RUNTIMECAP value for the target pool. The value represents the lowest of these three values:

  • session RUNTIMECAP

  • user RUNTIMECAP

  • target pool RUNTIMECAP

SUCCESS BOOLEAN True, if the query successfully moved to the target pool.
RESULT_REASON VARCHAR States reason for success or failure of the move.

See also

2.93 - RESOURCE_POOL_STATUS

Provides current state of built-in and user-defined resource pools on each node.

Provides current state of built-in and user-defined resource pools on each node. Information includes:

  • Current memory usage

  • Resources requested and acquired by various requests

  • Number of queries executing

For general information about resource pools, see Resource pool architecture.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node for which information is provided.
POOL_OID INTEGER Unique numeric ID that identifies the pool and is assigned by the Vertica catalog.
POOL_NAME VARCHAR Name of the resource pool.
IS_INTERNAL BOOLEAN Denotes whether a pool is built-in.
MEMORY_SIZE_KB INTEGER Value of MEMORYSIZE setting of the pool in kilobytes.
MEMORY_SIZE_ACTUAL_KB INTEGER

Current amount of memory, in kilobytes, allocated to the pool by the resource manager. The actual size can be less than specified in the DDL, if both the following conditions exist:

  • The pool has been recently altered in a running system.

  • The request to shuffle memory is pending.

MEMORY_INUSE_KB INTEGER Amount of memory, in kilobytes, acquired by requests running against this pool.
GENERAL_MEMORY_BORROWED_KB INTEGER Amount of memory, in kilobytes, borrowed from the GENERAL pool by requests running against this pool. The sum of MEMORY_INUSE_KB and GENERAL_MEMORY_BORROWED_KB should be less than MAX_MEMORY_SIZE_KB.
QUEUEING_THRESHOLD_KB INTEGER Calculated as MAX_MEMORY_SIZE_KB * 0.95. When the amount of memory used by all requests against this resource pool exceeds the QUEUEING_THRESHOLD_KB, new requests against the pool are queued until memory becomes available.
MAX_MEMORY_SIZE_KB INTEGER

Value, in kilobytes, of the MAXMEMORYSIZE parameter as defined for the pool. After this threshold is reached, new requests against this pool are rejected or queued until memory becomes available.

MAX_QUERY_MEMORY_SIZE_KB INTEGER Value, in kilobytes, of the MAXQUERYMEMORYSIZE parameter as defined for the pool. The resource pool limits this amount of memory to all queries that execute in it.
RUNNING_QUERY_COUNT INTEGER Number of queries currently executing in this pool.
PLANNED_CONCURRENCY INTEGER Value of PLANNEDCONCURRENCY parameter as defined for the pool.
MAX_CONCURRENCY INTEGER Value of MAXCONCURRENCY parameter as defined for the pool.
IS_STANDALONE BOOLEAN If the pool is configured to have MEMORYSIZE equal to MAXMEMORYSIZE, the pool is considered standalone because it does not borrow any memory from the General pool.
QUEUE_TIMEOUT INTERVAL The interval that the request waits for resources to become available before being rejected. If you set this value to NONE, Vertica displays it as NULL.
QUEUE_TIMEOUT_IN_SECONDS INTEGER Value of QUEUETIMEOUT parameter as defined for the pool. If QUEUETIMEOUT is set to NONE, Vertica displays this value as NULL.
EXECUTION_PARALLELISM INTEGER Limits the number of threads used to process any single query issued in this resource pool.
PRIORITY INTEGER

Value of PRIORITY parameter as defined for the pool.

When set to HOLD, Vertica sets a pool's priority to -999 so the query remains queued until QUEUETIMEOUT is reached.

RUNTIMECAP_IN_SECONDS INTEGER Defined for this pool by parameter RUNTIMECAP, specifies in seconds the maximum time a query in the pool can execute. If a query exceeds this setting, it tries to cascade to a secondary pool.
RUNTIME_PRIORITY VARCHAR Defined for this pool by parameter RUNTIMEPRIORITY, determines how the resource manager should prioritize dedication of run-time resources (CPU, I/O bandwidth) to queries already running in this resource pool.
RUNTIME_PRIORITY_THRESHOLD INTEGER Defined for this pool by parameter RUNTIMEPRIORITYTHRESHOLD, specifies in seconds a time limit in which a query must finish before the resource manager assigns to it the resource pool's RUNTIME_PRIORITY setting.
SINGLE_INITIATOR BOOLEAN Set for backward compatibility.
QUERY_BUDGET_KB INTEGER

The current amount of memory that queries are tuned to use. The calculation that Vertica uses to determine this value is described inQuery budgeting.

For a detailed example of query budget calculations, see Do You Need to Put Your Query on a Budget? in the Vertica User Community.

CPU_AFFINITY_SET VARCHAR

The set of CPUs on which queries associated with this pool are executed. Can be:

  • A percentage of CPUs on the system

  • A zero-based list of CPUs (a four-CPU system c of CPUs 0, 1, 2, and 3).

CPU_AFFINITY_MASK VARCHAR The bit mask of CPUs available for use in this pool, read from right to left. See Examples below.
CPU_AFFINITY_MODE VARCHAR

The mode for the CPU affinity, one of the following:

  • ANY

  • EXCLUSIVE

  • SHARED

Examples

The following query returns bit masks that show CPU assignments for three user-defined resource pools. Resource pool bigqueries runs queries on CPU 0, ceo_pool on CPU 1, and testrp on CPUs 0 and 1:

 => SELECT pool_name, node_name, cpu_affinity_set, cpu_affinity_mode,
      TO_BITSTRING(CPU_AFFINITY_MASK::VARBINARY) "CPU Affinity Mask"
      FROM resource_pool_status WHERE IS_INTERNAL = 'false' order by pool_name, node_name;
 pool_name  |    node_name     | cpu_affinity_set | cpu_affinity_mode | CPU Affinity Mask
------------+------------------+------------------+-------------------+-------------------
 bigqueries | v_vmart_node0001 | 0                | SHARED            | 00110001
 bigqueries | v_vmart_node0002 | 0                | SHARED            | 00110001
 bigqueries | v_vmart_node0003 | 0                | SHARED            | 00110001
 ceo_pool   | v_vmart_node0001 | 1                | SHARED            | 00110010
 ceo_pool   | v_vmart_node0002 | 1                | SHARED            | 00110010
 ceo_pool   | v_vmart_node0003 | 1                | SHARED            | 00110010
 testrp     | v_vmart_node0001 | 0-1              | SHARED            | 00110011
 testrp     | v_vmart_node0002 | 0-1              | SHARED            | 00110011
 testrp     | v_vmart_node0003 | 0-1              | SHARED            | 00110011
(9 rows)

See also

2.94 - RESOURCE_QUEUES

Provides information about requests pending for various resource pools.

Provides information about requests pending for various resource pools.

Column Name Data Type Description
NODE_NAME VARCHAR The name of the node for which information is listed.
TRANSACTION_ID INTEGER Transaction identifier for this request
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID uniquely identifies a statement within a session.
POOL_NAME VARCHAR The name of the resource pool
MEMORY_REQUESTED_KB INTEGER Amount of memory in kilobytes requested by this request
PRIORITY INTEGER Value of PRIORITY parameter specified when defining the pool.
POSITION_IN_QUEUE INTEGER Position of this request within the pool’s queue
QUEUE_ENTRY_TIMESTAMP TIMESTAMP Timestamp when the request was queued

See also

2.95 - RESOURCE_REJECTION_DETAILS

Records an entry for each resource request that Vertica denies.

Records an entry for each resource request that Vertica denies. This is useful for determining if there are resource space issues, as well as which users/pools encounter problems.

Column Name Data Type Description
REJECTED_TIMESTAMP TIMESTAMPTZ Time when Vertica rejected the resource.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_NAME VARCHAR Name of the user at the time Vertica recorded the session.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
REQUEST_ID INTEGER Unique identifier of the query request in the user session.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any; otherwise NULL.
STATEMENT_ID INTEGER Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID, STATEMENT_ID, and REQUEST_ID uniquely identifies a statement within a session.
POOL_ID INTEGER Catalog-assigned integer value that uniquely identifies theresource pool.
POOL_NAME VARCHAR Name of the resource pool
REASON VARCHAR

Reason for rejecting this request; for example:

  • Usage of single request exceeds high limit

  • Timed out waiting for resource reservation

  • Canceled waiting for resource reservation

RESOURCE_TYPE VARCHAR

Memory, threads, file handles or execution slots.

The following list shows the resources that are limited by the resource manager. A query might need some amount of each resource, and if the amount needed is not available, the query is queued and could eventually time out of the queue and be rejected.

  • Number of running plans

  • Number of running plans on initiator node (local)

  • Number of requested threads

  • Number of requested file handles

  • Number of requested KB of memory

  • Number of requested KB of address space

Note: Execution slots are determined by MAXCONCURRENCY parameter.

REJECTED_VALUE INTEGER Amount of the specific resource requested by the last rejection

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

RESOURCE_REJECTIONS

2.96 - RESOURCE_REJECTIONS

Monitors requests for resources that are rejected by the.

Monitors requests for resources that are rejected by the Resource manager. Information is valid only as long as the node is up and the counters reset to 0 upon node restart.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
POOL_ID INTEGER Catalog-assigned integer value that uniquely identifies theresource pool.
POOL_NAME VARCHAR Name of the resource pool.
REASON VARCHAR

Reason for rejecting this request, for example:

  • Usage of single request exceeds high limit

  • Timed out waiting for resource reservation

  • Canceled waiting for resource reservation

RESOURCE_TYPE VARCHAR

Memory, threads, file handles or execution slots.

The following list shows the resources that are limited by the resource manager. A query might need some amount of each resource, and if the amount needed is not available, the query is queued and could eventually time out of the queue and be rejected.

  • Number of running plans

  • Number of running plans on initiator node (local)

  • Number of requested threads

  • Number of requested file handles

  • Number of requested KB of memory

  • Number of requested KB of address space

REJECTION_COUNT INTEGER Number of requests rejected due to specified reason and RESOURCE_TYPE.
FIRST_REJECTED_TIMESTAMP TIMESTAMPTZ Time of the first rejection for this pool.
LAST_REJECTED_TIMESTAMP TIMESTAMPTZ Time of the last rejection for this pool.
LAST_REJECTED_VALUE INTEGER Amount of the specific resource requested by the last rejection.

Examples

=> SELECT node_name, pool_name, reason, resource_type, rejection_count AS count, last_rejected_value AS value FROM resource_rejections;
    node_name     | pool_name |           reason            | resource_type | count |  value
------------------+-----------+-----------------------------+---------------+-------+---------
 v_vmart_node0001 | sysquery  | Request exceeded high limit | Memory(KB)    |     1 | 8248449
(1 row)

See also

2.97 - RESOURCE_USAGE

Monitors system resource management on each node.

Monitors system resource management on each node.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
REQUEST_COUNT INTEGER The cumulative number of requests for threads, file handles, and memory (in kilobytes).
LOCAL_REQUEST_COUNT INTEGER The cumulative number of local requests.
REQUEST_QUEUE_DEPTH INTEGER The current request queue depth.
ACTIVE_THREAD_COUNT INTEGER The current number of active threads.
OPEN_FILE_HANDLE_COUNT INTEGER The current number of open file handles.
MEMORY_REQUESTED_KB INTEGER The memory requested in kilobytes.
ADDRESS_SPACE_REQUESTED_KB INTEGER The address space requested in kilobytes.
ROS_USED_BYTES INTEGER The size of the ROS in bytes.
ROS_ROW_COUNT INTEGER The number of rows in the ROS.
RESOURCE_REQUEST_REJECT_COUNT INTEGER The number of rejected plan requests.
RESOURCE_REQUEST_TIMEOUT_COUNT INTEGER The number of resource request timeouts.
RESOURCE_REQUEST_CANCEL_COUNT INTEGER The number of resource request cancelations.
DISK_SPACE_REQUEST_REJECT_COUNT INTEGER The number of rejected disk write requests.
FAILED_VOLUME_REJECT_COUNT INTEGER The number of rejections due to a failed volume.
TOKENS_USED INTEGER For internal use only.
TOKENS_AVAILABLE INTEGER For internal use only.

2.98 - SESSION_MARS_STORE

Shows Multiple Active Result Sets (MARS) storage information.

Shows Multiple Active Result Sets (MARS) storage information.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
SESSION_ID VARCHAR Identifier of the Vertica session. This identifier is unique within the cluster for the current session but can be reused in a subsequent session.
USER_NAME VARCHAR The username used to create the connection.
RESULTSET_ID INTEGER Identifier assigned to the result set.
ROW_COUNT INTEGER Number of rows requested by the query.
REMAINING_ROW_COUNT INTEGER Number of rows that still need to be returned.
BYTES_USED INTEGER The number of bytes requested.

2.99 - SESSION_PARAMETERS

Provides information about user-defined parameters (UDPARAMETERS) set for the current session.

Provides information about user-defined parameters (UDPARAMETERS) set for the current session.

Column Name Data Type Description
SESSION_ID VARCHAR The unique identifier for the session.
SCHEMA_NAME VARCHAR The name of the schema on which the session is running.
LIB_NAME VARCHAR The name of the user library running the UDx, if necessary.
LIB_OID VARCHAR The object ID of the library containing the function, if one is running.
PARAMETER_NAME VARCHAR The name of the session parameter.
CURRENT_VALUE VARCHAR The value of the session parameter.

See also

2.100 - SESSION_PROFILES

Provides basic session parameters and lock time out data.

Provides basic session parameters and lock time out data. To obtain information about sessions, see Profiling database performance.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
USER_NAME VARCHAR The name used to log in to the database or NULL if the session is internal.
CLIENT_HOSTNAME VARCHAR The host name and port of the TCP socket from which the client connection was made; NULL if the session is internal.
LOGIN_TIMESTAMP TIMESTAMP The date and time the user logged into the database or when the internal session was created. This field is useful for identifying sessions that have been left open for a period of time and could be idle.
LOGOUT_TIMESTAMP TIMESTAMP The date and time the user logged out of the database or when the internal session was closed.
SESSION_ID VARCHAR A unique numeric ID assigned by the Vertica catalog, which identifies the session for which profiling information is captured. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
EXECUTED_STATEMENT_SUCCESS_COUNT INTEGER The number of successfully run statements.
EXECUTED_STATEMENT_FAILURE_COUNT INTEGER The number of unsuccessfully run statements.
LOCK_GRANT_COUNT INTEGER The number of locks granted during the session.
DEADLOCK_COUNT INTEGER The number of deadlocks encountered during the session.
LOCK_TIMEOUT_COUNT INTEGER The number of times a lock timed out during the session.
LOCK_CANCELLATION_COUNT INTEGER The number of times a lock was canceled during the session.
LOCK_REJECTION_COUNT INTEGER The number of times a lock was rejected during a session.
LOCK_ERROR_COUNT INTEGER The number of lock errors encountered during the session.
CLIENT_TYPE VARCHAR

The type of client from which the connection was made. Possible client type values:

  • ADO.NET Driver

  • ODBC Driver

  • JDBC Driver

  • vsql

CLIENT_VERSION VARCHAR Returns the client version.
CLIENT_OS VARCHAR Returns the client operating system.
CLIENT_OS_USER_NAME VARCHAR The name of the user that logged into, or attempted to log into, the database. This is logged even when the login attempt is unsuccessful.

See also

LOCKS

2.101 - SESSIONS

Monitors external sessions.

Monitors external sessions. Use this table to perform the following tasks:

  • Identify users who are running lengthy queries.

  • Identify users who hold locks because of an idle but uncommitted transaction.

  • Determine the details of the database security used for a particular session, either Secure Socket Layer (SSL) or client authentication.

  • Identify client-specific information, such as client version.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
USER_NAME VARCHAR The name used to log in to the database or NULL if the session is internal.
CLIENT_OS_HOSTNAME VARCHAR The hostname of the client as reported by their operating system.
CLIENT_HOSTNAME VARCHAR

The IP address and port of the TCP socket from which the client connection was made; NULL if the session is internal.

Vertica accepts either IPv4 or IPv6 connections from a client machine. If the client machine contains mappings for both IPv4 and IPv6, the server randomly chooses one IP address family to make a connection. This can cause the CLIENT_HOSTNAME column to display either IPv4 or IPv6 values, based on which address family the server chooses.

CLIENT_PID INTEGER The process identifier of the client process that issued this connection. Remember that the client process could be on a different machine than the server.
LOGIN_TIMESTAMP TIMESTAMP The date and time the user logged into the database or when the internal session was created. This field can help you identify sessions that have been left open for a period of time and could be idle.
SESSION_ID VARCHAR The identifier required to close or interrupt a session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
IDLE_SESSION_TIMEOUT VARCHAR Specifies how long this session can remain idle before timing out, set by SET SESSION IDLESESSIONTIMEOUT.
GRACE_PERIOD VARCHAR Specifies how long a session socket remains blocked while awaiting client input or output for a given query, set by SET SESSION GRACEPERIOD. If the socket is blocked for a continuous period that exceeds the grace period setting, the server shuts down the socket and throws a fatal error. The session is then terminated.
CLIENT_LABEL VARCHAR A user-specified label for the client connection that can be set when using ODBC. See Label in ODBC DSN connection properties. An MC output value means there are is a client connection to an MC-managed database for that USER_NAME
TRANSACTION_START DATE The date/time the current transaction started or NULL if no transaction is running.
TRANSACTION_ID INTEGER A string containing the hexadecimal representation of the transaction ID, if any; otherwise, NULL.
TRANSACTION _DESCRIPTION VARCHAR Description of the current transaction.
STATEMENT_START TIMESTAMP The timestamp the current statement started execution, or NULL if no statement is running.
STATEMENT_ID INTEGER

A unique numeric ID assigned by the Vertica catalog, which identifies the currently-executing statement.

A value of NULL indicates that no statement is currently being processed.

LAST_STATEMENT_DURATION_US INTEGER The duration of the last completed statement in microseconds.
RUNTIME_PRIORITY VARCHAR Specifies how many run-time resources (CPU, I/O bandwidth) are allocated to queries that are running in the resource pool.
CURRENT_STATEMENT VARCHAR The currently executing statement, if any. NULL indicates that no statement is currently being processed.
LAST_STATEMENT VARCHAR NULL if the user has just logged in; otherwise the currently running statement or the most recently completed statement.
SSL_STATE VARCHAR

Indicates if Vertica used Secure Socket Layer (SSL) for a particular session. Possible values are:

  • None—Vertica did not use SSL.

  • Server—Server authentication was used, so the client could authenticate the server.

  • Mutual—Both the server and the client authenticated one another through mutual authentication.

See Security and authentication and TLS protocol.

AUTHENTICATION_ METHOD VARCHAR

The type of client authentication used for a particular session, if known. Possible values are:

  • Unknown

  • Trust

  • Reject

  • Hash

  • Ident

  • LDAP

  • GSS

  • TLS

See Security and authentication and Configuring client authentication.

CLIENT_TYPE VARCHAR

The type of client from which the connection was made. Possible client type values:

  • ADO.NET Driver

  • ODBC Driver

  • JDBC Driver

  • vsql

CLIENT_VERSION VARCHAR Client version.
CLIENT_OS VARCHAR Client operating system.
CLIENT_OS_USER _NAME VARCHAR The name of the user that logged into, or attempted to log into, the database. This is logged even when the login attempt is unsuccessful.
CLIENT_AUTHENTICATION_NAME VARCHAR User-assigned name of the authentication method.
CLIENT_ AUTHENTICATION INTEGER Object identifier of the client authentication method.
REQUESTED_PROTOCOL INTEGER The requested Vertica client server protocol to be used when connecting.
EFFECTIVE_PROTOCOL INTEGER The requested Vertica client server protocol used when connecting.
EXTERNAL_MEMORY_KB INTEGER Amount of memory consumed by the Java Virtual Machines associated with the session.

Privileges

A superuser has unrestricted access to all session information. Users can view information only about their own, current sessions.

See also

2.102 - SPREAD_STATE

Lists daemon settings for all nodes in the cluster.

Lists Spread daemon settings for all nodes in the cluster.

Column Name Data Type Description
NODE_NAME VARCHAR Which node the settings are for.
TOKEN_TIMEOUT INTEGER The timeout period in milliseconds before spread considers a node to be down due to lack of response to a message.

Examples

=> SELECT * FROM V_MONITOR.SPREAD_STATE;
    node_name     | token_timeout
------------------+---------------
 v_vmart_node0003 |          8000
 v_vmart_node0001 |          8000
 v_vmart_node0002 |          8000
(3 rows)

See also

2.103 - SQS_LISTENER_ERROR_HISTORY

Lists errors and rejections in reading from SQS.

Lists errors and rejections that occur when reading from SQS, such as malformed SQS messages and authorization problems. These errors occur when Vertica reads from SQS as part of automatic data load.

The DATA_LOADER_EVENTS table records errors that occur during the load (COPY) step but does not include pre-load errors from SQS.

Column Name Column Type Description
REPORT_TIME TIMESTAMPTZ Time when Vertica recorded the error or rejection.
NODE_NAME VARCHAR Name of the node where the error occurred.
ERROR_SOURCE VARCHAR Component that produced the error, such as "SQSTrigger" or "SQSListener".
MESSAGE VARCHAR More details about the error.
QUEUE_URL VARCHAR SQS queue.

2.104 - STATEMENT_OUTCOMES

...

Records consolidated information about session-level statements, which can consist of more than one operation and might include retries. For example, inserting into a table with a column constraint includes an INSERT query and a constraint check. STATEMENT_OUTCOMES has one row for the statement, and the related QUERY_REQUESTS table has two rows.

This table tracks only statements that are executed within transactions. Many meta-functions do not automatically open transactions.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that reported the requested information.
USER_NAME VARCHAR Name of the user who issued the query at the time Vertica recorded the session.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused after the session ends.
TRANSACTION_ID INTEGER Identifier for the transaction within the session. Statements that are not executed within transactions are not recorded in this table.
STATEMENT_ID INTEGER Unique identifier for the statement. The combination of TRANSACTION_ID and STATEMENT_ID uniquely identifies a user query within a session.
REQUEST_TYPE VARCHAR

Type of the query request. Examples include, but are not limited to:

  • QUERY
  • DDL
  • LOAD
  • UTILITY
  • TRANSACTION
  • PREPARE
  • EXECUTE
  • SET
  • SHOW
REQUEST VARCHAR Query statement.
REQUEST_LABEL VARCHAR Label of the query, if any.
SEARCH_PATH VARCHAR Contents of the search path.
SUCCESS BOOLEAN Whether the statement succeeded.
ERROR VARCHAR If the statement did not succeed, the error message.
START_TIMESTAMP TIMESTAMPTZ Beginning of history interval.
END_TIMESTAMP TIMESTAMPTZ End of history interval.
REQUEST_DURATION TIMESTAMPTZ Statement execution time in days, hours, minutes, seconds, and milliseconds. This time includes all operations that make up the statement, including any retries.
REQUEST_DURATION_MS INTEGER Statement execution time in milliseconds. This time includes all operations that make up the statement, including any retries.
IS_EXECUTING BOOLEAN Whether the statement is currently running.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

QUERY_PROFILES

2.105 - STORAGE_BUNDLE_INFO_STATISTICS

Indicates which projections have storage containers with invalid bundle metadata in the database catalog.

Indicates which projections have storage containers with invalid bundle metadata in the database catalog. If any ROS or DV container has invalid bundle metadata fields, Vertica increments the corresponding column (ros_without_bundle_info_count or dv_ros_without_bundle_info_count) by one.

To update the catalog with valid bundle metadata, call UPDATE_STORAGE_CATALOG, as an argument to Vertica meta-function DO_TM_TASK. For details, see Writing bundle metadata to the catalog.

Column Name Data Type Description
node_name VARCHAR Name of this projection's node
projection_oid INTEGER Projection's unique catalog identifier
projection_name VARCHAR Projection name
projection_schema VARCHAR Projection schema name
total_ros_count INTEGER Total number of ROS containers for this projection
ros_without_bundle_info_count INTEGER Number of ROS containers for this projection with invalid bundle metadata
total_dv_ros_count INTEGER Total number of DV (delete vector) containers for this projection
dv_ros_without_bundle_info_count INTEGER Number of DV containers for this projection with invalid bundle metadata

2.106 - STORAGE_BUNDLES

Monitors information about ROS storage bundles.

Monitors information about ROS storage bundles.

Column Name Data Type Description
NODE_NAME VARCHAR Node name for which information is listed.
STORAGE_ID INTEGER Numeric ID of the storage container. The same OID can appear on more than one node.
SAL_STORAGE_ID VARCHAR Unique hexadecimal numeric ID assigned by the Vertica catalog, which identifies the storage.
PROJECTION_ID INTEGER Unique identifier of the projection the bundle belongs to.
BUNDLE_SIZE INTEGER Size in bytes of the compressed data.
DATA_SIZE INTEGER Number of bytes in the storage container used to store the compressed projection data.
INDEX_SIZE INTEGER Size in bytes of the bundle's metadata.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.107 - STORAGE_CONTAINERS

Monitors information about Vertica storage containers.

Monitors information about Vertica storage containers.

Column Name Data Type Description
NODE_NAME* VARCHAR Node name for which information is listed.
NAMESPACE_NAME* VARCHAR For Eon Mode databases, namespace for which information is listed.
SCHEMA_NAME* VARCHAR

Schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

PROJECTION_ID* INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the projection.
PROJECTION_NAME* VARCHAR Projection name for which information is listed on that node.
STORAGE_OID* INTEGER Numeric ID assigned by the Vertica catalog, which identifies the storage. The same OID can appear on more than one node.
SAL_STORAGE_ID VARCHAR Unique hexadecimal numeric ID assigned by the Vertica catalog, which identifies the storage.
TOTAL_ROW_COUNT* VARCHAR

Total rows in the storage container listed for that projection.

If the database has been resharded, this value will be inaccurate until the Tuple mover realigns the storage containers to the new shard layout.

DELETED_ROW_COUNT* INTEGER

Total rows in the storage container deleted for that projection.

If the database has been resharded, this value will be inaccurate until the Tuple mover realigns the storage containers to the new shard layout.

USED_BYTES* INTEGER

Number of bytes in the storage container used to store the compressed projection data. This value should not be compared to the output of the AUDIT function, which returns the raw data size of database objects.

If the database has been resharded, this value will be inaccurate until the Tuple mover realigns the storage containers to the new shard layout.

START_EPOCH* INTEGER Number of the start epoch in the storage container for which information is listed.
END_EPOCH* INTEGER Number of the end epoch in the storage container for which information is listed.
GROUPING VARCHAR

The group by which columns are stored:

  • ALL: All columns are grouped

  • PROJECTION: Columns grouped according to projection definition

  • NONE: No columns grouped, despite grouping in the projection definition

  • OTHER: Some grouping but neither all nor according to projection (e.g., results from add column)

SEGMENT_LOWER_BOUND INTEGER Lower bound of the segment range spanned by the storage container or NULL if the corresponding projection is not elastic.
SEGMENT_UPPER_BOUND INTEGER Upper bound of the segment range spanned by the storage container or NULL if the corresponding projection is not elastic.
LOCATION_LABEL VARCHAR (128) The location label (if any) for the storage container is stored.
DELETE_VECTOR_COUNT INTEGER

The number of delete vectors in the storage container.

If the database has been resharded, this value will be inaccurate until the Tuple mover realigns the storage containers to the new shard layout.

SHARD_ID INTEGER Set only for an Eon Mode database, ID of the shard that this container belongs to.
SHARD_NAME VARCHAR(128) Set only for an Eon Mode database, name of the shard that this container belongs to.
ORIGINAL_SEGMENT_LOWER_BOUND INTEGER The lower bound of a storage container before database re-sharding. This value is set only if the database has been re-sharded and the storage containers have not been realigned with current shard definitions. For details, see RESHARD_DATABASE.
ORIGINAL_SEGMENT_UPPER_BOUND INTEGER The upper bound of a storage container before database re-sharding. This value is set only if the database has been re-sharded and the storage container has not been realigned with current shard definitions. For details, see RESHARD_DATABASE.
DISK_SIZE INTEGER Size in bytes of the compressed data in the storage container.

* Column values cached for faster query performance

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Examples

The following query identifies any storage containers that have not yet been realigned to the new shard segmentation bounds after running RESHARD_DATABASE:

=> SELECT COUNT(*) FROM storage_containers WHERE original_segment_lower_bound IS NOT NULL AND original_segment_upper_bound IS NOT NULL;

2.108 - STORAGE_POLICIES

Monitors the current storage policies in effect for one or more database objects.

Monitors the current storage policies in effect for one or more database objects.

Column Name Data Type Description
NAMESPACE_NAME VARCHAR For Eon Mode databases, namespace for which information is listed.
SCHEMA_NAME VARCHAR

Schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

OBJECT_NAME VARCHAR The name of the database object associated through the storage policy.
POLICY_DETAILS VARCHAR The object type of the storage policy.
LOCATION_LABEL VARCHAR (128) The label for this storage location.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

2.109 - STORAGE_TIERS

Provides information about all storage locations with the same label across all cluster nodes.

Provides information about all storage locations with the same label across all cluster nodes. This table lists data totals for all same-name labeled locations.

The system table shows what labeled locations exist on the cluster, as well as other cluster-wide data about the locations.

Column Name Data Type Description
LOCATION_LABEL VARCHAR The label associated with a specific storage location. The storage_tiers system table includes data totals for unlabeled locations, which are considered labeled with empty strings ('').
NODE_COUNT INTEGER The total number of nodes that include a storage location named location_label.
LOCATION_COUNT INTEGER

The total number of storage locations named location_label.

This value can differ from node_count if you create labeled locations with the same name at different paths on different nodes. For example:

v_vmart_node0001: Create one labeled location, FAST

V_vmart_node0002: Create two labeled locations, FAST, at different directory paths

In this case, node_count value = 2, while location_count value = 3.

ROS_CONTAINER_COUNT INTEGER The total number of ROS containers stored across all cluster nodes for location_label.
TOTAL_OCCUPIED_SIZE INTEGER The total number of bytes that all ROS containers for location_label occupy across all cluster nodes.

Privileges

None

See also

2.110 - STORAGE_USAGE

Provides information about file system storage usage.

Provides information about file system storage usage. This is useful for determining disk space usage trends.

Column Name Data Type Description
POLL_TIMESTAMP TIMESTAMPTZ Time when Vertica recorded the row.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
PATH VARCHAR Path where the storage location is mounted.
DEVICE VARCHAR Device on which the storage location is mounted.
FILESYSTEM VARCHAR File system on which the storage location is mounted.
USED_BYTES INTEGER Counter history of number of used bytes.
FREE_BYTES INTEGER Counter history of number of free bytes.
USAGE_PERCENT FLOAT Percent of storage in use.

Privileges

Superuser

See also

2.111 - STRATA

Contains internal details of how the combines ROS containers in each projection, broken down by stratum and classifies the ROS containers by size and partition.

Contains internal details of how the Tuple Mover combines ROS containers in each projection, broken down by stratum and classifies the ROS containers by size and partition. The related STRATA_STRUCTURES table provides a summary of the strata values.

Mergeout describes how the Tuple Mover combines ROS containers.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
SCHEMA_NAME VARCHAR

The schema name for which information is listed.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

PROJECTION_ID INTEGER Catalog-assigned numeric value that uniquely identifies the projection.
PROJECTION_NAME VARCHAR The projection name for which information is listed on that node.
STRATUM_KEY VARCHAR References the partition or partition group for which information is listed.
STRATA_COUNT INTEGER The total number of strata for this projection partition.
MERGING_STRATA_COUNT INTEGER The number of strata the Tuple Mover can merge out.
STRATUM_CAPACITY INTEGER The maximum number of ROS containers for the stratum before they must be merged.
STRATUM_HEIGHT FLOAT The size ratio between the smallest and largest ROS container in this stratum.
STRATUM_NO INTEGER The stratum number. Strata are numbered starting at 0, for the stratum containing the smallest ROS containers.
STRATUM_LOWER_SIZE VARCHAR The smallest ROS container size allowed in this stratum.
STRATUM_UPPER_SIZE VARCHAR The largest ROS container size allowed in this stratum.
ROS_CONTAINER_COUNT INTEGER The current number of ROS containers in the projection partition.

2.112 - STRATA_STRUCTURES

This table provides an overview of internal details.

This table provides an overview of Tuple Mover internal details. It summarizes how the ROS containers are classified by size. A more detailed view can be found in the STRATA virtual table.

Column Name Data Type Description
NODE_NAME VARCHAR The node name for which information is listed.
SCHEMA_NAME VARCHAR The schema name for which information is listed.
PROJECTION_NAME VARCHAR The projection name for which information is listed on that node.
PROJECTION_ID INTEGER Catalog-assigned numeric value that uniquely identifies the projection.
STRATUM_KEY VARCHAR References the partition or partition group for which information is listed.
STRATA_COUNT INTEGER The total number of strata for this projection partition.
MERGING_STRATA_COUNT INTEGER In certain hardware configurations, a high strata could contain more ROS containers than the Tuple Mover can merge out; output from this column denotes the number of strata the Tuple Mover can merge out.
STRATUM_CAPACITY INTEGER The maximum number of ROS containers that the strata can contained before it must merge them.
STRATUM_HEIGHT FLOAT The size ratio between the smallest and largest ROS container in a stratum.
ACTIVE_STRATA_COUNT INTEGER The total number of strata that have ROS containers in them.

Examples


=> \pset expanded
Expanded display is on.
=> SELECT node_name, schema_name, projection_name, strata_count,
            stratum_capacity, stratum_height, active_strata_count
            FROM strata_structures WHERE stratum_capacity > 60;
-[ RECORD 1 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0001
schema_name         | public
projection_name     | shipping_dimension_DBD_22_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1
-[ RECORD 2 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0001
schema_name         | public
projection_name     | shipping_dimension_DBD_23_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1
-[ RECORD 3 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0002
schema_name         | public
projection_name     | shipping_dimension_DBD_22_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1
-[ RECORD 4 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0002
schema_name         | public
projection_name     | shipping_dimension_DBD_23_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1
-[ RECORD 5 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0003
schema_name         | public
projection_name     | shipping_dimension_DBD_22_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1
-[ RECORD 6 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0003
schema_name         | public
projection_name     | shipping_dimension_DBD_23_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1
-[ RECORD 7 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0004
schema_name         | public
projection_name     | shipping_dimension_DBD_22_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1
-[ RECORD 8 ]-------+--------------------------------------------------------
node_name           | v_vmartdb_node0004
schema_name         | public
projection_name     | shipping_dimension_DBD_23_seg_vmart_design_vmart_design
strata_count        | 4
stratum_capacity    | 62
stratum_height      | 25.6511590887058
active_strata_count | 1

2.113 - SYSTEM

Monitors the overall state of the database.

Monitors the overall state of the database.

Column Name Data Type Description
CURRENT_EPOCH INTEGER The current epoch number.
AHM_EPOCH INTEGER The AHM epoch number.
LAST_GOOD_EPOCH INTEGER The smallest (min) of all the checkpoint epochs on the cluster.
REFRESH_EPOCH INTEGER Deprecated, always set to -1.
DESIGNED_FAULT_TOLERANCE INTEGER The designed or intended K-safety level.
NODE_COUNT INTEGER The number of nodes in the cluster.
NODE_DOWN_COUNT INTEGER The number of nodes in the cluster that are currently down.
CURRENT_FAULT_TOLERANCE INTEGER

The number of node failures the cluster can tolerate before it shuts down automatically.

This is the current K-safety level.

CATALOG_REVISION_NUMBER INTEGER The catalog version number.
ROS_USED_BYTES INTEGER The ROS size in bytes (cluster-wide).
ROS_ROW_COUNT INTEGER The number of rows in ROS (cluster-wide).
TOTAL_USED_BYTES INTEGER The total storage in bytes across the database cluster.
TOTAL_ROW_COUNT INTEGER The total number of rows across the database cluster.

2.114 - SYSTEM_RESOURCE_USAGE

Provides history about system resources, such as memory, CPU, network, disk, I/O.

Provides history about system resources, such as memory, CPU, network, disk, I/O.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
END_TIME TIMESTAMP End time of the history interval.
AVERAGE_MEMORY_USAGE_PERCENT FLOAT Average memory usage in percent of total memory (0-100) during the history interval.
AVERAGE_CPU_USAGE_PERCENT FLOAT Average CPU usage in percent of total CPU time (0-100) during the history interval.
NET_RX_KBYTES_PER_SECOND FLOAT Average number of kilobytes received from network (incoming) per second during the history interval.
NET_TX_KBYTES_PER_SECOND FLOAT Average number of kilobytes transmitting to network (outgoing) per second during the history interval.
IO_READ_KBYTES_PER_SECOND FLOAT Disk I/O average number of kilobytes read from disk per second during the history interval.
IO_WRITTEN_KBYTES_PER_SECOND FLOAT Average number of kilobytes written to disk per second during the history interval.

Privileges

Superuser

2.115 - SYSTEM_SERVICES

Provides information about background system services that Workload Analyzer monitors.

Provides information about background system services that Workload Analyzer monitors.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
SERVICE_TYPE VARCHAR

Type of service; can be one of:

  • SYSTEM

  • TUPLE MOVER

SERVICE_GROUP VARCHAR Group name, if there are multiple services of the same type.
SERVICE_NAME VARCHAR Name of the service.
SERVICE_INTERVAL_SEC INTEGER How often the service is executed (in seconds) during the history interval.
IS_ENABLED BOOLEAN Denotes if the service is enabled.
LAST_RUN_START TIMESTAMPTZ Denotes when the service was started last time.
LAST_RUN_END TIMESTAMPTZ Denotes when the service was completed last time.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

2.116 - SYSTEM_SESSIONS

Provides information about system internal session history by system task.

Provides information about system internal session history by system task.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_NAME VARCHAR Name of the user at the time Vertica recorded the session.
SESSION_ID INTEGER Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any. If a session is active but no transaction has begun, TRANSACTION_ID returns NULL.
STATEMENT_ID VARCHAR Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID and STATEMENT_ID uniquely identifies a statement within a session.
SESSION_TYPE VARCHAR

Session type, one of:

  • CLIENT

  • DBD

  • MERGEOUT

  • REBALANCE_CLUSTER

  • RECOVERY

  • REFRESH

  • TIMER_SERVICE

  • CONNECTION

  • SUBSESSION

  • REPARTITION_TABLE

  • LICENSE_AUDIT

  • STARTUP

  • SHUTDOWN

  • VSPREAD

RUNTIME_PRIORITY VARCHAR Specifies how many run-time resources (CPU, I/O bandwidth) are allocated to queries that are running in the resource pool.
DESCRIPTION VARCHAR Transaction description in this session.
SESSION_START_TIMESTAMP TIMESTAMPTZ Value of session at beginning of history interval.
SESSION_END_TIMESTAMP TIMESTAMPTZ Value of session at end of history interval.
IS_ACTIVE BOOLEAN Denotes if the session is still running.
SESSION_DURATION_MS INTEGER Duration of the session in milliseconds.
CLIENT_TYPE VARCHAR Columns not used in SYSTEM_SESSIONS system table. To view values for these columns, see the V_MONITOR schema system tables SESSIONS, USER_SESSIONS, CURRENT_SESSION, and SESSION_PROFILES.
CLIENT_VERSION VARCHAR
CLIENT_OS VARCHAR
CLIENT_OS_USER_NAME VARCHAR The name of the user that logged into, or attempted to log into, the database. This is logged even when the login attempt is unsuccessful.

Privileges

Superuser

2.117 - TABLE_RECOVERIES

Provides detailed information about recovered and recovering tables during a recovery by table.

Provides detailed information about recovered and recovering tables during a recovery by table.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is performing the recovery.
TABLE_NAME VARCHAR The name of the table being recovered.
TABLE_OID INTEGER The object ID of the table being recovered.
STATUS VARCHAR

The status of the table. Tables can have the following status:

  • recovered: The table is fully recovered

  • recovering: The table is in the process of recovery

  • error_retry: Vertica has attempted to recover the table, but the recovery failed.

Tables that have not yet begun the recovery process do not have a status.

PHASE VARCHAR The phase of the recovery.
THREAD_ID VARCHAR The ID of the thread that performed the recovery.
START_TIME TIMESTAMPTZ The date and time that the table began recovery.
END_TIME TIMESTAMPTZ The date and time that the table completed recovery.
RECOVER_PRIORITY INTEGER The recovery priority of the table being recovered.
RECOVER_ERROR VARCHAR Error that caused the recovery to fail.
IS_HISTORICAL BOOLEAN If f, the record contains recovery information for the current process.

Privileges

None

Examples

=> SELECT * FROM TABLE_RECOVERIES;
-[RECORD 1]----------------------------------
node_name        | node04
table_oid        | 45035996273708000
table_name       | public.t
status           | recovered
phase            | current replay delete
thread_id        | 7f7a817fd700
start_time       | 2017-12-13 08:47:28.825085-05
end_time         | 2017-12-13 08:47:29.216571-05
recover_priority | -9223372036854775807
recover_error    | Event apply failed
is_historical    | t
-[RECORD 2]--------------------------------------
node_name        | v_test_parquet_ha_node0011
table_oid        | 45035996273937680
table_name       | public.t2_impala230_uncompre_multi_file_libhdfs_1
status           | error-retry
phase            | historical
thread_id        | 7f89a574f700
start_time       | 2018-02-24 11:30:59.008831-05
end_time         | 2018-02-24 11:33:09.780798-05
recover_priority | -9223372036854775807
recover_error    | Could not stop all dirty transactions[txnId = 45035996273718426; ]
is_historical    | t

2.118 - TABLE_RECOVERY_STATUS

Provides node recovery information during a Recovery By Table.

Provides node recovery information during a Recovery By Table.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is performing the recovery.
NODE_RECOVERY_START_TIME TIMESTAMPTZ The timestamp for when the node began recovering.
RECOVER_EPOCH INTEGER The epoch that the recovery operation is trying to recover to.
RECOVERING_TABLE_NAME VARCHAR The name of the table currently recovering.
TABLES_REMAIN INTEGER The total number of tables on the node.
IS_RUNNING BOOLEAN Indicates if the recovery process is still running.

Privileges

None

Examples

=> SELECT * FROM TABLE_RECOVERY_STATUS;
-[ RECORD 1 ]------------+-----------------
node_name                | v_vmart_node0001
node_recovery_start_time |
recover_epoch            |
recovering_table_name    |
tables_remain            | 0
is_running               | f
-[ RECORD 2 ]------------+-----------------
node_name                | v_vmart_node0002
node_recovery_start_time |
recover_epoch            |
recovering_table_name    |
tables_remain            | 0
is_running               | f
-[ RECORD 3 ]------------+-----------------
node_name                | v_vmart_node0003
node_recovery_start_time | 2017-12-13 08:47:28.282377-05
recover_epoch            | 23
recovering_table_name    | user_table
tables_remain            | 5
is_running               | y

2.119 - TABLE_STATISTICS

Displays statistics that have been collected for tables and their respective partitions.

Displays statistics that have been collected for tables and their respective partitions.

Column Name Data Type Description
LOGICAL_STATS_OID INTEGER Uniquely identifies a collection of statistics for a given table.
TABLE_NAME VARCHAR Name of an existing database table.
MIN_PARTITION_KEY,
MAX_PARTITION_KEY
VARCHAR Statistics for a range of partition keys collected by ANALYZE_STATISTICS_PARTITION, empty if statistics were collected by ANALYZE_STATISTICS.
ROW_COUNT INTEGER The number of rows analyzed for each statistics collection.
STAT_COLLECTION_TIME TIMESTAMPTZ The timestamp of each statistics collection.

2.120 - TLS_CONFIGURATIONS

Lists settings for TLS Configuration objects for the server, LDAP, etc.

Lists settings for TLS Configuration objects for the server, LDAP, etc.

Column Name Data Type Description
NAME VARCHAR

Name of the TLS Configuration. Vertica includes the following TLS Configurations by default:

  • server

  • LDAPLink

  • LDAPAuth

  • data_channel

OWNER VARCHAR Owner of the TLS Configuration object.
CERTIFICATE VARCHAR The certificate associated with the TLS Configuration object.
CA_CERTIFICATES VARCHAR

The CA certificate(s) used to verify client certificates.

In cases where a TLS Configuration uses more than one CA, each CA will have its own row in the table.

CIPHER_SUITES VARCHAR The cipher suites to used to secure the connection.
MODE VARCHAR

How Vertica establishes TLS connections with another host, one of the following, in order of ascending security:

  • DISABLE: Disables TLS. All other options for this parameter enable TLS.

  • ENABLE: Enables TLS. Vertica does not check client certificates.

  • TRY_VERIFY: Establishes a TLS connection if one of the following is true:

    • the other host presents a valid certificate

    • the other host doesn't present a certificate

    If the other host presents an invalid certificate, the connection will use plaintext.

  • VERIFY_CA: Connection succeeds if Vertica verifies that the other host's certificate is from a trusted CA. If the other host does not present a certificate, the connection uses plaintext.

  • VERIFY_FULL: Connection succeeds if Vertica verifies that the other host's certificate is from a trusted CA and the certificate's cn (Common Name) or subjectAltName attribute matches the hostname or IP address of the other host.

    Note that for client certificates, cn is used for the username, so subjectAltName must match the hostname or IP address of the other host.

VERIFY_FULL is unsupported for client-server TLS (the connection type handled by ServerTLSConfig) and behaves as VERIFY_CA.

Examples

In this example, the LDAPAuth TLS Configuration uses two CA certificates:

=> SELECT * FROM tls_configurations WHERE name='LDAPAuth';
    name   |  owner  | certificate | ca_certificate | cipher_suites |  mode
----------+---------+-------------+----------------+---------------+---------
 LDAPAuth | dbadmin | server_cert | ca             |               | DISABLE
 LDAPAuth | dbadmin | server_cert | ica            |               | DISABLE
(2 rows)

To make more clear the relationship between a TLS Configuration and its CA certificates, you can format the query with LISTAGG:

=> SELECT name, owner, certificate, LISTAGG(ca_certificate) AS ca_certificates, cipher_suites, mode
FROM tls_configurations
WHERE name='LDAPAuth'
GROUP BY name, owner, certificate, cipher_suites, mode
ORDER BY 1;
   name   |  owner  | certificate | ca_certificates | cipher_suites |  mode
----------+---------+-------------+-----------------+---------------+---------
 LDAPAuth | dbadmin | server_cert | ca,ica          |               | DISABLE
(1 row)

2.121 - TRANSACTIONS

Records the details of each transaction.

Records the details of each transaction.

Column Name Data Type Description
START_TIMESTAMP TIMESTAMPTZ Beginning of history interval.
END_TIMESTAMP TIMESTAMPTZ End of history interval.
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the user.
USER_NAME VARCHAR Name of the user for which transaction information is listed.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any; otherwise NULL.
DESCRIPTION VARCHAR Textual description of the transaction.
START_EPOCH INTEGER Number of the start epoch for the transaction.
END_EPOCH INTEGER Number of the end epoch for the transaction
NUMBER_OF_STATEMENTS INTEGER Number of query statements executed in this transaction.
ISOLATION VARCHAR Denotes the transaction mode as "READ COMMITTED" or "SERIALIZABLE".
IS_READ_ONLY BOOLEAN Denotes "READ ONLY" transaction mode.
IS_COMMITTED BOOLEAN Determines if the transaction was committed. False means ROLLBACK.
IS_LOCAL BOOLEAN Denotes transaction is local (non-distributed).
IS_INITIATOR BOOLEAN Denotes if the transaction occurred on this node (t).
IS_DDL BOOLEAN Distinguishes between a DDL transaction (t) and non-DDL transaction (f).

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also

Transactions

2.122 - TRUNCATED_SCHEMATA

Lists the original names of restored schemas that were truncated due to name lengths exceeding 128 characters.

Lists the original names of restored schemas that were truncated due to name lengths exceeding 128 characters.

Column Name Data Type Description
RESTORE_TIME TIMESTAMPTZ The time that the table was restored.
SESSION_ID VARCHAR Identifier for the restoring session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INTEGER Identifier of the user for the restore event.
USER_NAME VARCHAR Name of the user for which Vertica lists restore information at the time it recorded the session.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any; otherwise NULL.
ORIGINAL_SCHEMA_NAME VARCHAR The original name of the schema prior to the restore.
NEW_SCHEMA_NAME VARCHAR The name of the schema after it was truncated.

Privileges

None

2.123 - TUNING_RECOMMENDATIONS

Returns tuning recommendation results from the last call to ANALYZE_WORKLOAD.

Returns tuning recommendation results from the last call to ANALYZE_WORKLOAD. This information is useful for building filters on the Workload Analyzer result set.

Column Name Data Type Description
OBSERVATION_COUNT INTEGER Integer for the total number of events observed for this tuning recommendation. For example, if you see a return value of 1, Workload Analyzer is making its first tuning recommendation for the event in 'scope'.
FIRST_OBSERVATION_TIME TIMESTAMPTZ Timestamp when the event first occurred. If this column returns a null value, the tuning recommendation is from the current status of the system instead of from any prior event.
LAST_OBSERVATION_TIME TIMESTAMPTZ Timestamp when the event last occurred. If this column returns a null value, the tuning recommendation is from the current status of the system instead of from any prior event.
TUNING_PARAMETER VARCHAR

Objects on which to perform a tuning action. For example, a return value of:

  • public.t informs the DBA to run Database Designer on table t in the public schema

  • bsmith notifies a DBA to set a password for user bsmith

TUNING_DESCRIPTION VARCHAR

Textual description of the tuning recommendation to perform on the tuning_parameter object. For example:

  • Run database designer on table schema.table

  • Create replicated projection for table schema.table

  • Consider incremental design on query

  • Re-segment projection projection-name on high-cardinality column(s)

  • Drop the projection projection-name

  • Alter a table's partition expression

  • Reorganize data in partitioned table

  • Decrease the MoveOutInterval configuration parameter setting

TUNING_COMMAND VARCHAR

Command string if tuning action is a SQL command. For example:

Update statistics on a particular schema's table.column:

SELECT ANALYZE_STATISTICS('public.table.column');

Resolve mismatched configuration parameter LockTimeout:

SELECT * FROM CONFIGURATION_PARAMETERS WHERE parameter_name = 'LockTimeout';

Set the password for user bsmith:

ALTER USER (bsmith) IDENTIFIED BY ('new_password');

TUNING_COST VARCHAR

Cost is based on the type of tuning recommendation and is one of:

  • LOW: minimal impact on resources from running the tuning command

  • MEDIUM: moderate impact on resources from running the tuning command

  • HIGH: maximum impact on resources from running the tuning command

Depending on the size of your database or table, consider running high-cost operations after hours instead of during peak load times.

Privileges

Superuser

Examples

See ANALYZE_WORKLOAD.

See also

2.124 - TUPLE_MOVER_OPERATIONS

Monitors the status of operations on each node.

Monitors the status of Tuple Mover operations on each node.

Column Name Data Type Description
OPERATION_START_TIMESTAMP TIMESTAMP Start time of a Tuple Mover operation.
NODE_NAME VARCHAR Node name for which information is listed.
OPERATION_NAME VARCHAR

One of the following:

  • Analyze Statistics

  • DVMergeout

  • Mergeout

  • Partitioning

  • Rebalance

  • Recovery Replay Delete

OPERATION_STATUS VARCHAR

Returns the status of each operation, one of the following:

  • Empty string: not running

  • Start

  • Running

  • Complete

  • Update

  • Abort

  • Change plan type to Replay Delete

TABLE_SCHEMA VARCHAR

Schema name for the specified projection.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

TABLE_NAME VARCHAR Table name for the specified projection.
PROJECTION_NAME VARCHAR Name of the projection being processed.
PROJECTION_ID INTEGER Unique numeric ID assigned by the Vertica catalog, which identifies the projection.
COLUMN_ID INTEGER Identifier for the column for the associated projection being processed.
EARLIEST_CONTAINER_START_EPOCH INTEGER Populated for mergeout and purge operations only. For an automatically-invoked mergeout, for example, the returned value represents the lowest epoch of containers involved in the mergeout.
LATEST_CONTAINER_END_EPOCH INTEGER Populated for mergeout and purge_partitions operations. For an automatically-invoked mergeout, for example, the returned value represents the highest epoch of containers involved in the mergeout.
ROS_COUNT INTEGER Number of ROS containers.
TOTAL_ROS_USED_BYTES INTEGER Size in bytes of all ROS containers in the mergeout operation. (Not applicable for other operations.)
PLAN_TYPE VARCHAR

One of the following:

  • Analyze Statistics

  • DVMergeout

  • Mergeout

  • Partitioning

  • Rebalance

  • Recovery Replay Delete

  • Replay Delete

SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
TRANSACTION_ID INTEGER Identifier for the transaction within the session, if any. If a session is active but no transaction has begun, TRANSACTION_ID returns NULL.
IS_EXECUTING BOOLEAN Distinguishes between actively-running (t) and completed (f) tuple mover operations.
RUNTIME_PRIORITY VARCHAR

Determines how many run-time resources (CPU, I/O bandwidth) the Resource Manager should dedicate to running queries in the resource pool, one of the following:

  • HIGH

  • MEDIUM

  • LOW

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

Examples

=> SELECT node_name, operation_status, projection_name, plan_type
    FROM TUPLE_MOVER_OPERATIONS;
 node_name         | operation_status | projection_name  | plan_type
-------------------+------------------+------------------+-----------
 v_vmart_node0001  | Running          | p1_b2            | Mergeout
 v_vmart_node0002  | Running          | p1               | Mergeout
 v_vmart_node0001  | Running          | p1_b2            | Replay Delete
 v_vmart_node0001  | Running          | p1_b2            | Mergeout
 v_vmart_node0002  | Running          | p1_b2            | Mergeout
 v_vmart_node0001  | Running          | p1_b2            | Replay Delete
 v_vmart_node0002  | Running          | p1               | Mergeout
 v_vmart_node0003  | Running          | p1_b2            | Replay Delete
 v_vmart_node0001  | Running          | p1               | Mergeout
 v_vmart_node0002  | Running          | p1_b1            | Mergeout

See also

2.125 - UDFS_EVENTS

Records information about events involving the S3, HDFS, GCS, and Azure file systems.

Records information about events involving the S3, HDFS, GCS, and Azure file systems.

Events are logged if they take longer to complete than the threshold specified by UDFSSlowRequestThreshold (default 1000ms).

HTTP requests are logged if they take longer to complete than the threshold specified by HTTPSlowRequestThreshold (default 500ms), or if they produce errors or are retries. HTTP requests are logged only for S3.

Column Name Data Type Description
START_TIME TIMESTAMPTZ Event start time
END_TIME TIMESTAMPTZ Event end time
NODE_NAME VARCHAR Name of the node that reported the event
SESSION_ID VARCHAR Identifies the event session, unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INTEGER Identifies the event user.
TRANSACTION_ID* INTEGER Identifies the event transaction within the SESSION_ID-specified session, if any; otherwise NULL.
STATEMENT_ID* INTEGER Uniquely identifies the current statement, if any; otherwise NULL.
REQUEST_ID* INTEGER Uniquely identifies the event request in the user session.
FILESYSTEM VARCHAR Name of the file system, such as S3
PATH VARCHAR Complete file path
EVENT VARCHAR An event type, such as HttpRequestAttempt, or a function call, such as virtual size_t SAL::S3FileOperator::read(void*, size_t)
STATUS VARCHAR Status of the event: OK, CANCEL, or FAIL
DESCRIPTION VARCHAR Other event details. Depending on the event type, this column can be plain text or JSON.
ACTIVITY VARCHAR Points to the component that was active and logged the event, for internal use only.
PLAN_ID VARCHAR Uniquely identifies the node-specific Optimizer plan for this event.
OPERATOR_ID INTEGER Identifier assigned by the Execution Engine operator instance that performs the work

* In combination, TRANSACTION_ID, STATEMENT_ID, and REQUEST_ID uniquely identify an event within a given session.

Privileges

Superuser

2.126 - UDFS_OPS_PER_HOUR

This table summarizes the S3 file system statistics for each hour.

This table summarizes the S3 file system statistics for each hour.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node the file system is on.
FILESYSTEM VARCHAR Name of the file system, such as S3.
START_TIME TIMESTAMP Start time for statistics gathering.
END_TIME TIMESTAMP Stop time for statistics gathering.
AVG_OPERATIONS_PER_SECOND INTEGER Average number of operations per second during the specified hour.
AVG_ERRORS_PER_SECOND INTEGER Average number of errors per second during the specified hour.
RETRIES INTEGER Number of retry events during the specified hour.
METADATA_READS INTEGER Number of requests to write metadata during the specified hour. For example, S3 POST and DELETE requests are metadata writes.
METADATA_WRITES INTEGER Number of requests to write metadata during the specified hour. For example, S3 POST and DELETE requests are metadata writes.
DATA_READS INTEGER Number of read operations, such as S3 GET requests to download files, during the specified hour.
DATA_WRITES INTEGER Number of write operations, such as S3 PUT requests to upload files, during the specified hour.
UPSTREAM_BYTES INTEGER Number of bytes received during the specified hour.
DOWNSTREAM_BYTES INTEGER Number of bytes sent during the specified hour.

Examples

=> \x
Expanded display is on.
=> SELECT * FROM UDFS_OPS_PER_HOUR;
-[ RECORD 1 ]-------------+--------------------
node_name                 | e1
filesystem                | S3
start_time                | 2018-04-06 04:00:00
end_time                  | 2018-04-06 04:00:00
avg_operations_per_second | 0
avg_errors_per_second     | 0
retries                   | 0
metadata_reads            | 0
metadata_writes           | 0
data_reads                | 0
data_writes               | 0
upstream_bytes            | 0
downstream_bytes          | 0
...

See also

UDFS_OPS_PER_MINUTE

2.127 - UDFS_OPS_PER_MINUTE

This table summarizes the S3 file system statistics for each minute.

This table summarizes the S3 file system statistics for each minute.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node the file system is on.
FILESYSTEM VARCHAR Name of the file system, such as S3.
START_TIME TIMESTAMP Start time for statistics gathering.
END_TIME TIMESTAMP Stop time for statistics gathering.
AVG_OPERATIONS_PER_SECOND INTEGER Average number of operations per second during the specified minute.
AVG_ERRORS_PER_SECOND INTEGER Average number of errors per second during the specified minute.
RETRIES INTEGER Number of retry events during the specified minute.
METADATA_READS INTEGER Number of requests to write metadata during the specified minute. For example, S3 POST and DELETE requests are metadata writes.
METADATA_WRITES INTEGER Number of requests to write metadata during the specified minute. For example, S3 POST and DELETE requests are metadata writes.
DATA_READS INTEGER Number of read operations, such as S3 GET requests to download files, during the specified minute.
DATA_WRITES INTEGER Number of write operations, such as S3 PUT requests to upload files, during the specified minute.
UPSTREAM_BYTES INTEGER Number of bytes received during the specified minute.
DOWNSTREAM_BYTES INTEGER Number of bytes sent during the specified minute.

Examples

=> \x
Expanded display is on.
=> SELECT * FROM UDFS_OPS_PER_MINUTE;
-[ RECORD 1 ]-------------+--------------------
node_name                 | e1
filesystem                | S3
start_time                | 2018-04-06 04:17:00
end_time                  | 2018-04-06 04:18:00
avg_operations_per_second | 0
avg_errors_per_second     | 0
retries                   | 0
metadata_reads            | 0
metadata_writes           | 0
data_reads                | 0
data_writes               | 0
upstream_bytes            | 0
downstream_bytes          | 0
...

See also

UDFS_OPS_PER_HOUR

2.128 - UDFS_STATISTICS

Records aggregate information about operations on file systems and object-stores.

Records aggregate information about operations on file systems and object stores. For access through LibHDFS++, the table records information about metadata but not data.

An operation can be made up of many individual read, write, or retry requests. SUCCESSFUL_OPERATIONS and FAILED_OPERATIONS count operations; the other counters count individual requests. When an operation finishes, one of the OPERATIONS counters is incremented once, but several other counters could be incremented several times each.

Column Name Data Type Description
FILESYSTEM VARCHAR Name of the file system, such as S3 or Libhdfs++.
SUCCESSFUL_OPERATIONS INTEGER Number of successful operations.
FAILED_OPERATIONS INTEGER Number of failed operations.
RETRIES INTEGER Number of retry events.
METADATA_READS INTEGER Number of requests to read metadata. For example, S3 list bucket and HEAD requests are metadata reads.
METADATA_WRITES INTEGER Number of requests to write metadata. For example, S3 POST and DELETE requests are metadata writes.
DATA_READS INTEGER Number of read operations, such as S3 GET requests to download files.
DATA_WRITES INTEGER Number of write operations, such as S3 PUT requests to upload files.
DOWNSTREAM_BYTES INTEGER Number of bytes received.
UPSTREAM_BYTES INTEGER Number of bytes sent.
OPEN_FILES INTEGER Number of files that are currently open.
MAPPED_FILES INTEGER Number of files that are currently mapped. On S3 file systems, this is the number of streaming connections for reading data. On other file systems, this value is 0.
READING INTEGER The number of read operations that are currently running.
WRITING INTEGER The number of write operations that are currently running.
TOTAL_REQUEST_DURATION_MS INTEGER Accumulated HTTP request duration, in milliseconds. This information is recorded only for S3 and GCS.
OVERALL_AVERAGE_LATENCY_MS INTEGER Average HTTP request duration, in milliseconds. This value is TOTAL_REQUEST_DURATION_MS divided by the sum of SUCCESSFUL_OPERATIONS and FAILED_OPERATIONS (rounded). This value is set only for S3 and GCS.
OVERALL_DOWNSTREAM_THROUGHPUT_MB_S FLOAT HTTP request downstream throughput in megabytes per second (MB/s). This value is DOWNSTREAM_BYTES divided by TOTAL_REQUEST_DURATION_MS. This value is set only for S3 and GCS.
OVERALL_UPSTREAM_THROUGHPUT_MB_S FLOAT HTTP request upstream throughput in megabytes per second (MB/s). This value is UPSTREAM_BYTES divided by TOTAL_REQUEST_DURATION_MS. This value is set only for S3 and GCS.

Examples

The following query gets the total number of metadata RPCs for Libhdfs++ operations:

=> SELECT SUM(metadata_reads) FROM UDFS_STATISTICS WHERE filesystem = 'Libhdfs++';

2.129 - UDX_EVENTS

Records information about events raised from the execution of user-defined extensions.

Records information about events raised from the execution of user-defined extensions.

A UDx populates the __RAW__ column using ServerInterface::logEvent() (C++ only). VMap support is provided by Flex Tables, which must not be disabled.

In combination, TRANSACTION_ID, STATEMENT_ID, and REQUEST_ID uniquely identify an event within a given session.

Column Name Data Type Description
REPORT_TIME TIMESTAMPTZ Time the event occurred.
NODE_NAME VARCHAR Name of the node that reported the event
SESSION_ID VARCHAR Identifies the event session, unique within the cluster at any point in time but can be reused when the session closes.
USER_ID INTEGER Identifies the user running the UDx.
USER_NAME VARCHAR Identifies the user running the UDx.
TRANSACTION_ID INTEGER Identifies the event transaction within the SESSION_ID-specified session, if any; otherwise NULL.
STATEMENT_ID INTEGER Uniquely identifies the current statement, if any; otherwise NULL.
REQUEST_ID INTEGER Uniquely identifies the event request in the user session.
UDX_NAME VARCHAR Name of the UDx, as specified in the corresponding CREATE FUNCTION statement.
__RAW__ VARBINARY VMap containing UDx-specific values. See the documentation of individual UDXs for supported fields.

2.130 - UDX_FENCED_PROCESSES

Provides information about processes Vertica uses to run user-defined extensions in fenced mode.

Provides information about processes Vertica uses to run user-defined extensions in fenced mode.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
PROCESS_TYPE VARCHAR

Indicates what kind of side process this row is for and can be one of the following values:

  • UDxZygoteProcess — Master process that creates worker side processes, as needed, for queries. There will be, at most, 1 UP UDxZygoteProcess for each Vertica instance.

  • UDxSideProcess — Indicates that the process is a worker side process. There could be many UDxSideProcesses, depending on how many sessions there are, how many queries, and so on.

SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
LANGUAGE VARCHAR The language of the UDx. For example 'R' or 'C++';
MAX_MEMORY_JAVA_KB INTEGER The maximum amount of memory in KB that can be used for the Java heap file on the node.
PID INTEGER Linux process identifier of the side process (UDxSideProcess).
PORT VARCHAR For Vertica internal use. The TCP port that the side process is listening on.
STATUS VARCHAR

Set to UP or DOWN, depending on whether the process is alive or not.

After a process fails, Vertica restarts it only on demand. So after a process failure, there might be periods of time when no side processes run.

Privileges

None

2.131 - USER_LIBRARIES

Lists the user libraries that are currently loaded.

Lists the user libraries that are currently loaded. These libraries contain user-defined extensions (UDxs) that provide additional analytic functions.

Column Name Data Type Description
NAMESPACE_NAME VARCHAR For Eon Mode databases, name of the namespace that contains the library.
SCHEMA_NAME VARCHAR(8192)

The name of the schema containing the library.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

LIB_NAME VARCHAR(8192) The name of the library.
LIB_OID INTEGER The object ID of the library.
AUTHOR VARCHAR(8192) The creator of the library file.
OWNER_ID INTEGER The object ID of the library's owner.
LIB_FILE_NAME VARCHAR(8192) The name of the shared library file.
MD5_SUM VARCHAR(8192)

The MD5 checksum of the library file, used to verify that the file was correctly copied to each node.

SDK_VERSION VARCHAR(8192) The version of the Vertica SDK used to compile the library.
REVISION VARCHAR(8192) The revision of the Vertica SDK used to compile the library.
LIB_BUILD_TAG VARCHAR(8192) Internal information set by library developer to track the when the library was compiled.
LIB_VERSION VARCHAR(8192) The version of the library.
LIB_SDK_VERSION VARCHAR(8192) The version of the Vertica SDK intended for use with the library. The developer sets this value manually. This value may differ from the values in the SDK_VERSION and REVISION, which are set automatically during compilation.
SOURCE_URL VARCHAR(8192) A URL that contains information about the library.
DESCRIPTION VARCHAR(8192) A description of the library.
LICENSES_REQUIRED VARCHAR(8192) The licenses required to use the library.
SIGNATURE VARCHAR(8192) The signature used to sign the library for validation.
DEPENDENCIES VARCHAR (8192) External libraries on which this library depends. These libraries are maintained by Vertica, just like the user libraries themselves.

2.132 - USER_LIBRARY_MANIFEST

Lists user-defined functions contained in all loaded user libraries.

Lists user-defined functions contained in all loaded user libraries.

Column Name Data Type Description
NAMESPACE_NAME VARCHAR For Eon Mode databases, name of the namespace that contains the function.
SCHEMA_NAME VARCHAR

Name of the schema that contains the function.

If the schema belongs to a non-default namespace in an Eon Mode database, the schema name is front-qualified with the name of the schema's namespace. For example, n1.s refers to schema s in namespace n1.

LIB_NAME VARCHAR The name of the library containing the UDF.
LIB_OID INTEGER The object ID of the library containing the function.
OBJ_NAME VARCHAR The name of the constructor class in the library for a function.
OBJ_TYPE VARCHAR The type of user defined function (scalar function, transform function)
ARG_TYPES VARCHAR A comma-delimited list of data types of the function's parameters.
RETURN_TYPE VARCHAR A comma-delimited list of data types of the function's return values.

Privileges

None

2.133 - USER_SESSIONS

Returns user session history on the system.

Returns user session history on the system.

Column Name Data Type Description
NODE_NAME VARCHAR Name of the node that is reporting the requested information.
USER_NAME VARCHAR Name of the user at the time Vertica recorded the session.
SESSION_ID VARCHAR Identifier for this session. This identifier is unique within the cluster at any point in time but can be reused when the session closes.
TRANSACTION_ID VARCHAR Identifier for the transaction within the session, if any. If a session is active but no transaction has begun, TRANSACTION_ID returns NULL.
STATEMENT_ID VARCHAR Unique numeric ID for the currently-running statement. NULL indicates that no statement is currently being processed. The combination of TRANSACTION_ID and STATEMENT_ID uniquely identifies a statement within a session.
RUNTIME_PRIORITY VARCHAR

Determines the amount of run-time resources (CPU, I/O bandwidth) the Resource Manager should dedicate to queries already running in the resource pool. Valid values are:

  • HIGH

  • MEDIUM

  • LOW

Queries with a HIGH run-time priority are given more CPU and I/O resources than those with a MEDIUM or LOW run-time priority.

SESSION_START_TIMESTAMP TIMESTAMPTZ Value of session at beginning of history interval.
SESSION_END_TIMESTAMP TIMESTAMPTZ Value of session at end of history interval.
IS_ACTIVE BOOLEAN Denotes if the operation is executing.
CLIENT_OS_HOSTNAME VARCHAR The hostname of the client as reported by their operating system.
CLIENT_HOSTNAME VARCHAR

The IP address and port of the TCP socket from which the client connection was made; NULL if the session is internal.

Vertica accepts either IPv4 or IPv6 connections from a client machine. If the client machine contains mappings for both IPv4 and IPv6, the server randomly chooses one IP address family to make a connection. This can cause the CLIENT_HOSTNAME column to display either IPv4 or IPv6 values, based on which address family the server chooses.

CLIENT_PID INTEGER

Linux process identifier of the client process that issued this connection.

Note: The client process could be on a different machine from the server.

CLIENT_LABEL VARCHAR User-specified label for the client connection that can be set when using ODBC. See Label in DSN Parameters.
SSL_STATE VARCHAR

Indicates if Vertica used Secure Socket Layer (SSL) for a particular session. Possible values are:

  • None – Vertica did not use SSL.

  • Server – Sever authentication was used, so the client could authenticate the server.

  • Mutual – Both the server and the client authenticated one another through mutual authentication.

See Implementing Security and TLS protocol.

AUTHENTICATION_METHOD VARCHAR

Type of client authentication used for a particular session, if known. Possible values are:

  • Unknown

  • Trust

  • Reject

  • Kerberos

  • Password

  • MD5

  • LDAP

  • Kerberos-GSS

  • Ident

See Security and authentication and Configuring client authentication.

CLIENT_TYPE VARCHAR

The type of client from which the connection was made. Possible client type values:

  • ADO.NET Driver

  • ODBC Driver

  • JDBC Driver

  • vsql

CLIENT_VERSION VARCHAR Returns the client version.
CLIENT_OS VARCHAR Returns the client operating system.
CLIENT_OS_USER_NAME VARCHAR The name of the user that logged into, or attempted to log into, the database. This is logged even when the login attempt is unsuccessful.

Privileges

Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.

See also