PostgreSQL and PL/Java
33
-
Upload
peter-eisentraut -
Category
Technology
-
view
12.059 -
download
1
description
server-side functions in Java
Transcript of PostgreSQL and PL/Java
2
Agenda
• Functions in PostgreSQL
• Enter PL/Java
• Features of PL/Java
• Support and Compatibility
• Outlook and Wrap-Up
3
Defining a Function
Example of an SQL function:
CREATE FUNCTION add(int, int) RETURNS int
LANGUAGE SQL
AS 'SELECT $1 + $2;';
SELECT add(4, 5);
add
-----
9
4
Defining a Function
Example of a C function:
PG_FUNCTION_INFO_V1(funcname);
Datum add(PG_FUNCTION_ARGS)
{
int32 a = PG_GETARG_INT32(0);
int32 b = PG_GETARG_INT32(1);
PG_RETURN_INT32(a + b);
}
5
Defining a Function
Example of a C function, continued:
gcc -fPIC -c file.c
gcc -shared -o file.so file.o
CREATE FUNCTION add(int, int) RETURNS int
LANGUAGE C
AS 'file.so', 'add';
6
Features of Functions
• Overloading
• Processing sets/tables
• Caching options (deterministic/nondeterministic)
• Execution privileges
7
Advantages of Server-Side Functions
• Encapsulation
• Faster database access
• Plan caching, inlining
• Data validation through triggers
• Side effects through triggers
8
Functions as Building Blocks
• Operators
• Data types
• Aggregate functions
• Index access methods
• Type casts
• Character set conversions
9
Procedural Languages
• Choice of SQL vs. C quite limited
• Solution: pluggable language handlers
• Available languages:Tcl, PL/pgSQL, Perl, Ruby, Python, Shell, R, Java, PHP
10
Procedural Language Example: PL/pgSQL
CREATE FUNCTION logfunc(logtxt text)
RETURNS timestamp
AS '
DECLARE
curtime timestamp;
BEGIN
curtime := ''now'';
INSERT INTO logtable VALUES (logtxt, curtime);
RETURN curtime;
END;
' LANGUAGE plpgsql;
11
Procedural Language Example: PL/Perl
CREATE OR REPLACE FUNCTION valid_id()
RETURNS trigger
AS '
if (($_TD->{new}{i} >= 100) || ($_TD->{new}{i} <= 0)) {
return "SKIP"; # skip INSERT/UPDATE command
} elsif ($_TD->{new}{v} ne "immortal") {
$_TD->{new}{v} .= "(modified by trigger)";
return "MODIFY"; # modify row and run INSERT/UPDATE
} else {
return; # execute INSERT/UPDATE command
}
' LANGUAGE plperl;
12
Enter PL/Java
• Developed by Thomas Hallgren
• Stored procedures written in the Java language
• Java the most popular (client) language for PostgreSQL
13
Standardization
SQL standard: ISO/IEC 9075-13:2003
SQL Routines and Types for the Java Programming Language ("SQL/JRT")
(210 pages)
driven by Oracle and IBM
14
Timeline of PL/Java
• Nov. 2000: first attempt with Kaffe 1.0.6
• Dec. 2003: PL/Java project launched
• Jan. 2004: first alpha release
• Jan. 2005: release 1.0.0 (for PG 7.4)
• Apr. 2005: release 1.1.0 (for PG 8.0)
• currently “stable”
15
Concept
• Write a Java class
• Designate static method as entry point
• Pack into JAR
• Load JAR into database
• Adjust classpath
• Create function in PostgreSQL
16
Simple Example: Codepackage com.example;
public class Foo
{
static int add(int a, int b)
{
return a + b;
}
}
17
Simple Example: Deploymentjavac com/example/Foo.java
jar cf foo.jar com/example/Foo.class
SELECT sqlj.install_jar('file:/home/peter/tmp/foo.jar', 'foo', false);
SELECT sqlj.set_classpath('public', 'foo:bar:etc');
CREATE FUNCTION add(int, int) RETURNS int
LANGUAGE java
AS 'com.example.Foo.add';
18
Deployment Descriptor
Optional way to integrate install/uninstall SQL statements into the JAR file:
SQLActions[] = {
"BEGIN INSTALL
CREATE FUNCTION add(int, int) RETURNS int
LANGUAGE java
AS 'com.example.Foo.add';
END INSTALL",
"BEGIN REMOVE
DROP FUNCTION add(int, int);
END REMOVE"
}
19
Configuration
New parameters for postgresql.conf:
custom_variable_classes = 'pljava'
pljava.classpath = '/some/where/pljava.jar'
pljava.statement_cache_size = 10
pljava.release_lingering_savepoints = true
pljava.vmoptions = '-Xmx64M'
pljava.debug = false
20
Parameter Type Mapping
Parameter types are mapped automatically:PostgreSQL Javaboolean booleanshortint shortint intbigint longreal floatdouble precision doublevarchar, text java.lang.Stringbytea byte[]date java.sql.Datetime java.sql.Timetimestamp java.sql.Timestampother java.lang.String
21
Composite TypesCREATE TYPE compositeTest AS (
base integer,
incbase integer,
ctime timestamp
);
CREATE FUNCTION useCompositeTest (compositeTest)
RETURNS varchar
AS 'foo.fee.Fum.useCompositeTest'
LANGUAGE java;
22
Composite Types
Represented as java.sql.ResultSet with one row.
public static String useCompositeTest(ResultSet compositeTest) throws SQLException
{
int base = compositeTest.getInt(1);
int incbase = compositeTest.getInt(2);
Timestamp ctime = compositeTest.getTimestamp(3);
return "Base = \\\\"" + base +
"\\\\", incbase = \\\\"" + incbase +
"\\\\", ctime = \\\\"" + ctime + "\\\\"";
}
23
Returning SetsCREATE FUNCTION getNames() RETURNS SETOF varchar
AS 'Bar.getNames'LANGUAGE java;
import java.util.Iterator;
public class Bar {
public static Iterator getNames() {
ArrayList names = new ArrayList();
names.add("Lisa");
names.add("Bob");
names.add("Bill");
return names.iterator();
}
}
24
Built-in JDBC Driver
• Prepare/execute queries
• Query metadata
• No transaction management (can use savepoints)
Connection conn = DriverManager.getConnection("jdbc:default:connection");
25
Triggersstatic void moddatetime(TriggerData td) throws SQLException
{
if(td.isFiredForStatement())
throw new TriggerException(td, "can't process STATEMENT events");
if(td.isFiredAfter())
throw new TriggerException(td, "must be fired before event");
if(!td.isFiredByUpdate())
throw new TriggerException(td, "can only process UPDATE events");
ResultSet _new = td.getNew();
String[] args = td.getArguments();
if (args.length != 1)
throw new TriggerException(td, "one argument was expected");
_new.updateTimestamp(args[0], new Timestamp(System.currentTimeMillis()));
}
26
Other Features
• Exception handling
• Logging
• DatabaseMetaData
• Multithreading
• IN/OUT parameters (PostgreSQL 8.1)
• Security
27
Problem Areas
• Memory usage
• Performance?
• Stack handling
28
Build Options
• Builds with:• Sun JDK ≥ 1.4 (shared library + JAR)
• GCJ ≥ 4.0 (shared library)
• Does not work with:• Kaffe
• SableVM
29
GCJ Issues
• Missing java.security implementation
• GCJ-based PL/Java installations are untrusted.
30
Supported Platforms
• Linux (most architectures)
• Cygwin
• Windows (PostgreSQL 8.1/recent)
• More reports welcome!
31
Compatibility
• vs. Oracle:• data type system not as good
• trigger procedures not compatible (wrappers possible)
• vs. DB/2, Firebird, ...:• unknown
32
The Future
• Dynamic type system (SQL:2003)
• Work on SQL conformance and compatibility
• More work on J4SQL
• Cooperation with PL/J project
33
Conclusion
• PL/Java is stable today.
• It is being used.
• It is almost feature complete.
• Get it now!
http://gborg.postgresql.org/project/pljava/projdisplay.php
