Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

33
Simba Apache HBase ODBC Driver with SQL Connector Quickstart Guide for Windows Simba Technologies Inc. September 15, 2015

Transcript of Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Page 1: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Simba Apache HBase ODBC Driverwith SQL Connector

Quickstart Guide for Windows

Simba Technologies Inc.

September 15, 2015

Page 2: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Copyright © 2015 Simba Technologies Inc. All Rights Reserved.

Information in this document is subject to change without notice. Companies, names anddata used in examples herein are fictitious unless otherwise noted. No part of thispublication, or the software it describes, may be reproduced, transmitted, transcribed,stored in a retrieval system, decompiled, disassembled, reverse-engineered, or translatedinto any language in any form by any means for any purpose without the express writtenpermission of Simba Technologies Inc.

Trademarks

Simba, the Simba logo, SimbaEngine, SimbaEngine C/S, SimbaExpress and SimbaLibare registered trademarks of Simba Technologies Inc. All other trademarks and/orservicemarks are the property of their respective owners.

Contact Us

Simba Technologies Inc.938 West 8th AvenueVancouver, BC CanadaV5Z 1E5

Tel: +1 (604) 633-0008

Fax: +1 (604) 633-0004

www.simba.com

www.simba.com 2

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 3: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

About This Guide

Purpose

The Simba Apache HBase ODBC Driver with SQL Connector Quickstart Guide forWindows is targeted towards users of the Simba Apache HBase ODBC Driver with SQLConnector, showing you how to set up your environment quickly so that you can evaluateand use the driver.

Audience

The guide is intended for end users of the Simba Apache HBase ODBC Driver with SQLConnector who want to evaluate the driver by using it in an application.

Knowledge Prerequisites

To use the Simba Apache HBase ODBC Driver with SQL Connector, the followingknowledge is helpful:

l Familiarity with the platform on which you are using the Simba Apache HBaseODBC Driver with SQL Connector

l Ability to use the data source to which the Simba Apache HBase ODBC Driver withSQL Connector is connecting

l An understanding of the role of ODBC technologies and driver managers in con-necting to a data source

l Experience creating and configuring ODBC connectionsl Exposure to SQL

Document Conventions

Italics are used when referring to book and document titles.

Bold is used in procedures for graphical user interface elements that a user clicks and textthat a user types.

Monospace font indicates commands, source code or contents of text files.

Underline is not used.

The pencil icon indicates a short note appended to a paragraph.

The star icon indicates an important comment related to the preceding paragraph.

The thumbs up icon indicates a practical tip or suggestion.

www.simba.com 3

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 4: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Table of Contents

Setting Up Hadoop 5

Installing and Running HBase 6

Authenticating Through Kerberos 8

Importing Sample Data into HBase 9

Installing the Driver 11

Configuring the Driver 12

Connecting to the Data Source 13Using Microsoft Excel 13Using Microsoft Access 16Using Tableau 17Using Power BI 18Using Qlik Sense 19Using Qlikview 20Using SPSS Statistics 21

Contact Us 23

Appendix A Troubleshooting 24Architecture Mismatch Problems 24Known Issues when using Microsoft Office 25

Appendix B Third Party Trademarks and Licenses 27

www.simba.com 4

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 5: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Setting Up Hadoop

To use HBase, you need to have a Hadoop installation already set up.

You can download Hadoop from https://hadoop.apache.org/releases.html.

Hadoop installation guides are available at https://hadoop.apache.org/docs/current/.

Alternatively, you can download and use one of the following preconfigured Hadoopdistributions:

l Hortonworks: http://hortonworks.com/products/hortonworks-sandbox/.l Cloudera: http://www.cloudera.com/content/cloudera-content/cloudera-docs/DemoVMs/Cloudera-QuickStart-VM/cloudera_quickstart_vm.html.

l MapR: http://www.mapr.com/doc/display/MapR/Quick+Start+-+Test+Drive+MapR+on+a+Virtual+Machine.

www.simba.com 5

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 6: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Installing and RunningHBase

You can download HBase from https://www.apache.org/dyn/closer.cgi/hbase/.

HBase installation guides are available at https://hbase.apache.org/book/quickstart.html.

To run HBase and confirm that it is working correctly:1. Start Hadoop, and then open the command line interface on the machine that

Hadoop is running on.2. To see a list of the Hadoop processes currently running, run the following command:

jps

The command returns a list that looks similar to the following:2886 TaskTracker

3069 JobTracker

2783 DataNode

18762 RunJar

2670 NameNode

28042 JpsIf your Hadoop distribution is configured to use secondary name nodes, thenyou may also see a SecondaryNameNode item in the list.

3. To start HBase, run the following command:start-hbase.sh

If the command is successful, then the following line of text appears as the last line inthe Command Prompt window, where LogPath is the path to the directory wherelogs are saved:starting master, logging to LogPath

4. To start the REST service, run the following command:hbase-daemons.sh start rest

The default port is that HBase uses is 8080. To use a different port, use the–p PortNumber option in the start command, where PortNumber is thenumber of the port that you want to use.

If the command is successful, then the following line of text appears as the last line inthe Command Prompt window, where LogPath is the path to the directory wherelogs are saved:starting rest, logging to LogPath

5. To confirm that HBase is running, type the following command, where PortNumberis the port on which HBase is listening:netstat –nl | grep PortNumber

