begriffs open source - ai-pg/blob - full-docs/txt/sql-load.txt

   1
   2 LOAD
   3
   4    LOAD — load a shared library file
   5
   6 Synopsis
   7
   8 LOAD 'filename'
   9
  10 Description
  11
  12    This command loads a shared library file into the PostgreSQL server's
  13    address space. If the file has been loaded already, the command does
  14    nothing. Shared library files that contain C functions are
  15    automatically loaded whenever one of their functions is called.
  16    Therefore, an explicit LOAD is usually only needed to load a library
  17    that modifies the server's behavior through “hooks” rather than
  18    providing a set of functions.
  19
  20    The library file name is typically given as just a bare file name,
  21    which is sought in the server's library search path (set by
  22    dynamic_library_path). Alternatively it can be given as a full path
  23    name. In either case the platform's standard shared library file name
  24    extension may be omitted. See Section 36.10.1 for more information on
  25    this topic.
  26
  27    Non-superusers can only apply LOAD to library files located in
  28    $libdir/plugins/ — the specified filename must begin with exactly that
  29    string. (It is the database administrator's responsibility to ensure
  30    that only “safe” libraries are installed there.)
  31
  32 Compatibility
  33
  34    LOAD is a PostgreSQL extension.
  35
  36 See Also
  37
  38    CREATE FUNCTION