#include "postgres.h"
#include "access/genam.h"
#include "access/heapam.h"
#include "access/htup_details.h"
#include "access/xact.h"
#include "catalog/index.h"
#include "catalog/indexing.h"
#include "executor/executor.h"
#include "utils/rel.h"

Include dependency graph for indexing.c:

Macros
#define	CatalogTupleCheckConstraints(heapRel, tup) ((void) 0)

Functions
CatalogIndexState	CatalogOpenIndexes (Relation heapRel)

void	CatalogCloseIndexes (CatalogIndexState indstate)

static void	CatalogIndexInsert (CatalogIndexState indstate, HeapTuple heapTuple)

void	CatalogTupleInsert (Relation heapRel, HeapTuple tup)

void	CatalogTupleInsertWithInfo (Relation heapRel, HeapTuple tup, CatalogIndexState indstate)

void	CatalogTuplesMultiInsertWithInfo (Relation heapRel, TupleTableSlot **slot, int ntuples, CatalogIndexState indstate)

void	CatalogTupleUpdate (Relation heapRel, ItemPointer otid, HeapTuple tup)

void	CatalogTupleUpdateWithInfo (Relation heapRel, ItemPointer otid, HeapTuple tup, CatalogIndexState indstate)

void	CatalogTupleDelete (Relation heapRel, ItemPointer tid)

Macro Definition Documentation

◆ CatalogTupleCheckConstraints

#define CatalogTupleCheckConstraints	(	heapRel,
		tup
	)	((void) 0)

Definition at line 205 of file indexing.c.

Referenced by CatalogIndexInsert(), CatalogTupleInsert(), CatalogTupleInsertWithInfo(), CatalogTupleUpdate(), and CatalogTupleUpdateWithInfo().

Function Documentation

◆ CatalogCloseIndexes()

void CatalogCloseIndexes ( CatalogIndexState indstate )

Definition at line 61 of file indexing.c.

References ExecCloseIndices(), and pfree().

Referenced by AddNewAttributeTuples(), AppendAttributeTuples(), CatalogTupleInsert(), CatalogTupleUpdate(), copyTemplateDependencies(), InsertPgAttributeTuples(), inv_truncate(), inv_write(), recordMultipleDependencies(), and swap_relation_files().

 {
     ExecCloseIndices(indstate);
     pfree(indstate);
 }

◆ CatalogIndexInsert()

static void CatalogIndexInsert	(	CatalogIndexState	indstate,
		HeapTuple	heapTuple
	)

static

Definition at line 75 of file indexing.c.

References Assert, att_isnull, attnum, CatalogTupleCheckConstraints, ExecDropSingleTupleTableSlot(), ExecStoreHeapTuple(), FormIndexDatum(), HeapTupleHasNulls, HeapTupleIsHeapOnly, i, IndexInfo::ii_ExclusionOps, IndexInfo::ii_Expressions, IndexInfo::ii_NumIndexKeyAttrs, IndexInfo::ii_Predicate, IndexInfo::ii_ReadyForInserts, index_insert(), INDEX_MAX_KEYS, MakeSingleTupleTableSlot(), TupleDescData::natts, NIL, RelationData::rd_index, ReindexIsProcessingIndex(), RelationGetDescr, RelationGetRelid, ResultRelInfo::ri_IndexRelationDescs, ResultRelInfo::ri_IndexRelationInfo, ResultRelInfo::ri_NumIndices, ResultRelInfo::ri_RelationDesc, HeapTupleHeaderData::t_bits, HeapTupleData::t_data, HeapTupleData::t_self, TTSOpsHeapTuple, TupleDescAttr, UNIQUE_CHECK_NO, UNIQUE_CHECK_YES, and values.

