Home
Developing
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
Development concepts
Development of stream applications consists of several components such as operators, streams, tuples, Streams Processing Language, toolkits, and more.
Development and runtime environments
You can develop stream applications in an integrated development environment, then you run those applications in instances on one or more computers.

Welcome
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
Developing
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
- Development concepts
  Development of stream applications consists of several components such as operators, streams, tuples, Streams Processing Language, toolkits, and more.
  - Stream applications
    A Stream application is a software program that processes streaming data. The application may consume, clean, transform, enrich, analyze, produce, and store data as part of its processing.
  - Streams and tuples
    A stream is a sequence of data that flows between operators in a stream application.
  - Operators
    Operators are the fundamental building blocks of stream applications. Typically, operators process tuples in incoming streams and produce output streams as a result.
  - Application development
    Teracloud® Streams offers the Streams Processing Language (SPL) to compose stream applications.
  - Toolkits
    A toolkit is an organized collection of artifacts to provide reusable components for application developers.
  - Development and runtime environments
    You can develop stream applications in an integrated development environment, then you run those applications in instances on one or more computers.
  - Running applications
    You can submit and run your applications in stand-alone or distributed runtime environments. In a stand-alone runtime environment, an application is a binary that you can launch directly, that is, it does not run on the Teracloud® Streams instance. In a distributed runtime environment, an application is run when you submit a application bundle file to a Teracloud Streams instance.
- Writing stream applications
  Teracloud® Streams provides features and functions to help you write your applications to fulfill your business needs.
- Enabling Streams data exchange
  Teracloud® Streams provides a data exchange REST API for inserting and retrieving Streams job data. You can add one or more endpoint operators to your Streams application to enable Streams data exchange. Providing a standard REST interface for Streams data exchange eases the integration of Streams data with other data services and externally hosted applications.
- Compiling stream applications
  The Streams Processing Language (SPL) Compiler is called sc and is included with the Teracloud® Streams installation package. You compile SPL to create files to run on your Teracloud Streams instance.
- Performance improvements for stream applications
  You can improve the processing of your stream application by following these guidelines and tips.
- Debugging stream applications
  The Streams Processing Language (SPL) Streams Debugger (sdb) provides a command line-based interactive debugger for debugging stream applications.
- Developing toolkits and operators
  You can create custom toolkits and operators for your applications.
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

Development and runtime environments

You can develop stream applications in an integrated development environment, then you run those applications in instances on one or more computers.

You must consider these elements of the Teracloud® Streams environment:

Development environment

You can create stream applications in the Streams Processing Language (SPL) as well as other languages by using the Teracloud Visual Studio Code (VS Code). The VSCODE extension is accessible through the Visual Studio Code Extension Marketplace.

Runtime environment

A distributed runtime environment is called a Teracloud® Streams instance. You configure your stream applications to run in a Teracloud® Streams instance.

The Teracloud® Streams instance can be deployed on one or more resources, based on your scalability needs as you develop, test, and use an application. Hosts are resources that run the host management services, the streams application, or both.

With the PE boxes, are one or more circles that represent operators. Between each operator are arrows, which represent streams. — Figure 1. A streams application at run time

This figure represents an application at run time. The application is shown as a series of nested boxes. The outermost box represents the instance of an application. Within the Instance box is a box that is labeled Job. Within the Job box are two boxes, each labeled, Resource. Within one of the Node boxes are two boxes that are labeled, PE. Within the other Resource box is one box that is labeled, PE.

Processing element (PE): The runtime units of streams application. When an SPL application is compiled, the operators and streams relationships that make up the data flow graph are divided into PEs. Each PE can contain one or more operators that are fused together into a partition.
Job: An application running in an instance.