31
Simba Amazon DynamoDB ODBC Driver with SQL Connector Quickstart Guide for Windows Simba Technologies Inc. September 15, 2015

SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

Simba AmazonDynamoDBODBCDriver with SQL Connector

Quickstart Guide for Windows

Simba Technologies Inc.

September 15, 2015

Page 2: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 3: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

About This Guide

Purpose

The Simba Amazon DynamoDB ODBC Driver with SQL Connector Quickstart Guide forWindows is targeted towards users of the Simba Amazon DynamoDB ODBC Driver withSQL Connector, showing you how to set up your environment quickly so that you canevaluate and use the driver.

Audience

The guide is intended for end users of the Simba Amazon DynamoDB ODBC Driver withSQL Connector who want to evaluate the driver by using it in an application.

Knowledge Prerequisites

To use the Simba Amazon DynamoDB ODBC Driver with SQL Connector, the followingknowledge is helpful:

l Familiarity with the platform on which you are using the Simba Amazon DynamoDBODBC Driver with SQL Connector

l Ability to use the data source to which the Simba Amazon DynamoDB ODBC Driverwith SQL 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 Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 4: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

Table of Contents

Accessing DynamoDB 5

Installing the Driver 6

Configuring the Driver 7Creating a DSN for Connecting to DynamoDB on AWS 7Creating a DSN for Connecting to DynamoDB Local 8

Connecting to the Data Source 10Using Microsoft Excel 10Using Microsoft Access 13Using Tableau 14Using Power BI 15Using Qlik Sense 16Using Qlikview 17Using SPSS Statistics 18

Contact Us 20

Appendix A Troubleshooting 21Architecture Mismatch Problems 21Known Issues when using Microsoft Office 22

Appendix B Third Party Trademarks and Licenses 24

www.simba.com 4

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 5: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

AccessingDynamoDB

For the purposes of this Quickstart Guide for Windows, it is assumed that you already havean Amazon Web Services (AWS) account and a DynamoDB that you can query, or aDynamoDB Local server that you can query.

For information about accessing the DynamoDB service, see Getting Started with AmazonDynamoDB in the AWS documentation located athttps://aws.amazon.com/dynamodb/getting-started/.

For information about installing, configuring, and running DynamoDB Local, seeDynamoDB Local in the AWS documentation located athttp://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tools.DynamoDBLocal.html.

www.simba.com 5

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 6: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

Installing the Driver

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 DynamoDB:

l SimbaDynamoDBODBC32.msi for 32-bit applicationsl SimbaDynamoDBODBC64.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 Amazon DynamoDB ODBC Driver with SQL Connector:1. Depending on the bitness of your client application, double-click to run

SimbaDynamoDBODBC32.msi or SimbaDynamoDBODBC64.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 6

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 7: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

Configuring the Driver

To use the Simba Amazon DynamoDB 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.

Connections to the DynamoDB service on AWS require different DSN settings comparedto connections to DynamoDB Local. Follow the procedure that corresponds to the type ofdata source you are connecting to.

Creating a DSN for Connecting to DynamoDB on AWS

To create a DSN for connecting to the DynamoDB service on AWS: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 DynamoDB ODBC Driver program groupcorresponding to the bitness of the client application accessing data inDynamoDB, and then click ODBC Administrator.

l If you are using Windows 8 or later, on the Start screen, typeODBC admin-istrator, and then click the ODBC Administrator search result cor-responding to the bitness of the client application accessing data inDynamoDB.

2. Click the System DSN tab.3. Select Sample Simba DynamoDB DSN in the list of DSNs, and then click

Configure.4. In the Host field, type the URL (the endpoint) for the DynamoDB service.5. Make sure that the DynamoDB Local check box is cleared.6. In the Authentication area, in the Region field, type the AWS region to which you

want to connect.7. Select IAM Credentials.8. In the Access Key field, type your access key ID for connecting to the DynamoDB

service.9. In the Secret Key field, type the secret access key corresponding to your access key

ID.10. If you are using temporary security credentials, select the Temporary Session

Token check box and then copy and paste your session token into the field.Otherwise, leave the check box cleared.

11.To create a schema file and configure the driver to use it when connecting to thedata source, do the following:

a) Click Schema Definition.

www.simba.com 7

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 8: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

b) Click Browse, then browse to the directory where you want to store theschema file, and then type a name for the file and click Save.

c) Click Generate All.d) After the driver finishes generating the schema, click OK to close the Schema

Definition dialog box. If you are prompted to confirm whether you want to closethe dialog box without updating the database metadata, click Yes.