www.simba.com 6

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 7: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

The default port number for HBase is 8080.

If HBase is running correctly and listening on an open port, then a line of text similarto the following appears in the Command Prompt window, where PortNumber is theport on which HBase is listening:tcp 0 0 0.0.0.0:PortNumber 0.0.0.0:* LISTEN

www.simba.com 7

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 8: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Authenticating Through Kerberos

If the HBase server requires Kerberos authentication for access, then you must retrieve aKerberos ticket.

The following procedure assumes that you already have Kerberos set up on yourcomputer. For information about installing and configuring MIT Kerberos on yourcomputer, see the MIT Kerberos website at http://web.mit.edu/kerberos/.

To obtain a Kerberos ticket:1. Open a command prompt:

l If you are using Windows 7 or earlier, click the Start button , then click AllPrograms, then click Accessories, and then click Command Prompt.

l If you are using Windows 8 or later, click the arrow button at the bottom of theStart screen, then find the Windows System program group, and then clickCommand Prompt.

2. Run the following command, where Principal is your Kerberos principal:kinit Principal

3. To verify that you have a valid principal, run the following command, where Principalis your Kerberos principal:klist Principal

Information about your principal and the time period for which the Kerberos ticket isvalid appears in the Command Prompt window.

www.simba.com 8

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 9: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Importing Sample Data into HBase

The following procedure describes how to import some sample data if you do not alreadyhave data to use.

To import sample data into HBase:1. Download the sample data set available at http://www.simba.com/wp-

content/uploads/2013/10/FAA_HBase.zip.The sample data set is a modified version of the FAA data set. The originalFAA data set is available for download at http://www.transtats.bts.gov/DL_SelectFields.asp?Table_ID=236&DB_Short_Name=On-Time.

2. Create a new folder in a convenient location, and then extract the sample data setinto the folder.

3. Start Hadoop and HBase as directed in the respective user guides.

Documentation for Hadoop is available at https://hadoop.apache.org/docs/current/.

Documentation for HBase is available athttps://hbase.apache.org/book/quickstart.html. You can also refer to Installing andRunning HBase on page 6 for instructions for starting HBase.

4. Open a command prompt:l If you are using Windows 7 or earlier, click the Start button , then click AllPrograms, then click Accessories, and then click Command Prompt.

l If you are using Windows 8 or later, click the arrow button at the bottom of theStart screen, then find the Windows System program group, and then clickCommand Prompt.

5. In the Command Prompt window, browse to the \bin subfolder of your HBaseinstallation.

6. To create a directory in Hadoop for the data files that you are importing, run thefollowing command:hadoop fs –mkdir \user\data\faa

7. To copy the Airline.csv file to the Hadoop file system, run the following command:hadoop fs –copyFromLocal Airline.csv\user\data\faa\Airline.csv

8. To create a table in the HBase shell to hold the data from the Airline.csv file, do thefollowing:

a) To run the HBase shell, run the following command:hbase shell

b) To create the table, run the following command:create ‘Airline’, ‘c’

c) To exit the HBase shell, run the following command:

www.simba.com 9

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 10: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

quit

9. To import data from the Airline.csv file into the Hadoop file system, run the followingcommand:hbase org.apache.hadoop.hbase.mapreduce.ImportTsv'-Dimporttsv.separator=,' -Dimporttsv.columns=HBASE_ROW_KEY,c:unique_carrier,c:airline_id,c:carrier,c:tail_num,c:fl_num Airline \user\data\faa\Airline.csv

If the command runs successfully, then text similar to the following appears as thelast lines in the Command Prompt window:ImportTsv

Bad Lines=0

10.To confirm that the data was imported correctly, do the following:a) To run the HBase shell, run the following command:

hbase shell

b) To retrieve the table, run the following command:t = get_table ‘Airline’

c) To scan through the table and see the rows it contains, run the followingcommand:t.scan

If the data was imported successfully, then rows of the imported data appear in theCommand Prompt window.

www.simba.com 10

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 11: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Installing the Driver

The Simba Apache HBase ODBC Driver with SQL Connector is available for downloadfrom http://www.simba.com/connectors/apache-hbase-odbc.

On 64-bit Windows operating systems, you can execute 32- and 64-bit applicationstransparently. You must use the version of the driver matching the bitness of the clientapplication accessing data in HBase:

l SimbaHBaseODBC32.msi for 32-bit applicationsl SimbaHBaseODBC64.msi for 64-bit applications

You can install both versions of the driver on the same computer.

For an explanation of how to use ODBC on 64-bit editions of Windows, seehttp://www.simba.com/wp-content/uploads/2010/10/HOW-TO-32-bit-vs-64-bit-ODBC-Data-Source-Administrator.pdf.

To install the Simba Apache HBase ODBC Driver with SQL Connector:1. Depending on the bitness of your client application, double-click to run

SimbaHBaseODBC32.msi or SimbaHBaseODBC64.msi.2. Click Next.3. Select the check box to accept the terms of the License Agreement if you agree, and

then click Next.4. To change the installation location, click Change, then browse to the desired folder,

and then click OK. To accept the installation location, click Next.5. Click Install.6. When the installation completes, click Finish.7. If you received a license file via e-mail, then copy the license file into the \lib

subfolder in the installation folder you selected in step 4.To avoid security issues, you may need to save the license file on your localcomputer prior to copying the file into the \lib subfolder.

