TIBCO®Data Virtualization Client Interfaces Guide
Total Page:16
File Type:pdf, Size:1020Kb
TIBCO® Data Virtualization Client Interfaces Guide Version 8.1 Last Updated: March 25, 2019 Two-Second Advantage® Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE. USE OF TIBCO SOFTWARE AND THIS DOCUMENTATION IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENTATION IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME. This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc. TIBCO and the TIBCO logo are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries TIBCO, Two-Second Advantage, TIBCO Spotfire, TIBCO ActiveSpaces, TIBCO Spotfire Developer, TIBCO EMS, TIBCO Spotfire Automation Services, TIBCO Enterprise Runtime for R, TIBCO Spotfire Server, TIBCO Spotfire Web Player, TIBCO Spotfire Statistics Services, S-PLUS, and TIBCO Spotfire S+ are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM. THIS DOCUMENTATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS DOCUMENTATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENTATION. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENTATION AT ANY TIME. THE CONTENTS OF THIS DOCUMENTATION MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright © 2004-2019 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information Contents | 5 Contents Preface . 11 Product-Specific Documentation . 11 How to Access TIBCO Documentation. 12 How to Contact TIBCO Support . 12 How to Join TIBCO Community . 12 Introduction to Accessing Your Data through Client Interfaces . .15 About Client Interface Connections . 15 Connecting Client Applications to TDV Resources . 16 TDV Port Settings for Client Connections to TDV . 17 TDV Data Retrieval Tuning for Client Connections to TDV . 19 Connecting to TDV Server through JDBC . .21 Installing JDBC Drivers . 21 Updating the JDBC Driver . 22 Setting the Java CLASSPATH for the JDBC Driver. 22 Setting Pass-Through Credentials for JDBC Clients . 23 Connecting to TDV Server through TIBCO Spotfire . 26 Connecting to TDV Server through SQuirreL . 27 Defining a JDBC Client using a Connection URL . 28 JDBC Driver Connection URL Properties. 29 Examples . 34 Example Java JDBC Client Application Code . 34 Example of Calling Procedures . 37 Examples of Accessing Data through JDBC . 38 Examples of Accessing Data through JDBC Using Statements . 39 Examples of Accessing Data through JDBC Using Prepared Statements . 43 Tips From an Expert on Duplicate Schema Names in a Catalog. 49 Unsupported JDBC Methods . 49 Connecting to TDV Server through ODBC . .59 ODBC Driver Requirements. 60 Installing the ODBC Driver. 60 Installing the ODBC Client Driver on Windows. 60 Uninstalling the ODBC Client Driver on Windows . 62 TIBCO® Data Virtualization 6 | Contents Updating the ODBC Driver . 62 Preparing TDV Data Services for ODBC Client Connections . 62 Configuring Each Windows System Data Source Name . 63 Adding a New System DSN . 64 Override the Configured Settings . 67 Defining an ODBC Client using a Connection URL . 67 ODBC Driver Connection URL Properties . 69 Connecting Cognos to TDV Using ODBC. 74 Connecting Oracle Database Gateway to TDV Using ODBC. 75 Connecting MicroStrategy to TDV Using ODBC. 76 Connecting Tableau to TDV Using ODBC . 79 Connecting PowerBI to TDV Using ODBC . 80 Examples Using ODBC to Connect to TDV Server. 81 PERL Code Sample for Connecting to TDV Server. 81 C++ Example using the Connection URL (DSN-less connection) . 82 C++ UNIX Code Sample for Connecting to TDV Server . 84 VBA Code Sample for Connecting to TDV Server. 87 TIBCO Power BI Data Connector for TDV . 89 Overview . 89 Getting Started . 89 Installing the Connector . ..