PostgreSQL中怎么載入外部模塊

本篇文章為大家展示了PostgreSQL中怎么載入外部模塊，內容簡明扼要并且容易理解，絕對能使你眼前一亮，通過這篇文章的詳細介紹希望你能有所收獲。

PostgreSQL如何加載extension，例如 PL/pgSQL、postgres_fdw，查看它們的symbol：

quanzl-mac:postgresql.builtin_pool quanzl$ nm lib/plpgsql.so 
                 U _AllocSetContextCreateExtended
                 U _BeginInternalSubTransaction
                 U _BlessTupleDesc
...
0000000000007a50 T _Pg_magic_func
000000000001c86c s _Pg_magic_func.Pg_magic_data
...
0000000000007e10 T _pg_finfo_plpgsql_call_handler
000000000001c888 s _pg_finfo_plpgsql_call_handler.my_finfo
...
0000000000007e20 T _plpgsql_call_handler
...

T 表示 The symbol is in the text (code) section.
s 表示 The symbol is in an uninitialized data section for small objects.

本文關注模塊加載時的動作，涉及上邊的兩個對象：_Pg_magic_func 和 _Pg_magic_func.Pg_magic_data

來看一個PG模塊的代碼（節選自 src/pl/plpgsql/src/pl_handler.c）：

...
static void plpgsql_extra_errors_assign_hook(const char *newvalue, void *extra);

PG_MODULE_MAGIC;

/* Custom GUC variable */
static const struct config_enum_entry variable_conflict_options[] = {
	{"error", PLPGSQL_RESOLVE_ERROR, false},
	{"use_variable", PLPGSQL_RESOLVE_VARIABLE, false},
	{"use_column", PLPGSQL_RESOLVE_COLUMN, false},
	{NULL, 0, false}
};
...

這里注意 PG_MODULE_MAGIC，它的定義（src/include/fmgr.h）：

...
/* The actual data block contents */
#define PG_MODULE_MAGIC_DATA \
{ \
	sizeof(Pg_magic_struct), \
	PG_VERSION_NUM / 100, \
	FUNC_MAX_ARGS, \
	INDEX_MAX_KEYS, \
	NAMEDATALEN, \
	FLOAT4PASSBYVAL, \
	FLOAT8PASSBYVAL \
}
...
#define PG_MAGIC_FUNCTION_NAME Pg_magic_func
#define PG_MAGIC_FUNCTION_NAME_STRING "Pg_magic_func"

#define PG_MODULE_MAGIC \
extern PGDLLEXPORT const Pg_magic_struct *PG_MAGIC_FUNCTION_NAME(void); \
const Pg_magic_struct * \
PG_MAGIC_FUNCTION_NAME(void) \
{ \
	static const Pg_magic_struct Pg_magic_data = PG_MODULE_MAGIC_DATA; \
	return &Pg_magic_data; \
} \
extern int no_such_variable

可以看出，這里就是 Pg_magic_func 這個函數定義（symbol為什么多一個下劃線請自行查資料），還有它的靜態變量 Pg_magic_data。

Pg_magic_struct 這個結構體作用是在加載時檢查模塊是否與當前數據庫內核匹配，防止不同版本或者不是PG模塊的庫的加載。

動態庫的加載函數 internal_load_library 代碼節選（src/backend/utils/fmgr/dfmgr.c）：

    magic_func = (PGModuleMagicFunction)
      pg_dlsym(file_scanner->handle, PG_MAGIC_FUNCTION_NAME_STRING);
    if (magic_func)
    {
      const Pg_magic_struct *magic_data_ptr = (*magic_func) ();
...

如果找不到 Pg_magic_func，或者是它的返回值與當前數據庫服務器不一致，拒絕加載。

用于結構體初始化的 PG_MODULE_MAGIC_DATA，包含

1、結構體尺寸
2、版本號
3、函數最大參數個數
4、索引最大列數
5、單精度浮點傳值
6、雙精度浮點傳值

上述內容就是PostgreSQL中怎么載入外部模塊，你們學到知識或技能了嗎？如果還想學到更多技能或者豐富自己的知識儲備，歡迎關注億速云行業資訊頻道。