Table of Contents
PostgreSQL的TABLESAMPLE子句实现支持
在 SQL 标准要求的BERNOULLI和SYSTEM方法之
外自定义表采样方法。采样方法决定了使用TABLESAMPLE子句时
表的哪些行会被选择。
在 SQL 层上，一种表采样方法被表达为一个 SQL 函数（通常用 C 实现）， 其签名是：
method_name(internal) RETURNS tsm_handler
函数的名称是出现在TABLESAMPLE子句中的同一个方法名称。
internal参数是不起作用的（总是值为零），它仅仅是为了阻止
直接从 SQL 命令中调用该函数。函数的结果必须是一个 palloc 好的
TsmRoutine结构，它包含了该采样方法的支持函数的指针。
这些支持函数是纯 C 函数并且对于 SQL 层面不可见也不可调用。支持函数见
Section 58.1。
除了函数指针之外，TsmRoutine结构必须提供这些额外的域：
List *parameterTypes
这是一个 OID 列表，它包含了使用这种采样方法时TABLESAMPLE
子句接受的参数的数据类型 OID。例如，对于内建方法，这个列表只包含一个值
为FLOAT4OID的项，它表示采样的百分数。自定义采样方法可以有
更多或者不同的参数。
bool repeatable_across_queries
如果为true，当每次查询时给出相同的参数和
REPEATABLE种子值且表内容没有改变时，采样方法可以在
连续的查询中给出相同的采样。当这个域为false时，不能把
REPEATABLE子句用于这种采样方法。
bool repeatable_across_scans
如果为true，这种采样方法在同一个查询的连续扫描中给出
相同的采样（假定参数、种子值和快照都不变）。当这个域为
false时，规划器将不会选择要求扫描被采样表多于一次的计划，
因为那会导致不一致的查询输出。
TsmRoutine结构类型被声明在
src/include/access/tsmapi.h中，需要更多细节可以参考该文件。
在尝试编写自己的采样方法时，包括在标准发布中的表采样方法是很好的参考。内建
采样方法的源代码树可见src/backend/access/tablesample子目录，
在contrib子目录中可以找到额外的方法。