Referenced by CatalogTupleInsert(), CatalogTupleInsertWithInfo(), CatalogTuplesMultiInsertWithInfo(), CatalogTupleUpdate(), and CatalogTupleUpdateWithInfo().

 {
     int         i;
     int         numIndexes;
     RelationPtr relationDescs;
     Relation    heapRelation;
     TupleTableSlot *slot;
     IndexInfo **indexInfoArray;
     Datum       values[INDEX_MAX_KEYS];
     bool        isnull[INDEX_MAX_KEYS];
 
     /*
      * HOT update does not require index inserts. But with asserts enabled we
      * want to check that it'd be legal to currently insert into the
      * table/index.
      */
 #ifndef USE_ASSERT_CHECKING
     if (HeapTupleIsHeapOnly(heapTuple))
         return;
 #endif
 
     /*
      * Get information from the state structure.  Fall out if nothing to do.
      */
     numIndexes = indstate->ri_NumIndices;
     if (numIndexes == 0)
         return;
     relationDescs = indstate->ri_IndexRelationDescs;
     indexInfoArray = indstate->ri_IndexRelationInfo;
     heapRelation = indstate->ri_RelationDesc;
 
     /* Need a slot to hold the tuple being examined */
     slot = MakeSingleTupleTableSlot(RelationGetDescr(heapRelation),
                                     &TTSOpsHeapTuple);
     ExecStoreHeapTuple(heapTuple, slot, false);
 
     /*
      * for each index, form and insert the index tuple
      */
     for (i = 0; i < numIndexes; i++)
     {
         IndexInfo  *indexInfo;
         Relation    index;
 
         indexInfo = indexInfoArray[i];
         index = relationDescs[i];
 
         /* If the index is marked as read-only, ignore it */
         if (!indexInfo->ii_ReadyForInserts)
             continue;
 
         /*
          * Expressional and partial indexes on system catalogs are not
          * supported, nor exclusion constraints, nor deferred uniqueness
          */
         Assert(indexInfo->ii_Expressions == NIL);
         Assert(indexInfo->ii_Predicate == NIL);
         Assert(indexInfo->ii_ExclusionOps == NULL);
         Assert(index->rd_index->indimmediate);
         Assert(indexInfo->ii_NumIndexKeyAttrs != 0);
 
         /* see earlier check above */
 #ifdef USE_ASSERT_CHECKING
         if (HeapTupleIsHeapOnly(heapTuple))
         {
             Assert(!ReindexIsProcessingIndex(RelationGetRelid(index)));
             continue;
         }
 #endif                          /* USE_ASSERT_CHECKING */
 
         /*
          * FormIndexDatum fills in its values and isnull parameters with the
          * appropriate values for the column(s) of the index.
          */
         FormIndexDatum(indexInfo,
                        slot,
                        NULL,    /* no expression eval to do */
                        values,
                        isnull);
 
         /*
          * The index AM does the rest.
          */
         index_insert(index,     /* index relation */
                      values,    /* array of index Datums */
                      isnull,    /* is-null flags */
                      &(heapTuple->t_self),  /* tid of heap tuple */
                      heapRelation,
                      index->rd_index->indisunique ?
                      UNIQUE_CHECK_YES : UNIQUE_CHECK_NO,
                      false,
                      indexInfo);
     }
 
     ExecDropSingleTupleTableSlot(slot);
 }

◆ CatalogOpenIndexes()

CatalogIndexState CatalogOpenIndexes ( Relation heapRel )

Definition at line 43 of file indexing.c.

References ExecOpenIndices(), makeNode, ResultRelInfo::ri_RangeTableIndex, ResultRelInfo::ri_RelationDesc, and ResultRelInfo::ri_TrigDesc.

Referenced by AddNewAttributeTuples(), AppendAttributeTuples(), CatalogTupleInsert(), CatalogTupleUpdate(), copyTemplateDependencies(), InsertPgAttributeTuples(), inv_truncate(), inv_write(), recordMultipleDependencies(), and swap_relation_files().

 {
     ResultRelInfo *resultRelInfo;
 
     resultRelInfo = makeNode(ResultRelInfo);
     resultRelInfo->ri_RangeTableIndex = 0;  /* dummy */
     resultRelInfo->ri_RelationDesc = heapRel;
     resultRelInfo->ri_TrigDesc = NULL;  /* we don't fire triggers */
 
     ExecOpenIndices(resultRelInfo, false);
 
     return resultRelInfo;
 }