e) In the Simba DynamoDB ODBC Driver DSN Setup dialog box, clickAdvanced Options.

f) In the Advanced Options dialog box, select Local file and then specify the fullpath of the JSON file from step b.

g) To save your settings and close the Advanced Options dialog box, click OK.12.To test the connection to your DynamoDB data source, click the Test button in the

Simba DynamoDB ODBC Driver DSN Setup dialog box.The Test Results dialog box appears, displaying a message informing you if theconnection succeeded or failed.

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

For more information about configuring the Simba Amazon DynamoDB ODBCDriver with SQL Connector, including how to configure different authenticationmethods and modify the schema defined for the DynamoDB data source, refer tothe Simba Amazon DynamoDB ODBC Driver with SQL Connector Installation andConfiguration Guide.

Creating a DSN for Connecting to DynamoDB Local

To create a DSN for connecting to DynamoDB Local: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 DynamoDB ODBC Driver program groupcorresponding to the bitness of the client application accessing data inDynamoDB, and then click ODBC Administrator.

l If you are using Windows 8 or later, on the Start screen, typeODBC admin-istrator, and then click the ODBC Administrator search result cor-responding to the bitness of the client application accessing data inDynamoDB.

2. Click the System DSN tab.3. Select Sample Simba DynamoDB DSN in the list of DSNs, and then click

Configure.4. In the Host field, type the IP address of the server.5. Select the DynamoDB Local check box.6. In the Port field, type the number of the port used by the server.

www.simba.com 8

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 9: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

The default port number used by DynamoDB Local is 8000.

7. To create a schema file and configure the driver to use it when connecting to thedata source, do the following:

a) Click Schema Definition.b) Click Browse, then browse to the directory where you want to store the

schema file, and then type a name for the file and click Save.c) Click Generate All.d) After the driver finishes generating the schema, click OK to close the Schema

Definition dialog box. If you are prompted to confirm whether you want to closethe dialog box without updating the database metadata, click Yes.

e) In the Simba DynamoDB ODBC Driver DSN Setup dialog box, clickAdvanced Options.

f) In the Advanced Options dialog box, select Local file and then specify the fullpath of the JSON file from step b.

g) To save your settings and close the Advanced Options dialog box, click OK.8. To test the connection to your DynamoDB data source, click the Test button in the

Simba DynamoDB ODBC Driver DSN Setup dialog box.The Test Results dialog box appears, displaying a message informing you if theconnection succeeded or failed.

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

For more information about configuring the Simba Amazon DynamoDB ODBCDriver with SQL Connector, including how to modify the schema defined for theDynamoDB data source, refer to the Simba Amazon DynamoDB ODBC Driverwith SQL Connector Installation and Configuration Guide.

www.simba.com 9

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 10: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

Connecting to the Data Source

After creating a Data Source Name for connecting to your DynamoDB data source, youcan connect to the data source using a client application. The following are a few examplesof the applications that you can use to access your data:

l Using Microsoft Excel on page 10l Using Microsoft Access on page 13l Using Tableau on page 14l Using a Linked Server on page 1l Using Power BI on page 15l Using Qlik Sense on page 16l Using Qlikview on page 17l Using SPSS Statistics on page 18

Using Microsoft Excel

In Microsoft Excel, you can connect to DynamoDB data by using one of the following tools:l Data Connection Wizard—Use this wizard to retrieve a table from DynamoDB.When using this wizard, you can only retrieve a single table at a time, and you cannotfilter the 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 AmazonDynamoDB ODBC 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 Simba DynamoDB DSN, and then click

Next.

www.simba.com 10

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 11: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 21.

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 Simba

DynamoDB 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 21.

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 11

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 12: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 22.

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 Simba

DynamoDB 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 12

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 13: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 DynamoDB data by importing it into a Microsoft Access database or bycreating a table that links to the DynamoDB data.

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

ImportingData

To import DynamoDB 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 Simba DynamoDB 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 21.

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 13

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 14: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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

Linking to Data

To link to DynamoDB 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 Simba DynamoDB 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 21.

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 DynamoDB table that youselected.

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

Using Tableau

The following procedure is written for Tableau 8. The Simba Amazon DynamoDB ODBCDriver with SQL Connector also supports Tableau 7.

To connect to your DynamoDB 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 Simba DynamoDB 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 21.

www.simba.com 14

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 15: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 DynamoDB.

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 DynamoDB 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 AmazonDynamoDB ODBC Driver with SQL Connector, see the Simba Amazon DynamoDB ODBCDriver with 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 21.

To retrieve data from your DynamoDB 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 15

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 16: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

