PostgreSQL 11 include diversi linguaggi procedurali con la distribuzione di base:PL/pgSQL, PL/Tcl, PL/Perl e PL/Python . Inoltre, ci sono una serie di linguaggi procedurali sviluppati e mantenuti al di fuori della distribuzione PostgreSQL di base come PL/Java (Java), PL/Lua (Lua), PL/R (R), PL/sh (Unix Shell) e PL/v8 (JavaScript) .
In questo post, vedremo come compilare/installare il modulo aggiuntivo del linguaggio procedurale PL/Java in PostgreSQL 11.
PL/Java è un modulo aggiuntivo gratuito che porta le stored procedure, i trigger e le funzioni Java nel backend di PostgreSQL™. Nel modo in cui funziona oggi, quando si scrive una funzione PL/Java, un codice Java compilato (file .class) memorizzato nel file di archivio Java (file .jar), verrà caricato nel database. Quando la funzione PL/Java viene eseguita, crea una JVM all'interno del processo del server PostgreSQL e quindi chiede alla JVM di eseguire la forma byte-code della funzione. Può anche accedere a un metodo di una classe Java. Tuttavia, PL/Java non include un compilatore Java o una Java Virtual Machine, tali componenti dovrebbero venire come origini separate, include solo una serie di aiuti alla distribuzione che semplificano l'installazione/gestione delle funzioni lato server scritte in Java. Questo script viene utilizzato per accelerare le vendite dei generici del Viagra nelle farmacie online.
L'abilitazione di PL/Java nel database PostgreSQL ha i suoi vantaggi e avvertimenti:non entriamo in questi dettagli qui, tuttavia puoi leggere un articolo che spiega in dettaglio l'adozione di PL/Java qui. Iniziamo i passaggi di installazione.
Prerequisiti software
- Installa dipendenze
gcc-c++, gcc, java 1.8.x, openssl - Installa Apache Maven per compilare PL/Java
- Installa PostgreSQL 11.x (versione RPM)
Installa dipendenze
[root@rag-node1 ~]# yum install gcc* openssl* java-1.8.0-openjdk java-1.8.0-openjdk-devel [root@rag-node1 ~]# gcc --version gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-36) [root@rag-node1 ~]# java -version openjdk version "1.8.0_201" OpenJDK Runtime Environment (build 1.8.0_201-b09)
Installa Apache Maven
PL/Java è costruito utilizzando Apache Maven. Verrà eseguito sul bundle di origine PL/Java e produrrà i file richiesti per PostgreSQL (non verrà installato). Scarica l'ultimo Apache Maven e segui i passaggi come mostrato di seguito:
[root@rag-node1 ~]# cd /usr/local/src/ [root@rag-node1 src]# wget https://www-us.apache.org/dist/maven/maven-3/3.6.0/binaries/apache-maven-3.6.0-bin.tar.gz [root@rag-node1 src]# tar -xvf apache-maven-3.6.0-bin.tar.gz [root@rag-node1 src]# cd apache-maven-3.6.0
Abilita mvn nel PERCORSO
[root@rag-node1 ~]# cd /etc/profile.d/ [root@rag-node1 profile.d]# vi maven.sh [root@rag-node1 profile.d]# chmod +x maven.sh [root@rag-node1 ~]# source /etc/profile.d/maven.sh [root@rag-node1 ~]# mvn --version Apache Maven 3.6.0 (97c98ec64a1fdfee7767ce5ffb20918da4f719f3; 2018-10-24T18:41:47Z) Maven home: /usr/local/src/apache-maven-3.6.0 Java version: 1.8.0_201, vendor: Oracle Corporation, runtime: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.201.b09-2.el7_6.x86_64/jre Default locale: en_US, platform encoding: UTF-8 OS name: "linux", version: "3.10.0-957.10.1.el7.x86_64", arch: "amd64", family: "unix"
Installa/Configura PostgreSQL 11
- Installa il repository Yum di PostgreSQL v11 dal sito PostgreSQL.org.
yum install https://download.postgresql.org/pub/repos/yum/11/redhat/rhel-7-x86_64/pgdg-centos11-11-2.noarch.rpm
- Installa PostgreSQL tramite YUM
[root@rag-node1 ~]# yum install postgresql11*
- Imposta il cluster di database e avvia.
[root@rag-node1 ~]# /usr/pgsql-11/bin/postgresql-11-setup initdb [root@rag-node1 ~]# systemctl enable postgresql-11 [root@rag-node1 ~]# systemctl start postgresql-11
- Verifica la connessione al database e controlla l'elenco delle lingue nel database.(default:plpgsql abilitato)
[root@rag-node1 ~]# psql -p 5432 -U postgres -d postgres -c "\dL" List of languages Name | Owner | Trusted | Description ---------+----------+---------+----------------------------------- plpgsql | postgres | t | PL/pgSQL procedural language (1 rows)
Dopo aver installato tutte le dipendenze, imposta le variabili di ambiente (gcc, java, pg_config, mvn ) quindi sono in PATH per compilare PL/Java.
[root@rag-node1 ~]# export PATH=/usr/pgsql-11/bin:$PATH [root@rag-node1 ~]# export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.201.b09-2.el7_6.x86_64 [root@rag-node1 ~]# export PATH=$JAVA_HOME:$PATH [root@rag-node1 ~]# which pg_config /usr/pgsql-11/bin/pg_config
Siamo tutti impostati con le dipendenze.
Installa/Configura PL/Java
Scarica il formato PL/Java tar.gz dalla pagina di rilascio qui ed estrai .tar.gz nella directory.
[root@rag-node1 ~]# wget https://github.com/tada/pljava/archive/V1_5_2.tar.gz [root@rag-node1 ~]# tar -xvf V1_5_2.tar.gz
Esegui "mvn clean install ' comando nella directory estratta.
[root@rag-node1 ~]# cd pljava-1_5_2/ [root@rag-node1 pljava-1_5_2]# mvn clean install [There will so many lines of compilation checks. Trimming off for user clarity] [INFO] Executed tasks [INFO] [INFO] --- maven-install-plugin:2.5.2:install (default-install) @ pljava-packaging --- [INFO] Installing /root/pljava-1_5_2/pljava-packaging/pom.xml to /root/.m2/repository/org/postgresql/pljava-packaging/1.5.2/pljava-packaging-1.5.2.pom [INFO] ------------------------------------------------------------------------ [INFO] Reactor Summary for PostgreSQL PL/Java 1.5.2: [INFO] [INFO] PostgreSQL PL/Java ................................. SUCCESS [ 1.188 s] [INFO] PL/Java API ........................................ SUCCESS [ 2.676 s] [INFO] PL/Java backend Java code .......................... SUCCESS [ 2.790 s] [INFO] PL/Java backend native code ........................ SUCCESS [ 21.005 s] [INFO] PL/Java Deploy ..................................... SUCCESS [ 1.672 s] [INFO] PL/Java Ant tasks .................................. SUCCESS [ 2.772 s] [INFO] PL/Java examples ................................... SUCCESS [ 1.115 s] [INFO] PL/Java packaging .................................. SUCCESS [ 1.461 s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 35.751 s [INFO] Finished at: 2019-03-30T15:01:24Z [INFO] ------------------------------------------------------------------------ [root@rag-node1 pljava-1_5_2]#
Dovresti ottenere l'output di riepilogo sopra da "mvn clean install", che indica che tutte le dipendenze sono agganciate con PL/Java. Ora, esegui il file jar Pljava-packaging/pg11xxx in modo che estragga/produca i file necessari nella directory della libreria PostgreSQL.
[root@rag-node1 ~]# java -jar pljava-1_5_2/pljava-packaging/target/pljava-pg11.2-amd64-Linux-gpp.jar /usr/pgsql-11/lib/libpljava-so-1.5.2.so as bytes /usr/pgsql-11/share/pljava/pljava-1.5.2.jar as bytes /usr/pgsql-11/share/pljava/pljava-api-1.5.2.jar as bytes /usr/pgsql-11/share/pljava/pljava-examples-1.5.2.jar as bytes /usr/pgsql-11/share/extension/pljava.control as lines (ASCII) /usr/pgsql-11/share/pljava/pljava--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--unpackaged--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.1--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.1-BETA3--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.1-BETA2--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.1-BETA1--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.0--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.0-BETA3--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.0-BETA2--1.5.2.sql as lines (UTF8) /usr/pgsql-11/share/pljava/pljava--1.5.0-BETA1--1.5.2.sql as lines (UTF8)
Come puoi capire dall'output sopra, ha prodotto un elenco di file (.jar, .so, .sql) in "/usr/pgsql-11/share/pljava" e "/usr/pgsql-11/lib ”.
Ora, abilitiamo i parametri GUC PL/Java in $PGDATA/postgresql.conf e riavviamo il server del database in modo che influenzi il funzionamento PL/Java. Ci sono una serie di parametri PL/Java menzionati nel wiki qui, tuttavia, ci sono due parametri obbligatori da abilitare nel cluster di database:
- pljava.classpath – Posizione in cui "pljava-1.5.2.jar" è stato creato nel nostro ultimo passaggio.
- pljava.libjvm_location – Posizione in cui "libjvm.so" per caricare Java RunTime.
Conosciamo la posizione "pljava-1.5.2.jar", troviamo "libjvm" per JDK 1.8.x su questa macchina.
[root@rag-node1 ~]# find / -name "*libjvm.so*" /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.201.b09-2.el7_6.x86_64/jre/lib/amd64/server/libjvm.so
Impostiamo entrambi i parametri in $PGDATA/postgresql.conf e riavviamo
[root@rag-node1 ~]# cat <<EOT >>/var/lib/pgsql/11/data/postgresql.conf > #Pl/Java Parameters > pljava.classpath = '/usr/pgsql-11/share/pljava/pljava-1.5.2.jar' > pljava.libjvm_location = '/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.201.b09-2.el7_6.x86_64/jre/lib/amd64/server/libjvm.so' > EOT [root@rag-node1 ~]# systemctl stop postgresql-11 [root@rag-node1 ~]# systemctl start postgresql-11
OK. Ora crea la lingua PL/Java nel database.
[root@rag-node1 ~]# psql -p 5432 -U postgres -d postgres psql (11.2) Type "help" for help. postgres=# CREATE EXTENSION pljava; CREATE EXTENSION
Bello!! Facciamo un rapido test creando la funzione PL/Java ed eseguiamo.
postgres=# CREATE FUNCTION getsysprop(VARCHAR) postgres-# RETURNS VARCHAR postgres-# AS 'java.lang.System.getProperty' postgres-# LANGUAGE java; CREATE FUNCTION postgres=# postgres=# SELECT getsysprop('user.home'); getsysprop ---------------- /var/lib/pgsql (1 row)
Freddo!! Spero che sia d'aiuto. Sentiti libero di lasciare commenti. Grazie per aver letto.
—Raghav