Manage the SAP IQ Connector

The Composer SAP IQ connector allows you to access the data stored within your SAP IQ database using the Composer client. The Composer connector supports SAP IQ version 16.

Before you can establish a connection from Composer to SAP IQ, a connector server needs to be installed, configured and enabled. See Manage Connectors and Connector Servers for general instructions and Connect to SAP IQ for details specific to the SAP IQ connector. If you elect to use Kerberos authentication, see Configure Kerberos Support for the SAP IQ Connector.

After the connector has been set up, you can create data source configurations that specify the necessary connection information and identify the data you want to use. See Manage Data Source Configurations for more information. After data sources are configured, they can be used to create dashboards and visuals from your data. See Create Dashboards.

Composer Feature Support

SAP IQ connector support for specific Composer features is shown in the following table.

Key: P - Supported; O - Not Supported; N/A - not applicable

Feature Supported?
Admin-Defined Functions P
Box Plots P
Custom SQL Queries P
Derived Fields (Row-Level Expressions) P
Distinct Counts P
Fast Distinct Values N/A
Group By Multiple Fields P
Group By Time P
Group By UNIX Time P
Histogram Floating Point Values P
Histograms P
Kerberos Authentication P
Last Value P
Live Mode and Playback P
Multivalued Fields N/A
Nested Fields N/A
Partitions O
Pushdown Joins for Fusion Data Sources O
Schemas P
Text Search N/A
TLS P
User Delegation O
Wild Card Filters P
Wild Card Filters, Case-Insensitive Mode P
Wild Card Filters, Case-Sensitive Mode P

Connect to SAP IQ

Make sure that the jConnect system objects were installed on your Sap IQ database instance (see https://help.sap.com/viewer/a894a54d84f21015b142ffe773888f8c/16.1.3.0/en-US/3bd561266c5f10149e06d363dbe03486.html).

The SAP IQ connector requires a JDBC driver to be configured before your data source configurations can use it. You can download the driver from the vendor's site. For information and steps, see Add a JDBC Driver.

When setting up a connection to SAP IQ , you need to provide the following:

  • The name of the connection
  • The JDBC URL. The format for the JDBC URL must be as follows: jdbc:sybase:Tds:<ipaddr>:<port>. For example, jdbc:sybase:Tds:10.1.2.3:2638/.
  • The username and password, if applicable.
  • Optionally, the microservice principal name.
  • Optionally, select Request Kerberos Session if Kerberos connection authentication will be used. See Configure Kerberos Support for the SAP IQ Connector for more information.

Configure Kerberos Support for the SAP IQ Connector

To configure Kerberos support for the connector:

  1. Create or update the file named /etc/zoomdata/edc-sapiq.properties. If this file already exists, verify that the information below exists in the file:

    kerberos.krb5.conf.location=/etc/krb5.conf
    
    kerberos.service.account.authentication=true
    kerberos.service.account.principal=<yourcompany_principal>@KERBEROS.REALM kerberos.service.account.keytab.location=/etc/zoomdata/<yourcompany_principal>.keytab
  2. Restart the SAP IQ connector.

  3. To connect to SAP IQ, use the following JDBC URL template:

    jdbc:sybase:Tds:host:port/?REQUEST_KERBEROS_SESSION=true&SERVICE_PRINCIPAL_NAME=sap_iq_database@PRINCIPAL.NAME