OSIsoft Release Notes

PI OLEDB Enterprise 2012

Version 1.3.1.5
2013 OSIsoft, LLC. All rights reserved

Table of Contents
Overview ................................................................................................................... 1
Fixes and Enhancements ........................................................................................ 1
Fixes .................................................................................................................... 1
Enhancements..................................................................................................... 3
Known Issues ........................................................................................................... 3
Setup ......................................................................................................................... 7
Operating Systems .............................................................................................. 7
System Prerequisites .......................................................................................... 7
Server Platforms .................................................................................................. 8
Distribution Kit Files ............................................................................................. 8
Installation and Upgrade ..................................................................................... 9
Uninstalling PI OLEDB Enterprise ....................................................................... 9
List of Files Installed During Setup........................................................................ 9
Documentation Overview ......................................................................................11
Technical Support and Resources ......................................................................12

Overview
PI OLEDB Enterprise is an OLE DB data provider which provides access to the PI System in
a relational view, accessible through SQL queries. The provider supports read-only access to
asset and event data stored in the PI Asset Framework (AF), such as AF Elements, AF
Attributes, and PI Event Frames. PI OLEDB Enterprise also provides read-only access to
timeseries data from the PI Data Archive, since Attributes can be configured to reference PI
points.
PI OLEDB Enterprise belongs to OSIsofts PI Data Access suite of products, which are
designed to support implementation of custom applications on top of the PI System, as well
as integration of PI System data with other applications and business systems. For more
information on other PI Data Access products and details on the licensing specific to these
products (e.g. development vs. runtime), please consult the PI OLEDB Enterprise User Guide
or contact your account manager.
This release brings performance enhancements and the following new features, in addition to
bugs being fixed:

Added Event Frame tables in a new EventFrame schema

Added ElementReference table to the Asset schema

Added GetPIPoint Table-Valued Function

Export/Import of custom database objects via the PI SQL Commander

Fixes and Enhancements

Fixes
This section items that were resolved or added in this release of PI OLEDB Enterprise.
Item

Description

WI53694

Non-ASCII characters in a query stopped logging. This bug has been fixed.

WI58929

OPTION (EMBED ERRORS) and OPTION (IGNORE ERRORS) are not

honored when used in View definitions. This bug has been fixed.

WI59215

Search by value query may return Unknown error. Details: error code
0xc0000005 error. This bug has been fixed.

WI59243

A distributed query may return an unexpected result, usually empty.

When sending string parameter values to a linked server, SQL Server
sometimes doesnt add the trailing zero, but always specifies the length. The
provider doesnt honor the length so if theres no trailing zero the string is
misinterpreted. This bug has been fixed.

WI59247

Using an expression with parameters as Table-Valued Function argument

returns an error saying that the query is expensive because the parameter
values failed to be set. This bug has been fixed.

OSIsoft Release Notes

Template Version 2.1

Page 1

WI60680

Queries containing Archive, InterpolateDiscrete or Plot tables/TVFs and time

restrictions that go before 1-Jan-1970 returned unexpected errors.
This bug has been fixed.

WI61417

Renaming an AF database may prevent loading of custom database objects

in the provider. This bug has been fixed.

WI62408

When the PI SQL Commander is launched the first time for a certain user,
an unhandled Microsoft .NET Framework exception is shown at startup.
This bug has been fixed.

WI62409

When the PI SQL Commander is closing and there is an open .sql file which
is not included in any project, an unhandled Microsoft .NET Framework
exception is shown. This bug has been fixed.

WI62963

Global PI System settings (AF Server ports, PI Server lists) were not
refreshed. This bug has been fixed.

WI63000

Sometimes a cancel request didnt do anything when executing queries with

Archive, InterpolateRange or Plot tables/TVFs. This bug has been fixed.

WI63003

Search by value query may return incorrect results against attributes of

type Byte. This bug has been fixed.

WI63118

A timeseries data query may fail when connected with explicit credentials.
This bug has been fixed.

WI66174

An ElementAttribute table query against asset hierarchy containing multiversion elements could fail. This bug has been fixed.

WI63876

It was not possible to connect to an AF Server with a blank password. This

bug has been fixed.

WI65217

PI OLEDB Enterprise Agent may crash while stopping. This bug has been
fixed.

WI66183

Transpose functions could return empty cells when values were expected.
This bug has been fixed.

WI66529

Data retrieval from attributes with empty Guid or DateTime arrays fails.
This bug has been fixed.

WI71657

Registering a PI SQL Commander File has corrupted Visual Studio so that

SSIS packages could not be debugged. This bug has been fixed.

WI71675

When the 64-bit PIPC path has a pattern like Program