◆ CatalogTupleDelete()

void CatalogTupleDelete	(	Relation	heapRel,
		ItemPointer	tid
	)

Definition at line 350 of file indexing.c.

References simple_heap_delete().

Referenced by AlterSetting(), ATExecAlterColumnType(), ATExecDropExpression(), changeDependenciesOn(), changeDependencyFor(), CreateComments(), CreateSharedComments(), DeleteAttributeTuples(), DeleteComments(), deleteDependencyRecordsFor(), deleteDependencyRecordsForClass(), deleteDependencyRecordsForSpecific(), DeleteInheritsTuple(), DeleteInitPrivs(), deleteOneObject(), DeleteRelationTuple(), DeleteSecurityLabel(), DeleteSequenceTuple(), DeleteSharedComments(), DeleteSharedSecurityLabel(), DeleteSystemAttributeTuples(), DelRoleMems(), drop_parent_dependency(), DropConfigurationMapping(), dropDatabaseDependencies(), dropdb(), DropObjectById(), DropRole(), DropSetting(), DropSubscription(), DropTableSpace(), EnumValuesDelete(), heap_drop_with_catalog(), index_drop(), IndexSetParentIndex(), inv_truncate(), LargeObjectDrop(), MakeConfigurationMapping(), RangeDelete(), recordExtensionInitPrivWorker(), RelationRemoveInheritance(), RemoveAttrDefaultById(), RemoveAttributeById(), RemoveConstraintById(), RemoveExtensionById(), RemoveFunctionById(), RemoveOperatorById(), RemovePartitionKeyByRelId(), RemovePolicyById(), RemovePublicationRelById(), RemoveRewriteRuleById(), RemoveStatistics(), RemoveStatisticsById(), RemoveSubscriptionRel(), RemoveTriggerById(), RemoveTSConfigurationById(), RemoveTypeById(), replorigin_drop_guts(), SetSecurityLabel(), SetSharedSecurityLabel(), shdepChangeDep(), and shdepDropDependency().

 {
     simple_heap_delete(heapRel, tid);
 }

◆ CatalogTupleInsert()

void CatalogTupleInsert	(	Relation	heapRel,
		HeapTuple	tup
	)

Definition at line 221 of file indexing.c.

References CatalogCloseIndexes(), CatalogIndexInsert(), CatalogOpenIndexes(), CatalogTupleCheckConstraints, and simple_heap_insert().

Referenced by AddEnumLabel(), AddRoleMems(), AddSubscriptionRelState(), AggregateCreate(), AlterSetting(), CastCreate(), CollationCreate(), ConversionCreate(), CopyStatistics(), CreateAccessMethod(), CreateComments(), CreateConstraintEntry(), createdb(), CreateForeignDataWrapper(), CreateForeignServer(), CreateForeignTable(), CreateOpFamily(), CreatePolicy(), CreateProceduralLanguage(), CreatePublication(), CreateRole(), CreateSharedComments(), CreateStatistics(), CreateSubscription(), CreateTableSpace(), CreateTransform(), CreateTriggerFiringOn(), CreateUserMapping(), DefineOpClass(), DefineSequence(), DefineTSConfiguration(), DefineTSDictionary(), DefineTSParser(), DefineTSTemplate(), EnumValuesCreate(), insert_event_trigger_tuple(), InsertExtensionTuple(), InsertPgClassTuple(), InsertRule(), LargeObjectCreate(), MakeConfigurationMapping(), NamespaceCreate(), OperatorCreate(), OperatorShellMake(), ProcedureCreate(), publication_add_relation(), RangeCreate(), recordExtensionInitPrivWorker(), replorigin_create(), SetDefaultACL(), SetSecurityLabel(), SetSharedSecurityLabel(), shdepAddDependency(), shdepChangeDep(), StoreAttrDefault(), storeOperators(), StorePartitionKey(), storeProcedures(), StoreSingleInheritance(), TypeCreate(), TypeShellMake(), update_attstats(), and UpdateIndexRelation().

 {
     CatalogIndexState indstate;
 
     CatalogTupleCheckConstraints(heapRel, tup);
 
     indstate = CatalogOpenIndexes(heapRel);
 
     simple_heap_insert(heapRel, tup);
 
     CatalogIndexInsert(indstate, tup);
     CatalogCloseIndexes(indstate);
 }

