OpenText Analytics Database 26.2.x – Developing with the OpenText Analytics Database SDK

Extending: Setting up a development environment

Mon, 01 Jan 0001 00:00:00 +0000

Before you start developing your UDx, you need to configure your development and test environments. Development and test environments must use the same operating system and OpenText™ Analytics Database version as the production environment.

For additional language-specific requirements, see the following topics:

Development environment options

The language that you use to develop your UDx determines the setup options and requirements for your development environment. C++ developers can use the C++ UDx container, and all developers can use a non-production OpenText™ Analytics Database environment.

C++ UDx container

C++ developers can develop with the C++ UDx container. The UDx-container GitHub repository provides the tools to build a container that packages the binaries, libraries, and compilers required to develop C++ OpenText™ Analytics Database extensions. The C++ UDx container has the following build options:

CentOS or Ubuntu base image
OpenText™ Analytics Database 12.x and 11.x versions

For requirement, build, and test details, see the repository README.

Non-production OpenText™ Analytics Database environments

You can use a node in a non-production database or another machine that runs the same operating system and database version as your production environment. For specific requirements and dependencies, refer to Operating System Requirements and Language Requirements.

Test environment options

To test your UDx, you need access to a non-production database. You have the following options:

Install a single-node database on your development machine.
Download and build a containerized test environment.

Extending: Downloading and running UDx example code

Mon, 01 Jan 0001 00:00:00 +0000

You can download all of the examples shown in this documentation, and many more, from the Vertica GitHub repository. This repository includes examples of all types of UDxs.

You can download the examples in either of two ways:

Download the ZIP file. Extract the contents of the file into a directory.
Clone the repository. Using a terminal window, run the following command:
```
$ git clone https://github.com/vertica/UDx-Examples.git
```

The repository includes a makefile that you can use to compile the C++ and Java examples. It also includes .sql files that load and use the examples. See the README file for instructions on compiling and running the examples. To compile the examples you will need g++ or a JDK and make. See Setting up a development environment for related information.

Running the examples not only helps you understand how a UDx works, but also helps you ensure your development environment is properly set up to compile UDx libraries.

Extending: C++ SDK

Mon, 01 Jan 0001 00:00:00 +0000

The SDK supports writing both fenced and unfenced UDxs in C++ 11. You can download, compile, and run the examples; see Downloading and running UDx example code. Running the examples is a good way to verify that your development environment has all needed libraries.

If you do not have access to an OpenText™ Analytics Database test environment, you can install the database on your development machine and run a single node. Each time you rebuild your UDx library, you need to re-install it into the database. The following diagram illustrates the typical development cycle.

This section covers C++-specific topics that apply to all UDx types. For information that applies to all languages, see Arguments and return values, UDx parameters, Errors, warnings, and logging, Handling cancel requests and the sections for specific UDx types. For full API documentation, see the C++ SDK Documentation.

Extending: Java SDK

Mon, 01 Jan 0001 00:00:00 +0000

OpenText™ Analytics Database SDK supports writing Java UDxs of all types except aggregate functions. All Java UDxs are fenced.

You can download, compile, and run the examples; see Downloading and running UDx example code. Running the examples is a good way to verify that your development environment has all needed libraries.

If you do not have access to a database test environment, you can install Vertica on your development machine and run a single node. Each time you rebuild your UDx library, you need to re-install it into the database. The following diagram illustrates the typical development cycle.

This section covers Java-specific topics that apply to all UDx types. For information that applies to all languages, see Arguments and return values, UDx parameters, Errors, warnings, and logging, Handling cancel requests and the sections for specific UDx types. For full API documentation, see the Java SDK Documentation.

Extending: Python SDK

Mon, 01 Jan 0001 00:00:00 +0000

The OpenText™ Analytics Database SDK supports writing UDxs of some types in Python 3.

The Python SDK does not require any additional system configuration or header files. This low overhead allows you to develop and deploy new capabilities to your database cluster in a short amount of time.

The following workflow is typical for the Python SDK:

Because Python has an interpreter, you do not have to compile your program before loading the UDx in the database. However, you should expect to do some debugging of your code after you create your function and begin testing it in the database.

When the database calls your UDx, it starts a side process that manages the interaction between the server and the Python interpreter.

This section covers Python-specific topics that apply to all UDx types. For information that applies to all languages, see Arguments and return values, UDx parameters, Errors, warnings, and logging, Handling cancel requests and the sections for specific UDx types. For full API documentation, see the Python SDK.

Important

Your UDx must be able to run with the version of Python bundled with the database. You can find this with /opt/vertica/sbin/python3 --version. You cannot change the version used by the OpenText™ Analytics Database Python interpreter.

Extending: R SDK

Mon, 01 Jan 0001 00:00:00 +0000

The OpenText™ Analytics Database R SDK extends the capabilities of the OpenText™ Analytics Database so you can leverage additional R libraries. Before you can begin developing User Defined Extensions (UDxs) in R, you must install the R Language Pack for the database on each of the nodes in your cluster. The R SDK supports scalar and transform functions in fenced mode. Other UDx types are not supported.

The following workflow is typical for the R SDK:

You can find detailed documentation of all of the classes in the database R SDK.

Extending: Debugging tips

Mon, 01 Jan 0001 00:00:00 +0000

The following tips can help you debug your UDx before deploying it in a production environment.

Use a single node for initial debugging

You can attach to the OpenText™ Analytics Database process using a debugger such as gdb to debug your UDx code. Doing this in a multi-node environment, however, is very difficult. Therefore, consider setting up a single-node database test environment to initially debug your UDx.

Use logging

Each UDx has an associated ServerInterface instance. The ServerInterface provides functions to write to the database log and, in the C++ API only, a system table. See Logging for more information.

OpenText Analytics Database 26.2.x – Developing with the OpenText Analytics Database SDK

Extending: Setting up a development environment

Development environment options

C++ UDx container

Non-production OpenText™ Analytics Database environments

Test environment options

Extending: Downloading and running UDx example code

See also

Extending: C++ SDK

Extending: Java SDK

Extending: Python SDK

Important

Extending: R SDK

Extending: Debugging tips

Use a single node for initial debugging

Use logging