Files\<subpath1>\PIPC and the 32-bit PIPC path is not Program Files
(x86)\<subpath1>\PIPC then the 32-bit PI OLEDB Enterprise msi creates
another PIPC directory as Program Files (x86)\<subpath1>\PIPC and
some OLE DB files are stored there. This bug has been fixed.

WI73074

The command timeout could expire earlier than it was specified. This bug
has been fixed.

WI73387

Execution of parameterized queries could fail. This bug has been fixed.

WI73390

Execution of a query containing nested queries with TOP or DISTINCT

clause could return incorrect results. This bug has been fixed.

WI73558

Invalid number of rows could be returned in queries with UNION in a nested

query. This bug has been fixed.

WI73639

ORDER BY <integer_literal> could make the query execution fail. This bug
has been fixed.

WI75002

Under heavy load (excessive communication with PI OLEDB Enterprise

Agent, e.g. when running multiple queries in parallel threads) The pipe has
been ended. Error message could appear. This bug has been fixed.

OSIsoft Release Notes

Page 2

WI75231

Under high load and due to a bug in the OLE DB layer, the query execution
may have ended with an unhandled exception. This bug has been fixed.

WI75237

Search by value may not return any results when parameters of type VT_I8
(OleDbType.BigInt in ADO.NET) are used. This bug has been fixed.

WI75509

Catalogs were listed for users with no access to the corresponding AF

Database. This bug has been fixed.

WI76028

Hierarchy tables truncated paths longer than 4000. This bug has been fixed.

WI76040

RIGHT function with N argument bigger than the string length made the
whole query execution fail. This bug has been fixed.

WI76047

Queries containing more than 64 "UNION" subqueries might have failed with
the "The parameter is incorrect." error message. This bug has been fixed.

WI77118

Queries with ALLOW EXPENSIVE option could sometimes return 'Unknown

error'. This bug has been fixed.

Enhancements
Read-only Event Frame tables have been added to the provider.
The Asset.ElementReference table has been added. It complements the
Asset.vElementReference table and simplifies queries in certain cases. (WI58870)
Added GetPIPoint Table-Valued Function. (WI32497)
Export/Import capability for custom database objects (e.g. Views, Transpose Functions)
has been added to PI SQL Commander. (WI61286)

Known Issues
This section lists problems and enhancements that have been deferred until a future release or
need to be solved by the user.

Punch List Item

Description

22592OSI8

OLE DB Core Services version 6.0 and above

(Windows Server 2008 and later) may cause the
following error when using the UDL dialog for
configuring a connection and selecting Use
Windows NT Integrated security:
Microsoft Data Link Error: Connection failed
because of an error in initializing provider. Invalid
credentials. User name must be non-empty.

OSIsoft Release Notes

Page 3

The reason for the error is that Integrated

Security=SSPI is not set when selecting this
option.
Workaround:
Go to the All tab first and edit Integrated
Security=SSPI manually.

n/a

OSIsoft Release Notes

By default, custom Views and Table Value

Functions (TVFs) cannot be dropped in PI SQL
Commander. The following error message may
occur:

Page 4

[OSIsoft.AFSDK] Cannot delete Element .....

in Element ..... in Element ..... in Element
Database Objects in Element PI SQL in
Element OSIsoft because the current user does
not have Delete permission.
The reason for the error is that Views and TVFs
are stored in the Configuration database of PI
AF. By default no user has Delete permissions for
Elements that are children of the OSIsoft
Element. This is also true for Administrators.
Solution:
Using PI System Explorer, grant Delete
permission to the OSIsoft\PI SQL\ child elements
for selected users.
22860OSI8

Out-of-Process Linked Server fails on Windows

Server 2008, Vista, 7 under a non-privileged
user.
Workaround:
Add all users that need to access the Linked
Server to the Create global objects policy
(Administrative Tools Local Security Policy
Local Policies User Rights Assignment)
It is recommended to add standard users group
or Everyone instead of users one by one.
Solution:
Microsoft plans on fixing this in Windows 8

N/A

An installation of Microsoft Visual Studio 2008

may be broken after PI OLEDB Enterprise
2010 R3 got installed on the same machine.
This problem can be fixed before or after
upgrading to PI OLEDB Enterprise 2012 in the
following way:
Open a command prompt and call regsvr32 to reregister all the relevant DLLs (csm.dll,
dbgautoattach.dll, msdbg2.dll, pdm.dll,
pdmproxy100.dll, vsjitdebuggerps.dll).
For example:
C:\Program Files\Common Files\Microsoft
Shared\VS7Debug >regsvr32 csm.dll
or
C:\Program Files (x86)\Common Files\Microsoft
Shared\VS7Debug >regsvr32 csm.dll
The path depends on selected installation
directory and architecture of the operating
system.

