mirror of
https://github.com/postgres/postgres.git
synced 2026-03-20 17:44:08 -04:00
Allow a partition be detached from its partitioned table without blocking concurrent queries, by running in two transactions and only requiring ShareUpdateExclusive in the partitioned table. Because it runs in two transactions, it cannot be used in a transaction block. This is the main reason to use dedicated syntax: so that users can choose to use the original mode if they need it. But also, it doesn't work when a default partition exists (because an exclusive lock would still need to be obtained on it, in order to change its partition constraint.) In case the second transaction is cancelled or a crash occurs, there's ALTER TABLE .. DETACH PARTITION .. FINALIZE, which executes the final steps. The main trick to make this work is the addition of column pg_inherits.inhdetachpending, initially false; can only be set true in the first part of this command. Once that is committed, concurrent transactions that use a PartitionDirectory will include or ignore partitions so marked: in optimizer they are ignored if the row is marked committed for the snapshot; in executor they are always included. As a result, and because of the way PartitionDirectory caches partition descriptors, queries that were planned before the detach will see the rows in the detached partition and queries that are planned after the detach, won't. A CHECK constraint is created that duplicates the partition constraint. This is probably not strictly necessary, and some users will prefer to remove it afterwards, but if the partition is re-attached to a partitioned table, the constraint needn't be rechecked. Author: Álvaro Herrera <alvherre@alvh.no-ip.org> Reviewed-by: Amit Langote <amitlangote09@gmail.com> Reviewed-by: Justin Pryzby <pryzby@telsasoft.com> Discussion: https://postgr.es/m/20200803234854.GA24158@alvherre.pgsql
34 lines
1.2 KiB
C
34 lines
1.2 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* partition.h
|
|
* Header file for structures and utility functions related to
|
|
* partitioning
|
|
*
|
|
* Copyright (c) 2007-2021, PostgreSQL Global Development Group
|
|
*
|
|
* src/include/catalog/partition.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef PARTITION_H
|
|
#define PARTITION_H
|
|
|
|
#include "partitioning/partdefs.h"
|
|
#include "utils/relcache.h"
|
|
|
|
/* Seed for the extended hash function */
|
|
#define HASH_PARTITION_SEED UINT64CONST(0x7A5B22367996DCFD)
|
|
|
|
extern Oid get_partition_parent(Oid relid, bool even_if_detached);
|
|
extern List *get_partition_ancestors(Oid relid);
|
|
extern Oid index_get_partition(Relation partition, Oid indexId);
|
|
extern List *map_partition_varattnos(List *expr, int fromrel_varno,
|
|
Relation to_rel, Relation from_rel);
|
|
extern bool has_partition_attrs(Relation rel, Bitmapset *attnums,
|
|
bool *used_in_expr);
|
|
|
|
extern Oid get_default_partition_oid(Oid parentId);
|
|
extern void update_default_partition_oid(Oid parentId, Oid defaultPartId);
|
|
extern List *get_proposed_default_constraint(List *new_part_constraints);
|
|
|
|
#endif /* PARTITION_H */
|