www.simba.com 11

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 12: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Configuring the Driver

To use the Simba Apache HBase ODBC Driver with SQL Connector, you need toconfigure a Data Source Name (DSN) to connect to your data source using a clientapplication, such as Microsoft Excel or Tableau.

To create a Data Source Name:1. Open the ODBC Administrator:

l If you are using Windows 7 or earlier, click the Start button , then click AllPrograms, then click the Simba HBase ODBC Driver program group cor-responding to the bitness of the client application accessing data in HBase,and then click ODBC Administrator.

l Or, if you are using Windows 8 or later, on the Start screen, typeODBCadministrator, and then click the ODBC Administrator search result cor-responding to the bitness of the client application accessing data in HBase.

2. Click the System DSN tab.3. Select Sample Simba HBase DSN in the list of DSNs, and then click Configure.4. In the Host field, type the IP address or host name of your HBase server.

If you are running HBase on your local computer, then type localhost in theHost field.

5. In the Port field, type the number of the port that the HBase server uses to listen forclient requests.

By default, HBase uses port 8080.

6. If your HBase data source is configured to use authentication, then select BasicAuthentication in the Mechanism list and then type your credentials in the Username and Password fields.

7. To test the connection to your HBase data source, ensure that HBase is running,and then click Test in the Simba HBase ODBC Driver DSN Setup dialog box.

The Test Results dialog box appears, displaying a message informing you whetherthe connection succeeded or failed.

8. Click OK to close the Test Results dialog box, and then click OK to save your DSNand close the Simba HBase ODBC Driver DSN Setup dialog box.

For more information about configuring the Simba Apache HBase ODBC Driverwith SQL Connector, see the Simba Apache HBase ODBC Driver with SQLConnector Installation and Configuration Guide.

www.simba.com 12

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 13: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Connecting to the Data Source

After creating a Data Source Name for connecting to your HBase data source, you canconnect to the data source using a client application. The following are a few examples ofthe applications that you can use to access your data:

l Using Microsoft Excel on page 13l Using Microsoft Access on page 16l Using Tableau on page 17l Using a Linked Server on page 1l Using Power BI on page 18l Using Qlik Sense on page 19l Using Qlikview on page 20l Using SPSS Statistics on page 21

Using Microsoft Excel

In Microsoft Excel, you can connect to HBase data by using one of the following tools:l Data Connection Wizard—Use this wizard to retrieve a table from HBase. Whenusing this wizard, you can only retrieve a single table at a time, and you cannot filterthe result set.

l Query Wizard—Use this wizard from Microsoft Query to define and run a simplequery. You can query multiple tables and columns, and sort and filter the result set.

l Microsoft Query—Work directly in the application to define and run complex quer-ies. For example, you can define parameterized queries and different types of joins.

The following procedures are written for Microsoft Excel 2013. The Simba Apache HBaseODBC Driver with SQL Connector also supports Excel 2010.

Using the Data ConnectionWizard

To connect using the Data Connection Wizard:1. In Excel, select the Data tab in the ribbon, then click From Other Sources in the

Get External Data group, and then click From Data Connection Wizard.2. In the Data Connection Wizard, select ODBC DSN in the list of data source types,

and then click Next.3. In the list of ODBC data sources, select Sample Simba HBase DSN, and then click

Next.

www.simba.com 13

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 14: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

If the connection fails, confirm that the bitness of the driver that you areusing matches the bitness of Excel. If you are using the 32-bit version ofExcel, then you need to use the 32-bit version of the driver. If you are usingthe 64-bit version of Excel, then you need to use the 64-bit version of thedriver. For more information about diagnosing the issue, see ArchitectureMismatch Problems on page 24.

4. From the list of tables, select the name of a table that you want to retrieve, and thenclick Finish.

5. In the Import Data dialog box, in the Existing Worksheet field, specify the cellwhere you want the top left corner of the selected table to be inserted, and then clickOK.

Data from the selected table is displayed in the current Excel worksheet.

Using the Query Wizard

The Query Wizard is part of Microsoft Query. When the Query Wizard is open, youcan switch from using the Query Wizard to working directly in Microsoft Query atany time by clicking Cancel and then clicking Yes at the prompt.

To connect using the Query Wizard:1. In Excel, select the Data tab in the ribbon, then click From Other Sources in the

Get External Data group, and then click From Microsoft Query.2. In the Choose Data Source dialog box, on the Databases tab, select Sample

Simba HBase DSN.3. Make sure that the Use the Query Wizard to create/edit queries check box is

selected, and then click OK.If the connection fails, confirm that the bitness of the driver that you areusing matches the bitness of Excel. If you are using the 32-bit version ofExcel, then you need to use the 32-bit version of the driver. If you are usingthe 64-bit version of Excel, then you need to use the 64-bit version of thedriver. For more information about diagnosing the issue, see ArchitectureMismatch Problems on page 24.

4. In the Query Wizard, select the tables or columns that you want to include in yourquery by selecting each item in the left pane and then clicking the > button. Whenyour selection is complete, click Next.

If the tables or columns that you want to include are not listed in the leftpane, then click Options and configure the table options as needed.

5. To filter the data in your query, select a column from the left pane, then select acomparison operator from the list, and then specify a value in the list on the right.Repeat as needed to define additional filters, and then click Next to proceed.

