C on tableAM

Author: interma

src/backend/catalog/index.c

@@ -3221,7 +3221,11 @@ IndexCheckExclusion(Relation heapRelation,
 	indexInfo->ii_PredicateState = NULL;
 }
 
-
+/**
+validate_index 是 PostgreSQL 中用于支持并发索引构建的核心函数之一。
+并发索引构建允许在*不阻塞表的插入、更新和删除操作的情况下*创建索引，从而提高系统的可用性和并发性能。
+该函数的主要任务是验证索引的完整性(通过两次表扫描)，确保所有符合条件的元组都被正确地索引。
+ */
 /*
  * validate_index - support code for concurrent index builds
  *

src/backend/executor/nodeSamplescan.c

@@ -12,6 +12,23 @@
  *
  *-------------------------------------------------------------------------
  */
+
+/**
+Sample Scan 是 PostgreSQL 中用于表采样的功能，通过 TABLESAMPLE 子句实现。
+它允许用户从表中随机抽取部分数据，适用于统计分析、查询优化和测试等场景。
+在 PostgreSQL 的实现中，nodeSamplescan.c 文件定义了 Sample Scan 的核心逻辑，包括初始化、采样和资源释放等操作。
+通过支持多种采样方法和参数，Sample Scan 提供了灵活且高效的数据采样能力
+
+ubuntu=# select * from bar TABLESAMPLE BERNOULLI (20);
+ a
+---
+ 1
+ 7
+ 9
+(3 rows)
+
+*/
+
 #include "postgres.h"
 
 #include "access/relscan.h"

src/include/access/tableam.h

@@ -1644,6 +1644,11 @@ table_relation_set_new_filelocator(Relation rel,
 												  minmulti);
 }
 
+/**
+table_relation_nontransactional_truncate 是一个静态内联函数，用于以非事务性的方式清空指定表（rel）的所有内容。
+非事务性操作意味着该函数不支持回滚，因此一旦执行，操作的效果将是不可逆的。
+这种设计通常用于特定场景，例如在当前事务中创建的临时存储对象的截断操作。
+ */
 /*
  * Remove all table contents from `rel`, in a non-transactional manner.
  * Non-transactional meaning that there's no need to support rollbacks. This