====
LOAD
====


.. container:: refentry
   :name: SQL-LOAD

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: LOAD
         :name: load

      LOAD — 载入一个共享库文件

   .. container:: refsynopsisdiv

      .. rubric:: 大纲
         :name: 大纲

      .. code:: synopsis

         LOAD 'filename'

   .. container:: refsect1
      :name: SQL-LOAD-DESCRIPTION

      .. rubric:: 描述
         :name: 描述

      这个命令把一个共享库文件载入到PostgreSQL服务器
      的地址空间中。如果该文件已经被载入，这个命令什么也不会做。只要调用
      包含 C
      函数的共享库文件中的一个函数，这些共享库文件就会被自动载入。
      因此，一次显式的\ ``LOAD``\ 通常只在载入一个通过
      “钩子”修改服务器行为而不是提供一组函数的库时需要。

      库文件名通常只是一个裸文件名，在服务器的库搜索路径（由
      `dynamic_library_path <runtime-config-client.html#GUC-DYNAMIC-LIBRARY-PATH>`__\ 设置）中寻找。或者，
      它可以作为完整的路径名称给出。无论哪种情况，平台的标准共享库文件扩展名都可以省略。

      非超级用户只能把\ ``LOAD``\ 应用在位于
      ``$libdir/plugins/``\ 中的库文件 — 指定的 *``filename``*
      必须正好以该字符串开始（确保在那里只安装了
      “安全的”库是数据库管理员的责任）。

   .. container:: refsect1
      :name: SQL-LOAD-COMPAT

      .. rubric:: 兼容性
         :name: 兼容性

      ``LOAD``\ 是一种 PostgreSQL扩展。

   .. container:: refsect1
      :name: id-1.9.3.154.7

      .. rubric:: 另见
         :name: 另见

      `CREATE FUNCTION <sql-createfunction.html>`__