The following sections describe the components in the Client Drivers and Tools for Windows in more detail:
This is the multi-page printable view of this section. Click here to print.
Components of the client drivers and tools on Windows
- 1: The ODBC client driver for windows
- 2: The vsql client for windows
- 3: The Microsoft connectivity pack for windows
- 3.1: Microsoft components
- 3.1.1: Microsoft component configuration
- 3.1.2: BIDS and SSDT-BI
- 3.1.3: SQL server analysis services (SSAS) support
- 3.1.4: SQL server integration services (SSIS) support
- 3.1.5: SQL server reporting services (SSRS) support
- 3.2: Compatibility issues and limitations
- 3.2.1: BIDS and SSDT-BI limitations
- 3.2.2: SSAS limitations
- 3.2.3: SSIS data type limitations
- 3.2.4: SSRS limitations
- 4: The OLE DB client driver for windows
- 5: The ADO.NET driver for windows
- 6: The visual studio plug-in for windows
1 - The ODBC client driver for windows
The Vertica ODBC driver for Windows is installed as part of the Client Drivers and Tools for Windows. See the Client Drivers downloads page.
After installing the ODBC driver
After installing the ODBC driver, you must create a DSN to be able to connect to your Vertica database. For the procedure, see Creating an ODBC DSN for windows clients.
1.1 - ODBC driver settings on Windows
ODBC driver settings are automatically configured using the Vertica Client Drivers and Tools installer on Windows. The values for the settings are stored in the Windows registry under the path HKEY_LOCAL_MACHINE\SOFTWARE\Vertica\ODBC\Driver. It is not necessary to configure additional ODBC driver settings on Windows platforms beyond what is automatically configured by the installer. You can, however, set the ODBC driver settings using the Windows ODBC Data Source Configuration window.
See Additional parameter settings for a list of additional settings for the ODBC client driver. See Diverting ODBC log entries to ETW for information on how to send ODBC log entries to Event Tracing for Windows (ETW).
1.2 - Diverting ODBC log entries to ETW
On Windows clients, you can direct Vertica to send ODBC log entries to Event Tracing for Windows (ETW). Once set, ODBC log entries appear in the Windows Event Viewer. To use ETW:
-
Register the driver as a Windows Event Log provider, and enable the logs.
-
Activate ETW by adding a string value to your Windows Registry.
-
Understand how Vertica compresses log levels for the Windows Event Viewer.
-
Know where to find the logs within Event Viewer.
-
Understand the meaning of the Event IDs in your log entries.
Register the ODBC driver as a windows event log provider, and enable the logs
To use ETW logging, you must register the ODBC driver as a Windows Event Log provider. You can choose to register either the 32-bit or 64-bit driver. Once you have registered the driver, you must enable the logs.
Important
If you do not both register the driver and enable the logs, output is directed to stdout.-
Open a command prompt window as Administrator, or launch the command prompt with the Run as Administrator option.
Important
You must have administrator privileges to successfully complete the next step. -
Run the command
wevtutil im
to register either the 32-bit or 64-bit version of the driver.-
For the 64-bit ODBC driver, run:
wevtutil im "c:\Program Files\Vertica Systems\ODBC64\lib\VerticaODBC64.man" /resourceFilePath:"c:\Program Files\Vertica Systems\ODBC64\lib\vertica_9.1_odbc_3.5.dll" /messageFilePath:"c:\Program Files\Vertica Systems\ODBC64\lib\vertica_9.1_odbc_3.5.dll"
-
For the 32-bit ODBC driver, run:
wevtutil im "c:\Program Files (x86)\Vertica Systems\ODBC32\lib\VerticaODBC32.man" /resourceFilePath:"c:\Program Files (x86)\Vertica Systems\ODBC32\lib\vertica_9.1_odbc_3.5.dll" /messageFilePath:"c:\Program Files (x86)\Vertica Systems\ODBC32\lib\vertica_9.1_odbc_3.5.dll"
-
-
Run the command
wevtutil sl
to enable the logs.-
For 64-bit ODBC driver logs, run:
wevtutil sl VerticaODBC64/e:true
-
For the 32-bit ODBC driver logs, run:
wevtutil sl VerticaODBC32/e:true
Note
Should you want to later disable the logs, you can use the samewevtutil sl
command, substituting/e:false
in place of/e:true
when you issue the statement. Alternatively, you can enable or disable logs within the Windows Event Viewer itself. -
Add the string value LogType
By default, Vertica does not send ODBC log entries to ETW. To activate ETW, add the string LogType
to your Windows registry, and set its value to ETW
.
-
Start the registry editor by typing
regedit.exe
in the Windows Run command box. -
Navigate to the correct location in the registry.
HKEY_LOCAL_MACHINE\SOFTWARE\Vertica\ODBC\Driver
-
Right-click in the right pane of the Registry Editor window. Select New and then select String Value.
-
Change the name of the string value from
New Value #1
toLogType
. -
Double-click the new
LogType
entry. When prompted for a new value, enterETW
. -
Exit the registry editor.
ETW is off by default. When ETW is activated, you can subsequently turn it off by clearing the value ETW from the LogType string.
Event viewer log levels
The LogLevel parameter setting is described in the section, Additional parameter settings. The parameter allows you to specify a LogLevel of 0 through 6. Be aware that Vertica compresses the log levels for the Windows Event Viewer. The six levels are compressed to four in Event Viewer.
Vertica LogLevel Setting | Vertica LogLevel Description | Entries are sent to Event Viewer as log level... | Event Viewer Displays... |
---|---|---|---|
0 | (No logging) | 0 | (No logging) |
1 | Fatal Errors | 1 | Critical |
2 | Errors | 2 | Error |
3 | Warnings | 3 | Warning |
4 | Info | 4 | Information |
5 | Debug | 4 | |
6 | Trace (all messages) | 4 |
Examples:
-
A LogLevel setting of 5 sends fatal errors, errors, warnings, info and debug log level entries to Event Viewer as Level 4 (Information).
-
A LogLevel setting of 6 sends fatal errors, errors, warnings, debug and trace log level entries to Event Viewer as Level 4.
Where to find logs in event viewer
-
Launch the Windows Event Viewer.
-
From Event Viewer (Local), expand Applications and Services Logs.
-
Expand the folder that contains the log you want to review (for example,
VerticaODBC64
). -
Select the Vertica ODBC log under the folder. Entries appear in the right pane.
Event log entry: event ID
Once you have chosen an ODBC log in Event Viewer, note the value in the Event ID field.
Each Event Log entry includes one of four Event IDs. An Event ID of 0 is informational (debug, info, and trace events), 1 is an error, 2 is a fatal event, and 3 is a warning.
2 - The vsql client for windows
The Vertica vsql client for Windows is installed as part of the Client Drivers and Tools for Windows.
There is no shortcut for the vsql client. Before you can start using vsql, you must add the vsql executable to the Windows PATH environment variable. The method for altering the PATH environment variable depends on the version of the Microsoft Windows operating system you are running. After you have made the change to your PATH environment variable, start a command window and type vsql -? at the command prompt to start vsql and show the help list.
For information about editing the Window PATH environment variable, see How do I set or change the PATH system variable?
For important details about using vsql in a Windows console, see Using vsql for windows users .
2.1 - Using vsql for windows users
Font
The default raster font does not work well with the ANSI code page. Set the console font to "Lucida Console."
Console encoding
vsql is built as a "console application." The Windows console windows use a different encoding than the rest of the system, so take care when you use 8-bit characters within vsql. If vsql detects a problematic console code page, it warns you at startup.
To change the console code page, set the code page by entering cmd.exe /c chcp 1252
.
Note
1252 is a code page that is appropriate for European languages. Replace it with your preferred locale code page.Running under cygwin
Verify that your cygwin.bat file does not include the "tty" flag. If the "tty" flag is included in your cywgin.bat file, then banners and prompts are not displayed in vsql.
To verify, enter:
set CYGWIN=binmode tty ntsec
To remove the "tty" flag, enter:
set CYGWIN=binmode ntsec
Additionally, when running under Cygwin, vsql uses Cygwin shell conventions as opposed to Windows console conventions.
Tab completion
Tab completion is a function of the shell, not vsql. Because of this, tab completion does not work the same way in Windows vsql as it does on Linux versions of vsql.
On Windows, instead of using tab-completion, press F7 to pop-up a history window of commands. You can also press F8 after typing a few letters of a command to cycle through commands in the history buffer which begin with the same letters.
3 - The Microsoft connectivity pack for windows
The Vertica Microsoft Connectivity Pack for Windows provides a configuration file for you to access Microsoft Business Intelligence tools. The Connectivity Pack is installed as part of the Client Drivers and Tools for Windows.
To learn about which Microsoft components are configured with the Microsoft Connectivity Pack, see Microsoft components.
3.1 - 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 Vertica server.
Important
Client Drivers and Tools for Windows includes the Vertica Microsoft Connectivity Pack. To use the Connectivity Pack to access Microsoft Business Intelligence tools, reboot your system after installation to ensure integration.3.1.1 - Microsoft component configuration
The Vertica ADO.NET driver, the Visual Studio plug-in, and the OLE DB driver allow you to integrate your Vertica server with an environment that includes Microsoft components previously installed on your system. Additional tools are also available for integration with Microsoft SQL Server.
The available drivers provide integration with the following Microsoft components:
-
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 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 2008/2010/2012/2013/2015 for use with SQL Server 2012, 2014, and 2016. SSDT-BI replaces BIDS for Visual Studio 2008, 2010, 2012, 2013, and 2015. It serves the same purpose as BIDS, providing a development environment for developing business intelligence solutions.
-
SQL Server Analysis Services (SSAS) for SQL Server 2012, 2014, and 2016. Use SSAS for OLAP and data mining, while using Vertica as the source for cube creation.
-
SQL Server Integration Services (SSIS) for SQL Server 2012, 2014, and 2016. SSIS provides SQL Server Type Mappings to map data types between Vertica and SQL Server. Use SSIS for data migration, data integration and workflow, and ETL.
The following figure displays the relationship between Microsoft components and Vertica dependencies.
3.1.2 - BIDS and SSDT-BI
Business Intelligence Development Studio (BIDS) is available in Microsoft Visual Studio 2008 with additional project types that are specific to SQL Server business intelligence. BIDS is the primary environment that you use to develop business solutions that include Analysis Services, Integration Services, and Reporting Services projects.
SQL Server Data Tool - Business Intelligence (SSDT-BI) replaces BIDS for Visual Studio 2010, 2012, 2013, and 2015. It serves the same purpose as BIDS, providing a development environment for developing business solutions.
Both BIDS and SSDT-BI are client-based applications that include additional project types specific to SQL Server Business Intelligence.
You can use the Visual Studio Shell Integration plug-in to browse a database from within the Visual Studio Server Explorer. This capability allows you to work outside of BIDS or SSDT-BI development to perform tasks, such as listing tables or inserting data. When you use Visual Studio in BIDS or SSDT-BI mode, you can develop business solutions using the data in your Vertica database. For example, you can create cubes or open tables.
Microsoft does not support the following configurations:
-
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/2013/2015 with SSDT-BI development to create a SQL Server 2008 Business Intelligence solution.
3.1.3 - SQL server analysis services (SSAS) support
BIDS or SSDT-BI includes the Analysis Services project for developing online analytical processing (OLAP) for business intelligence applications. This project type includes templates for:
-
Cubes
-
Dimensions
-
Data sources
-
Data source views
It also provides the tools for working with these objects.
Note
Note: OpenText recommends that you use the Vertica OLE DB driver when connecting to the Vertica server from SSAS due to improved performance.You can find the OLE DB connection properties in OLE DB connection properties.
3.1.4 - SQL server integration services (SSIS) support
BIDS or SSDT-BI includes the Integration Services project for developing ETL solutions. This project type includes templates for:
-
Packages
-
Data sources
-
Data source views
It also provides the tools for working with these objects.
You can find support for using Vertica as a data source and target from both SSIS and the import/export wizard. You must install mapping files specific to Vertica on the Integration Server and BIDS or SSDT-BI workstation to enable this capability. The Vertica Client Drivers and Tools for Windows installs these mapping files as the "SQL Server Type Mappings" component(s) in both 32-bit and 64-bit versions.
Note
Note: Always use the Vertica ADO.NET driver when connecting to the Vertica server from SSIS.3.1.5 - SQL server reporting services (SSRS) support
BIDS or SSDT-BI includes Report projects for developing reporting solutions.
You can use 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.
3.2 - Compatibility issues and limitations
This section lists compatibility issues and limitations for integrating the Microsoft Connectivity Pack with Microsoft Visual Studio and Microsoft SQL Server.
3.2.1 - BIDS and SSDT-BI limitations
BIDS and SSDT-BI are 32-bit development environments for Analysis Services, Integration Services, and Reporting Services projects. They are not designed to run on the Itanium 64-bit architecture and thus are not installed on Itanium servers.
3.2.2 - SSAS limitations
-
The SSAS Tabular Model is not supported.
-
If, after installing the Vertica OLE DB driver, an SSAS cube build fails, restart the SSAS service.
3.2.3 - SSIS data type limitations
The following sections cover data type limitations when using SQL Server Integration Services (SSIS).
Time data transfer
When transferring time data, SSIS uses the TimeSpan data type that supports precision greater than six digits. The Vertica ADO.NET driver translates TimeSpan as an Interval data type that supports up to six digits. The Interval type is not converted to the TimeSpan type during transfer. As a result, if the time value has a precision of more than six digits, the data is truncated, not rounded.
For information on ADO.NET data types, refer to ADO.NET data types.
DATE and DATETIME precision
To function without errors, DATE and DATETIME have a range 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 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.
Numeric precision
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
Unsupported floating point values
SQL Server does not support NaN, Infinity, or –Infinity values. These values are supported when you use SSIS to transfer between Vertica instances, but they are not supported with a SQL Server Destination.
String Conversion
The CHAR and VARCHAR data types used in SSIS are DT_WSTR, with a maximum length of 4000 characters.
In SSIS, 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.
Scale
Whenever you use a scale greater than 38, SSIS replaces it with a value of 4.
Interval conversion
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 issues with 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:
-
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, manually change the type mappings with BIDS or SSDT-BI.
Data transfer failures
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 Vertica to SQL Server. To avoid this issue, use either BIDS or SSDT-BI when transferring data.
Batch insert of VARBINARY/LONG VARBINARY data types
Sometimes, one row of a batch insert of VARBINARY or LONG VARBINARY data types exceeds the data type limit:
-
VARBINARY: 65 KB
-
LONG VARBINARY: 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'
).
3.2.4 - SSRS limitations
Data Connection Wizard Workaround
The SSRS Report Wizard provides a data connection wizard. After you select the wizard and enter all the connection information, the OK button is disabled. You cannot save your work and continue. The workaround is to not use the wizard and to use the following panel instead:
Report Wizard - Query Designer
Vertica uses the Report Wizard's Generic Query Designer. Other data sources use a Graphical Query Designer that supports building queries visually. The Graphical Query Designer is a part of a package called Visual Data Tools (VDT). The Graphical Query Designer works only with Generic OLE DB providers and the built-in providers. You cannot use it with the Vertica Data Provider.
Report Builder
Report Builder is a web-based report design tool. It does not support creating reports using custom data extensions, so you cannot use it with Vertica. When you create a report using Report Builder, existing Vertica data sources appear in the list of available data sources. However, choosing a Vertica data source causes an error.
Schema Name Not Automatically Provided when Mapping Vertica Destination
Currently, when you map a Vertica destination, the schema name is not automatically provided. You must enter it manually or pick it from the drop-down menu as follows:
4 - The OLE DB client driver for windows
The Vertica OLE DB driver for Windows is installed as part of the Client Drivers and Tools for Windows. See the Client Drivers downloads page.
The values for the OLE DB driver's settings are stored in the Windows registry under the path HKEY_LOCAL_MACHINE\SOFTWARE\Vertica\OLEDB\Driver.
For information on how the OLE DB driver integrates with Microsoft components previously installed on your system, see Microsoft component configuration.
4.1 - OLE DB connection properties
Use the Connection Manager to set the OLE DB connection string properties, which define your connection. You access the Connection Manager from within Visual Studio.
These connection parameters appear on the Connection page.
Parameters | Action |
---|---|
Provider | Select the native OLE DB provider for the connection. |
OLE DB Provider | Indicates Vertica OLE DB Provider. |
Server or file name | Enter the server or file name. |
Location | Not supported. |
Use Windows NT Integrated Security | Not supported. |
Use a specific user name and password |
Enter a user name and password. Connect with No Password: Select the Blank password check box. Save and Encrypt Password: Select Allow saving password. |
Initial Catalog | The name of the database running on the server. |
The All page from the Connection Manager dialog box includes all possible connection string properties for the provider.
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.
Parameters | Action |
---|---|
Extended Properties | Not supported. |
Locale Identifier |
Indicates the Locale ID. Default: 0 |
Mode |
Specifies access permissions. Default: 0 |
Connect Timeout |
Not supported. Default: 0 |
General Timeout | Not supported. |
File Name | Not supported. |
OLE DB Services | Specifies which OLE DB services to enable or disable. |
Password |
Specifies the password for the user ID. For no password, insert an empty string. |
Persist Security Info |
A security measure. When False, security sensitive-information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state. Default: true |
User ID | The database username. |
Data Source |
The host name or IP address of any active node in a Vertica cluster. You can provide an IPv4 address, IPv6 address, or host name. In mixed IPv4/IPv6 networks, the DNS server configuration determines which IP version address is sent first. Use the |
Initial Catalog | The name of the database running on the server. |
Provider |
The name of the OLE DB Provider to use when connecting to the Data Source. Default: VerticaOLEDB.1 |
BackupServerNode |
A designated host name or IP address to use if the ServerName host is unavailable. Enter as a string. Connection attempts continue until successful or until the list of server nodes is exhausted. Valid values: Comma-separated list of servers optionally followed by a colon and port number. For example:
|
ConnectionLoadBalance |
A Boolean value that determines whether the connection can be redirected to a host in the database other than the ServerNode. This parameter affects the connection only if load balancing is set to a value other than NONE. When the node differs from the node that the client is connected to, the client disconnects and reconnects to the targeted node. See About Native Connection Load Balancing in the Administration Guide. Default: false |
ConnSettings |
SQL commands that the driver should execute immediately after connecting to the server. Use to configure the connection, such as setting a schema search path. Reserved symbol:';' To set multiple parameters in this field use '%3B' for ','. Spaces: Use '+'. |
ConvertSquareBracketIdentifiers |
Controls whether square-bracket query identifiers are converted to a double quote identifier for compatibility when making queries to a Vertica database. Default: false |
DirectBatchInsert | Deprecated, always set to true. |
KerberosHostName |
Provides the instance or host name portion of the Vertica Kerberos principal; for example: vertica/host@EXAMPLE.COM |
KerberosServiceName |
Provides the service name portion of the Vertica Kerberos principal; for example: vertica/host@EXAMPLE.COM |
Label | Sets a label for the connection on the server. This value appears in the session_id column of system table SESSIONS . |
LogLevel | Specifies the amount of information included in the log. Leave this field blank or set to 0 unless otherwise instructed by Vertica Customer Support. |
LogPath | The path for the log file. |
Port |
The port number on which Vertica listens for OLE DB connections. Default: port 5433 |
PreferredAddressFamily |
The IP version to use if the client and server have both IPv4 and IPv6 addresses and you have provided a host name, one of the following:
|
SSLCertFile | The absolute path of the client's public certificate file. This file can reside anywhere on the system. |
SSLKeyFile | The absolute path to the client's private key file. This file can reside anywhere on the system. |
SSLMode |
Controls whether the connection to the database uses SSL encryption, one of the following:
Default: |
4.2 - Diverting OLE DB log entries to ETW
On Windows clients, you can direct Vertica to send OLE DB log entries to Event Tracing for Windows (ETW). Once set, OLE DB log entries appear in the Windows Event Viewer. To use ETW:
-
Register the driver as a Windows Event Log provider, and enable the logs.
-
Activate ETW by adding a string value to your Windows Registry.
-
Understand how Vertica compresses log levels for the Windows Event Viewer.
-
Know where to find the logs within Event Viewer.
-
Understand the meaning of the Event IDs in your log entries.
Register the OLE DB driver as a windows event log provider, and enable the logs
To use ETW logging, you must register the OLE DB driver as a Windows Event Log provider. You can choose to register either the 32-bit or 64-bit driver. Once you have registered the driver, you must enable the logs.
Important
If you do not both register the driver and enable the logs, output is directed to stdout.-
Open a command prompt window as Administrator, or launch the command prompt with the Run as Administrator option.
Important
You must have administrator privileges to successfully complete the next step. -
Run the command
wevtutil im
to register either the 32-bit or 64-bit version of the driver.-
For the 64-bit OLE DB driver, run:
wevtutil im "c:\Program Files\Vertica Systems\OLEDB64\lib\VerticaOLEDB64.man" /resourceFilePath:"c:\Program Files\Vertica Systems\OLEDB64\lib\vertica_8.1_oledb.dll" /messageFilePath:"c:\Program Files\Vertica Systems\OLEDB64\lib\vertica_8.1_oledb.dll"
-
For the 32-bit OLE DB driver, run:
wevtutil im "c:\Program Files (x86)\Vertica Systems\OLEDB32\lib\VerticaOLEDB32.man" /resourceFilePath:"c:\Program Files (x86)\Vertica Systems\OLEDB32\lib\vertica_8.1_oledb.dll" /messageFilePath:"c:\Program Files (x86)\Vertica Systems\OLEDB32\lib\vertica_8.1_oledb.dll"
-
-
Run the command
wevtutil sl
to enable the logs.-
For 64-bit OLE DB driver logs, run:
wevtutil sl VerticaOLEDB64/e:true
-
For the 32-bit ODBC driver logs, run:
wevtutil sl VerticaOLEDB32/e:true
Note
Should you want to later disable the logs, you can use the samewevtutil sl
command, substituting/e:false
in place of/e:true
when you issue the statement. Alternatively, you can enable or disable logs within the Windows Event Viewer itself. -
Add the string value LogType
By default, Vertica does not send OLE DB log entries to ETW. To activate ETW, add the string LogType
to your Windows registry, and set its value to ETW
.
-
Start the registry editor by typing
regedit.exe
in the Windows Run command box. -
Navigate to the correct location in the registry.
HKEY_LOCAL_MACHINE\SOFTWARE\Vertica\OLEDB\Driver
-
Right-click in the right pane of the Registry Editor window. Select New and then select String Value.
-
Change the name of the string value from
New Value #1
toLogType
. -
Double-click the new
LogType
entry. When prompted for a new value, enterETW
. -
Exit the registry editor.
ETW is off by default. When ETW is activated, you can subsequently turn it off by clearing the value ETW from the LogType string.
Event viewer log levels
The LogLevel parameter setting is described in the section, Additional parameter settings. The parameter allows you to specify a LogLevel of 0 through 6. Be aware that Vertica compresses the log levels for the Windows Event Viewer. The six levels are compressed to four in Event Viewer.
Vertica LogLevel Setting | Vertica LogLevel Description | Entries are sent to Event Viewer as log level... | Event Viewer Displays... |
---|---|---|---|
0 | (No logging) | 0 | (No logging) |
1 | Fatal Errors | 1 | Critical |
2 | Errors | 2 | Error |
3 | Warnings | 3 | Warning |
4 | Info | 4 | Information |
5 | Debug | 4 | |
6 | Trace (all messages) | 4 |
Examples:
-
A LogLevel setting of 5 sends fatal errors, errors, warnings, info and debug log level entries to Event Viewer as Level 4 (Information).
-
A LogLevel setting of 6 sends fatal errors, errors, warnings, debug and trace log level entries to Event Viewer as Level 4.
Where to find logs in event viewer
-
Launch the Windows Event Viewer.
-
From Event Viewer (Local), expand Applications and Services Logs.
-
Expand the folder that contains the log you want to review (for example,
VerticaOLEDB64
). -
Select the Vertica OLE DB log under the folder. Entries appear in the right pane.
Event log entry: event ID
Once you have chosen an OLE DB log in Event Viewer, note the value in the Event ID field.
Each Event Log entry includes one of four Event IDs. An Event ID of 0 is informational (debug, info, and trace events), 1 is an error, 2 is a fatal event, and 3 is a warning.
5 - The ADO.NET driver for windows
The Vertica ADO.NET driver for Windows is installed as part of the Client Drivers and Tools for Windows.
The ADO.NET driver is installed in the ADO.NET folder of the installation folder. The driver is also installed into the Windows Global Assembly Cache (GAC).
For information on how the ADO.NET driver integrates with Microsoft components previously installed on your system, see Microsoft components.
6 - The visual studio plug-in for windows
The Visual Studio plug-in for Windows is installed as part of the Client Drivers and Tools for Windows.
For information on how the Visual Studio plug-in integrates with Microsoft components previously installed on your system, see Microsoft components.
6.1 - Visual studio limitations
Visual Studio 2012 May Require Update 3
You may need to install update 3 to Visual Studio 2012 if:
-
You launch Server Explorer to view and work with your Vertica server, but the Vertica data source is not visible.
-
You create a SSAS cube, connect to Vertica, and find either an empty list of tables or tables not functioning correctly.
This issue does not occur for other versions of Visual Studio supported by Vertica.
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 Visual Studio plug-in, you do not see Vertica listed as a data provider, manually refresh.
To do so, run devenv.exe/setup
, which you can find in the Visual Studio installation folder.
SQL Pane Issues
-
ALTER TABLE or CREATE TABLE
You use Visual Studio 2008, 2010, 2012, 2013, or 2015 and issue the ALTER TABLE or CREATE TABLE statement in the SQL pane. However, a message displays telling you that the statement is not supported. To resolve the error, click Continue, and the query executes.
-
Queries with Semicolons
You use Visual Studio 2008, 2010, 2012, 2013, or 2015 and execute a SQL query in the SQL pane. If you include a semicolon (;) with your query, the query executes, but the result returned cannot be edited. To avoid this issue, enter the same query in the SQL pane without the semicolon.
-
Quoting Boolean Values
You use Visual Studio 2008, 2010, 2012, 2013, or 2015 to connect to the Vertica database and execute a SQL query in the SQL pane. When attempting to insert a value into a Boolean column without putting quotes around the value, subsequent execution of the SQL statement returns an error. To work around this issue, include quotes.
Uninstalling Client Drivers and Tools for Windows Error
There is a scenario where an uninstall of the Client Drivers and Tools for Windows package fails with a message that the .NET framework is required. What follows is the scenario that causes this issue.
- You Install the Client Drivers and Tools for Windows.
- You then install Visual Studio 2010 or 2012, which includes installation of the .NET framework 4.0 or 4.5.
- You uninstall the .NET framework using the Windows Control Panel.
- You then attempt to uninstall the Client Drivers and Tools for Windows. The uninstall fails with the message that .NET framework is required.
Perform the following to correct this issue:
- Reinstall the .NET framework 4.0 or 4.5 manually, using the Windows Control Panel.
- Uninstall the Client Drivers and Tools for Windows.