Practical PostgreSQL

Load

Dynamically loads object files into a database.

Synopsis

LOAD 'filename'

Parameters

filename

The name of the dynamic object file you wish to load.

Results

LOAD

The message returned when a dynamic object file was successfully loaded.

ERROR: LOAD: could not open file 'filename'

The error returned if the specified file was not found. Make sure the PostgreSQL backend is permitted to access the file.

Description

Use the LOAD command to load an object file into the PostgreSQL backend. Once loaded, an object file provides the backend the required functionality for which the file was created. In this way, you can incorporate your own database components (such as types and functions) dynamically. If you do not explicitly load an object file, the backend will load it automatically when a function from the file is called. Currently, only C language object files are supported.

Note

You can also use this command to force the reloading of recently recompiled object files.

Example

The following example loads the object file /usr/local/src/lxp/libxpl.so in the lx database:

lx=# LOAD '/usr/local/src/lxp/libxpl.so';
LOAD