3. In the From ODBC dialog box, in the Connection String field, type:DSN=Simba DynamoDB 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 DynamoDB 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 21.

To retrieve data from your DynamoDB 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 16

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 17: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 DynamoDB 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 DynamoDB data into Qlikview through an ODBC connection. Qlikview'sScript Editor generates a SQL script that connects to your data source and imports yourdata, so that 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 21.

To retrieve data from your DynamoDB 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 DynamoDB 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 17

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 18: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 DynamoDB 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 Amazon DynamoDBODBC 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 21.

To retrieve data from your DynamoDB 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 DynamoDB DSN .

www.simba.com 18

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 19: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 19

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 20: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 20

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 21: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 DynamoDB data source does not match the bitness ofthe driver that you are using. You may be attempting to connect a 32-bit application to a64-bit driver, or vice versa. Ensure that the bitness of your application matches the bitnessof driver 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 21

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 22: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 22

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 23: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 23

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 24: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

Appendix B Third Party Trademarks and Licenses

Third Party Trademarks

Amazon DynamoDB, Amazon, and DynamoDB are trademarks or registered trademarksof Amazon Web Services, Inc. or its subsidiaries in Canada, United States and/or othercountries.

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 24

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 25: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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.

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.

www.simba.com 25

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 26: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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.

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.

www.simba.com 26

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 27: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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 PARTICULARPURPOSE 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:

www.simba.com 27

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 28: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

"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])"

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.]

rapidjson

Tencent is pleased to support the open source community by making RapidJSONavailable.

Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rightsreserved.

If you have downloaded a copy of the RapidJSON binary from Tencent, please note thatthe RapidJSON binary is licensed under the MIT License.

If you have downloaded a copy of the RapidJSON source code from Tencent, please notethat RapidJSON source code is licensed under the MIT License, except for the third-partycomponents listed below which are subject to different license terms. Your integration ofRapidJSON into your own projects may require compliance with the MIT License, as wellas the other licenses applicable to the third-party components included within RapidJSON.To avoid the problematic JSON license in your own projects, it's sufficient to exclude thebin/jsonchecker/ directory, as it's the only code under the JSON license.

A copy of the MIT License is included in this file.

Other dependencies and licenses:

Open Source Software Licensed Under the BSD License:

www.simba.com 28

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 29: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

The msinttypes r29Copyright (c) 2006-2013 Alexander ChemerisAll rights reserved.

Redistribution and use in source and binary forms, with or withoutmodification, are permitted provided that the following conditions are met:

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

l Redistributions in binary form must reproduce the above copyrightnotice, this list of conditions and the following disclaimer in the doc-umentation and/or other materials provided with the distribution.

l Neither the name of copyright holder nor the names of its contributorsmay be used to endorse or promote products derived from this softwarewithout specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE REGENTS ANDCONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR APARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THEREGENTS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIALDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OFSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICTLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Open Source Software Licensed Under the JSON License:

json.orgCopyright (c) 2002 JSON.orgAll Rights Reserved.

JSON_checkerCopyright (c) 2002 JSON.orgAll Rights Reserved.

Terms of the JSON License:

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

www.simba.com 29

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 30: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.

The Software shall be used for Good, not Evil.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANYKIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THEWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OFCONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR INCONNECTION WITH THE SOFTWARE OR THE USE OR OTHERDEALINGS IN THE SOFTWARE.

Terms of the MIT License:

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

The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANYKIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THEWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OFCONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR INCONNECTION WITH THE SOFTWARE OR THE USE OR OTHERDEALINGS IN THE SOFTWARE.

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.

www.simba.com 30

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows

Page 31: SimbaAmazonDynamoDBODBC DriverwithSQLConnector ...€¦ · InstallingtheDriver On64-bitWindowsoperatingsystems,youcanexecute32-and64-bitapplications transparently.Youmustusetheversionofthedrivermatchingthebitnessoftheclient

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.

This is the standard "new" BSD license:

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

zlib License

Copyright (C) 1995-2013 Jean-loup Gailly and Mark Adler

This software is provided 'as-is', without any express or implied warranty. In no event willthe authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, includingcommercial applications, and to alter it and redistribute it freely, subject to the followingrestrictions:1. The origin of this software must not be misrepresented; you must not claim that you

wrote the original software. If you use this software in a product, an acknowledgmentin the product documentation would be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not bemisrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

Jean-loup Gailly Mark Adler

[email protected] [email protected]

www.simba.com 31

Simba Amazon DynamoDB ODBC Driverwith SQL Connector Quickstart Guide for Windows