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.
This is the multi-page printable view of this section. Click here to print.
Vertica system tables
- 1: V_CATALOG schema
- 1.1: ACCESS_POLICY
- 1.2: ALL_RESTORE_POINTS
- 1.3: ALL_TABLES
- 1.4: AUDIT_MANAGING_USERS_PRIVILEGES
- 1.5: CA_BUNDLES
- 1.6: CATALOG_SUBSCRIPTION_CHANGES
- 1.7: CATALOG_SYNC_STATE
- 1.8: CATALOG_TRUNCATION_STATUS
- 1.9: CERTIFICATES
- 1.10: CLIENT_AUTH
- 1.11: CLIENT_AUTH_PARAMS
- 1.12: CLUSTER_LAYOUT
- 1.13: COLUMNS
- 1.14: COMMENTS
- 1.15: COMPLEX_TYPES
- 1.16: CONSTRAINT_COLUMNS
- 1.17: CRYPTOGRAPHIC_KEYS
- 1.18: DATABASES
- 1.19: DIRECTED_QUERIES
- 1.20: DUAL
- 1.21: ELASTIC_CLUSTER
- 1.22: EPOCHS
- 1.23: FAULT_GROUPS
- 1.24: FOREIGN_KEYS
- 1.25: GRANTS
- 1.26: HCATALOG_COLUMNS
- 1.27: HCATALOG_SCHEMATA
- 1.28: HCATALOG_TABLE_LIST
- 1.29: HCATALOG_TABLES
- 1.30: ICEBERG_COLUMNS
- 1.31: INHERITED_PRIVILEGES
- 1.32: INHERITING_OBJECTS
- 1.33: KEYWORDS
- 1.34: LARGE_CLUSTER_CONFIGURATION_STATUS
- 1.35: LICENSE_AUDITS
- 1.36: LICENSES
- 1.37: LOAD_BALANCE_GROUPS
- 1.38: LOG_PARAMS
- 1.39: LOG_QUERIES
- 1.40: LOG_TABLES
- 1.41: MATERIALIZE_FLEXTABLE_COLUMNS_RESULTS
- 1.42: MODELS
- 1.43: NAMESPACES
- 1.44: NETWORK_ADDRESSES
- 1.45: NODE_SUBSCRIPTION_CHANGE_PHASES
- 1.46: NODE_SUBSCRIPTIONS
- 1.47: NODES
- 1.48: ODBC_COLUMNS
- 1.49: PASSWORD_AUDITOR
- 1.50: PASSWORDS
- 1.51: PRIMARY_KEYS
- 1.52: PROFILE_PARAMETERS
- 1.53: PROFILES
- 1.54: PROJECTION_CHECKPOINT_EPOCHS
- 1.55: PROJECTION_COLUMNS
- 1.56: PROJECTION_DELETE_CONCERNS
- 1.57: PROJECTIONS
- 1.58: REGISTERED_MODELS
- 1.59: RESOURCE_POOL_DEFAULTS
- 1.60: RESOURCE_POOLS
- 1.61: ROLES
- 1.62: ROUTING_RULES
- 1.63: SCHEDULER_TIME_TABLE
- 1.64: SCHEMATA
- 1.65: SEQUENCES
- 1.66: SESSION_SUBSCRIPTIONS
- 1.67: SHARDS
- 1.68: STORAGE_LOCATIONS
- 1.69: STORED_PROC_TRIGGERS
- 1.70: SUBCLUSTER_RESOURCE_POOL_OVERRIDES
- 1.71: SUBCLUSTERS
- 1.72: SYSTEM_COLUMNS
- 1.73: SYSTEM_TABLES
- 1.74: TABLE_CONSTRAINTS
- 1.75: TABLES
- 1.76: TEXT_INDICES
- 1.77: TYPES
- 1.78: USER_AUDITS
- 1.79: USER_CLIENT_AUTH
- 1.80: USER_CONFIGURATION_PARAMETERS
- 1.81: USER_FUNCTION_PARAMETERS
- 1.82: USER_FUNCTIONS
- 1.83: USER_PROCEDURES
- 1.84: USER_SCHEDULES
- 1.85: USER_TRANSFORMS
- 1.86: USERS
- 1.87: VIEW_COLUMNS
- 1.88: VIEW_TABLES
- 1.89: VIEWS
- 1.90: WORKLOAD_ROUTING_RULES
- 2: V_MONITOR schema
- 2.1: ACTIVE_EVENTS
- 2.2: ALLOCATOR_USAGE
- 2.3: ARCHIVE_RESTORE_POINTS
- 2.4: ARCHIVES
- 2.5: COLUMN_STORAGE
- 2.6: COMMUNAL_CLEANUP_RECORDS
- 2.7: COMMUNAL_TRUNCATION_STATUS
- 2.8: CONFIGURATION_CHANGES
- 2.9: CONFIGURATION_PARAMETERS
- 2.10: CPU_USAGE
- 2.11: CRITICAL_HOSTS
- 2.12: CRITICAL_NODES
- 2.13: CRITICAL_SUBCLUSTERS
- 2.14: CURRENT_SESSION
- 2.15: DATA_COLLECTOR
- 2.16: DATA_LOADER_EVENTS
- 2.17: DATA_LOADERS
- 2.18: DATA_READS
- 2.19: DATABASE_BACKUPS
- 2.20: DATABASE_CONNECTIONS
- 2.21: DATABASE_MIGRATION_STATUS
- 2.22: DELETE_VECTORS
- 2.23: DEPLOY_STATUS
- 2.24: DEPLOYMENT_PROJECTION_STATEMENTS
- 2.25: DEPLOYMENT_PROJECTIONS
- 2.26: DEPOT_EVICTIONS
- 2.27: DEPOT_FETCH_QUEUE
- 2.28: DEPOT_FETCHES
- 2.29: DEPOT_FILES
- 2.30: DEPOT_PIN_POLICIES
- 2.31: DEPOT_SIZES
- 2.32: DEPOT_UPLOADS
- 2.33: DESIGN_QUERIES
- 2.34: DESIGN_STATUS
- 2.35: DESIGN_TABLES
- 2.36: DESIGNS
- 2.37: DIRECTED_QUERY_STATUS
- 2.38: DISK_QUOTA_USAGES
- 2.39: DISK_RESOURCE_REJECTIONS
- 2.40: DISK_STORAGE
- 2.41: DRAINING_STATUS
- 2.42: ERROR_MESSAGES
- 2.43: EVENT_CONFIGURATIONS
- 2.44: EXECUTION_ENGINE_PROFILES
- 2.45: EXTERNAL_TABLE_DETAILS
- 2.46: HEALTH_WATCHDOG_BLOCKED_TRANSACTIONS
- 2.47: HIVE_CUSTOM_PARTITIONS_ACCESSED
- 2.48: HOST_RESOURCES
- 2.49: IO_USAGE
- 2.50: LDAP_LINK_DRYRUN_EVENTS
- 2.51: LDAP_LINK_EVENTS
- 2.52: LOAD_SOURCES
- 2.53: LOAD_STREAMS
- 2.54: LOCK_USAGE
- 2.55: LOCKS
- 2.56: LOG_ROTATE_EVENTS
- 2.57: LOGIN_FAILURES
- 2.58: MEMORY_EVENTS
- 2.59: MEMORY_USAGE
- 2.60: MERGEOUT_PROFILES
- 2.61: MODEL_STATUS_HISTORY
- 2.62: MONITORING_EVENTS
- 2.63: NETWORK_INTERFACES
- 2.64: NETWORK_USAGE
- 2.65: NODE_EVICTIONS
- 2.66: NODE_RESOURCES
- 2.67: NODE_STATES
- 2.68: NOTIFIER_ERRORS
- 2.69: OUTPUT_DEPLOYMENT_STATUS
- 2.70: OUTPUT_EVENT_HISTORY
- 2.71: PARTITION_COLUMNS
- 2.72: PARTITION_REORGANIZE_ERRORS
- 2.73: PARTITION_STATUS
- 2.74: PARTITIONS
- 2.75: PROCESS_SIGNALS
- 2.76: PROJECTION_RECOVERIES
- 2.77: PROJECTION_REFRESHES
- 2.78: PROJECTION_STORAGE
- 2.79: PROJECTION_USAGE
- 2.80: QUERY_CONSUMPTION
- 2.81: QUERY_EVENTS
- 2.82: QUERY_METRICS
- 2.83: QUERY_PLAN_PROFILES
- 2.84: QUERY_PROFILES
- 2.85: QUERY_REQUESTS
- 2.86: REBALANCE_OPERATIONS
- 2.87: REBALANCE_PROJECTION_STATUS
- 2.88: REBALANCE_TABLE_STATUS
- 2.89: RECOVERY_STATUS
- 2.90: REMOTE_REPLICATION_STATUS
- 2.91: REPARENTED_ON_DROP
- 2.92: REPLICATION_STATUS
- 2.93: RESHARDING_EVENTS
- 2.94: RESOURCE_ACQUISITIONS
- 2.95: RESOURCE_POOL_MOVE
- 2.96: RESOURCE_POOL_STATUS
- 2.97: RESOURCE_QUEUES
- 2.98: RESOURCE_REJECTION_DETAILS
- 2.99: RESOURCE_REJECTIONS
- 2.100: RESOURCE_USAGE
- 2.101: SESSION_MARS_STORE
- 2.102: SESSION_PARAMETERS
- 2.103: SESSION_PROFILES
- 2.104: SESSIONS
- 2.105: SPREAD_STATE
- 2.106: SQS_LISTENER_ERROR_HISTORY
- 2.107: STATEMENT_OUTCOMES
- 2.108: STORAGE_BUNDLE_INFO_STATISTICS
- 2.109: STORAGE_BUNDLES
- 2.110: STORAGE_CONTAINERS
- 2.111: STORAGE_POLICIES
- 2.112: STORAGE_TIERS
- 2.113: STORAGE_USAGE
- 2.114: STRATA
- 2.115: STRATA_STRUCTURES
- 2.116: SYSTEM
- 2.117: SYSTEM_RESOURCE_USAGE
- 2.118: SYSTEM_SERVICES
- 2.119: SYSTEM_SESSIONS
- 2.120: TABLE_RECOVERIES
- 2.121: TABLE_RECOVERY_STATUS
- 2.122: TABLE_STATISTICS
- 2.123: TLS_CONFIGURATIONS
- 2.124: TRANSACTIONS
- 2.125: TRUNCATED_SCHEMATA
- 2.126: TUNING_RECOMMENDATIONS
- 2.127: TUPLE_MOVER_OPERATIONS
- 2.128: UDFS_EVENTS
- 2.129: UDFS_OPS_PER_HOUR
- 2.130: UDFS_OPS_PER_MINUTE
- 2.131: UDFS_STATISTICS
- 2.132: UDX_EVENTS
- 2.133: UDX_FENCED_PROCESSES
- 2.134: USER_LIBRARIES
- 2.135: USER_LIBRARY_MANIFEST
- 2.136: USER_SESSIONS
1 - 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.
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:
|
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_RESTORE_POINTS
Provides information about existing restore points.
Column Name | Data Type | Description |
---|---|---|
RP_ID | INTEGER | The unique identifier for the restore point. |
RP_OID | INTEGER | The current identifier of the restore point. This can change if the cluster is restarted. |
ARCHIVE_OID | INTEGER | The identifier for the archive. |
STATE | VARCHAR |
Can be one of the following states:
|
SAVE_TIME | VARCHAR | The time at which the restore point was saved. |
CATALOG_VERSION | VARCHAR | The catalog version that was saved. |
VERTICA_VERSION | VARCHAR | The version of Vertica for the restore point. |
1.3 - ALL_TABLES
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:
|
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.4 - AUDIT_MANAGING_USERS_PRIVILEGES
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:
|
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:
|
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.5 - CA_BUNDLES
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.6 - CATALOG_SUBSCRIPTION_CHANGES
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.7 - CATALOG_SYNC_STATE
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.8 - CATALOG_TRUNCATION_STATUS
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.9 - CERTIFICATES
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
1.10 - CLIENT_AUTH
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:
|
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:
|
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.11 - CLIENT_AUTH_PARAMS
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:
|
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.12 - 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. 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. NoteAn output value of 0 has no special meaning other than there are no nodes in position before the node assigned 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. NoteThis value matches the |
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:
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 cluster1.13 - COLUMNS
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, |
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 |
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.14 - COMMENTS
Returns information about comments associated with objects in the database.
Note
Queries on this table can be slow because it fetches data at query time from other Vertica catalog tables.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:
|
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.15 - 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.16 - CONSTRAINT_COLUMNS
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, |
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:
|
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, |
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.17 - CRYPTOGRAPHIC_KEYS
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.
|
LENGTH | INTEGER | The size of the key in bits. |
HAS_PASSWORD | BOOLEAN | Whether the key has a password. |
KEY | VARCHAR | The private key. |
Examples
1.18 - DATABASES
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:
|
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.19 - 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:
where:
|
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:
|
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
SuperuserTruncated 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:
-
Use the statement GET DIRECTED QUERY.
-
Use EXPORT_CATALOG to export directed queries.
1.20 - DUAL
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.21 - ELASTIC_CLUSTER
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.22 - EPOCHS
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.23 - FAULT_GROUPS
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:
|
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:
|
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.24 - FOREIGN_KEYS
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, |
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, |
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.25 - GRANTS
Returns information about privileges that are explicitly granted on database objects. Information about inherited privileges is not included.
Note
While an ADMIN OPTION granted to users through roles is not viewable directly from this table, you can view it and a summary of privileges data with vsql meta-commands\z
and
\dp
.
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, |
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.26 - HCATALOG_COLUMNS
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.27 - HCATALOG_SCHEMATA
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.28 - HCATALOG_TABLE_LIST
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.29 - HCATALOG_TABLES
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.30 - ICEBERG_COLUMNS
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, |
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.31 - INHERITED_PRIVILEGES
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.
Note
Inherited privileges are not displayed if privilege inheritance is disabled at the database level with DisableInheritedPrivileges.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, |
OBJECT_NAME | VARCHAR | Name of the table or view. |
OBJECT_TYPE | VARCHAR |
The object type, one of the following:
|
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.32 - INHERITING_OBJECTS
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:
|
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.33 - 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:
|
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
Keywords1.34 - 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.
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
1.35 - LICENSE_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.36 - LICENSES
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.37 - 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:
|
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:
|
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.38 - LOG_PARAMS
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.39 - LOG_QUERIES
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:
|
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.40 - LOG_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.41 - MATERIALIZE_FLEXTABLE_COLUMNS_RESULTS
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:
|
MESSAGE |
BOOLEAN |
Message associated with the status in the previous column, one of the following:
|
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.42 - MODELS
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.43 - NAMESPACES
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.44 - NETWORK_ADDRESSES
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.45 - NODE_SUBSCRIPTION_CHANGE_PHASES
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:
|
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.46 - NODE_SUBSCRIPTIONS
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:
|
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.47 - NODES
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:
|
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.48 - ODBC_COLUMNS
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.49 - PASSWORD_AUDITOR
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:
|
SYSTEM_SECURITY_ALGORITHM | VARCHAR |
System-level security algorithm for hash authentication. Valid values:
|
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:
|
1.50 - 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.51 - PRIMARY_KEYS
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, |
1.52 - PROFILE_PARAMETERS
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.53 - PROFILES
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.54 - PROJECTION_CHECKPOINT_EPOCHS
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
See also: GET_LAST_GOOD_EPOCH |
IS_BEHIND_AHM | BOOLEAN |
Specifies whether 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.55 - 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.
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, |
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:
|
COLUMN_EXPRESSION |
VARCHAR |
Expression that calculates the column value. |
Examples
See Statistics Data in PROJECTION_COLUMNS
See also
1.56 - PROJECTION_DELETE_CONCERNS
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.57 - 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, |
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:
|
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:
Rebalancing does not change the |
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. NoteProjections that have no data never have full statistics. Query system table PROJECTION_STORAGE to determine whether your projection contains data. |
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
indicate that the projection was created with the following expression:
|
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
|
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:
|
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:
|
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_COLUMNS1.58 - REGISTERED_MODELS
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:
|
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:
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.59 - RESOURCE_POOL_DEFAULTS
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.60 - 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:
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:
|
CPUAFFINITYMODE |
VARCHAR |
Specifies whether to share usage of the CPUs assigned to this resource pool by
|
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.61 - ROLES
Contains the names of all roles the user can access, along with any roles that have been assigned to those roles.
Tip
You can also use the functionHAS_ROLE
to see if a role is available to a user.
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. NoteAn asterisk (*) appended to a role in this column indicates that the user can grant the role to other users. |
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.62 - ROUTING_RULES
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.63 - SCHEDULER_TIME_TABLE
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:
|
DATE_TIME_STRING | VARCHAR |
The string used to schedule the event, one of the following:
|
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.64 - SCHEMATA
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, |
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.65 - 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, |
SEQUENCE_NAME |
VARCHAR |
One of the following:
|
OWNER_NAME |
VARCHAR |
One of the following:
|
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)
Note
The CurrentValue of both sequences is one less than its start number—0 and 149 for the IDENTITY column employeeID
and named sequence my_seq
, respectively:
employeeID
's start number—by default set to 1 because the table DDL did not specify otherwise—is set to 0 because no rows have yet been added to theemployees
table.my_seq
is set to 149 because NEXTVAL has not yet been called on it.
1.66 - 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. 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.67 - SHARDS
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.68 - STORAGE_LOCATIONS
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:
|
SHARING_TYPE | VARCHAR |
How this location is shared among database nodes, if it is:
|
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.69 - STORED_PROC_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, |
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.70 - SUBCLUSTER_RESOURCE_POOL_OVERRIDES
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.71 - SUBCLUSTERS
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.72 - SYSTEM_COLUMNS
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.73 - SYSTEM_TABLES
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 |
1.74 - 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:
|
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_CONSTRAINTS1.75 - TABLES
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.76 - TEXT_INDICES
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.77 - 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.78 - USER_AUDITS
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.79 - USER_CLIENT_AUTH
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.80 - USER_CONFIGURATION_PARAMETERS
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.81 - USER_FUNCTION_PARAMETERS
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, |
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.82 - 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.
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.83 - USER_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:
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, |
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.84 - USER_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, |
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:
|
DATE_TIME_STRING | VARCHAR |
The string used to schedule the event, one of the following:
|
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.85 - USER_TRANSFORMS
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.86 - USERS
Provides information about all users in the database.
Tip
To see if a role has been assigned to a user, call the function HAS_ROLE.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. NoteThe You can view the database start time by querying the DATABASES system table:
|
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:
|
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:
For more information see Troubleshooting LDAP link issues |
See also
1.87 - VIEW_COLUMNS
Provides view attribute information.
Note
If you drop a table that is referenced by a view, Vertica does not drop the view. However, attempts to access information about it fromVIEW_COLUMNS
return an error that the view is invalid.
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, |
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.88 - VIEW_TABLES
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.89 - VIEWS
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, |
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_COLUMNS1.90 - WORKLOAD_ROUTING_RULES
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 subclusterdefault_subcluster
. - Clients with workload
analytics
are randomly routed tosc_01
orsc_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. These tables provide information about the health of the Vertica database.
2.1 - ACTIVE_EVENTS
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.
|
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.
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:
|
ALLOCATION_TYPE |
VARCHAR |
One of two memory allocation types:
|
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. NoteVertica does not release memory after originally allocating it, unless the node or database is restarted. |
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.
|
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 aUNIT_SIZE
of 8 bytes, with aUSED_COUNT
of 1. -
When you add a second table object (
t2
), theUSED_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, andUSED_BYTES
decreases to 8. Since Vertica retains the memory for future use,FREE_BYTES
increases to 8, andFREE_COUNT
increases to 1. -
Finally, when you create a new table object (t3), Vertica frees the memory for reuse.
FREE_COUNT
andFREE_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 - ARCHIVE_RESTORE_POINTS
Eon Mode only
Lists information about In-DB restore points.
Column Name | Column Type | Description |
---|---|---|
ID |
INT | Unique object ID of the restore point. |
SAVE_TIME |
DATETIME | Time at which the restore point was saved. |
INDEX |
INT | Index of the restore point in the archive, where 1 specifies the most recent restore point. |
ARCHIVE |
VARCHAR | Name of the archive that contains the restore point. |
STATE |
VARCHAR |
Status of the restore points, one of the following:
|
Examples
List details for all restore points in your database:
=> SELECT * FROM ARCHIVE_RESTORE_POINTS;
id | save_time | index | archive | state
--------------------------------------+----------------------------+-------+-----------------+----------
2616f6cd-e98c-472c-8d5c-a7f459dff82b | 2023-11-30 10:19:58.565311 | 1 | vertica-restore | COMPLETE
116066cc-29cb-4ce5-9a27-170538ba95cf | 2023-11-10 11:02:48.059941 | 2 | vertica-restore | COMPLETE
(2 rows)
2.4 - ARCHIVES
Eon Mode only
Lists information about In-DB restore points archives.
Column Name | Column Type | Description |
---|---|---|
NAME |
VARCHAR | Archive name. |
LIMIT_COUNT |
INT | Maximum number of restore points stored in the archive. |
OWNER |
VARCHAR | Owner of the archive. |
OBJECT_INCLUSION_RULES |
VARCHAR | Currently, only database-level restore points are supported, so this column is always empty. |
DATA_INCLUSION RULES |
VARCHAR | Currently, only database-level restore points are supported, so this column is always empty. |
Examples
List all archives and their attributes:
=> select * from archives;
name | limit_count | owner | object_inclusion_rules | data_inclusion_rules
------+-------------+-------+------------------------+----------------------
eon | 10 | luis | |
(1 row)
2.5 - COLUMN_STORAGE
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, |
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.6 - COMMUNAL_CLEANUP_RECORDS
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_STORAGE2.7 - COMMUNAL_TRUNCATION_STATUS
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.8 - CONFIGURATION_CHANGES
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.9 - CONFIGURATION_PARAMETERS
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:
|
RESTART_LEVEL | VARCHAR |
Level at which the parameter will be set after the next restart, one of the following:
|
IS_MISMATCH | BOOLEAN | Whether CURRENT_VALUE and RESTART_VALUE match. |
GROUPS | VARCHAR |
A group to which the parameter belongs—for example, OptVOptions. NoteMost configuration parameters do not belong to any group. |
ALLOWED_LEVELS | VARCHAR |
Levels at which the specified parameter can be set, a comma-delimited list of any of the following values:
|
SUPERUSER_VISIBLE_ONLY | BOOLEAN |
Whether non-superusers can view all parameter settings. If true, the following columns are masked to non-superusers:
|
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 management2.10 - CPU_USAGE
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.11 - CRITICAL_HOSTS
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.12 - CRITICAL_NODES
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.13 - CRITICAL_SUBCLUSTERS
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.14 - CURRENT_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:
|
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:
|
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.15 - DATA_COLLECTOR
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 ( NoteSetting a component's policy's interval_time property has no effect on how much data storage the Data Collector retains on disk for that component. Maximum disk storage capacity is determined by the disk_size_kb property. Setting the interval_time property only affects how long data is retained by the component's Data Collector table. For details, see Configuring data retention policies. |
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.16 - DATA_LOADER_EVENTS
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, |
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.17 - 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, |
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.18 - DATA_READS
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.
Note
This table is only populated in Eon Mode.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.19 - DATABASE_BACKUPS
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 [Mapping n] 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.20 - DATABASE_CONNECTIONS
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.21 - DATABASE_MIGRATION_STATUS
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:
NoteNo data is transferred during this phase, so BYTES_TO_TRANSFER and BYTES_TRANSFERED are always set to 0.
|
STATUS | VARCHAR |
Specifies status of a given phase, one of the following:
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:
|
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:
|
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.22 - DELETE_VECTORS
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, |
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.23 - DEPLOY_STATUS
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.24 - DEPLOYMENT_PROJECTION_STATEMENTS
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.25 - DEPLOYMENT_PROJECTIONS
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, |
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:
|
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.26 - DEPOT_EVICTIONS
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:
|
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.27 - DEPOT_FETCH_QUEUE
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.28 - DEPOT_FETCHES
Eon Mode only
Records data of depot fetch requests.
Note
Vertica reports all fetches to this table, including failed fetch attempts and their causes.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:
|
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.29 - DEPOT_FILES
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:
|
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.30 - DEPOT_PIN_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, |
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:
|
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.31 - DEPOT_SIZES
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.32 - DEPOT_UPLOADS
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.33 - DESIGN_QUERIES
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.34 - DESIGN_STATUS
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.35 - DESIGN_TABLES
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, |
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.36 - DESIGNS
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:
|
DESIGN_TYPE |
VARCHAR |
Name of the design type. Valid values are:
|
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.
|
2.37 - DIRECTED_QUERY_STATUS
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
Superuser2.38 - DISK_QUOTA_USAGES
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.39 - DISK_RESOURCE_REJECTIONS
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:
|
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.40 - DISK_STORAGE
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:
|
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:
|
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.41 - DRAINING_STATUS
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.
Note
If you aren't a superuser, the OLDEST_SESSION columns contain only information about sessions for which you have privileges. Unprivileged users do not see session details, but they do see the node draining status and the user session aggregate count.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.42 - ERROR_MESSAGES
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:
|
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:
|
Privileges
Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.
2.43 - EVENT_CONFIGURATIONS
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.44 - EXECUTION_ENGINE_PROFILES
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 byNetworkSend
.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 byNetworkSend.
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
orDataTarget
operator. Compare to thetotal merge phases
. Variants on this value includejoin 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 includejoin 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 anhdfs
source (using libhdfs++).Hadoop FS bytes read through webhdfs
[Scan, Load]
Number of bytes read from awebhdfs
source.Hadoop FS bytes written through webhdfs
[DataTarget]
Number of bytes written towebhdfs
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 protocolHadoop 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 protocolHadoop FS read operations through native libhdfs++ client failure count
[Scan, Load]
Number of times a native libhdfs++ source encountered an error and gave upHadoop FS read operations through native libhdfs++ client retry count
[Scan, Load]
Number of times a native libhdfs++ source encountered an error and retriedHadoop FS read operations through webhdfs failure count
[Scan, Load]
Number of times a webhdfs source encountered an error and gave upHadoop FS read operations through webhdfs retry count
[Scan, Load]
Number of times a webhdfs source encountered an error and retriedHadoop FS write operations through webhdfs failure count
[DataTarget]
Number of times a webhdfs write encountered an error and gave upHadoop FS write operations through webhdfs retry count
[DataTarget]
Number of times a webhdfs write encountered an error and retriedhistogram 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 withdc_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 withdc_load_events
. portion size
- Size value of a portion descriptor in an apportioned load.
counter_tag
indicates the source when joining withdc_load_events
. producer stall (µs)
[NetworkSend]
Time in microseconds spent byNetworkSend
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 1000rows produced
not only 1rle 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
orDataTarget
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 includejoin 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.45 - EXTERNAL_TABLE_DETAILS
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, |
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.46 - HEALTH_WATCHDOG_BLOCKED_TRANSACTIONS
Provides detailed information about transactions blocked by the Heath Watchdog.
Column Name | Data Type | Description |
---|---|---|
NODE_NAME |
VARCHAR | Name of the node. |
BLOCK_START_TIME |
TIMESTAMP | Time when the transaction was blocked. |
TRANSACTION_DESCRIPTION |
VARCHAR | The description of the transaction that was blocked. |
BLOCK_TYPE |
VARCHAR | Lists the health metric that initiated the block. |
Privileges
None
Example
verticadb21249=> select * from health_watchdog_blocked_transactions;
node_name | block_start_time | transaction_description | block_type
-----------+-------------------+-------------------------------+---------------------------------------------------------------------------+------------------
initiator | 2024-06-17 22:24:08.636447-04 | Txn: a00000000000de 'create table table_t2(b int, c varchar(10), a int);' | GCLX QUEUE BLOAT
initiator | 2024-06-17 22:28:43.340537-04 | Txn: a00000000000e9 'create table table_t3(b int, c varchar(10), a int);' | GCLX QUEUE BLOAT
(2 rows)
See also
2.47 - HIVE_CUSTOM_PARTITIONS_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.48 - HOST_RESOURCES
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.49 - IO_USAGE
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.50 - LDAP_LINK_DRYRUN_EVENTS
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.51 - LDAP_LINK_EVENTS
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.52 - LOAD_SOURCES
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
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 |
|
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:
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.53 - 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: 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: |
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.54 - LOCK_USAGE
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.55 - LOCKS
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 After a lock is granted, its scope is set to one of the following:
All scopes other than |
REQUEST_TIMESTAMP |
TIMESTAMP | Time when the transaction began waiting on the lock. |
GRANT_TIMESTAMP |
TIMESTAMP |
Time the transaction acquired or upgraded the lock:
|
See also
2.56 - LOG_ROTATE_EVENTS
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.57 - LOGIN_FAILURES
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:
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:
|
Privileges
Superuser
2.58 - MEMORY_EVENTS
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:
|
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.59 - 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.60 - MERGEOUT_PROFILES
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:
|
EVENT_TYPE | VARCHAR |
Displays the status of the mergeout operation. Possible values:
|
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.61 - MODEL_STATUS_HISTORY
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 [ |
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.62 - MONITORING_EVENTS
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:
|
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_EVENTS2.63 - NETWORK_INTERFACES
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.64 - NETWORK_USAGE
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.65 - NODE_EVICTIONS
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.66 - NODE_RESOURCES
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.67 - NODE_STATES
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:
|
The following flow chart details different node states:
Privileges
None
2.68 - NOTIFIER_ERRORS
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.69 - OUTPUT_DEPLOYMENT_STATUS
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:
|
error_message |
VARCHAR | Text of any error that occurred when creating or refreshing the specified projection. |
2.70 - OUTPUT_EVENT_HISTORY
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
|
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
|
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.71 - PARTITION_COLUMNS
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:
|
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.72 - PARTITION_REORGANIZE_ERRORS
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.73 - 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. 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.74 - PARTITIONS
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, |
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
2.75 - PROCESS_SIGNALS
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.76 - 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.
Note
You cannot query this or other system tables during cluster recovery; the cluster must be UP to accept connections.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:
|
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:
|
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 |
DETAIL |
VARCHAR |
More detailed information about PROGRESS. The values returned for this column depend on the type of recovery plan:
The DETAIL column value becomes |
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:
|
Privileges
Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.
See also
RECOVERY_STATUS
2.77 - 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:
|
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:
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:
|
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:
|
TRANSACTION_ID | INTEGER |
Identifier for the transaction within the session, if any; otherwise NULL. NoteThe transaction_id is correlated with the execution plan only when refreshing from scratch. When refreshing from a buddy, multiple sub-transactions are created |
Privileges
Non-superuser: No explicit privileges required. You only see records for tables that you have privileges to view.
2.78 - PROJECTION_STORAGE
Monitors the amount of disk storage used by each projection on each node.
Note
Projections that have no data never have full statistics. Querying this system table lets you see if your projection contains data.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.79 - PROJECTION_USAGE
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.80 - QUERY_CONSUMPTION
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.81 - QUERY_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:
|
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 predicateB a = 1
as a filter for better storage access of tableB
. - 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:
-
Review the explain plan. The query might be too ambitious, for example, cross joining two large tables.
-
Consider adding the query to a lower priority pool to reduce impact on other queries.
-
Create projections that allow for a merge join instead of a hash join.
-
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.82 - QUERY_METRICS
Monitors the sessions and queries running on each node.
Note
Totals in this table are reset each time the database restarts.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.83 - QUERY_PLAN_PROFILES
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 also
2.84 - QUERY_PROFILES
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 |
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 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.85 - 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:
|
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_PROFILES2.86 - REBALANCE_OPERATIONS
Contains information on historic and ongoing rebalance operations.
Column Name | Data Type | Description |
---|---|---|
OBJECT_TYPE | VARCHAR |
The type of the rebalanced object:
|
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, |
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:
|
OPERATION_STATUS | VARCHAR |
Specifies status of the rebalance operation, one of the followin:
|
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:
|
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.87 - REBALANCE_PROJECTION_STATUS
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, |
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:
|
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 view only rows from the current, latest or upcoming rebalance operation, use:
|
Privileges
Superuser
See also
2.88 - REBALANCE_TABLE_STATUS
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:
|
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 view only rows from the current, latest or upcoming rebalance operation, use:
|
start_timestamp |
TIMESTAMPTZ | The time that the rebalance began. |
end_timestamp |
TIMESTAMPTZ | The time that the rebalance ended. |
Privileges
Superuser
See also
2.89 - RECOVERY_STATUS
Provides the status of recovery operations, returning one row for each node.
Note
You cannot query this or other system tables table during cluster recovery; the cluster must be UP to accept connections.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:
|
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_RECOVERIES2.90 - REMOTE_REPLICATION_STATUS
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.91 - REPARENTED_ON_DROP
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.92 - REPLICATION_STATUS
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.
Note
If you replicate data between the main cluster and a sandboxed cluster, theSENT_BYTES
and TOTAL_BYTES_TO_SEND
columns will both have a value of zero. Because the clusters use the same communal storage location, no data is actually copied between the two clusters.
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:
|
STATUS | VARCHAR(8192) |
State of the
|
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.93 - RESHARDING_EVENTS
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:
NoteOnly the RESHARDED and RUNNING statuses are logged for each node. All other statuses are logged only on the initiator node. |
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.94 - RESOURCE_ACQUISITIONS
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.
Important
If a request cascades to one or more resource pools beyond the original pool, this table contains multiple records for the same request—one record for each resource pool. The following values are specific to each resource pool:
-
Timestamp values:
QUEUE_ENTRY_TIMESTAMP
,ACQUISITION_TIMESTAMP
, andRELEASE_TIMESTAMP
-
DURATION_MS
-
IS_EXECUTING
You can trace the history of cascade events by querying system table
RESOURCE_POOL_MOVE
.
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:
|
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 If operators for a query acquire all memory specified by |
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:
|
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.95 - RESOURCE_POOL_MOVE
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:
|
SOURCE_CAP |
INTEGER |
Effective
|
TARGET_CAP |
INTEGER |
Effective
|
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.96 - RESOURCE_POOL_STATUS
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:
|
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 Note
|
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 When set to |
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. NoteThe calculated value can change when one or more running queries needs more than the budgeted amount to run. 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:
|
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:
|
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.97 - RESOURCE_QUEUES
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.98 - RESOURCE_REJECTION_DETAILS
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:
|
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.
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_REJECTIONS2.99 - RESOURCE_REJECTIONS
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:
|
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.
NoteExecution slots are determined by MAXCONCURRENCY parameter. |
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.100 - RESOURCE_USAGE
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.101 - SESSION_MARS_STORE
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.102 - SESSION_PARAMETERS
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.103 - SESSION_PROFILES
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:
|
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
LOCKS2.104 - 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.
Note
During session initialization and termination, you might see sessions running only on nodes other than the node on which you ran the virtual table query. This is a temporary situation that corrects itself when session initialization and termination complete.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. |
|
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:
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:
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:
|
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.105 - SPREAD_STATE
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.106 - SQS_LISTENER_ERROR_HISTORY
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.107 - 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:
|
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_PROFILES2.108 - STORAGE_BUNDLE_INFO_STATISTICS
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.109 - 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.110 - 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, |
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:
|
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.111 - STORAGE_POLICIES
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, |
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.112 - STORAGE_TIERS
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 This value can differ from v_vmart_node0001: Create one labeled location, V_vmart_node0002: Create two labeled locations, In this case, |
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.113 - 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.114 - STRATA
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, |
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.115 - STRATA_STRUCTURES
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.116 - SYSTEM
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.117 - SYSTEM_RESOURCE_USAGE
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.118 - SYSTEM_SERVICES
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:
|
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.119 - SYSTEM_SESSIONS
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:
|
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.120 - TABLE_RECOVERIES
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:
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.121 - TABLE_RECOVERY_STATUS
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.122 - TABLE_STATISTICS
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.123 - TLS_CONFIGURATIONS
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:
|
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:
|
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.124 - TRANSACTIONS
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
Transactions2.125 - TRUNCATED_SCHEMATA
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.126 - TUNING_RECOMMENDATIONS
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:
|
TUNING_DESCRIPTION | VARCHAR |
Textual description of the tuning recommendation to perform on the
|
TUNING_COMMAND | VARCHAR |
Command string if tuning action is a SQL command. For example: Update statistics on a particular schema's table.column:
Resolve mismatched configuration parameter
Set the password for user
|
TUNING_COST | VARCHAR |
Cost is based on the type of tuning recommendation and is one of:
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.127 - TUPLE_MOVER_OPERATIONS
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:
|
OPERATION_STATUS | VARCHAR |
Returns the status of each operation, one of the following:
|
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, |
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:
|
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:
|
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.128 - UDFS_EVENTS
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.129 - UDFS_OPS_PER_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_MINUTE2.130 - UDFS_OPS_PER_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_HOUR2.131 - UDFS_STATISTICS
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.132 - UDX_EVENTS
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.133 - UDX_FENCED_PROCESSES
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:
|
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.134 - USER_LIBRARIES
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, |
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. NoteThis use of MD5 is not for cryptographic or authentication purposes. For information on authenticating with MD5 see Hash authentication. |
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.135 - USER_LIBRARY_MANIFEST
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, |
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.136 - USER_SESSIONS
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:
Queries with a |
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:
See Implementing Security and TLS protocol. |
AUTHENTICATION_METHOD |
VARCHAR |
Type of client authentication used for a particular session, if known. Possible values are:
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:
|
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.