Odysseus Studio is the RCP based frontend to develop and run persistent queries. Odysseus Studio needs no installation and can be extracted to any directory.
To run Odysseus a Java JDK 1.7 or higher needs to be installed. For a detailed tutorial for the installation look at How to install Odysseus
Start Odysseus Studio by running “studio” and choose a new workspace.
- Do not use an existing Eclipse workspace.
- Avoid blanks in the workspace path.
In the login screen use “System” as user and “manager” as password (leave field Tenant empty if available). You can check the mark to avoid typing login information again.
Initially, Odysseus creates a directory in the user’s home directory for configuration issues.
After the login process, the Odysseus RCP GUI starts up. In this GUI you can create a new Odysseus project by issuing a click with the right mouse button in area 1. When you have created a new project you can start creating Queries for your project using any soure listet in area 2 or creating own sources. You can start an Odysseus Query by a click on the Play-Button in the toolbar. All running queries are listet in area 3.
The Odysseus Studio provides a wide range of so called Views to make the definition, administration and controlling of processing queries very convenient. In the following, we will go through all available Views in Odysseus Studio.
The Sources View contains a list of available sources with their given name and schema information to be used in you processing query. Every time a new source is registered in Odysseus, a new source will be inserted in the list of available sources.
The Queries View allows you to control you processing queries. Using this view, you can start and stop queries, remove them from the list of queries or perform actions on multiple queries at once. The View consists of 7 columns providing all necessary information about registered queries. In the first column, you have the unique identifier of you query. The second column holds the name of the query of the name of the last operator in the query if no name was given. The third column shows the status of the query, i.e., Running, Inactive,.. The fourth query hold the priority of the query. Column 5 shows the parser that is used to parse the query, available parser are: PQL and CQL. The sixth column shows the user who registered the query. Finally, the last column shows the query itself in the given language. In the menu bar you have a list of menu entries to control either the selected query, or performing actions on all queries. Further, the first entry can be used to reload the list of registered queries, and the last entry switches to the graph view to see the current selected query as a processing graph representation.
In the PQL Operators View you can see all available PQL Operators including their required and optional parameters.
The Outline View includes all operators of the current query including their output schema and queries they belong to. This is especially interesting in case of query sharing in which one operator is used in multiple queries to increase the processing performance.
MEP Functions View
The MEP Functions View provide a convenient way to look up available functions to be used in filter and mapping operators. The list includes in the symbol, the return type, the arity, and the possible parameter for the function.The first column is the symbol to be used in a query. As you see, the symbol can be overwritten allowing you to use the function on different parameter settings with different semantics, i.e., the similarity function can be used on two different parameter types and performs different calculations internally. The second column defines the return type of the function. The third column is the number of parameter the function takes. Finally, the fourth column includes a list of accepted parameter types, i.e., the sin function takes an integer, long, double, or float value for the first parameter and the round takes the same for the first and the second parameter. You can also restrict the list of MEP functions by providing a search string in the upper text field. Here, you can search either by wildcards or using regular expressions to filter for a particular function symbol.
The users view holds a list of users and their privileges. In the example above we see the queryexecutor user that has all permissions for registering, starting, stopping, and dropping a query.
Operator Detail Info View
The Operator Detail Info View allows a deeper look to the settings of an operator and is thus a perfect debugging tool for your processing queries.