6. To sort the data in your query, select the column on which you want to base thesorting and then specify whether to sort the data in ascending or descending order.Repeat as needed to define additional levels of sorting, and then click Next toproceed.

www.simba.com 14

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 15: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

7. Optionally, to save the query so that you can run it again without going through theprocess of recreating it, click Save Query, type a unique name for the query, andthen click Save

8. Select Return Data To Microsoft Excel and then click FinishIf the query fails and you encounter an error message stating "Qualifiedcolumn could not be bound", then the result set may contain column namesthat are not valid in Microsoft Query. For more information, see KnownIssues when using Microsoft Office on page 25.

9. In the Import Data dialog box, in the Existing Worksheet field, specify the cell whereyou want the first column header of the result set to appear, and then click OK.

Data retrieved from the defined query is displayed in the current Excel spreadsheet.

UsingMicrosoft Query

To connect by working directly in Microsoft Query:1. In Excel, select the Data tab in the ribbon, then click From Other Sources in the

Get External Data group, and then click From Microsoft Query.2. In the Choose Data Source dialog box, on the Databases tab, select Sample

Simba HBase DSN.3. Clear the Use the Query Wizard to create/edit queries check box, and then click

OK4. In the Add Tables dialog box, select the tables that you want to include in your query

by selecting each table and then clicking Add. When your selection is complete, clickClose. If necessary, you can reopen the dialog box to add more tables by clicking

Add Table(s)If the tables that you want to include are not listed in the dialog box, thenclick Options and configure the table options as needed.

5. To define joins between your tables, in the upper pane, click and drag a field fromone table to a field in another table. You can then double-click the line between thefields to modify the join.

For detailed information about defining joins in Microsoft Query, see thesection titled Creating, Changing, and Removing Joins in the MicrosoftQuery Help documentation that is provided in the application.

6. Select the columns that you want to include in your query by double-clicking thecolumn names from the tables. You can double-click the asterisk (*) to select all thecolumns from a table.

If Auto Query is enabled, then the results of your query automaticallyappear in the lower pane. Otherwise, you must click Query Now to runthe query and see the results.

7. To filter the data in your query, click Show/Hide Criteria and then use theoptions in the criteria pane to define your filters.

www.simba.com 15

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 16: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

8. To sort the data in your query, select a column header in the lower pane and then

click Sort Ascending or Sort Descending as needed.

9. If Auto Query is disabled, then click Query Now to run your query and seethe results.

10.When you are finished defining your query, click Return Data to retrieve theresult set in Excel.

11. In the Import Data dialog box, in the Existing Worksheet field, specify the cell whereyou want the first column header of the result set to appear, and then click OK.

Data retrieved from the defined query appears in the current Excel spreadsheet.

For more information about defining complex queries using Microsoft Query, seethe Microsoft Query Help documentation that is provided in the application.

Using Microsoft Access

You can connect to HBase data by importing it into a Microsoft Access database or bycreating a table that links to the HBase data.

The following procedures are written for Microsoft Access 2013. The Simba ApacheHBase ODBC Driver with SQL Connector also supports Access 2010.

ImportingData

To import HBase data:1. In Access, select the External Data tab in the ribbon and then click

ODBC Database.2. Select Import the source data into a new table in the current database and

then click OK.3. In the Select Data Source dialog box, select the Machine Data Source tab, then

select Sample Simba HBase DSN from the list, and then click OK.If the connection fails, confirm that the bitness of the driver that you areusing matches the bitness of Access. If you are using the 32-bit version ofAccess, then you need to use the 32-bit version of the driver. If you areusing the 64-bit version of Access, then you need to use the 64-bit version ofthe driver. For more information about diagnosing the issue, seeArchitecture Mismatch Problems on page 24.

4. In the Import Objects dialog box, select the tables that you want to import, and thenclick OK.

5. In the Get External Data dialog box, select the Save import steps check box if youwant to save the import process so that you can run it again at a later time, and thenclick Close.

The tables that you selected appear in the Navigation Pane on the left.

www.simba.com 16

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 17: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

For information about known issues that you may encounter while using the SimbaApache HBase ODBC Driver with SQL Connector in Microsoft Access, seeKnown Issues when using Microsoft Office on page 25.

Linking to Data

To link to HBase data:1. In Access, select the External Data tab in the ribbon and then click

ODBC Database.2. Select Link to the data source by creating a linked table and then click OK.3. In the Select Data Source dialog box, select the Machine Data Source tab, then

select Sample Simba HBase DSN from the list, and then click OK.If the connection fails, confirm that the bitness of the driver that you areusing matches the bitness of Access. If you are using the 32-bit version ofAccess, then you need to use the 32-bit version of the driver. If you areusing the 64-bit version of Access, then you need to use the 64-bit version ofthe driver. For more information about diagnosing the issue, seeArchitecture Mismatch Problems on page 24.

4. In the Link Tables dialog box, select the tables that you want to link to, and then clickOK.

5. If the Select Unique Record Identifier dialog box opens, select the column thatcontains the unique identifiers for the rows in the table (for example, the primary keycolumn) and then click OK. You may be prompted to do this for multiple tables.

Access creates a linked table in the Navigation Pane for each HBase table that youselected.

For information about known issues that you may encounter while using the SimbaApache HBase ODBC Driver with SQL Connector in Microsoft Access, seeKnown Issues when using Microsoft Office on page 25.