◆ CatalogTupleInsertWithInfo()

void CatalogTupleInsertWithInfo	(	Relation	heapRel,
		HeapTuple	tup,
		CatalogIndexState	indstate
	)

Definition at line 244 of file indexing.c.

References CatalogIndexInsert(), CatalogTupleCheckConstraints, and simple_heap_insert().

Referenced by inv_truncate(), and inv_write().

 {
     CatalogTupleCheckConstraints(heapRel, tup);
 
     simple_heap_insert(heapRel, tup);
 
     CatalogIndexInsert(indstate, tup);
 }

◆ CatalogTuplesMultiInsertWithInfo()

void CatalogTuplesMultiInsertWithInfo	(	Relation	heapRel,
		TupleTableSlot **	slot,
		int	ntuples,
		CatalogIndexState	indstate
	)

Definition at line 261 of file indexing.c.

References CatalogIndexInsert(), ExecFetchSlotHeapTuple(), GetCurrentCommandId(), heap_freetuple(), heap_multi_insert(), i, HeapTupleData::t_tableOid, and TupleTableSlot::tts_tableOid.

Referenced by copyTemplateDependencies(), InsertPgAttributeTuples(), and recordMultipleDependencies().

 {
     /* Nothing to do */
     if (ntuples <= 0)
         return;
 
     heap_multi_insert(heapRel, slot, ntuples,
                       GetCurrentCommandId(true), 0, NULL);
 
     /*
      * There is no equivalent to heap_multi_insert for the catalog indexes, so
      * we must loop over and insert individually.
      */
     for (int i = 0; i < ntuples; i++)
     {
         bool        should_free;
         HeapTuple   tuple;
 
         tuple = ExecFetchSlotHeapTuple(slot[i], true, &should_free);
         tuple->t_tableOid = slot[i]->tts_tableOid;
         CatalogIndexInsert(indstate, tuple);
 
         if (should_free)
             heap_freetuple(tuple);
     }
 }

◆ CatalogTupleUpdate()

void CatalogTupleUpdate	(	Relation	heapRel,
		ItemPointer	otid,
		HeapTuple	tup
	)

Definition at line 301 of file indexing.c.

References CatalogCloseIndexes(), CatalogIndexInsert(), CatalogOpenIndexes(), CatalogTupleCheckConstraints, and simple_heap_update().