25437OSI8

OSIsoft Release Notes

Executing a command that contains one or more

non-ASCII characters will suspend the logging

Page 5

stream (Log File).

25733OSI8

Data table queries may return fewer rows than

expected when 'Arc Off-line' events are reported
for an archive gap.
In more detail, the situation occurs if the
snapshot value of a tag corresponds to an
archive before the archive gap.
Workaround:
Until this problem is fixed in the PI Server we
recommend switching of returning special 'Arc
Off-line' events when archive files are taken
offline or when time gaps are detected in
mounted archives. This can be done via PI-SMT,
setting the tuning parameter
'MarkArchiveGaps'=0

WI74499

Release tests have pointed out that when using

SQL Server 2012 on Windows Server 2012 then
Out-of-Process Linked Server does not work. The
SQL Server process stops when accessing
metadata or trying to execute a query.
This problem is also visible with other OLE DB
providers and will be reported to Microsoft for
further investigation.
Workaround:
Configure the Linked Server in-process, which is
also the recommended configuration.

WI75531

Queries using the ElementHierarchy or

vElementHierarchy tables may return duplicate
rows if the result includes a root element that has
multiple versions.
This bug will be fixed in a version after PI AF
Server 2012.
Workaround:
Use the DISTINCT keyword to remove
duplicates.

WI77542

On machines with multiple CPUs (cores), queries

for attribute data run in multithreaded
environments may return the following error:
"Object reference not set to an instance of an
object.".
When using the OPTION(IGNORE ERRORS) the
queries alternatively return less rows than
expected.
This problem will be fixed in an upcoming PI
AF Client patch (WI77653).
Workaround:
Change Data Reference thread execution to STA
mode in the Agent config file
(PIOLEDBENTAgent.exe.config or
PIOLEDBENTAgent64.exe.config respectively):

OSIsoft Release Notes

Page 6

<add key="requireStaThreads" value="false"/>

Setup
Operating Systems
This release supports:

Windows XP, SP2

Windows Vista, SP1

Windows 7

Windows 8

Windows Server 2003, SP2

Windows Server 2008, SP1

Windows Server 2008 R2

Windows Server 2012

Note: The specified Service Pack versions represent minimum versions.

This software is provided as 32-bit (x86) and 64-bit (x64) version.
Windows NT and Windows 9x are not supported.

System Prerequisites
PI OLEDB Enterprise requires PI SQL for AF Server that is part of the PI AF Server
installation.
If you use PI AF Server 2.3, then PI SQL for AF Server can optionally be updated to version
PI SQL for AF Server 2.3.1.0. This version provides higher performance for Attribute
searches, compared to the version included in PI AF Server 2.3.
If you use PI AF Server 2.4 (2010 R3) it is recommended to install PI AF Server 2010 R3
Patch.
Installation of an OSIsoft product on Windows relies on the presence of Microsoft operating
system components such as the Microsoft .NET Framework and Microsoft run time libraries.
OSIsoft Prerequisite Kits are available in three packages that verify and install the needed
operating system prerequisites:
Online (Recommended): For installation on a computer connected to the internet. This kit
connects to Microsoft sites in order to download .NET Framework 3.5 for the operating
system on which it is run. This is a bootstrapper kit that is much smaller than the Standalone
kit.
Standalone (Recommended): For installation on a computer that cannot connect to Microsoft
sites, or for installations where such connection is not desirable. This is a full redistributable
kit that is much larger than the Online kit.
OSIsoft Release Notes

Page 7

Legacy: This kit should only be used for installation on older operating systems where the
OSIsoft products do not require .NET Framework 3.5.
All three Prerequisite Kits contain both 32-bit and 64-bit installation redistributables.
See the Prerequisites Product Pages on the OSIsoft Tech Support Web site to determine
which MS Operating System prerequisites you need:
http://techsupport.osisoft.com/Products/Prerequisite+Kits/Prerequisite+Kits+Overview.htm

Server Platforms

This release supports PI AF Server 2010 (2.2) and later.

PI SQL for AF Server is included in PI AF Server 2010 (2.2) and later

AF High Availability (HA) is supported with PI AF Server 2010 (2.2) and later.

Distribution Kit Files

PI OLEDB Enterprise and PI SQL for AF Server are provided in separate distribution kits.
The PI OLEDB Enterprise setup distribution
(PI OLEDB Enterprise_2012_.exe) consists of the following files:
File

Description

setup.exe

Setup wrapper installation program. This program