Using Tableau

The following procedure is written for Tableau 8. The Simba Apache HBase ODBC Driverwith SQL Connector also supports Tableau 7.

To connect to your HBase data source using Tableau:1. In Tableau, click Connect to Data in the left navigation pane, and then selectOther

Databases (ODBC) from the bottom of the pane.2. In the DSN list, select Sample Simba HBase DSN and then click Connect.

If the connection fails, confirm that the bitness of the driver that you areusing matches the bitness of Tableau. If you are using the 32-bit version ofTableau, then you need to use the 32-bit version of the driver. If you areusing the 64-bit version of Tableau, then you need to use the 64-bit versionof the driver. For more information about diagnosing the issue, seeArchitecture Mismatch Problems on page 24.

www.simba.com 17

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 18: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

3. Select the Single Table option and then click the magnifying glass to open theSelect Table dialog box.

4. Select the name of a table that you want to retrieve, and then click Select.If the database contains a large number of tables, you may need to clickLoad to see the list of tables.

5. To load the selected table, click OK.

If the following warning is displayed, click OK:

This warning is displayed because Tableau sees only a generic driver and attemptsto determine the capabilities of the driver. The warning does not affect how the driverwill operate in Tableau.

6. In the Data Connection dialog box, click Connect live so that Tableau does notimport all of the data and you work on the data in HBase.

Data retrieved from the selected table is loaded in Tableau, with the columns listed asdimensions or measures depending on the data type. You can now create reports on thetable.

Using Power BI

You can import HBase data into Power BI Desktop through the PowerBI ODBC connector. You use a DSN connection string to connect Power BI to thedatabase. For more information about creating connection strings for the Simba ApacheHBase ODBC Driver with SQL Connector, see the Simba Apache HBase ODBC Driverwith SQL Connector Installation and Configuration Guide.

Make sure that the bitness of the driver that you are using matches the bitness ofPower BI. If you are using the 32-bit version of Power BI, then you need to use the32-bit version of the driver. If you are using the 64-bit version of Power BI, thenyou need to use the 64-bit version of the driver. For more information aboutdiagnosing the issue, see Architecture Mismatch Problems on page 24.

To retrieve data from your HBase data store using Power BI:1. In Power BI Desktop, click Get Data > More.2. In the Get Data dialog box, from the list of data sources, select ODBC and click

Connect.

www.simba.com 18

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 19: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

3. In the From ODBC dialog box, in the Connection String field, type:DSN=Sample Simba HBase DSN

4. Optionally, to specify what data is returned with a SQL statement, click SQLStatement (optional) and, in the field that is displayed, type or paste aSQL statement to specify the data.

5. Click OK. In the ODBC Driver dialog box, choose one:l If your data store requires credentials for access, then in the Usernameand Password fields, type your credentials for accessing your data store, andthen click Connect.

l Otherwise, from the column on the left, select Default or Custom and clickConnect.

6. The Navigator opens, with a list of the schemas and tables that are contained in thedata store.

If you used a SQL statement to specify what data is returned, then only thetables containing the specified data are displayed.

7. In the Navigator, select the check boxes next to the tables that you want to import,and click Load.

The selected tables are loaded into Power BI Desktop, and are listed in the Fields taskpane. You can now use Power BI to analyze the data in those tables.

For more information about connecting to a database in Power BI Desktop, seethe Power BI Help documentation that is linked from the application.

For more Power BI tutorials and how-to information, seehttp://www.simba.com/topic/power-bi.

Using Qlik Sense

You can import HBase data into a Qlik Sense app through an ODBC connection. Youspecify which tables and columns in your data store to load into Qlik Sense, and thenconstruct charts and stories to analyze and present that data.

Make sure that the bitness of the driver that you are using matches the bitness ofQlik Sense Desktop. If you are using the 32-bit version of Qlik Sense Desktop,then you need to use the 32-bit version of the driver. If you are using the 64-bitversion of Qlik Sense Desktop, then you need to use the 64-bit version of thedriver. For more information about diagnosing the issue, see ArchitectureMismatch Problems on page 24.

To retrieve data from your HBase data store using Qlik Sense:1. In Qlik Sense Desktop, from the Qlik Sense Desktop Hub, click Create New App.2. In the Create New App dialog box, type the name of your new app and click Create,

then click Open App.3. In the new app, click Add Data.

www.simba.com 19

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 20: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

4. In the Select a Data Source dialog box, make sure Connect My Data is selected,and then click ODBC.

5. In the Create New Connection (ODBC) dialog box, make sure System DSN  and thecorrect bitness for your version of Qlik Sense Desktop are selected.

6. From the list of data sources, select Sample Simba HBase DSN .7. If your data store requires credentials for access, then in the Username

and Password fields, type your credentials for accessing your data store.8. Click >.9. In the Select Data dialog box, from the list of tables, select the check box next to

each table that you want to include in your app.10.To specify which columns from each table to include in your app, select the table,

and then select the columns to include.11.When you are done selecting the tables and columns that you need, click Load and

Finish. The Select Data dialog box closes and the Data Loading dialog box opens.12.When the data has finished loading, click Edit the Sheet.

You can now use Qlik Sense to analyze the data in those tables.

For more information about connecting to a database in Qlik Sense, see the QlikSense documentation that is available at http://www.qlik.com/support/.

Using Qlikview

