Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Feature] Dynamic Table. #725

Merged
merged 7 commits into from
Dec 9, 2024
Merged

[Feature] Dynamic Table. #725

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
38cf024
Dynamc Table.
avamingli Dec 4, 2024
597bfbf
Add document about DYNAMIC TABLE.
avamingli Dec 4, 2024
c72e333
Add DYNAMIC TABLE support to pg_dump.
avamingli Dec 4, 2024
238a094
Add DYNAMIC TABLE support to psql.
avamingli Dec 4, 2024
16145db
Dynamic Table case: query on external tables as fast as internal tables.
avamingli Dec 4, 2024
17c9fed
Add pg_get_dynamic_table_schedule() for dynamic tables.
avamingli Dec 6, 2024
b215893
[pg_dump] Dump SCHEDULE clause of Dynamic Tables.
avamingli Dec 6, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions contrib/pg_stat_statements/pg_stat_statements.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1153,6 +1153,7 @@ pgss_ProcessUtility(PlannedStmt *pstmt, const char *queryString,
rows = (qc && (qc->commandTag == CMDTAG_COPY ||
qc->commandTag == CMDTAG_FETCH ||
qc->commandTag == CMDTAG_SELECT ||
qc->commandTag == CMDTAG_REFRESH_DYNAMIC_TABLE ||
qc->commandTag == CMDTAG_REFRESH_MATERIALIZED_VIEW)) ?
qc->nprocessed : 0;

Expand Down
3 changes: 3 additions & 0 deletions doc/src/sgml/ref/allfiles.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ Complete list of usable sgml source files in this directory.
<!ENTITY createConversion SYSTEM "create_conversion.sgml">
<!ENTITY createDatabase SYSTEM "create_database.sgml">
<!ENTITY createDomain SYSTEM "create_domain.sgml">
<!ENTITY createDynamicTable SYSTEM "create_dynamic_table.sgml">
<!ENTITY createEventTrigger SYSTEM "create_event_trigger.sgml">
<!ENTITY createExtension SYSTEM "create_extension.sgml">
<!ENTITY createForeignDataWrapper SYSTEM "create_foreign_data_wrapper.sgml">
Expand Down Expand Up @@ -114,6 +115,7 @@ Complete list of usable sgml source files in this directory.
<!ENTITY dropConversion SYSTEM "drop_conversion.sgml">
<!ENTITY dropDatabase SYSTEM "drop_database.sgml">
<!ENTITY dropDomain SYSTEM "drop_domain.sgml">
<!ENTITY dropDynamicTable SYSTEM "drop_dynamic_table.sgml">
<!ENTITY dropEventTrigger SYSTEM "drop_event_trigger.sgml">
<!ENTITY dropExtension SYSTEM "drop_extension.sgml">
<!ENTITY dropForeignDataWrapper SYSTEM "drop_foreign_data_wrapper.sgml">
Expand Down Expand Up @@ -166,6 +168,7 @@ Complete list of usable sgml source files in this directory.
<!ENTITY prepare SYSTEM "prepare.sgml">
<!ENTITY prepareTransaction SYSTEM "prepare_transaction.sgml">
<!ENTITY reassignOwned SYSTEM "reassign_owned.sgml">
<!ENTITY refreshDynamicTable SYSTEM "refresh_dynamic_table.sgml">
<!ENTITY refreshMaterializedView SYSTEM "refresh_materialized_view.sgml">
<!ENTITY reindex SYSTEM "reindex.sgml">
<!ENTITY releaseSavepoint SYSTEM "release_savepoint.sgml">
Expand Down
185 changes: 185 additions & 0 deletions doc/src/sgml/ref/create_dynamic_table.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,185 @@
<!--
doc/src/sgml/ref/create_dynamic_table.sgml
PostgreSQL documentation
-->

<refentry id="sql-createdynamictable">
<indexterm zone="sql-createdynamictable">
<primary>CREATE DYNAMIC TABLE</primary>
</indexterm>

<refmeta>
<refentrytitle>CREATE DYNAMIC TABLE</refentrytitle>
<manvolnum>7</manvolnum>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>

<refnamediv>
<refname>CREATE DYNAMIC TABLE</refname>
<refpurpose>define a new dynamic table</refpurpose>
</refnamediv>

<refsynopsisdiv>
<synopsis>
CREATE DYNAMIC TABLE [ IF NOT EXISTS ] <replaceable>table_name</replaceable>
[ (<replaceable>column_name</replaceable> [, ...] ) ]
[ USING <replaceable class="parameter">method</replaceable> ]
[ WITH ( <replaceable class="parameter">storage_parameter</replaceable> [= <replaceable class="parameter">value</replaceable>] [, ... ] ) ]
[ TABLESPACE <replaceable class="parameter">tablespace_name</replaceable> ]
AS <replaceable>query</replaceable>
[ WITH [ NO ] DATA ]
</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Description</title>

<para>
<command>CREATE DYNAMIC TABLE</command> defines a dynamic table of
a query. The query is executed and used to populate the view at the time
the command is issued (unless <command>WITH NO DATA</command> is used) and may be
refreshed later using <command>REFRESH DYNAMIC TABLE</command>.
</para>

<para>
<command>CREATE DYNAMIC TABLE</command> is similar to
<command>CREATE TABLE AS</command>, except that it also remembers the query used
to initialize the view, so that it can be refreshed later upon demand.
A dynamic table has many of the same properties as a table, but there
is no support for temporary dynamic tables.
</para>

<para>
<command>CREATE DYNAMIC TABLE</command> requires
<literal>CREATE</literal> privilege on the schema used for the dynamic
table.
</para>
</refsect1>

<refsect1>
<title>Parameters</title>

<variablelist>
<varlistentry>
<term><literal>IF NOT EXISTS</literal></term>
<listitem>
<para>
Do not throw an error if a dynamic table with the same name already
exists. A notice is issued in this case. Note that there is no guarantee
that the existing dynamic table is anything like the one that would
have been created.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><replaceable>table_name</replaceable></term>
<listitem>
<para>
The name (optionally schema-qualified) of the dynamic table to be
created.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><replaceable>column_name</replaceable></term>
<listitem>
<para>
The name of a column in the new dynamic table. If column names are
not provided, they are taken from the output column names of the query.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>USING <replaceable class="parameter">method</replaceable></literal></term>
<listitem>
<para>
This optional clause specifies the table access method to use to store
the contents for the new dynamic table; the method needs be an
access method of type <literal>TABLE</literal>. See <xref
linkend="tableam"/> for more information. If this option is not
specified, the default table access method is chosen for the new
dynamic table. See <xref linkend="guc-default-table-access-method"/>
for more information.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>WITH ( <replaceable class="parameter">storage_parameter</replaceable> [= <replaceable class="parameter">value</replaceable>] [, ... ] )</literal></term>
<listitem>
<para>
This clause specifies optional storage parameters for the new
dynamic table; see
<xref linkend="sql-createtable-storage-parameters"/> in the
<xref linkend="sql-createtable"/> documentation for more
information. All parameters supported for <literal>CREATE
TABLE</literal> are also supported for <literal>CREATE DYNAMIC
TABLE</literal>.
See <xref linkend="sql-createtable"/> for more information.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>TABLESPACE <replaceable class="parameter">tablespace_name</replaceable></literal></term>
<listitem>
<para>
The <replaceable class="parameter">tablespace_name</replaceable> is the name
of the tablespace in which the new dynamic table is to be created.
If not specified, <xref linkend="guc-default-tablespace"/> is consulted.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><replaceable>query</replaceable></term>
<listitem>
<para>
A <link linkend="sql-select"><command>SELECT</command></link>, <link linkend="sql-table"><command>TABLE</command></link>,
or <link linkend="sql-values"><command>VALUES</command></link> command. This query will run within a
security-restricted operation; in particular, calls to functions that
themselves create temporary tables will fail.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>WITH [ NO ] DATA</literal></term>
<listitem>
<para>
This clause specifies whether or not the dynamic table should be
populated at creation time. If not, the dynamic table will be
flagged as unscannable and cannot be queried until <command>REFRESH
DYNAMIC TABLE</command> is used. Also, if the view is IMMV,
triggers for maintaining the view are not created.
</para>
</listitem>
</varlistentry>

</variablelist>
</refsect1>

<refsect1>
<title>Compatibility</title>

<para>
<command>CREATE DYNAMIC TABLE</command> is a
<productname>Cloudberry</productname> extension.
</para>
</refsect1>

<refsect1>
<title>See Also</title>

<simplelist type="inline">
<member><xref linkend="sql-createtableas"/></member>
<member><xref linkend="sql-createview"/></member>
<member><xref linkend="sql-dropmaterializedview"/></member>
<member><xref linkend="sql-refreshmaterializedview"/></member>
</simplelist>
</refsect1>

</refentry>
116 changes: 116 additions & 0 deletions doc/src/sgml/ref/drop_dynamic_table.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
<!--
doc/src/sgml/ref/drop_dynamic_table.sgml
PostgreSQL documentation
-->

<refentry id="sql-dropdynamictable">
<indexterm zone="sql-dropdynamictable">
<primary>DROP DYNAMIC TABLE</primary>
</indexterm>

<refmeta>
<refentrytitle>DROP DYNAMIC TABLE</refentrytitle>
<manvolnum>7</manvolnum>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>

<refnamediv>
<refname>DROP DYNAMIC TABLE</refname>
<refpurpose>remove a dynamic table</refpurpose>
</refnamediv>

<refsynopsisdiv>
<synopsis>
DROP DYNAMIC TABLE [ IF EXISTS ] <replaceable class="parameter">name</replaceable> [, ...] [ CASCADE | RESTRICT ]
</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Description</title>

<para>
<command>DROP DYNAMIC TABLE</command> drops an existing dynamic
table. To execute this command you must be the owner of the dynamic
table. Since every dynamic table has a auto refresh process of pg_task
job, drop a dynamic table will drop that job too.
</para>
</refsect1>

<refsect1>
<title>Parameters</title>

<variablelist>
<varlistentry>
<term><literal>IF EXISTS</literal></term>
<listitem>
<para>
Do not throw an error if the dynamic table does not exist. A notice
is issued in this case.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><replaceable class="parameter">name</replaceable></term>
<listitem>
<para>
The name (optionally schema-qualified) of the dynamic table to
remove.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>CASCADE</literal></term>
<listitem>
<para>
Automatically drop objects that depend on the dynamic table (such as
other materialized views, or regular views or pg_task jobs),
and in turn all objects that depend on those objects
(see <xref linkend="ddl-depend"/>).
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>RESTRICT</literal></term>
<listitem>
<para>
Refuse to drop the dynamic table if any objects depend on it. This
is the default.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Examples</title>

<para>
This command will remove the dynamic table called
<literal>order_summary</literal>:
<programlisting>
DROP DYNAMIC TABLE order_summary;
</programlisting></para>
</refsect1>

<refsect1>
<title>Compatibility</title>

<para>
<command>DROP DYNAMIC TABLE</command> is a
<productname>Cloudberry</productname> extension.
</para>
</refsect1>

<refsect1>
<title>See Also</title>

<simplelist type="inline">
<member><xref linkend="sql-createdynamictable"/></member>
<member><xref linkend="sql-refreshdynamictable"/></member>
</simplelist>
</refsect1>

</refentry>
Loading
Loading