SAS Viya is a cloud-enabled analytics engine used for producing useful insights.
The Installing SAS Viya section describes the following:
Downloading SAS Viya
Integrating with SQreamDB has been tested with SAS Viya v.03.05 and newer.
To download SAS Viya, see SAS Viya.
Installing the JDBC Driver
The SQreamDB JDBC driver is required for establishing a connection between SAS Viya and SQreamDB.
To install the JDBC driver:
Download the JDBC driver.
Unzip the JDBC driver into a location on the SAS Viya server.
SQreamDB recommends creating the directory
/opt/sqreamon the SAS Viya server.
After installing the JDBC driver, you must configure the JDBC driver from the SAS Studio so that it can be used with SQreamDB BStudio.
To configure the JDBC driver from the SAS Studio:
Sign in to the SAS Studio.
From the New menu, click SAS Program.
Configure the SQreamDB 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;
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.
The Best Practices and Troubleshooting section describes the following best practices and troubleshooting procedures when connecting to SQreamDB using SAS Viya:
Inserting Only Required Data
When using SAS Viya, SQreamDB 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 SQreamDB 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
SQreamDB 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 SQreamDB JDBC Driver
In some cases, SAS Viya cannot locate the SQreamDB JDBC driver, generating the following error message:
To locate the SQreamDB 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 SQreamDB 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.