You can import HBase data into Qlikview through an ODBC connection. Qlikview's ScriptEditor generates a SQL script that connects to your data source and imports your data, sothat you can analyze the data in Qlikview.

Make sure that the bitness of the driver that you are using matches the bitness ofQlikview. If you are using the 32-bit version of Qlikview, then you need to use the32-bit version of the driver. If you are using the 64-bit version of Qlikview, then youneed to either use the 64-bit version of the driver, or, in the Edit Script dialog box,select the Force 32 Bit check box. For more information about diagnosing theissue, see Architecture Mismatch Problems on page 24.

To retrieve data from your HBase data store using Qlikview:1. In Qlikview, click File > New. If the Getting Started Wizard opens, close it. A new

empty document is displayed in Qlikview.2. Select File > Edit Script.3. In the Edit Script dialog box, in the Database drop-down list, make sureODBC is

selected, and click Connect.4. In the Connect to Data Source dialog box, from the Data Sources list, select

Sample Simba HBase DSN .5. If your data store requires credentials for access, then in the User ID and Password

fields, type your credentials for accessing your data store.

www.simba.com 20

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 21: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

6. To make sure your connection is working, click Test Connection and note theresults in the Connection Test dialog box.

7. Click OK. The Connect to Data Source dialog box closes and anODBC CONNECT statement is displayed in the main script area of the Edit Scriptdialog box.

8. Click Select.9. In the Create Select Statement dialog box, from the Database Tables list, select a

table that contains data that you want to analyze in Qlikview.10.From the Fields list, select the fields that contain data that you want to analyze in

Qlikview.11.To select data from another table, click Add and select the table and its fields,

selecting a different table from the Database Tables list.12.When you are done selecting the data to include in your app, click OK. The Create

Select Statement dialog box closes.13.Select File > Save Entire Document. Browse to the location where you want to

save the script, specify a file name for the script, and click Save.14.Click OK. The Edit Script dialog box closes.15.Select File > Reload.

The script is executed and the specified tables are loaded into Qlikview. You can now useQlikview to analyze the data in those tables.

For more information about connecting to a database in Qlikview, see the QlikviewHelp documentation that is linked from the application.

Using SPSS Statistics

You can import HBase data into SPSS Statistics with a standard SQL query. TheSPSS Database Wizard can automatically generate and execute an appropriate querybased on parameters you specify.

The following procedure is written for SPSS Statistics 23. The Simba Apache HBaseODBC Driver with SQL Connector also supports earlier versions of SPSS.

Make sure that the bitness of the driver that you are using matches the bitness ofSPSS. If you are using the 32-bit version of SPSS, then you need to use the 32-bitversion of the driver. If you are using the 64-bit version of SPSS, then you need touse the 64-bit version of the driver. For more information about diagnosing theissue, see Architecture Mismatch Problems on page 24.

To retrieve data from your HBase data source using SPSS:1. In SPSS Statistics, select File > Database > New Query. The Database Wizard

opens at theWelcome page.2. From the ODBC Data Source list, select Sample Simba HBase DSN.

www.simba.com 21

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 22: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

3. Under Select the table types, select the check boxes corresponding to the types oftables you want to retrieve and then click Next.

4. On the Select Data page, select and order the tables and fields that you want toretrieve and then click Next.

5. If you selected more than one table, then on the Specify Relationships page, specifyhow the tables should be joined and then click Next.

6. On the Limit Retrieved Cases page, specify how to limit the data you retrieve andthen click Next.

7. On the Define Variables page, specify how SPSS should define those variables andthen click Next.

8. On the Results page, review the generated SQL.9. Make sure that Retrieve the data I have selected is selected and then click

Finish.

Data retrieved from the selected tables is displayed in SPSS Statistics in a new Datasetwindow. You can now use SPSS Statistics to analyze the data.

For more information about connecting to a database in SPSS Statistics, see theSPSS Statistics Help documentation that is provided in the application.

www.simba.com 22

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 23: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Contact Us

If you have difficulty using the driver, please contact our Technical Support staff. Wewelcome your questions, comments, and feature requests.

Technical Support is available Monday to Friday from 8 a.m. to 6 p.m. Pacific Time.

To help us assist you, prior to contacting Technical Support please prepare adetailed summary of the client and server environment including operating systemversion, patch level, and configuration.

You can contact Technical Support via:l E-mail—[email protected] Web site—www.simba.coml Telephone—(604) 633-0008 Extension 3l Fax—(604) 633-0004

You can also follow us on Twitter @SimbaTech

www.simba.com 23

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 24: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Appendix A Troubleshooting

Architecture Mismatch Problems

If you encounter an error message similar to "The specified DSN contains an architecturemismatch between the Driver and Application", then the bitness of the application you areusing to attempt to connect to the HBase data source does not match the bitness of thedriver that you are using. You may be attempting to connect a 32-bit application to a 64-bitdriver, or vice versa. Ensure that the bitness of your application matches the bitness ofdriver that you are trying to use.

Applications in Microsoft Office 2007 and earlier are 32-bit only.

To determine the bitness of an application:1. Open the About dialog box for the application. For example, to open the About dialog

box for Microsoft Office 2013 products, click the File tab in the ribbon, then clickAccount in the left pane, and then click the About Application button (whereApplication is the application name).

2. In the About dialog box, look for the words 32-bit or 64-bit:l If the About dialog box contains 32-bit then you must use a 32-bit driver to con-nect to that application.

