pgtle.install_extension

La función install_extension le permite instalar los artefactos que componen la extensión TLE en la base de datos, después de lo cual se puede crear mediante el comando CREATE EXTENSION.

Prototipo de función

pgtle.install_extension(name text, version text, description text, ext text, requires text[] DEFAULT NULL::text[])

Rol

Ninguno.

Argumentos

• name: nombre de la extensión TLE. Este valor se utiliza cuando se llama a CREATE EXTENSION.

• version: versión de la extensión TLE.

• description: descripción detallada acerca de la extensión TLE. Esta descripción se muestra en el campo comment de pgtle.available_extensions().

• ext: contenido de la extensión TLE. Este valor contiene objetos como funciones.

• requires: parámetro opcional que especifica las dependencias de esta extensión TLE. La extensión pg_tle se añade automáticamente como una dependencia.

Muchos de estos argumentos son los mismos que se incluyen en un archivo de control de extensiones para instalar una extensión de PostgreSQL en el sistema de archivos de una instancia de PostgreSQL. Para obtener más información acerca de las extensiones de PostgreSQL, vea Extension Files (Archivos de extensión) en Packaging Related Objects into an Extension (Empaquetar objetos relacionados en una extensión) en la documentación de PostgreSQL.

Output

Esta función devuelve OK en caso de éxito y NULL en caso de error.

• OK: la extensión TLE se ha instalado correctamente en la base de datos.

• NULL: la extensión TLE no se ha instalado correctamente en la base de datos.

Ejemplo de uso

SELECT pgtle.install_extension(
 'pg_tle_test',
 '0.1',
 'My first pg_tle extension',
$_pgtle_$
  CREATE FUNCTION my_test()
  RETURNS INT
  AS $$
    SELECT 42;
  $$ LANGUAGE SQL IMMUTABLE;
$_pgtle_$
);