16.20 - Registering the JAR or ZIP File - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL External Routine Programming

Advanced SQL Engine
Teradata Database
Release Number
Release Date
April 2020
Content Type
Programming Reference
Publication ID
English (United States)

After you write and test the Java source code for a UDF, you place the resulting class or classes in an archive (JAR or ZIP) file.

Next, you call the SQLJ.INSTALL_JAR external stored procedure to register the archive file and its classes with the database, specifying an SQL identifier for the archive file. The SQL identifier that you specify is the same name that you use later in the EXTERNAL NAME clause of the CREATE FUNCTION or REPLACE FUNCTION statement to define the SQL function.

For example, consider a JAR file called reports.jar on a Windows client in the directory C:\java_udf.

The following statements register the JAR file with the JUDF database and create an SQL identifier called Report_JAR for the JAR file:

CALL SQLJ.INSTALL_JAR('CJ?C:\java_udf\reports.jar', 'Report_JAR', 0);

For details on how to register archive files for a Java external routine, see Registering and Distributing JAR and ZIP Files for Java External Routines.