The stored procedure
GET_VIEWS returns information about views. You can filter the result by several parameters: view name, view type,
etc. Each row represents a view.
If you want to obtain information any type of element, not just views, use the procedure GET_ELEMENTS.
GET_VIEWS ( input_database_name : text , input_name : text , input_user_creator : text , input_last_user_modifier : text , input_init_create_date : date , input_end_create_date : date , input_init_last_modification_date : date , input_end_last_modification_date : date , <input_view_type> , <input_swap_active> , <input_cache_status> , input_description : text ) <input_view_type> ::= 0 // Base views | 1 // Derived views | 2 // Interface views | 3 // Materialized tables <input_swap_active> ::= 0 // Swapping status is "Default" | 1 // Swapping status is "On" | 2 // Swapping status is "Off" <input_cache_status> ::= 0 // Cache mode is "Off" | 1 // Cache mode is "Partial exact" | 2 // Cache mode is "Partial" | 3 // Cache mode is "Full" | 4 // Cache mode is "Partial exact preload" | 5 // Cache mode is "Partial preload"
If you invoke the procedure using
CALLand do not want to filter by a parameter, pass
The procedure evaluates the input parameters with AND conditions. E.g. if you pass a value to
input_description, the procedure will search return views of this database and this name and that contains this description.
The procedure evaluates the following parameters with the operator LIKE instead of equals:
This means that in the value of these parameters, you can use the wildcard operators you use with LIKE (
_). The search by the description is case insensitive.
When providing a value for
input_end_last_modification_date, the procedure returns the views between the two intervals. I.e.: when you provide a value for
input_end_create_date, the procedure returns the views created during these two dates.
null, the procedure returns all the views that were created before
null, the procedure returns all the views that were created after
input_init_create_date. Searching by
input_end_last_modification_dateworks in the same way.
The procedure returns these fields:
database_name: name of database that the view belongs to.
name: name of the view.
type: the value is always “view”.
user_creator: user that created the view.
last_user_modifier: user that modified the view for the last time. If the view was never modified, the value is the same as
create_date: date when the view was created.
last_modification_date: date when the view was modified for the last time. If the view was never modified, the value is the same as
description: description of the view.
view_type: the possible values are:
0: if it is a base view
1: if it is a derived view
2: if it is an interface view
3: if it is a materialized table
swap_active: the possible values are:
0: if the swapping status is “Default”
1: if the swapping status is “On”
2: if the swapping status is “Off”
cache_status: the possible values are:
0: if the cache mode is “Off”
1: if the cache mode is “Partial exact”
2: if the cache mode is “Partial”
3: if the cache mode is “Full”
4: if the cache mode is “Partial exact preload”
5: if the cache mode is “Partial preload”
folder: folder of the view in lowercase. If the view is not in any folder, the value is
The results of this procedure change depending on the privileges granted to the user that runs it. If the user is not an administrator user consider that this procedure only returns information about the procedures on which the user has Read privileges. The implications of this are the following:
- If the user is an administrator, the procedure can return information about all the views.
- If the user is an administrator of one or more databases, the procedure can return information about all the views of that database.
- The procedure will return information about all the views over which the user has the Read privilege.
SELECT * FROM GET_VIEWS() WHERE input_database_name = 'customer_report' AND folder = '/base views'
Obtains all the views of the database “customer_report” inside a particular folder. Note that
folder is not an input parameter of the procedure. Therefore, the execution engine executes the procedure passing the parameter
input_database_name. The result is the information about all the views in that database. Then, the execution engine filters this result to return only the folders whose name is “base views”.
SELECT * FROM GET_VIEWS() WHERE input_database_name = 'customer_report' AND (input_init_create_date = ADDDAY(CURRENT_DATE, -1));
Obtains all the views of the database “customer_report” created since yesterday at 12 AM.
SELECT * FROM GET_VIEWS() WHERE input_description = '%report%';
This query returns all the views whose description contains the word “report”.