Manage the SAP IQ Connector

Describes the SAP IQ connector.

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

Before you can establish a connection from Self-Service Analytics 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 setting up the connector, create data sources that specify the necessary connection information and identify the data you want to use. See Create and Manage Data Sources for more information. After you set up your data sources, create dashboards, self service reports, and visuals from the data in these data sources.

Feature Support

Connector support for specific features is shown in the following table.

Key: Y - Supported; N - Not Supported; N/A - not applicable

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

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

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=[e-mail]