Professional Documents
Culture Documents
HP Vertica 7.1.x MS Connectivity Pack
HP Vertica 7.1.x MS Connectivity Pack
Legal Notices
Warranty
The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be
construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Copyright Notice
Copyright 2006 - 2015 Hewlett-Packard Development Company, L.P.
Trademark Notices
Adobe is a trademark of Adobe Systems Incorporated.
Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.
UNIX is a registered trademark of The Open Group.
Page 2 of 31
Contents
Contents
Introduction
Installation
System Prerequisites
Operating System
.NET Framework
9
9
10
10
11
Microsoft Components
12
13
13
13
14
14
16
16
SSAS Limitations
16
SSIS Limitations
16
SSRS Limitations
18
General Limitations
20
22
31
Page 3 of 31
Introduction
The HP Vertica Connectivity Pack for Microsoft is a package you download from HP Vertica that
allows you to integrate your HP Vertica server with an environment that includes Microsoft
components previously installed on your system. The Connectivity Pack includes the ADO.NET
and OLE DB client drivers and additional tools for integration with Microsoft Visual Studio and
Microsoft SQL Server.
Specifically, the Connectivity Pack is an enhanced .NET data provider package and provides
integration with the following Microsoft components:
l
Business Intelligence Development Studio (BIDS) for Visual Studio 2008 for use with SQL
Server 2012. BIDS is a client-based application used to develop business intelligence solutions
and based on the Microsoft Visual Studio development environment. It includes additional
project types specific to SQL Server Business Intelligence. As a developer, you can use BIDS
to develop business solutions.
SQL Server Data Tool - Business Intelligence (SSDT-BI) for Visual Studio 2010/2012 for use
with SQL Server 2012. SSDT-BI replaces BIDS for Visual Studio 2010 and 2012. It serves the
same purpose as BIDS, providing a development environment for developing business
intelligence solutions.
SQL Server Analysis Services (SSAS) for SQL Server 2008 and 2012. Use SSAS for OLAP and
data mining, while using HP Vertica as the source for cube creation.
SQL Server Integration Services (SSIS) for SQL Server 2008 and 2012. SSIS provides SQL
Server Type Mappings to map data types between HP Vertica and SQL Server. Use SSIS for
data migration, data integration and workflow, and ETL.
Page 4 of 31
The HP Vertica Connectivity Pack for Microsoft is available in both 32-bit and 64-bit versions.
Download the Connectivity Pack that matches your operating system (32-bit or 64-bit).
Page 5 of 31
Installation
HP Vertica offers both client- and server-side plug-in components. You need these components to
develop and implement the Microsoft Business Intelligence capabilities.
When you download and install the HP Vertica Connectivity Pack for Microsoft and launch the
installer:
l
The installer detects the Microsoft components that are installed on your system. You choose
the integration features from the Connectivity Pack that you want to install.
If you do not have a version of Visual Studio or SQL Server installed on your system,you do not
have the option of installing the Connectivity Pack features associated with those Microsoft
products.
If you have neither Visual Studio nor SQL Server on your system, the installer installs only the
ADO.NET and OLE DB drivers. In this case, other optional contents within the Connectivity
Pack are not visible when you install.
The Vertica Data Provider - InstallShield Wizard displays only those items related to the Microsoft
products already installed on your system.
If you are installing on a system that includes all of the Microsoft components, the following items
are pre-selected during installation. Review the list, and deselect those items that you do not want
to install.
SQL Server 2008 Integration
SQL Server Analysis Services Integration 64 bit
SQL Server Type Mappings
Page 6 of 31
System Prerequisites
The HP Vertica Microsoft Connectivity Pack released with HP Vertica Release 7.0 or later has
basic system prerequisite requirements. The pack also requires that specific Microsoft components
be installed for full integration.
For a list of all prerequisites, see the Supported Platforms document located at
http://www.vertica.com/documentation.
Operating System
The HP Vertica Connectivity Pack for Microsoft 7.1.x requires a supported Windows operating
system. You can find the list of supported Windows versions in the Supported Platforms document
a http://www.vertica.com/documentation.
.NET Framework
The .NET framework is not bundled into the HP Vertica Connectivity Pack for Microsoft. However,
during Connectivity Pack installation, a web installer launches if Microsoft .NET 3.5 SP1 is not
detected on your system. You then have the opportunity to download the framework. Also, if your
operating system version includes .NET 3.5 SP1, but it is not turned on, the installer turns on the
feature.
You can find the requirements for the .NET framework for the HP Vertica Connectivity Pack for
Microsoft in the Supported Platforms document at http://www.vertica.com/documentation.
If you have Visual Studio 2010 or 2012 installed, your system already includes Microsoft .NET
Framework 4.0 or 4.5, respectively. You also need Microsoft .NET 3.5 SP1 to use the HP Vertica
Connectivity Pack for Microsoft integration features.
Page 7 of 31
Use the following links to download the appropriate version of .NET framework directly from
Microsoft:
l
Page 8 of 31
http://www.microsoft.com/en-us/download/details.aspx?id=21835
l
SQL Server using Visual Studio 2008 Business Intelligence Development Studio (BIDS)
SQL Server using Visual Studio 2010 and 2012 SQL Server Data Tool - Business
Intelligence (SSDT-BI)
Note: For SQL Server 2012, you can use either SQL Server 2012 or SQL Server 2012 SP1.
Page 9 of 31
To use the enhanced HP Vertica.NET data provider, you must install SQL Server first. Then, you
can install the Connectivity Pack for Microsoft. The following components must be installed on the
SQL server:
For...
Install...
SSAS
SSRS
Page 10 of 31
You must have the appropriate Visual Studio SDK on your system to use the integration
pack features for Visual Studio (such as using the HP Vertica plug-in).
If the SDK is not detected on your system during installation, you are prompted with two
choices:
o
Continue installation without the SDK (if you do not plan to use Visual Studio integration
features)
4. Verify that the integration features you want to install are selected, and click Next.
n
Features automatically selected for installation depend on which Microsoft components are
already installed on the server.
Whether features appear as options during installation depends upon the Microsoft
components installed on your server.
If the prerequisite software is not installed, then the additional Connectivity Pack features
are not shown. See System Prerequisites for details on optional prerequisites for the HP
Vertica Microsoft Connectivity Pack.
Note:The ADO.NET and OLE DB drivers are installed, respectively, in the ADO.NET and OLE
DB folders of the installation folder. The ADO.NET driver is also installed into the Windows
Global Assembly Cache (GAC).
Page 11 of 31
Page 12 of 31
Microsoft Components
This section describes the Microsoft Business Intelligence components you can use with Microsoft
Visual Studio and Microsoft SQL Server. After configuration, you can use these Microsoft
components to develop business solutions using your HP Vertica server.
You cannot use Microsoft Visual Studio 2008 with BIDS development to create a SQL Server
2012 Business Intelligence solution.
You cannot use Microsoft Visual Studio 2010/2012 with SSDT-BI development to create a SQL
Server 2008 Business Intelligence solution.
Page 13 of 31
Cubes
Dimensions
Data sources
Packages
Data sources
Page 14 of 31
You can use HP Vertica as a data source for Reporting Services. The installer implements various
configuration file modifications to enable this capability on both the BIDS or SSDT-BI workstation
and the Reporting Services server.
Page 15 of 31
SSAS Limitations
Restart SSAS after installing the HP Vertica Microsoft Connectivity Pack
If, after installing the HP Vertica Microsoft Connectivity Pack, an SSAS cube build fails, restart the
SSAS service.
Tabular Model not supported
The SSAS Tabular Model is not supported.
SSIS Limitations
Data Type Limitations
Consider the following data type limitations when using SQL Server Integration Services (SSIS).
l
Page 16 of 31
To function without errors, DATE and DATETIME range falls is from 0001-01-01
00:00:00.0000000 to 9999-12-31 23:59:59.999999.
In SSIS, the DATETIME type (DT_TIMESTAMP) supports only a scale up to three decimal
places for the seconds. Any decimal places after that are automatically discarded. You can
perform derived column transformations only on DATETIME values between January 1, 1753
through December 31, 9999.
l
Numeric
The maximum and minimum decimal allowed is:
Max: +79,228,162,514,264,337,593,543,950,335
Min: -79,228,162,514,264,337,593,543,950,335
For example, if the scale is 16, the range of values is:
+/- 7,922,816,251,426.4337593543950335
The valid scale range is any number that is smaller than 29 and greater than 38. Using a scale
between 29 and 38 does not generate an error.
See : http://msdn.microsoft.com/en-us/library/system.decimal.maxvalue.aspx
Character
The CHAR and VARCHAR data types used in SSIS is DT_WSTR, with a maximum length of
4000 characters.
In SSIS, HP Vertica strings are converted to Unicode strings in SSIS to handle multi-lingual
data. You can convert these strings to ASCII using a Data Conversion Task.
Floating Point
SQL Server does not support NaN, Infinity, or Infinity values. These values are supported
when you use SSIS to transfer between HP Vertica instances, but they are not supported with a
SQL Server Destination.
Scale
Whenever you use a scale greater than 38, SSIS replaces it with a value of 4.
Interval
Page 17 of 31
SSIS does not support interval types. It converts them to TIME and strips off the day
component. Any package that has interval types greater than a day returns incorrect results.
Data Mapping when Using the SQL Server Import and Export Wizard
When you create an Integrated Services package (SSIS) using the SQL Server Import and Export
Wizard, certain data types do not automatically map correctly. A mapping issue can occur when
you use the wizard with:
l
SQL Server Native OLE DB Provider for SQL Server 2008 or 2012
SQL Server Native Client 10.0/11.0 Provider for SQL Server 2010/2012
To avoid this issue, you can manually change the type mappings using either BIDS or SSDT-BI.
Data Transfer of Certain Data Types
When using an Integrated Services package (SSIS) with the SQL Server OLE DB Provider for SQL
Server 2008 or 2012, certain data type transfers can fail when transferring from HP Vertica to SQL
Server. To avoid this issue, use either BIDS or SSDT-BI when transferring data.
Batch Insert of Varbinary or Long Varbinary Data Types
Sometimes, one row of a batch insert of varbinary or long varbinary data types exceeds the data
type limit:
l
Varbinary 65 KB
Long Binary 32 MB
In such cases, all rows are rejected, rather than just the one row whose length exceeds the type
limit. The batch insert fails with the message "row(s) are rejected".
To avoid this issue, use a predicate to filter out rows from the source that do not fit into the receiving
database.
Boolean Queries in SQL Server Query Designer
When issuing a Boolean query in SQL Server Query Designer, you must enclose Boolean column
values in quotes. Otherwise, you receive a SQL execution error (for example, someboolean =
'true').
SSRS Limitations
Data Connection Wizard Workaround
Page 18 of 31
The SSRS Report Wizard provides a data connection wizard. After you select the wizard and enter
all the connection information, the OK button is not clickable. You cannot save your work and
continue. The workaround is not to use the wizard and to use the following panel instead.
Page 19 of 31
General Limitations
Visual Studio 2012 May Need Update 3
You may need to install update 3 to Visual Studio 2012 if:
l
You launch Server Explorer to view and work with your HP Vertica server, but the HP Vertica
data source is not visible.
You create a SSAS cube, connect to HP Vertica, and find either an empty list of tables or tables
not functioning correctly.
This issue does not occur for other supported versions of Visual Studio.
Results Viewer Limited to 655 Columns
The Visual Studio results viewer cannot execute a query that includes more than 655 columns. If a
table includes more than 655 columns, select specific columns (up to 655 total) rather than
selecting all columns.
Manually Refresh Settings for Visual Studio
If, after installing the HP Vertica Microsoft Connectivity Pack, you do not see HP Vertica listed as a
data provider, manually refresh.
To do so, run devenv.exe/setup, which you can find in the Visual Studio's installation folder.
SQL Pane Issues
Page 20 of 31
Page 21 of 31
Action
Default Value
Provider
None
None
Provider.
Server or file name
None
Location
Not supported.
Disabled.
Page 22 of 31
Parameters
Action
Default Value
Not supported.
Disabled.
Security
Use a specific user name and Enter a user name and
password
None
password.
Connect with No Password:
Select the Blank password
check box.
Save and Encrypt Password:
Select Allow saving password.
Initial Catalog
None
Page 23 of 31
The table that follows lists the connection parameters for the All page.
For OLE DB properties information specific to Microsoft, see the Microsoft documentation OLE DB
Properties.
Page 24 of 31
Parameters
Action
Default Value
Extended Properties
Not supported.
Locale Identifier
Mode
Connect Timeout
Blank
Default
enable or disable.
Password
None
(If no password
string.
specified, login
succeeds only if the
user has not set a
password.)
True
None
Page 25 of 31
Parameters
Action
Default Value
Data Source
None
None
the server.
Provider
VerticaOLEDB.1
None
Page 26 of 31
Parameters
Action
Default Value
ConnectionLoadBalance
False
None
Page 27 of 31
Parameters
Action
Default Value
DirectBatchInsert
False
None.
KerberosServiceName
None
None
None
None
Page 28 of 31
Parameters
Action
Default Value
Port
None
PreferredAddressFamily
None
SSLCertFile
None
None
Page 29 of 31
Parameters
Action
Default Value
SSLMode
Prefer
Page 30 of 31
Page 31 of 31