Logo
v2020.3

Contents:

  • Getting Started
    • Preparing Your Machine to Install SQream
    • Installing SQream
    • Executing Statements in SQream
    • Performing Basic SQream Operations
      • Running the SQream SQL Client
      • Creating Your First Table
      • Listing Tables
      • Inserting Rows
      • Running Queries
      • Deleting Rows
      • Saving Query Results to a CSV or PSV File
  • Installation Guides
    • Installing and Launching SQream
      • Recommended Pre-Installation Configuration
      • Installing SQream Using Binary Packages
      • Installing and Running SQream in a Docker Container
      • Installing SQream with Kubernetes
      • Installing Monit
      • Launching SQream with Monit
    • Installing SQream Studio
      • Installing Prometheus Exporter
      • Installing Prometheus Using Binary Packages
      • Installing the Dashboard Data Collector
      • Installing Studio on a Stand-Alone Server
      • Installing an NGINX Proxy Over a Secure Connection
  • Data Ingestion Sources
    • Inserting Data Overview
    • Inserting Data from a CSV File
    • Inserting Data from a Parquet File
    • Inserting Data from an ORC File
    • Migrating Data from Oracle
  • Third Party Tools
    • Client Platforms
      • Connect to SQream Using Power BI Desktop
      • Connecting to SQream Using TIBCO Spotfire
      • Connect to SQream Using SAS Viya
      • Connect to SQream Using SQL Workbench
      • Connecting to SQream Using Tableau
      • Connecting to SQream Using Pentaho Data Integration
      • Connect to SQream Using MicroStrategy
      • Connect to SQream Using Informatica Cloud Services
      • Connect to SQream Using R
      • Connect to SQream Using PHP
    • Client Drivers for v2020.3
      • JDBC
      • Python (pysqream)
      • Node.JS
      • ODBC
        • Install and Configure ODBC on Windows
        • Install and configure ODBC on Linux
      • C++ Driver
  • Feature Guides
    • Access Control
    • Compression
    • Python UDF (User-Defined Functions)
    • Workload Manager
    • Transactions
    • Concurrency and Locks
    • Concurrency and Scaling in SQream DB
  • Operational Guides
    • Access Control
    • Creating or Cloning Storage Clusters
    • Working with External Data
      • Inserting Data Using Amazon S3
      • Using SQream in an HDFS Environment
    • Deleting Data
    • Exporting Data
    • Logging
    • Monitoring Query Performance
    • Security
    • Saved Queries
    • Seeing System Objects as DDL
    • Optimization and Best Practices
    • Hardware Guide
  • SQream Acceleration Studio 5.4.3
    • Getting Started with SQream Acceleration Studio 5.4.3
    • Monitoring Workers and Services from the Dashboard
    • Executing Statements and Running Queries from the Editor
    • Viewing Logs
    • Creating, Assigning, and Managing Roles and Permissions
    • Configuring Your Instance of SQreams
  • System Architecture
    • Internals and Architecture
    • Filesystem and usage
  • Configuration Guides
    • Configuring the Spooling Feature
    • Configuration Methods
      • Configuring SQream
      • Configuring SQream Using the Previous Configuration Method
    • Configuration Flags
      • Administration Flags
        • Regular Administration Flags
        • Cluster Administration Flags
        • Worker Administration Flags
      • Generic Flags
        • Regular Generic Flags
        • Worker Generic Flags
  • Reference Guide
    • SQL Statements and Syntax
      • SQL Syntax Features
      • SQL Statements
      • SQL Functions
        • Built-In Scalar Functions
        • User-Defined Functions
        • Aggregate Functions
        • Window Functions
    • Catalog Reference
    • Command Line Programs
      • metadata_server
      • sqreamd
      • sqream-console
      • sqream-installer
      • server_picker
      • SqreamStorage
      • sqream sql
      • upgrade_storage
    • SQL Feature Checklist
    • Python API Reference Guide
  • Data Type Guides
    • Converting and Casting Types
    • Supported Data Types
    • Supported Casts
      • Numeric
      • Boolean
      • Integer
      • Floating Point
      • String
      • Date
  • Release Notes
    • Release Notes 2020.3
      • Release Notes 2020.3
    • Release Notes 2020.2
    • Release Notes 2020.1
  • Troubleshooting
    • Remedying Slow Queries
    • Resolving Common Issues
    • Examining Logs
    • Identifying Configuration Issues
    • Lock Related Issues
    • SAS Viya Related Issues
    • Tableau Related Issues
    • Solving “Code 126” ODBC Errors
    • Log Related Issues
    • Node.js Related Issues
    • Core Dumping Related Issues
    • SQream SQL Installation Related Issues
    • Gathering Information for SQream Support
  • Glossary
SQream DB
  • »
  • Troubleshooting »
  • SAS Viya Related Issues

SAS Viya Related Issues¶

This section describes the following best practices and troubleshooting procedures when connecting to SQream using SAS Viya:

  • Inserting Only Required Data

  • Creating a Separate Service for SAS Viya

  • Locating the SQream JDBC Driver

  • Supporting TEXT

Inserting Only Required Data¶

When using Tableau, 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 analyze 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:

java.lang.ClassNotFoundException: com.sqream.jdbc.SQDriver

To locate the SQream JDBC driver:

  1. Verify that you have placed the JDBC driver in a directory that SAS Viya can access.

  2. Verify that the classpath in your SAS program is correct, and that SAS Viya can access the file that it references.

  3. Restart SAS Viya.

For more troubleshooting assistance, see the SQream Support Portal.

Supporting TEXT¶

In SAS Viya versions lower than 4.0, casting TEXT to CHAR changes the size to 1,024, such as when creating a table including a TEXT column. This is resolved by casting TEXT into CHAR when using the JDBC driver.

Next Previous

© Copyright 2022 SQream. Revision a1f754c1.

SQream DB v: v2020.3
Versions
latest
v2021.2
v2021.1
v2020.3.2.1
v2020.3.2
v2020.3.1
v2020.3
v2020-2
v2020-1
internal_documentation
Downloads
pdf
html