CREATE MATERIALIZED VIEW
CREATE MATERIALIZED VIEW — создать материализованное представление
Синтаксис
CREATE MATERIALIZED VIEW [ IF NOT EXISTS ]имя_таблицы
[ (имя_столбца
[, ...] ) ] [ USINGметод
] [ WITH (параметр_хранения
[=значение
] [, ... ] ) ] [ TABLESPACEтабл_пространство
] ASquery
[ WITH [ NO ] DATA ]
Описание
CREATE MATERIALIZED VIEW
определяет материализованное представление запроса. Заданный запрос выполняется и наполняет представление в момент вызова команды (если только не указано WITH NO DATA
). Обновить представление позже можно, выполнив REFRESH MATERIALIZED VIEW
.
Команда CREATE MATERIALIZED VIEW
подобна CREATE TABLE AS
, за исключением того, что она запоминает запрос, порождающий представление, так что это представление можно позже обновить по требованию. Материализованные представления сходны с таблицами во многом, но не во всём; например, не поддерживаются временные материализованные представления.
Команда CREATE MATERIALIZED VIEW
требует наличия права CREATE
для схемы, выбранной для создания материализованного представления.
Параметры
IF NOT EXISTS
Не считать ошибкой, если материализованное представление с таким именем уже существует. В этом случае будет выдано замечание. Заметьте, что нет никакой гарантии, что существующее материализованное представление как-то соотносится с тем, которое могло бы быть создано.
имя_таблицы
Имя создаваемого материализованного представления (возможно, дополненное схемой).
имя_столбца
Имя столбца в создаваемом материализованном представлении. Если имена столбцов не заданы явно, они определяются по именам столбцов результата запроса.
USING
метод
Это дополнительное предложение задаёт табличный метод доступа, который будет использоваться для сохранения содержимого нового материализованного представления; этот метод должен быть типа
TABLE
. Подробнее об этом рассказывается в Главе 58. В случае отсутствия этого указания для нового материализованного представления выбирается метод доступа по умолчанию. За подробностями обратитесь к default_table_access_method.WITH (
параметр_хранения
[=значение
] [, ... ] )Это предложение задаёт дополнительные параметры хранения для создаваемого материализованного представления; подробнее о них можно узнать в разделе Параметры хранения описания CREATE TABLE. Все параметры, которые поддерживает
CREATE TABLE
, поддерживает иCREATE MATERIALIZED VIEW
. За дополнительной информацией обратитесь к CREATE TABLE.TABLESPACE
табл_пространство
Здесь
табл_пространство
— имя табличного пространства, в котором будет создано материализованное представление. Если оно не задано, выбирается default_tablespace.query
Команда
SELECT
,TABLE
илиVALUES
. Эта команда будет выполняться с ограничениями по безопасности; в частности, будут запрещены вызовы функций, которые сами создают временные таблицы.WITH [ NO ] DATA
Это предложение указывает, будет ли материализованное представление наполняться в момент создания. Если материализованное представление не наполняется, оно помечается как нечитаемое, так что к нему нельзя будет обращаться до выполнения
REFRESH MATERIALIZED VIEW
.
Совместимость
CREATE MATERIALIZED VIEW
является расширением Postgres Pro.
CREATE MATERIALIZED VIEW
CREATE MATERIALIZED VIEW — define a new materialized view
Synopsis
CREATE MATERIALIZED VIEW [ IF NOT EXISTS ]table_name
[ (column_name
[, ...] ) ] [ USINGmethod
] [ WITH (storage_parameter
[=value
] [, ... ] ) ] [ TABLESPACEtablespace_name
] ASquery
[ WITH [ NO ] DATA ]
Description
CREATE MATERIALIZED VIEW
defines a materialized view of a query. The query is executed and used to populate the view at the time the command is issued (unless WITH NO DATA
is used) and may be refreshed later using REFRESH MATERIALIZED VIEW
.
CREATE MATERIALIZED VIEW
is similar to CREATE TABLE AS
, except that it also remembers the query used to initialize the view, so that it can be refreshed later upon demand. A materialized view has many of the same properties as a table, but there is no support for temporary materialized views.
CREATE MATERIALIZED VIEW
requires CREATE
privilege on the schema used for the materialized view.
Parameters
IF NOT EXISTS
Do not throw an error if a materialized view with the same name already exists. A notice is issued in this case. Note that there is no guarantee that the existing materialized view is anything like the one that would have been created.
table_name
The name (optionally schema-qualified) of the materialized view to be created.
column_name
The name of a column in the new materialized view. If column names are not provided, they are taken from the output column names of the query.
USING
method
This optional clause specifies the table access method to use to store the contents for the new materialized view; the method needs be an access method of type
TABLE
. See Chapter 58 for more information. If this option is not specified, the default table access method is chosen for the new materialized view. See default_table_access_method for more information.WITH (
storage_parameter
[=value
] [, ... ] )This clause specifies optional storage parameters for the new materialized view; see Storage Parameters in the CREATE TABLE documentation for more information. All parameters supported for
CREATE TABLE
are also supported forCREATE MATERIALIZED VIEW
. See CREATE TABLE for more information.TABLESPACE
tablespace_name
The
tablespace_name
is the name of the tablespace in which the new materialized view is to be created. If not specified, default_tablespace is consulted.query
A
SELECT
,TABLE
, orVALUES
command. This query will run within a security-restricted operation; in particular, calls to functions that themselves create temporary tables will fail.WITH [ NO ] DATA
This clause specifies whether or not the materialized view should be populated at creation time. If not, the materialized view will be flagged as unscannable and cannot be queried until
REFRESH MATERIALIZED VIEW
is used.
Compatibility
CREATE MATERIALIZED VIEW
is a Postgres Pro extension.