l If the About dialog box contains 64-bit then you must use a 64-bit driver to con-nect to that application.

For example, the following image shows the About dialog box for a 32-bit version ofMicrosoft Excel 2013.

www.simba.com 24

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 25: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Known Issues when using Microsoft Office

The following are known issues that you may encounter when using Microsoft Query orMicrosoft Access to work with your data.

Invalid Primary Keys

In Microsoft Access, if a table contains cells that show #Deleted as the value instead of theexpected data value, then the table may be using an invalid primary key. To diagnose thisissue, check the primary key values in the table and the data type of the primary keycolumn, and verify if either of the following situations apply.

Primary Key Value is not Unique

Access does not allow primary keys to be used by more than one row in the same table.Each primary key in a table must be unique.

www.simba.com 25

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 26: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

To resolve this issue, ensure that the table does not contain any rows that share the sameprimary key value.

Primary Key Column is of an Unsupported Type

Access does not support the following data types for primary key columns:l SQL_BIGINTl SQL_WCHARl SQL_WVARCHARl SQL_WLONGVARCHAR

To resolve this issue, convert the column to another data type, such as SQL_INTEGER orSQL_CHAR.

Invalid Column Names

In Microsoft Access, if you encounter an error message stating "ColumnName is not a validname" (where ColumnName is the name of a column in your result set), then the columnname contains special characters that are not supported by the application.

In Microsoft Query, this issue returns an error message stating "Qualified column could notbe bound".

The issue may be caused by the separator characters that the driver uses whengenerating a schema. To resolve this issue, change the ODBC column name in theschema to a valid name, based on the following guidelines:

l The column name starts with a letter of the alphabet or an underscore (_).l The column name only contains characters that are a letter of the alphabet, a num-ber, or an underscore (_).

To rename columns in the schema:1. In the Schema Editor, open the local file containing the schema that you are using for

the connection.2. In the left pane, select the table containing the column that has the invalid name.3. In the lower area of the right pane, find the column that has the invalid name, and

then change the dsiiName value to a valid column name.The dsiiName value is the column name that will be exposed in theODBC layer.

4. Save the schema file.

After reconnecting to the data source using the new schema, you should be able toretrieve the column successfully.

For more information about using the Schema Editor, see the Schema Editor UserGuide.

www.simba.com 26

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 27: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Appendix B Third Party Trademarks and Licenses

Third Party Trademarks

Apache HBase, Apache, and HBase are trademarks of The Apache Software Foundationor its subsidiaries in Canada, United States and/or other countries.

Microsoft SQL Server, SQL Server, Microsoft, Access, Excel, Power BI, MSDN, Windows,Windows Server, Windows Vista, and the Windows start button are trademarks orregistered trademarks of Microsoft Corporation or its subsidiaries in Canada, UnitedStates and/or other countries.

Tableau and the Tableau logo are trademarks or registered trademarks of TableauSoftware, Inc. or its subsidiaries in Canada, United States and/or other countries.

MicroStrategy, MicroStrategy 10, and MicroStrategy Developer are trademarks orregistered trademarks of MicroStrategy, Inc. or its subsidiaries in Canada, United Statesand/or other countries.

SPSS and SPSS Statistics are trademarks or registered trademarks of IBM Corporationor its subsidiaries in Canada, United States, and/or other countries.

All other trademarks are trademarks of their respective owners.

Third Party Licenses

cURL

COPYRIGHT AND PERMISSION NOTICE

Copyright (c) 1996 - 2015, Daniel Stenberg, [email protected].

All rights reserved.

Permission to use, copy, modify, and distribute this software for any purpose with orwithout fee is hereby granted, provided that the above copyright notice and this permissionnotice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE ANDNONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OROTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OROTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWAREOR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

www.simba.com 27

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 28: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

Except as contained in this notice, the name of a copyright holder shall not be used inadvertising or otherwise to promote the sale, use or other dealings in this Software withoutprior written authorization of the copyright holder.

dtoa License

The author of this software is David M. Gay.

Copyright (c) 1991, 2000, 2001 by Lucent Technologies.

Permission to use, copy, modify, and distribute this software for any purpose without fee ishereby granted, provided that this entire notice is included in all copies of any softwarewhich is or includes a copy or modification of this software and in all copies of thesupporting documentation for such software.

THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS ORIMPLIED WARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR LUCENTMAKES ANY REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THEMERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULARPURPOSE.

Expat

Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd

Permission is hereby granted, free of charge, to any person obtaining a copy of thissoftware and associated documentation files (the "Software"), to deal in the Softwarewithout restriction, including without limitation the rights to use, copy, modify, merge,publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons towhom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies orsubstantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE ANDNOINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHTHOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHERDEALINGS IN THE SOFTWARE.

Google Protocol Buffers License

This license applies to all parts of Protocol Buffers except the following:l Atomicops support for generic gcc, located in src/google/protobuf/stubs/atomicops_internals_generic_gcc.h.This file is copyrighted by Red Hat Inc.

www.simba.com 28

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 29: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

l Atomicops support for AIX/POWER, located in src/-google/protobuf/stubs/atomicops_internals_aix.h.This file is copyrighted by Bloomberg Finance LP.

Copyright 2014, Google Inc. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, arepermitted provided that the following conditions are met:

l Redistributions of source code must retain the above copyright notice, this list of con-ditions and the following disclaimer.

l Redistributions in binary form must reproduce the above copyright notice, this list ofconditions and the following disclaimer in the documentation and/or other materialsprovided with the distribution.

l Neither the name of Google Inc. nor the names of its contributors may be used toendorse or promote products derived from this software without specific prior writtenpermission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ANDCONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORSBE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENTOF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; ORBUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Code generated by the Protocol Buffer compiler is owned by the owner of the input fileused when generating it. This code is not standalone and requires a support library to belinked with it. This support library is itself covered by the above license.

ICU License - ICU 1.8.1 and later

COPYRIGHT AND PERMISSION NOTICE

Copyright (c) 1995-2014 International Business Machines Corporation and others

All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of thissoftware and associated documentation files (the "Software"), to deal in the Softwarewithout restriction, including without limitation the rights to use, copy, modify, merge,publish, distribute, and/or sell copies of the Software, and to permit persons to whom theSoftware is furnished to do so, provided that the above copyright notice(s) and thispermission notice appear in all copies of the Software and that both the above copyrightnotice(s) and this permission notice appear in supporting documentation.

www.simba.com 29

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 30: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE ANDNONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THECOPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FORANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, ORANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA ORPROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHERTORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE ORPERFORMANCE OF THIS SOFTWARE.

Except as contained in this notice, the name of a copyright holder shall not be used inadvertising or otherwise to promote the sale, use or other dealings in this Software withoutprior written authorization of the copyright holder.

All trademarks and registered trademarks mentioned herein are the property of theirrespective owners.

OpenSSL

Copyright (c) 1998-2011 The OpenSSL Project. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, arepermitted provided that the following conditions are met:1. Redistributions of source code must retain the above copyright notice, this list of

conditions and the following disclaimer.2. Redistributions in binary form must reproduce the above copyright notice, this list of

conditions and the following disclaimer in the documentation and/or other materialsprovided with the distribution.

3. All advertising materials mentioning features or use of this software must display thefollowing acknowledgment:

"This product includes software developed by the OpenSSL Project for use in theOpenSSL Toolkit. (http://www.openssl.org/)"

4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorseor promote products derived from this software without prior written permission. Forwritten permission, please contact [email protected].

5. Products derived from this software may not be called "OpenSSL" nor may"OpenSSL" appear in their names without prior written permission of the OpenSSLProject.

6. Redistributions of any form whatsoever must retain the following acknowledgment:

"This product includes software developed by the OpenSSL Project for use in theOpenSSL Toolkit (http://www.openssl.org/)"

THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT "AS IS" AND ANYEXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THEIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

www.simba.com 30

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 31: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITSCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITEDTO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, ORTORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OFTHE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCHDAMAGE.

Original SSLeay License

Copyright (C) 1995-1998 Eric Young ([email protected])

All rights reserved.

This package is an SSL implementation written by Eric Young ([email protected]). Theimplementation was written so as to conform with Netscapes SSL.

This library is free for commercial and non-commercial use as long as the followingconditions are aheared to. The following conditions apply to all code found in thisdistribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSLdocumentation included with this distribution is covered by the same copyright termsexcept that the holder is Tim Hudson ([email protected]).

Copyright remains Eric Young's, and as such any Copyright notices in the code are not tobe removed. If this package is used in a product, Eric Young should be given attribution asthe author of the parts of the library used. This can be in the form of a textual message atprogram startup or in documentation (online or textual) provided with the package.

Redistribution and use in source and binary forms, with or without modification, arepermitted provided that the following conditions are met:1. Redistributions of source code must retain the copyright notice, this list of conditions

and the following disclaimer.2. Redistributions in binary form must reproduce the above copyright notice, this list of

conditions and the following disclaimer in the documentation and/or other materialsprovided with the distribution.

3. All advertising materials mentioning features or use of this software must display thefollowing acknowledgement:

"This product includes cryptographic software written by Eric Young([email protected])"

The word 'cryptographic' can be left out if the rouines from the library being used arenot cryptographic related :-).

4. If you include any Windows specific code (or a derivative thereof) from the appsdirectory (application code) you must include an acknowledgement:

"This product includes software written by Tim Hudson ([email protected])"

www.simba.com 31

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 32: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND ANY EXPRESS ORIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULARPURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR ORCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITEDTO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, ORTORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OFTHE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCHDAMAGE.

The licence and distribution terms for any publically available version or derivative of thiscode cannot be changed. i.e. this code cannot simply be copied and put under anotherdistribution licence [including the GNU Public Licence.]

Stringencoders License

Copyright 2005, 2006, 2007

Nick Galbreath -- nickg [at] modp [dot] com

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, arepermitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list ofconditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list ofconditions and the following disclaimer in the documentation and/or other materialsprovided with the distribution.

Neither the name of the modp.com nor the names of its contributors may be used toendorse or promote products derived from this software without specific prior writtenpermission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ANDCONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORSBE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENTOF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; ORBUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

www.simba.com 32

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows

Page 33: Simba Apache HBase ODBC Driver with SQL Connector Guide for ...

This is the standard "new" BSD license:

http://www.opensource.org/licenses/bsd-license.php

www.simba.com 33

Simba Apache HBase ODBC Driver withSQL Connector Quickstart Guide for Windows