manages delivery of all components.
Setup wrapper configuration.
Setup wrapper utility module.
Setup wrapper silent installation configuration.
Setup wrapper utility module for Visual Studio Shell.
Visual Studio Shell 2010 redistributables
Setup module for .NET Framework 3.5
Setup module for .NET Framework 4.0
Microsoft .NET Framework 4.0 redistributables

setup.ini
SetupUtils.dll
silent.ini
VSIsoShellSetup.dll
VSIsoShell.exe
dotnet35Setup.dll
dotnet40Setup.dll
dotNetFx40_Full_x86_x64.
exe
MSRuntimes.msi
MSRuntimes_x64.msi
en_visual_c++_2010_sp1_r
edistributable_package_x8
6_651767.exe
en_visual_c++_2010_sp1_r
edistributable_package_x6
4_651767.exe
MSRuntimesSetupVS2010
SP1_x86.dll
MSRuntimesSetupVS2010
SP1_x64.dll
pisdk.msi
pisdk_X64.msi
pibufss.msi
AFClient_x86_2012*.msi
AFClient_x86_2012*.msi

OSIsoft Release Notes

Microsoft Visual Studio redistributables, 32-bit

Microsoft Visual Studio redistributables, 64-bit
Visual C++ redistributables, 32-bit

Visual C++ redistributables, 64-bit

Microsoft 2010 SP1 Runtimes, 32-bit

Microsoft 2010 SP1 Runtimes, 64-bit
PI SDK 2010 R2, 32-bit
PI SDK 2010 R2, 64-bit
PI Buffer Subsystem
AF Client 2012, 32-bit
AF Client 2012, 64-bit

Page 8

File

Description

VSTOWrapper_x86.dll

Setup module for Microsoft Visual Studio 2010 Tools

for Office Runtime, 32-bit
Setup module for Microsoft Visual Studio 2010 Tools
for Office Runtime, 64-bit
Microsoft Visual Studio 2010 Tools for Office Runtime,
32-bit
Microsoft Visual Studio 2010 Tools for Office Runtime,
64-bit
Windows Installer file for PI OLEDB Enterprise, 32-bit
Windows Installer file for PI OLEDB Enterprise, 64-bit
Windows Installer file for PI OLEDB Provider, 32-bit
Windows Installer file for PI OLEDB Provider, 64-bit
PI SQL Data Access Server, 32-bit

VSTOWrapper_x64.dll
vstor40_x86.exe
vstor40_x64.exe
PIOLEDBEnterprise.msi
PIOLEDBEnterprise64.msi
PIOLEDB.msi
PIOLEDB64.msi
pisqldas_1.2.2.0243x86.msi
pisqldas_1.2.2.0243x64.msi
PISQLDASUpgrade.dll
*.htm
*.pdf

PI SQL Data Access Server, 64-bit

Setup module for PI SQL Data Access Server upgrade
Release Notes

Installation and Upgrade

PI OLEDB Enterprise is installed via setup kit. The setup kit includes the Microsoft Visual
Studio Shell which is used by PI SQL Commander. Also included are AF Client, PI SDK and
the classic PI OLEDB Provider.
Previous release versions are updated automatically.
If the setup kit detects an installation of PI SQL Data Access Server older than 1.2.2.0243, it
will update this as well. This is because PI SQL Data Access Server relies on PI OLEDB
Enterprise but older versions cannot operate with the new PI OLEDB Enterprise version.
Note that this setup kit does not perform an initial install of PI SQL Data Access Server.

Uninstalling PI OLEDB Enterprise

PI OLEDB Enterprise can be uninstalled via "Add or Remove Programs" in the Control Panel
for Windows XP and 2003, or via Programs and Features in the Control Panel for later
Windows versions.

List of Files Installed During Setup

The following tables list the files contained in the product MSI files. If not already present or
available in an older version, these files are installed on your system.
PIOLEDBEnterprise.msi, PIOLEDBEnterprise64.msi

OSIsoft Release Notes

Page 9

Directory

File

Version

Comment

$PIPC\OLEDB

PIOLEDBENT.dll

1.3.1.5

PI OLEDB
Enterprise, 32-bit

$PIPC\OLEDB

PIOLEDBENT64.dll

1.3.1.5

PI OLEDB
Enterprise, 64-bit

$PIPC\OLEDB

PIOLEDBENTAgent.exe

1.3.1.5

PI OLEDB
Enterprise Agent,
32-bit

$PIPC\OLEDB

PIOLEDBENTAgent.exe.config

n/a

Agent config file,

32-bit

$PIPC\OLEDB

PIOLEDBENTAgent.exe.config.1.
3.1.5

