Disclaimer
Your use of this download is governed by Stonebranch’s Terms of Use, which are available at https://www.stonebranch.com/integration-hub/Terms-and-Privacy/Terms-of-Use/
Overview
SQL Server Integration Services (SSIS) is a platform for building data integrations and data transformation solutions.
This Universal Extension task interactively allows users to list and select the SSIS Folder, Project, Environment Reference, and SSIS Package while creating the job. Furthermore, it can trigger the SSIS package execution in the Microsoft SQL server, monitor the SSIS Package execution, and fetch SSIS logs to the universal Controller when the SSIS package execution has completed.
Software Requirements
Software Requirements for Universal Agent
Universal Agent for Linux or Windows Version 7.0.0.0 or later is required.
Universal Agent needs to be installed with python option (--python yes).
Software Requirements Universal Controller
Universal Controller 7.0.0.0. or later is required.
Software Requirements for the Application to be Scheduled
The Universal Task has been tested for the following databases, Versions and Connector. Please make sure that the connector is installed for your database.
In Universal Controller
Administration → Universal Templates → SQL → Fields → odbc_drivername → New - button
Key Features
The solution supports the following file transfer scenarios:
The Universal Task supports execution of SQL scripts for Oracle, MySQL, PostgreSQL, Microsoft SQL Server and SAP HANA.
For Oracle the execution of SQL scripts and oracle PLSQL blocks are supported.
All connections are agentless via ODBC for SQLSERVER, MySQL and PostgreSQL.
Oracle connections are performed agentless using the oracle basic instant client.
SAP Hana Database connections are performed agentless using the SAP HANA client for Python.
The Universal Task supports both Universal Agent for Linux/Unix and Windows.
You can select different log-levels e.g. Info and debug.
You can decide whether or not the SQL-output is provided in the standard out.
All Passwords are encrypted using Controller Credentials.
For SQLSERVER Windows Authentication and SQLSERVER Authentication is supported.
Import SQL Universal Task Downloadable Universal Template
To use this downloadable Universal Template, you first must perform the following steps:
This Universal Task requires the /wiki/spaces/UC71x/pages/5178443 feature. Check that the/wiki/spaces/UC71x/pages/5177877 system property has been set to true.
Copy or Transfer the Universal Template file to a directory that can be accessed by the Universal Controller Tomcat user.
In the Universal Controller UI, select Configuration > Universal Templates to display the current list of /wiki/spaces/UC71x/pages/5178054.
Right-click any column header on the list to display an Action menu.
Select Import from the menu, enter the directory containing the Universal Template file(s) that you want to import, and click OK.
When the files have been imported successfully, the Universal Template will appear on the list.
Configure SQL Universal Tasks
For the new Universal Task type, create a new task and enter the task-specific Details that were created in the Universal Template.
Field Descriptions for SQL Universal Task
The following will provide a configuration Example for each of the supported Databases:
Database Type: MySQL
Database Type: Oracle - SQL
Database Type: Oracle - PLSQL Block
Database Type: PostgreSQL
Database Type: Microsoft SQL Server
Database Type: SAP HANA
Database Type: MySQL
Field | Description |
Database Type | Type of database to connect:
|
Database Name | Database name or oracle service name |
Database Server | Database Servername e.g. localhost |
Database Port | Port of the Database e.g.
|
Database Credentials | Database Connection Credentials |
ODBC Drivername | Name of the ODBC driver - the field is only relevant for MySQL, PostgreSQL and Microsoft SQL Server. The following driver are available for selection:
Additional driver can be added in the SQL Task Universal Template under: Administration → Universal Templates → SQL → Fields → odbc_drivername → New |
Script | The database script to execute Note: The name should not contain a Universal Controller Variable e.g. script name: sb-${ENV}-proc01 will not work, because it contains a variable (${ENV}) in the name. |
Get Output | prints the SQL output to STDOUT In case of an Oracle Stored procedure print the dbms_output to STDOUT. |
Loglevel | Universal Task logging settings [DEBUG | INFO| WARNING | ERROR | CRITICAL] |
Example: Run a SQL script on MySQL
Database Type: Oracle - SQL
Field | Description |
Database Type | Type of database to connect:
|
Database Name | Database name or oracle service name |
Database Server | Database Servername e.g. localhost |
Database Port | Port of the Database e.g.
|
Database Credentials | Database Connection Credentials |
Mode | Connection Authorization Mode: [sysdba | sysasm | sysoper | sysbkp | sysdgd | syskmt | None] The field is only relevant oracle connections |
Script Type | The field is only relevant for oracle connections [SQL Script | PL/SQL Block ]
|
Script | The database script to execute Note: The name should not contain a Universal Controller Variable e.g. script name: sb-${ENV}-proc01 will not work, because it contains a variable (${ENV}) in the name. |
Get Output | Prints the SQL output to STDOUT In case of an Oracle Stored procedure print the dbms_output to STDOUT. |
Loglevel | Universal Task logging settings [DEBUG | INFO| WARNING | ERROR | CRITICAL] |
Example: Run a SQL Script on Oracle - SQL
Database Type: Oracle - PLSQL Block
Field | Description |
Database Type | Type of database to connect:
|
Database Name | Database name or oracle service name |
Database Server | Database Servername e.g. localhost |
Database Port | Port of the Database e.g.
|
Database Credentials | Database Connection Credentials |
Mode | Connection Authorization Mode: [sysdba | sysasm | sysoper | sysbkp | sysdgd | syskmt | None] The field is only relevant oracle connections |
Script Type | The field is only relevant for oracle connections [SQL Script | PL/SQL Block ]
|
Script | The database script to execute Note: The name should not contain a Universal Controller Variable e.g. script name: sb-${ENV}-proc01 will not work, because it contains a variable (${ENV}) in the name. |
Get Output | prints the SQL output to STDOUT In case of an Oracle Stored procedure print the dbms_output to STDOUT. |
Loglevel | Universal Task logging settings [DEBUG | INFO| WARNING | ERROR | CRITICAL] |
Example: Run an Oracle - PLSQL Block
Database Type: PostgreSQL
Field | Description |
Database Type | Type of database to connect:
|
Database Name | Database name or oracle service name |
Database Server | Database Servername e.g. localhost |
Database Port | Port of the Database e.g.
|
Database Credentials | Database Connection Credentials |
ODBC Drivername | Name of the ODBC driver - the field is only relevant for MySQL, PostgreSQL and Microsoft SQL Server. The following driver are available for selection:
Additional driver can be added in the SQL Task Universal Template under: Administration → Universal Templates → SQL → Fields → odbc_drivername → New |
Script | The database script to execute Note: The name should not contain a Universal Controller Variable e.g. script name: sb-${ENV}-proc01 will not work, because it contains a variable (${ENV}) in the name. |
Get Output | prints the SQL output to STDOUT In case of an Oracle Stored procedure print the dbms_output to STDOUT. |
Loglevel | Universal Task logging settings [DEBUG | INFO| WARNING | ERROR | CRITICAL] |
Example: Run a SQL Script on PostgreSQL
Database Type: Microsoft SQL Server
Field | Description |
Database Type | Type of database to connect:
|
Database Name | Database name or oracle service name |
Database Server | Database Servername e.g. localhost |
Database Port | Port of the Database e.g.
|
Database Credentials | Database Connection Credentials |
Authentication | Supported Methods:
Note: If “Microsoft SQL Server - Windows Authentication” is chosen you should select under the Agent “Credentials” the Windows user, who should execute the script. The database credentials are not used for SQLSERVER -Windows Authentication. |
ODBC Drivername | Name of the ODBC driver - the field is only relevant for MySQL, PostgreSQL and Microsoft SQL Server. The following driver are available for selection:
Additional driver can be added in the SQL Task Universal Template under: Administration → Universal Templates → SQL → Fields → odbc_drivername → New |
Script | The database script to execute Note: The name should not contain a Universal Controller Variable e.g. script name: sb-${ENV}-proc01 will not work, because it contains a variable (${ENV}) in the name. |
Get Output | prints the SQL output to STDOUT In case of an Oracle Stored procedure print the dbms_output to STDOUT. |
Loglevel | Universal Task logging settings [DEBUG | INFO| WARNING | ERROR | CRITICAL] |
Example: Run a SQL Script on Microsoft SQL Server
Database Type: SAP HANA
Field | Description |
Database Type | Type of database to connect:
|
Database Name | Database name or oracle service name |
Database Server | Database Servername e.g. localhost |
Database Port | Port of the Database e.g.
|
Database Credentials | Database Connection Credentials |
Script | The database script to execute Note: The name should not contain a Universal Controller Variable e.g. script name: sb-${ENV}-proc01 will not work, because it contains a variable (${ENV}) in the name. |
Column Separator | The field is only relevant for SAP HANA connections Output separator [ Semicolon | Comma | Hash | Whitespace ] |
Get Output | prints the SQL output to STDOUT In case of an Oracle Stored procedure print the dbms_output to STDOUT. |
Loglevel | Universal Task logging settings [DEBUG | INFO| WARNING | ERROR | CRITICAL] |
Example: Run a SQL Script on SAP HANA
Document References
This document references the following documents:
Name | Location | Description |
---|---|---|
Universal Templates | https://docs.stonebranch.com/confluence/display/UC71x/Universal+Templates | User documentation for creating Universal Templates in the Universal Controller user interface. |
Universal Tasks | https://docs.stonebranch.com/confluence/display/UC71x/Universal+Tasks | User documentation for creating Universal Tasks in the Universal Controller user interface. |