pub struct CreateTable<X: Extension = NoExt> {
pub or_replace: bool,
pub temporary: Option<TemporaryTableKind>,
pub unlogged: bool,
pub if_not_exists: bool,
pub name: ObjectName,
pub body: CreateTableBody<X>,
pub inherits: ThinVec<ObjectName>,
pub partition_by: Option<Box<PartitionSpec<X>>>,
pub access_method: Option<Box<Ident>>,
pub options: ThinVec<CreateTableOption<X>>,
pub meta: Meta,
}Expand description
An SQL create table.
Fields§
§or_replace: boolCREATE OR REPLACE TABLE (DuckDB): atomically replaces an existing table.
Gated by StatementDdlGates::create_or_replace_table —
off elsewhere, where OR REPLACE before TABLE surfaces as a clean parse error
(only VIEW/FUNCTION take OR REPLACE in the other dialects).
temporary: Option<TemporaryTableKind>Optional temporary for this syntax.
unlogged: boolCREATE UNLOGGED TABLE (PostgreSQL; also a DuckDB no-op): the table’s data is not
written to the write-ahead log. PostgreSQL’s OptTemp grammar makes UNLOGGED a
peer of TEMP/TEMPORARY — the two are mutually exclusive, so a set unlogged
never co-occurs with a Some(temporary) (CREATE TEMP UNLOGGED TABLE is a raw-parse
error, reproduced here). Gated for acceptance by
CreateTableClauseSyntax::unlogged_tables — off
elsewhere (ANSI/MySQL/SQLite), where UNLOGGED after CREATE surfaces as a clean
parse error.
if_not_exists: boolWhether the if not exists form was present in the source.
name: ObjectNameName referenced by this syntax.
body: CreateTableBody<X>Statement or query body governed by this node.
inherits: ThinVec<ObjectName>The INHERITS (<parent>, ...) legacy table-inheritance clause (PostgreSQL), naming the
parent tables this table inherits columns and constraints from. It follows the
Definition (elements) body and precedes both
partition_by and the trailing options
(PostgreSQL grammar order: (…) INHERITS (…) PARTITION BY … WITH … ON COMMIT … TABLESPACE …). Empty when no clause is written — an INHERITS () with no parent is a raw-parse
error, so a non-empty list always corresponds to a written clause and no separate
Option is needed. Only the (elements) definition body carries it (the PARTITION OF,
OF <type>, and AS <query> bodies do not), so it is empty for those. Gated for
acceptance by
CreateTableClauseSyntax::table_inheritance — off
elsewhere, where the INHERITS keyword is left unconsumed and surfaces as a clean parse
error.
partition_by: Option<Box<PartitionSpec<X>>>The trailing PARTITION BY {LIST | RANGE | HASH} (<key>, ...) declarative-partitioning
clause (PostgreSQL), marking this table as a partitioned parent. It follows the
Definition body (CREATE TABLE t (...) PARTITION BY LIST (a)) and the PartitionOf child body (a
sub-partitioned child, ... FOR VALUES IN (1) PARTITION BY RANGE (b)); it never rides
an AS <query> body. Boxed as a cold clause so a non-partitioned table pays only a
null pointer. None when the table is not a partition parent. Gated for acceptance by
CreateTableClauseSyntax::declarative_partitioning —
off elsewhere, where the PARTITION keyword is left unconsumed and surfaces as a clean
parse error.
access_method: Option<Box<Ident>>The USING <access_method> table access-method clause (PostgreSQL): the storage
engine backing the table (heap, an extension-provided method). In PostgreSQL’s
CreateStmt grammar it sits after the body, inherits, and
partition_by but before the trailing
options ((…) INHERITS (…) PARTITION BY … USING heap WITH (…) ON COMMIT … TABLESPACE …) — a WITH (…) before USING is a raw-parse error, so parsing
it here reproduces that order. On an AS <query> body the slot instead precedes the
AS (CreateTableAsStmt: CREATE TABLE t [(cols)] USING m [WITH (…)] AS query; a
USING after the query is a raw-parse error). The method is a single (optionally
quoted) identifier — a qualified schema.method is a raw-parse error. None when the
clause is unwritten. Boxed as a cold clause (rarely written) so a plain CREATE TABLE
pays only a null pointer, keeping this node within its size budget (the box/inline
budget). Gated for acceptance by
CreateTableClauseSyntax::table_access_method — off
elsewhere, where the USING keyword is left unconsumed and surfaces as a clean parse
error.
options: ThinVec<CreateTableOption<X>>Options supplied in source order.
meta: MetaSource location and node identity.
Trait Implementations§
Source§impl<X: Clone + Extension> Clone for CreateTable<X>
impl<X: Clone + Extension> Clone for CreateTable<X>
Source§fn clone(&self) -> CreateTable<X>
fn clone(&self) -> CreateTable<X>
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl<'de, X> Deserialize<'de> for CreateTable<X>where
X: Deserialize<'de> + Extension,
impl<'de, X> Deserialize<'de> for CreateTable<X>where
X: Deserialize<'de> + Extension,
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
impl<X: Eq + Extension> Eq for CreateTable<X>
Source§impl<X: Extension + Render> Render for CreateTable<X>
impl<X: Extension + Render> Render for CreateTable<X>
Source§fn render(&self, ctx: &RenderCtx<'_>, f: &mut Formatter<'_>) -> Result
fn render(&self, ctx: &RenderCtx<'_>, f: &mut Formatter<'_>) -> Result
Source§fn operand_binding_power(&self) -> Option<BindingPower>
fn operand_binding_power(&self) -> Option<BindingPower>
None (the default) for a self-delimiting node — an atom, call, or
constructor — that never needs parentheses. Read moreSource§impl<X> Serialize for CreateTable<X>
impl<X> Serialize for CreateTable<X>
Source§impl<X: Extension> Spanned for CreateTable<X>
impl<X: Extension> Spanned for CreateTable<X>
impl<X: PartialEq + Extension> StructuralPartialEq for CreateTable<X>
Auto Trait Implementations§
impl<X> Freeze for CreateTable<X>
impl<X> RefUnwindSafe for CreateTable<X>where
X: RefUnwindSafe,
impl<X> Send for CreateTable<X>where
X: Send,
impl<X> Sync for CreateTable<X>where
X: Sync,
impl<X> Unpin for CreateTable<X>where
X: Unpin,
impl<X> UnsafeUnpin for CreateTable<X>
impl<X> UnwindSafe for CreateTable<X>where
X: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> DeserializeOwned for Twhere
T: for<'de> Deserialize<'de>,
Source§impl<T> DynAstExt for T
impl<T> DynAstExt for T
Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&dyn Any for downcasting a node back to its concrete type.Source§fn dyn_clone(&self) -> Box<dyn DynAstExt>
fn dyn_clone(&self) -> Box<dyn DynAstExt>
Clone (whose
Self-returning signature cannot go through a vtable).Source§fn dyn_eq(&self, other: &dyn DynAstExt) -> bool
fn dyn_eq(&self, other: &dyn DynAstExt) -> bool
PartialEq (whose &Self argument cannot go through a vtable). Equal
iff other holds the same concrete type and that type deems the values
equal; differently-typed nodes are never equal.