Referenced by AddRoleMems(), AggregateCreate(), AlterCollation(), AlterConstraintNamespaces(), AlterDatabase(), AlterDatabaseOwner(), AlterDomainDefault(), AlterDomainNotNull(), AlterDomainValidateConstraint(), AlterEventTrigger(), AlterEventTriggerOwner_internal(), AlterExtensionNamespace(), AlterForeignDataWrapper(), AlterForeignDataWrapperOwner_internal(), AlterForeignServer(), AlterForeignServerOwner_internal(), AlterFunction(), AlterObjectNamespace_internal(), AlterObjectOwner_internal(), AlterObjectRename_internal(), AlterOperator(), AlterPolicy(), AlterPublicationOptions(), AlterPublicationOwner_internal(), AlterRelationNamespaceInternal(), AlterRole(), AlterSchemaOwner_internal(), AlterSequence(), AlterSetting(), AlterStatistics(), AlterSubscription(), AlterSubscriptionOwner_internal(), AlterTableSpaceOptions(), AlterTSDictionary(), AlterTypeNamespaceInternal(), AlterTypeOwnerInternal(), AlterTypeRecurse(), AlterUserMapping(), ApplyExtensionUpdates(), ATExecAddColumn(), ATExecAddIdentity(), ATExecAddOf(), ATExecAlterColumnGenericOptions(), ATExecAlterColumnType(), ATExecAlterConstrRecurse(), ATExecChangeOwner(), ATExecDropColumn(), ATExecDropConstraint(), ATExecDropExpression(), ATExecDropIdentity(), ATExecDropNotNull(), ATExecDropOf(), ATExecForceNoForceRowSecurity(), ATExecGenericOptions(), ATExecSetCompression(), ATExecSetIdentity(), ATExecSetNotNull(), ATExecSetOptions(), ATExecSetRelOptions(), ATExecSetRowSecurity(), ATExecSetStatistics(), ATExecSetStorage(), ATExecValidateConstraint(), change_owner_fix_column_acls(), changeDependenciesOf(), changeDependenciesOn(), changeDependencyFor(), ConstraintSetParentConstraint(), copy_table_data(), create_toast_table(), CreateComments(), CreateProceduralLanguage(), CreateSharedComments(), CreateTransform(), CreateTriggerFiringOn(), DefineIndex(), DefineQueryRewrite(), DelRoleMems(), DetachPartitionFinalize(), EnableDisableRule(), EnableDisableTrigger(), ExecGrant_Attribute(), ExecGrant_Database(), ExecGrant_Fdw(), ExecGrant_ForeignServer(), ExecGrant_Function(), ExecGrant_Language(), ExecGrant_Largeobject(), ExecGrant_Namespace(), ExecGrant_Relation(), ExecGrant_Tablespace(), ExecGrant_Type(), extension_config_remove(), finish_heap_swap(), index_build(), index_concurrently_swap(), index_constraint_create(), index_set_state_flags(), InsertRule(), MakeConfigurationMapping(), mark_index_clustered(), MarkInheritDetached(), MergeAttributesIntoExisting(), MergeConstraintsIntoExisting(), MergeWithExistingConstraint(), movedb(), OperatorCreate(), OperatorUpd(), pg_extension_config_dump(), ProcedureCreate(), recordExtensionInitPrivWorker(), reindex_index(), relation_mark_replica_identity(), RelationClearMissing(), RelationSetNewRelfilenode(), RemoveAttrDefaultById(), RemoveAttributeById(), RemoveConstraintById(), RemoveInheritance(), RemoveRoleFromObjectPolicy(), rename_policy(), renameatt_internal(), RenameConstraintById(), RenameDatabase(), RenameEnumLabel(), RenameRelationInternal(), RenameRewriteRule(), RenameRole(), RenameSchema(), RenameTableSpace(), renametrig_internal(), RenameTypeInternal(), RenumberEnumType(), SetAttrMissing(), SetDefaultACL(), SetIndexStorageProperties(), SetMatViewPopulatedState(), SetRelationHasSubclass(), SetRelationNumChecks(), SetRelationRuleStatus(), SetRelationTableSpace(), SetSecurityLabel(), SetSharedSecurityLabel(), shdepChangeDep(), statext_store(), StoreAttrDefault(), StorePartitionBound(), TypeCreate(), update_attstats(), update_default_partition_oid(), update_relispartition(), UpdateSubscriptionRelState(), UpdateTwoPhaseState(), and validatePartitionedIndex().

 {
     CatalogIndexState indstate;
 
     CatalogTupleCheckConstraints(heapRel, tup);
 
     indstate = CatalogOpenIndexes(heapRel);
 
     simple_heap_update(heapRel, otid, tup);
 
     CatalogIndexInsert(indstate, tup);
     CatalogCloseIndexes(indstate);
 }

◆ CatalogTupleUpdateWithInfo()

void CatalogTupleUpdateWithInfo	(	Relation	heapRel,
		ItemPointer	otid,
		HeapTuple	tup,
		CatalogIndexState	indstate
	)

Definition at line 324 of file indexing.c.

References CatalogIndexInsert(), CatalogTupleCheckConstraints, and simple_heap_update().

Referenced by inv_truncate(), inv_write(), and swap_relation_files().

 {
     CatalogTupleCheckConstraints(heapRel, tup);
 
     simple_heap_update(heapRel, otid, tup);
 
     CatalogIndexInsert(indstate, tup);
 }

Macros

Functions