n/a

Backup of
previous Agent
config file, 32-bit

$PIPC\OLEDB

PIOLEDBENTAgent64.exe

1.3.1.5

PI OLEDB
Enterprise Agent,
64-bit

$PIPC\OLEDB

PIOLEDBENTAgent64.exe.config

n/a

Agent config file,

64-bit

$PIPC\OLEDB

PIOLEDBENTAgent64.exe.config.
1.3.1.5

n/a

Backup of
previous Agent
config file, 64-bit

$PIPC\OLEDB

ManageAgentConfig.log

n/a

Configuration log
file

$Windows\Symbols\exe

PIOLEDBENTAgent.pdb

n/a

debug symbols,
32-bit

$Windows\Symbols\exe

PIOLEDBENTAgent64.pdb

n/a

debug symbols,
64-bit

$Windows\Symbols\dll

PIOLEDBENT.pdb

n/a

debug symbols,
32-bit

$Windows\Symbols\dll

PIOLEDBENT64.pdb

n/a

debug symbols,
64-bit

$PIPC\OLEDB\Tools

Demonstration, testing and

configuration tools, e.g. PI SQL
Commander

n/a

32-bit Folder only

$PIPC\OLEDB\Doc

documentation and release notes

n/a

32-bit Folder only

$PIPC\HELP

PISQLCommander.chm

n/a

Help file
32-bit Folder only

$WinSXS

Microsoft_VC100_CRT_x86.msm

10.0

$WinSXS

Microsoft_VC100_CRT_x86_x64.
msm

10.0

Visual C++ 10.0

CRT (x86)
WinSXS MSM
(32-bit only)
Visual C++ 10.0
CRT (x64)
WinSXS MSM
(64-bit only)

For other MSI files (PI SDK, AF Client and the classic PI OLEDB Provider), please consult
the release notes of these products to get a complete list of installed components.

OSIsoft Release Notes

Page 10

Details on the Microsoft Visual Studio Shell 2010 (Isolated) redistributables can be found
here:
http://www.microsoft.com/download/en/details.aspx?id=1366
Details on the .NET Framework 4.0 redistributables can be found here:
http://www.microsoft.com/downloads/en/details.aspx?FamilyID=0a391abd-25c1-4fc0-919fb21f31ab88b7&displaylang=en

Documentation Overview
PI OLEDB Enterprise User Guide:
Product description and use cases.
PI SQL Commander Help:
Working with PI SQL Commander and Generate Custom TVFs and Function Tables
Samples, tutorials and additional development support are provided through the OSIsoft
Virtual Campus (vCampus) program see http://vCampus.osisoft.com.

OSIsoft Release Notes

Page 11

Technical Support and Resources

For technical assistance, contact OSIsoft Technical Support at +1 510-297-5828 or
[email protected]. The OSIsoft Technical Support website offers additional contact
options for customers outside of the United States.
When you contact OSIsoft Technical Support, be prepared to provide this information:

Product name, version, and build numbers

Computer platform (CPU type, operating system, and version number)

Time that the difficulty started

Log files at that time

Details of any environment changes prior to the start of the issue

Summary of the issue, including any relevant log files during the time the issue occurred

The OSIsoft Virtual Campus (vCampus) website has subscription-based resources to help you
with the programming and integration of OSIsoft products.

OSIsoft Release Notes

Page 12

OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 USA
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: http://www.osisoft.com
OSIsoft Australia Perth, Australia
OSIsoft Europe GmbH Frankfurt, Germany
OSIsoft Asia Pte Ltd. Singapore
OSIsoft Canada ULC Montreal & Calgary, Canada
OSIsoft, LLC Representative Office Shanghai, Peoples Republic of China
OSIsoft Japan KK Tokyo, Japan
OSIsoft Mexico S. De R.L. De C.V. Mexico City, Mexico
OSIsoft do Brasil Sistemas Ltda. Sao Paulo, Brazil

Copyright: 1992-2013 OSIsoft, LLC. All rights reserved.

No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical,
photocopying, recording, or otherwise, without the prior written permission of OSIsoft, LLC.
OSIsoft, the OSIsoft logo and logotype, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, Analysis Framework, IT Monitor,
MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Data Services, PI Manual Logger, PI
ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports PI Event Frames, PI Coresight and
RtWebParts are all trademarks of OSIsoft, LLC. All other trademarks or trade names used herein are the property of their respective
owners.
U.S. GOVERNMENT RIGHTS
Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the OSIsoft, LLC license agreement and as
provided in DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, as applicable. OSIsoft, LLC.
Published: 04-Jan-2013

OSIsoft Release Notes

Page 13