Connect to SQream Using SAS Viya¶
SAS Viya is a cloud-enabled analytics engine used for producing useful insights. The Connect to SQream Using SAS Viya page describes how to connect to SAS Viya, and describes the following:
Installing SAS Viya¶
The Installing SAS Viya section describes the following:
Downloading SAS Viya¶
Integrating with SQream has been tested with SAS Viya v.03.05 and newer.
To download SAS Viya, see SAS Viya.
Installing the JDBC Driver¶
The SQream JDBC driver is required for establishing a connection between SAS Viya and SQream.
To install the JDBC driver:
Download the JDBC driver.
Unzip the JDBC driver into a location on the SAS Viya server.
SQream recommends creating the directory
/opt/sqreamon the SAS Viya server.
Configuring SAS Viya¶
After installing the JDBC driver, you must configure the JDBC driver from the SAS Studio so that it can be used with SQream Studio.
To configure the JDBC driver from the SAS Studio:
Sign in to the SAS Studio.
From the New menu, click SAS Program.
Configure the SQream JDBC connector by adding the following rows:
options sastrace='d,d,d,d' sastraceloc=saslog nostsuffix msglevel=i sql_ip_trace=(note,source) DEBUG=DBMS_SELECT; options validvarname=any; libname sqlib jdbc driver="com.sqream.jdbc.SQDriver" classpath="/opt/sqream/sqream-jdbc-4.0.0.jar" URL="jdbc:Sqream://sqream-cluster.piedpiper.com:3108/raviga;cluster=true" user="rhendricks" password="Tr0ub4dor3" schema="public" PRESERVE_TAB_NAMES=YES PRESERVE_COL_NAMES=YES;
For more information about writing a connection string, see Connect to SQream DB with a JDBC Application and navigate to Connection String.
Operating SAS Viya¶
The Operating SAS Viya section describes the following:
Using SAS Viya Visual Analytics¶
This section describes how to use SAS Viya Visual Analytics.
To use SAS Viya Visual Analytics:
Log in to SAS Viya Visual Analytics using your credentials:
Click New Report.
Click Data Sources.
Click the Connect icon.
From the Type menu, select Database.
Provide the required information and select Persist this connection beyond the current session.
Click Advanced and provide the required information.
Add the following additional parameters by clicking Add Parameters:
Click Test Connection.
If the connection is successful, click Save.
If your connection is not successful, see Troubleshooting SAS Viya below.
Troubleshooting SAS Viya¶
The Best Practices and Troubleshooting section describes the following best practices and troubleshooting procedures when connecting to SQream using SAS Viya:
Inserting Only Required Data¶
When using SAS Viya, SQream recommends using only data that you need, as described below:
Insert only the data sources you need into SAS Viya, excluding tables that don’t require analysis.
To increase query performance, add filters before analyzing. Every modification you make while analyzing data queries the SQream database, sometimes several times. Adding filters to the datasource before exploring limits the amount of data analyzed and increases query performance.
Creating a Separate Service for SAS Viya¶
SQream recommends creating a separate service for SAS Viya with the DWLM. This reduces the impact that Tableau has on other applications and processes, such as ETL. In addition, this works in conjunction with the load balancer to ensure good performance.
Locating the SQream JDBC Driver¶
In some cases, SAS Viya cannot locate the SQream JDBC driver, generating the following error message:
To locate the SQream JDBC driver:
Verify that you have placed the JDBC driver in a directory that SAS Viya can access.
Verify that the classpath in your SAS program is correct, and that SAS Viya can access the file that it references.
Restart SAS Viya.
For more troubleshooting assistance, see the SQream Support Portal.
In SAS Viya versions lower than 4.0, casting
CHAR changes the size to 1,024, such as when creating a table including a
TEXT column. This is resolved by casting
CHAR when using the JDBC driver.