Download Net Data Provider for Teradata Release Definition

.NET Data Provider for Teradata
Release Definition Including Installation Instructions
Release 12.00.00
B035-2032-127C
March 2008
The product or products described in this book are licensed products of Teradata Corporation or its affiliates.
Teradata, BYNET, DBC/1012, DecisionCast, DecisionFlow, DecisionPoint, Eye logo design, InfoWise, Meta Warehouse, MyCommerce,
SeeChain, SeeCommerce, SeeRisk, Teradata Decision Experts, Teradata Source Experts, WebAnalyst, and You’ve Never Seen Your Business Like
This Before are trademarks or registered trademarks of Teradata Corporation or its affiliates.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
BakBone and NetVault are trademarks or registered trademarks of BakBone Software, Inc.
EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation.
GoldenGate is a trademark of GoldenGate Software, Inc.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, z/OS, and z/VM are registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI and Engenio are registered trademarks of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United
States and other countries.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
QLogic and SANbox trademarks or registered trademarks of QLogic Corporation.
SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.
SPARC is a registered trademarks of SPARC International, Inc.
Sun Microsystems, Solaris, Sun, and Sun Java are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other
countries.
Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States
and other countries.
Unicode is a collective membership mark and a service mark of Unicode, Inc.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN “AS-IS” BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION
MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL,
OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
The information contained in this document may contain references or cross-references to features, functions, products, or services that are
not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features,
functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions,
products, or services available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated
without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any
time without notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this
document. Please e-mail: [email protected]
Any comments or materials (collectively referred to as “Feedback”) sent to Teradata Corporation will be deemed non-confidential. Teradata
Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform,
create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata
Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including
developing, manufacturing, or marketing products or services incorporating Feedback.
Copyright © 2005-2008 by Teradata Corporation. All Rights Reserved.
Preface
Purpose
Microsoft® .NET Framework applications utilize .NET Data Providers for uniform and
standard access to data sources such as Teradata®. The .NET Data Provider for Teradata is the
data access component of the .NET Framework Class Library (FCL).
This Release Definition provides an overview of the .NET Data Provider for Teradata product,
requirements and dependencies. It includes installation instructions for the product and its
dependencies, how to contact customer support, and information that may not have been
included in other documentation associated with this release.
Audience
This Release Definition is intended for system administrators, analysts, engineers, and other
database specialists who perform product installations or use the .NET Data Provider for
Teradata product.
Supported Releases
This Release Definition supports the .NET Data Provider for Teradata 12.00.00.
Prerequisites
The following prerequisite knowledge is required for this product:
•
None
.NET Data Provider for Teradata Release Definition Including Installation Instructions
3
Preface
Changes to This Book
Changes to This Book
The following changes were made to this book to support the current release and are marked
with change bars:
Date
Description
March 2008
.NET Data Provider for Teradata 12.00.00 includes:
version 12.00.00
•
•
•
•
•
•
•
•
•
•
•
•
•
Certification on Teradata Database 12.00.00
Support for Unicode Data Dictionary
Support for implicit cast from Timestamp to Date
Generation of authentication string based on User ID and
password
Support for Stored Procedure Dynamic Result Set
Support for database Linux and MP-RAS Kerberos authentication
mechanism
Removal of CLI dependency, CLI functionality included within
.NET Data Provider for Teradata
Incorporation of managed teragss into .NET Data Provider for
Teradata
New value types for Data and Time
A hierarchical Server Explorer view in Visual Studio 2005 to
provide quick access to data dictionary objects such as: databases,
tables, views, and stored procedure
Support for single-click access to SHOW commands from Visual
Studio 2005 Server Explorer (for example, SHOW TABLE)
Support for expired passwords and changing passwords in Visual
Studio 2005 Server Explorer
Branding of documentation for Teradata Database
Additional Information
Additional information that supports this product and Teradata Tools and Utilities is available
at the web sites listed in the table that follows. In the table, mmyx represents the publication
date of a manual, where mm is the month, y is the last digit of the year, and x is an internal
publication code. Match the mmy of a related publication to the date on the cover of this book.
This ensures that the publication selected supports the same release.
4
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Preface
Additional Information
Type of Information
Description
Source
Release overview
Use the Release Definition for the following
information:
http://www.info.teradata.com/
Late information
• Overview of all of the products in the
release
• Information received too late to be
included in the manuals
• Operating systems and Teradata
Database versions that are certified to
work with each product
• Version numbers of each product and
the documentation for each product
• Information about available training
and the support center
Additional product
information
Use the Teradata Information Products
Publishing Library site to view or download
specific manuals that supply related or
additional information to this manual.
Navigate to General Search >
Publication Product ID, and enter 2032 to bring up
the following Release Definition:
• .NET Data Provider for Teradata Release
Definition Including Installation Instructions
B035-2032-mmyx
1 Go to http://www.info.teradata.com/.
2 Select the Teradata Data Warehousing check box.
3 Do one of the following:
• For a list of Teradata Tools and Utilities
documents, click Teradata Tools and Utilities
and then select a release or a specific title.
• Select a link to any of the data warehousing
publications categories listed.
Specific books related to .NET Data Provider for
Teradata are as follows:
• Teradata Call-Level Interface Version 2 Reference
for Network-Attached Systems
B035-2018-mmyx
CD-ROM images
Ordering
information for
manuals
Access a link to a downloadable CD-ROM
image of all customer documentation for
this release. Customers are authorized to
create CD-ROMs for their use from this
image.
1 Go to http://www.info.teradata.com/.
Use the Teradata Information Products
Publishing Library site to order printed
versions of manuals.
1 Go to http://www.info.teradata.com/
2 Select the General Search check box.
3 In the Title or Keyword box, type CD-ROM.
4 Click Search.
2 Select the How to Order check box under Print &
CD Publications.
3 Follow the ordering instructions.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
5
Preface
Additional Information
Type of Information
Description
Source
General information
about Teradata
The Teradata home page provides links to
numerous sources of information about
Teradata. Links include:
1 Go to Teradata.com.
2 Select a link.
• Executive reports, case studies of
customer experiences with Teradata,
and thought leadership
• Technical information, solutions, and
expert advice
• Press releases, mentions, and media
resources
6
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Supported Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Changes to This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Chapter 1:
Release Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Release Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Product Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Platform Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Certified and Supported Teradata Database Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Requests for Change (RFCs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11
11
11
11
12
13
14
Chapter 2:
Product Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Chapter 3:
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Download and Install Microsoft .NET Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Download .NET Data Provider for Teradata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Install .NET Data Provider for Teradata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configure .NET Data Provider Setup for Windows Vista . . . . . . . . . . . . . . . . . . . . . . . . . 21
.NET Data Provider for Teradata Release Definition Including Installation Instructions
7
Table of Contents
Install .NET Data Provider for Teradata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Configuring .NETteragss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Verify Installation and Connectivity to the Teradata Database . . . . . . . . . . . . . . . . . . . . . . . . .23
Chapter 4:
Teradata Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Obtaining Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Chapter 5:
Customer Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Customer Education. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
8
.NET Data Provider for Teradata Release Definition Including Installation Instructions
List of Tables
Table 1: .NET Data Provider for Teradata 12.00.00 RFCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Table 2: Product Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Table 3: Obtaining Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
.NET Data Provider for Teradata Release Definition Including Installation Instructions
9
List of Tables
10
.NET Data Provider for Teradata Release Definition Including Installation Instructions
CHAPTER 1
Release Information
This chapter provides release information for .NET Data Provider for Teradata 12.00.00.
Release Information
Product Versions
The product information included in this document is for .NET Data Provider for Teradata
12.00.00.
Platform Requirements
To install Teradata Tools and Utilities or .NET Data Provider for Teradata software on a
computer, it must be running one of the following operating systems:
•
Microsoft Windows 2000 with SP4
•
Microsoft Windows XP Professional (32-bit x86) with SP2
•
Microsoft Windows XP Professional x64 Edition with SP2
•
Microsoft Windows Server 2003 (32-bit x86)
•
Microsoft Windows Server 2003 x64 Editions
•
Microsoft Windows Vista Enterprise
•
Microsoft Windows Vista Enterprise x64
Certified and Supported Teradata Database Versions
.NET Data Provider for Teradata is certified and supported for use with the following versions
of Teradata Database:
•
Teradata Database 12.0.0.12
•
Teradata Database V2R6.2.2.22
•
Teradata Database V2R6.1.1.100
•
Teradata Database V2R6.0.2.77
Note: .NET Data Provider for Teradata does not connect to Teradata Database V2R5.1 or
earlier.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
11
Chapter 1: Release Information
Release Information
Requests for Change (RFCs)
Requests for Change (RFCs) introduce new features and track changes that enhance the
operation of .NET Data Provider for Teradata software. The following RFCs have been
incorporated in this release.
Table 1: .NET Data Provider for Teradata 12.00.00 RFCs
RFC
Feature or Enhancement
.NET Data Provider for Teradata 12.00.00 New Features
100035
.NET Data Provider for Teradata:
• Does not depend on Teradata Call-Level Interface (CLI)
• Is 100 percent managed code and communicates directly with Teradata Database
• Supports XCOPY deployment, simply copy the assemblies to the application
directory
102718
Stored Procedure output parameters are accessible as the very first result set of the
TdDataReader, if the application:
• Does not bind Input-Output or Output parameters
• Sets the TdCommand.CommandType to CommandType.Text
• Sets the TdCommand.CommandText to the CALL SQL statement
This is a useful feature for ad-hoc query tools that do not support Output or InputOutput parameters.
12
102777
Support for SELECT statements with over 2000 columns or expressions.
105201
• The installation can selectively install publisher policy files into the Global
Assembly Cache. Previous versions of the provider always installed publisher
policy files into the GAC.
• Publisher Policy files target an existing application having a dependency on earlier
versions of the provider
106631
• There is a new Hierarchical Server Explorer view in Visual Studio 2005. It provides
quick access to Data Dictionary objects (Databases, Tables, Views, Stored
Procedure and more.)
• Single-click access to SHOW commands from Visual Studio 2005 Server Explorer
(for example, SHOW TABLE)
• Support for expired-password and change-password in Visual Studio 2005
108998
.NET Data Provider for Teradata generates Authentication String for LDAP and
SPNEGO Authentication Mechanisms based on User ID and Password fields. This
should greatly simplify application development and interoperability with packaged
applications.
110309
.NET Data Provider for Teradata cancels pending asynchronous commands when
TdConnection is closed.
113666
.NET Data Provider for Teradata has Provider Specific Value Types for Date,
Timestamp, Timestamp with Time Zone, Time and Time With Time Zone Teradata
Data Types.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Chapter 1: Release Information
Release Information
Table 1: .NET Data Provider for Teradata 12.00.00 RFCs (continued)
RFC
Feature or Enhancement
Teradata Database 12.00.00 Feature Support
102718
• Stored Procedures can return Result Sets
• Applications can invoke TdCommand.ExecuteReader to retrieve a DataReader
102784
Provide Unicode Data Dictionary support.
109616
Support an Implicit cast of Date to Timestamp.
Problems Fixed
109229
• .NET Data Provider for Teradata correctly reports expired password events
(TdConnection.InfoMessage) and the connection is left open
• Applications can execute a MODIFY USER statement
111207
DataType schema collection correctly reports Data Type properties like CreateFormat
and IsBestMatch.
115621
Applications can use CommandBehavior.Text to execute CALL statement.
116053
.NET Data Provider for Teradata now supports Turkish culture.
Dependencies
.NET Framework Version 2.0 Dependency
.NET Framework Version 2.0 is a dependency for .NET Data Provider for Teradata version
12.00.00. It must be installed prior to installing .NET Data Provider for Teradata.
Note: If .NET Framework Version 2.0 is not installed prior to attempting to install .NET Data
Provider for Teradata, the .NET Data Provider for Teradata installation will abort and request
that .NET Framework Version 2.0 be installed first, before continuing.
Visual Studio 2005 Integration Feature
Visual Studio 2005 Integration feature integrates:
•
.NET Data Provider for Teradata schema collection into the Microsoft Visual Studio Server
Explorer. It provides access to Teradata Data Dictionary including Databases, Tables,
Views and Stored Procedures.
•
.NET Data Provider for Teradata help files into the Microsoft Visual Studio 2005 help
collections. It enables context sensitive help for all classes in Teradata.Client.Provider
namespace.
If Microsoft Visual Studio 2005 or Microsoft SQL Server 2005 is installed on the system, and
the Visual Studio Integration feature is selected, then the .NET Data Provider for Teradata
product is integrated into Microsoft Visual Studio 2005, and/or Microsoft SQL Server
Business Intelligence Development Studio.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
13
Chapter 1: Release Information
Release Information
Publisher Policy
A publisher policy assembly configures the policy used when the .NET Data Provider for
Teradata runtime binds to an assembly. The publisher policy assembly is installed into the
GAC and is named using the following naming convention:
policy.major_ver.minor_ver.Teradata.Client.Provider.dll
where: major_ver and minor_ver refer to the major and minor version of the old version of the
.NET Data Provider for Teradata.
Therefore, if upgrading from .NET Data Provider for Teradata 01.02.00 to .NET Data Provider
for Teradata 12.00.00, and binding all existing applications to the 12.00.00 version, the
publisher policy assembly policy.1.2.Teradata.Client.Provider.dll must be placed in the Global
Assembly Cache to redirect existing application built against .NET Data Provider for Teradata
01.02.00 to .NET Data Provider for Teradata 12.00.00.
•
If this is a new installation of .NET Data Provider for Teradata, do not select Publisher
Policy.
•
If this is an upgrade of a previous installation of .NET Data Provider for Teradata, select
Publisher Policy for installation.
Table 2: Product Dependencies
Product
Required Installations
.NET Data Provider for Teradata 12.00.00
• .NET Framework Version 2.0
• (Optional feature) Microsoft Visual Studio
2005
• (Optional feature) Microsoft SQL Server
Business Intelligence Development Studio
Release Notes
Restrictions
The following restrictions apply to .NET Data Provider for Teradata 12.00.00. These
restrictions are also listed in the .NET Data Provider for Teradata Readme.txt file.
•
To run .NET Data Provider for Teradata 12.00.00 requires the Full Trust permission set.
For additional information, refer to the articles on “Security in the .NET Framework” at
http://msdn2.microsoft.com/en-us/library/fkytk30f.aspx in MSDN.
Also, refer to “Administering Security Policy” at http://msdn2.microsoft.com/en-us/
library/wztcyd2e.aspx in MSDN.
14
•
TdDataReader.GetSchemaTable() method reports an invalid Column Size for columns of
type CLOB. This is due to a defect in the Teradata Database. For additional information,
refer to DR 100397 to determine if this issue is applicable to your installation, or contact a
Teradata GSC representative.
•
Stored Procedures return garbled Error Messages when Session Character Set UTF16 is
used. This is due to a defect in the Teradata Database. For additional information, refer to
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Chapter 1: Release Information
Release Information
DR 90385 and DR 100534 to determine if this issue is applicable to your installation, or
contact a Teradata GSC representative.
•
The maximum input parameter size when Session Character Set is UTF8 is 32000 bytes.
This is due to a limitation in the Teradata Database. For additional information, refer to
DR 97879 to determine if this issue is applicable to your installation, or contact a Teradata
GSC representative.
•
.NET Data Provider for Teradata returns an incorrect result for HELP TYPE, HELP
TRANSFORM and HELP CAST SQL statements. This is due to a defect in the Teradata
Database. For additional information, refer to DR 99885 to determine if this issue is
applicable to your installation, or contact a Teradata GSC representative.
•
The Size property of a parameter must be specified for parameters that are of type out or
inout, and that are varying length data types. Refer to DR 103626. An exception will be
thrown if the Size is less than or equal to 0. Size will also be used to determine how much
data is returned for out/inout parameters of data types that are varying length. For
example, suppose Size = 10, DbType = DbType.String. The maximum length of the string
that can be returned is 10.
•
There are outstanding side-by-side install and uninstall issues related to version 01.00.00,
01.01.00 and 01.02.00. The uninstall does not update the following registry key to the last
available version (for example version 01.01.00.00 after 01.02.00.00 is uninstalled):
HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\.NETFramework\AssemblyFolders\
Teradata Data Provider
Therefore, .NET Data Provider for Teradata is not listed in the Add Reference dialog box.
•
Install adds/creates a directory in Program Files (x86) on x64 (64-bit) operating systems.
•
The TdDataAdapter Configuration Wizard, in Microsoft Visual Studio 2005, does not
generate unique names for the Commands. It always generates SelectCommand,
InsertCommand, UpdateCommand and DeleteCommand names for the corresponding
instances of TdCommand class. In order to configure a second or subsequent
TdDataAdapter, the existing generated commands must be renamed to a different name
which does not conflict with the default generated command names. For instance
SelectCommand may be renamed to SelectCommand1.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
15
Chapter 1: Release Information
Release Information
16
.NET Data Provider for Teradata Release Definition Including Installation Instructions
CHAPTER 2
Product Information
This Release Definition covers .NET Data Provider for Teradata 12.00.00.
Overview
.NET Data Provider for Teradata 12.00.00 conforms to Microsoft .NET Framework Version
2.0 specification. The product requires the .NET Framework Version 2.0 runtime
environment.
.NET Framework applications utilize .NET Data Providers for uniform and standard access to
data sources such as Teradata. .NET Data Provider is the data access component of the .NET
Framework Class Library (FCL).
The following URL provides additional information on ADO.NET architecture, ADO.NET
DataSet and .NET Data Provider interfaces and functionality.
•
Overview of ADO.NET
.NET Data Provider for Teradata Release Definition Including Installation Instructions
17
Chapter 2: Product Information
Overview
18
.NET Data Provider for Teradata Release Definition Including Installation Instructions
CHAPTER 3
Installation
This chapter contains procedures to install .NET Data Provider for Teradata 12.00.00 and its
dependent products.
Download and Install Microsoft .NET
Framework
.NET Data Provider for Teradata 12.00.00 is dependent on Microsoft .NET Framework
Version 2.0, which must be installed on all computers running .NET Data Provider for
Teradata.
Procedure - Install Microsoft .NET Framework Version 2.0 Redistributable
Follow these steps to install the Microsoft .NET Framework Version 2.0 Redistributable:
1
Go to http://msdn2.microsoft.com/en-us/netframework/aa731542.aspx.
2
Click .NET Framework Version 2.0 Runtime Package for the client machine.
•
.NET Framework Version 2.0 Redistributable Package (x86)
•
.NET Framework Version 2.0 Redistributable Package (x64)
3
Click Download to download Microsoft .NET Framework Version 2.0 Runtime software.
4
In the dotnetfx.exe dialog box, click Run to download dotnetfx.exe to the Temporary folder.
5
When the software is finished downloading, the Security Warning dialog asks to run
dotnetfx.exe. Click Run.
6
In the Microsoft .NET Framework 2.0 Setup screen, click Next to install the Microsoft .NET
Framework Version 2.0 package.
7
Read the License Agreement, then select “I Accept” and click Install.
8
When Setup indicates that the installation is complete, click Finish. If the installation
requests, restart the computer; otherwise, continue.
9
Continue with: “Install .NET Data Provider for Teradata” on page 21.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
19
Chapter 3: Installation
Download .NET Data Provider for Teradata
Download .NET Data Provider for Teradata
.NET Data Provider for Teradata 12.00.00 installation package is located on the Teradata
Download Center located at:
http://www.teradata.com
Procedure - Download .NET Data Provider from the Teradata Download Center
Follow this procedure to download .NET Data Provider for Teradata 12.00.00 from the
Teradata Download Center.
1
Create a “temporary” folder where the .NET Data Provider for Teradata EXE file can be
downloaded.
2
Go to: http://www.teradata.com.
3
Choose Downloads in the Support Services menu.
4
Choose Drivers and Connectivity Software.
5
Choose .NET Data Provider.
6
Choose Windows Win2K/XP/WS03.
7
Click the “.NET Data Provider for Teradata for Windows” version that is correct for the
client system. A description of the software appears.
8
Click on the download EXE in Download Files.
9
Read the License Agreement and click I Accept.
10 Click the link to the software.
11 Click Save.
12 Navigate to the “temporary” folder created in step 1, then click Save to download the
.NET Data Provider for Teradata EXE file.
13 Extract tdnetdp 12.00.00.00.exe and tdnetdp 12.00.00.00.txt from the ZIP files to the folder.
The files must be a minimum of the version number shown:
20
•
tdnetdp.12.00.00.00.exe - the .NET Data Provider for Teradata executable file
•
tdnetdp.12.00.00.00.txt - the .NET Data Provider for Teradata readme file
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Chapter 3: Installation
Install .NET Data Provider for Teradata
Install .NET Data Provider for Teradata
Configure .NET Data Provider Setup for Windows Vista
Installation on Windows Vista requires Windows XP Compatibility Mode. If installing on
Windows Vista, perform the following procedure, otherwise, continue with “Install .NET
Data Provider for Teradata” on page 21.
Procedure - Configure .NET Data Provider Setup for Windows Vista
Follow this procedure to configure .NET Data Provider for Teradata Setup for Windows Vista
before installing .NET Data Provider for Teradata on a Windows Vista platform.
1
Navigate to the “temporary” folder created in “Download .NET Data Provider for
Teradata” on page 20 and locate the tdnetdp.12.00.00.00.exe executable file.
2
Right click on the tdnetdp.12.00.00.00.exe executable file and select Properties.
3
In tdnetdp.12.00.00.00.exe Properties dialog, select Compatibilities tab.
4
Click Run this program in compatibility mode for:
5
Select Windows XP (Service Pack 2).
6
Click Run this program as an administrator:
7
Click OK.
Install .NET Data Provider for Teradata
Previously the .NET Data Provider for Teradata installation package must have been
downloaded, along with its dependent products listed in “Download .NET Data Provider for
Teradata” on page 20. This procedure installs .NET Data Provider for Teradata that was
downloaded.
Procedure - Install .NET Data Provider for Teradata
Follow this procedure to install .NET Data Provider for Teradata.
1
Navigate to the “temporary” folder created in “Download .NET Data Provider for
Teradata” on page 20 and locate the tdnetdp.12.00.00.00.exe executable file.
2
Run the tdnetdp.12.00.00.00.exe executable file.
Note: If installing on Windows Vista, the following message appears if Run this program in
compatibility mode for: and Run this program as an administrator: are not selected.
On Windows Vista, before the install, both the “Compatibility mode”
and the “Privilege Level” check boxes must be selected on the
Compatibility tab of the executable’s Properties dialog.
If the message appears, see “Configure .NET Data Provider Setup for Windows Vista” on
page 21 before continuing.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
21
Chapter 3: Installation
Install .NET Data Provider for Teradata
3
If installing on Windows Vista, the User Account Control dialog appears when the
tdnetdp.12.00.00.00.exe executable file is run. If it does, click Allow: I trust this program. I
know where it's from or I've used it before.
4
In the Choose Setup Language dialog, select the Language to use, then click OK.
5
When the Welcome screen appears, click Next>.
6
In the Select Features dialog, select the features to install, then click Next>.
The Select Features dialog box allows selection or unselection of:
•
Microsoft Visual Studio 2005 Integration feature
Note: If Microsoft Visual Studio 2005 or Microsoft SQL Server 2005 is installed on the
system, and the Visual Studio 2005 Integration feature is selected, then the .NET Data
Provider for Teradata product is integrated into Microsoft Visual Studio 2005, or
Microsoft SQL Server Business Intelligence Development Studio, or both.
By default, this feature is selected for installation. If the Visual Studios 2005 Integration
is not required, unselect this feature to reduce the installation time.
•
Publisher Policy feature
Note: A publisher policy assembly configures the policy used when the .NET Data
Provider for Teradata runtime binds to an assembly. The publisher policy assembly is
installed into the GAC. If updating from .NET Data Provider for Teradata version
01.02.00 to .NET Data Provider for Teradata 12.00.00, and binding all existing
applications to the 12.00.00 version, the publisher policy assembly
policy.1.2.Teradata.Client.Provider.dll must be placed in the Global Assembly Cache to
redirect an existing application built against .NET Data Provider for Teradata 01.02.00
to .NET Data Provider for Teradata 12.00.00.
•
If this is a new installation of .NET Data Provider for Teradata, do not select
Publisher Policy.
•
If this is an upgrade of a previous installation of .NET Data Provider for Teradata,
select Publisher Policy for installation.
7
In the Choose Destination Location screen, choose a destination folder and click Next>.
8
In the Select Program Folder dialog, click Next>.
9
In the Start Copying Files dialog, click Next> to start copying files.
10 If installing Visual Studio 2005 Integration on Windows Vista, and the Program
Compatibility Assistant dialog appears, click Run program to continue the installation.
11 In the InstallShield Wizard Complete screen, select “Yes, I want to view the readme file now.”
to display the readme file.
12 Click Finish to complete the installation.
22
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Chapter 3: Installation
Configuring .NETteragss
Configuring .NETteragss
.NETteragss is installed with .NET Data Provider for Teradata. For information on configuring
.NETteragss, see “Configuring .NETteragss” in the .NET Data Provider for Teradata Help file.
Also, see the Teradata Database Security Administration manual.
Verify Installation and Connectivity to the
Teradata Database
.NET Data Provider for Teradata installs an unsupported ad-hoc query tool named
NQUERY.exe. It can be used to verify installation and connectivity to Teradata Database.
Procedure - Verify the Installation of .NET Data Provider for Teradata and Connectivity to
the Teradata Database
Follow this procedure to verify the installation of .NET Data Provider for Teradata and the
connectivity to the Teradata Database.
1
Run <Installation Directory>\12.00.00.00\Samples\Bin\NQuery.exe.
2
From the menu bar, select Connection followed by Connect… to display the Connect
dialog.
3
Select .NET Data Provider for Teradata for the Data Provider.
4
Enter the connection string as:
Data Source = DbcName;User Id = X;Password=Y;
where:
•
DbcName is the Teradata system name
•
X is the user name/ID
•
Y is the password
5
Click Connect.
6
Enter Select Date in the SQL Command box and click Execute to display the Teradata
Database system date in the Result window.
7
From the menu bar, select Connection followed by Disconnect.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
23
Chapter 3: Installation
Verify Installation and Connectivity to the Teradata Database
24
.NET Data Provider for Teradata Release Definition Including Installation Instructions
CHAPTER 4
Teradata Documentation
The .NET Data Provider for Teradata Developer’s Guide and the .NET Data Provider for
Teradata Developer’s Reference are included with the product as a single stand-alone help file.
The help file is also integrated into Visual Studio 2005.
To access this online help file, select .NET Data Provider for Teradata 12.00.00.00 under
Start->All Programs.
The Release Definition for the .NET Data Provider for Teradata product is available from the
Teradata Information Products Publishing website.
For a nominal cost, printed manuals, additional manuals, and additional CD-ROMs can be
ordered from Teradata Information Products Publishing by calling toll free 1.800.543.2010
(select option 1 to order Teradata documentation), or by visiting http://
www.info.teradata.com/Hard-Copy/Ordering-Info/eHowToOrder.cfm.
All documentation can be accessed at www.info.teradata.com, including:
•
Web-only Release Definitions
•
Electronic downloads of all available documentation in PDF format
•
Information on whether printed copies of documentation are available and how to order
them
•
A fully searchable, free of charge CD image of the User Documentation CD that can be
used to burn a CD of user documents for this release
Obtaining Documentation
Additional information that supports .NET Data Provider for Teradata and the Teradata Tools
and Utilities is available at the web sites in the following table, mmyx represents the
publication date of a manual, where mm is the month, y is the last digit of the year, and x is an
internal publication code (“A” for a guide or reference, “C” for a release definition).
.NET Data Provider for Teradata Release Definition Including Installation Instructions
25
Chapter 4: Teradata Documentation
Obtaining Documentation
Table 3: Obtaining Information
Type of Information
Description
Source
Overview of the
release
The Release Definition provides the
following information:
http://www.info.teradata.com/
Information too late
for the manuals
• Overview of all the products in the
release
• Information received too late to be
included in the on-line help
• Operating systems and Teradata
Database versions that are certified to
work with each product
• Version numbers of each product and
the documentation for each product
• Information about available training
and support center
Additional
information related
to this product
Use the Teradata Information Products
Publishing Library site to view or
download, the most recent versions of all
manuals.
Specific manuals that supply related or
additional information to this product are
listed.
Navigate to General Search >
Publication Product ID, and enter 2032 to bring up
the following Release Definitions:
• .NET Data Provider for Teradata Release
Definition Including Installation Instructions
B035-2032-mmyx
http://www.info.teradata.com/
Click General Search, and do one of the following:
• In the Product Line field, select Software Teradata Tools and Utilities (TTU) for a list of all
of the publications for this release,
• In the Publication Product ID field, enter the
following book number:
• .NET Data Provider for Teradata Release
Definition Including Installation Instructions
B035-2032-mmyx
Related Websites
These websites include general information
about .Net Framework or .Net Data
Provider
http://msdn.microsoft.com/vstudio/
CD-ROM images
This site contains a link to a downloadable
CD-ROM image of all customer
documentation for this release. Customers
are authorized to create CD-ROMs for their
use from this image.
http://www.info.teradata.com/
The User Documentation CD-ROM
features an index (accessible through the
Search function in Acrobat Reader) that
allows you to search for text strings across
all of the documents on the CD-ROM.
Ordering
information for
manuals
26
Use the Teradata Information Products
Publishing Library site to order printed
versions of manuals.
Navigate to General Search > Title or Keyword, and
enter CD-ROM.
Caution: This download is large. Depending upon
your connection, it might take a long
time to download.
http://www.info.teradata.com/
Click How to Order under Print & CD Publications.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Chapter 4: Teradata Documentation
Obtaining Documentation
Table 3: Obtaining Information (continued)
Type of Information
Description
Source
General information
about Teradata
The Teradata home page provides links to
numerous sources of information about
Teradata. Links include:
Teradata.com
• Executive reports, case studies of
customer experiences with Teradata,
and thought leadership
• Technical information, solutions, and
expert advice
• Press releases, mentions and media
resources
.NET Data Provider for Teradata Release Definition Including Installation Instructions
27
Chapter 4: Teradata Documentation
Obtaining Documentation
28
.NET Data Provider for Teradata Release Definition Including Installation Instructions
CHAPTER 5
Customer Assistance
To help you make the most of your Teradata system, trained professionals are available to
assist you. There are a number of training and support centers you can contact to learn more
about Teradata applications or to get help with your Teradata system. Assistance is also
available at www.Teradata.com/TeradataAtYourService.
Customer Education
Teradata Customer Education delivers training for your global workforce—from scheduled
public courses and customized on-site training to the latest E-learning solutions. For
information on the latest classes, schedules, and the Teradata Certification Program, go to the
Teradata Customer Education web site at: www.TeradataEducationNetwork.com.
Customers and Teradata associates can enroll in classes online at
www.TeradataEducationNetwork.com, or by contacting the representative for your region. To
find the representative for your region, use the Contact Us link at the bottom of the Teradata
Education Network page.
Customer Support
Customer support is available around-the-clock, 7 days a week. Trained professionals at a
Remote Services Center (RSC) are available to assist you. To learn more about Teradata
Customer Services, go to Teradata @ Your Service at www.Teradata.com/
TeradataAtYourService.
Note: RSCs were formerly called MSCs (Managed Service Centers).
If you purchased an ESS (Enterprise System Support) support contract, a customized support
plan was created for you. Please refer to your support plan for contact information. In
addition, a unique PIN (Personal Identification Number) was given to your site. If you are an
ESS customer, you must contact the regional RSC to request support, and you must use your
PIN.
Note: PINs are not published; if you misplace your PIN, contact your account representative.
.NET Data Provider for Teradata Release Definition Including Installation Instructions
29
Chapter 5: Customer Assistance
Customer Support
30
.NET Data Provider for Teradata Release Definition Including Installation Instructions
Index
Symbols
Windows Server 2003 (32-bit x86) 11
Windows Server 2003 x64 Editions 11
Windows Vista Enterprise 11
Windows Vista Enterprise x64 11
Windows XP Professional (32-bit x86) with SP2 11
Windows XP Professional x64 Edition with SP2 11
. 23
.NET Framework
Version 2.0 13
A
ADO.NET architecture 17
O
C
overview 17
configure
.NET Data Provider Setup for Windows Vista 21
customer education 29
customer support 29
P
D
database versions
certified 11
supported 11
Teradata Database V2R6.0 11
Teradata Database V2R6.1 11
Teradata Database V2R6.2 11
dependencies 13
documentation
downloading CD-ROM images 26
general 27
obtaining 25
ordering print documentation 26
related to this release 26
release definition 26
download
.NET Data Provider for Teradata 20
platforms
Microsoft Windows 2000 11
Microsoft Windows Server 2003 11
Microsoft Windows Vista 11
Microsoft Windows XP Professional 11
requirements 11
product versions 11
publisher policy 14
R
release
definition 26
information 11
release notes 14
restrictions 14
RFCs 12
T
Teradata Database 12.00.00 11
Teradata Database Versions 11
I
U
install
.NET Data Provider for Teradata 21
configure for Windows Vista 21
dependent products 20
Microsoft .NET Framework 19
verify the installation 23
uninstall
.NET Data Provider for Teradata (VISTA) 23
M
Microsoft
Windows 2000 with SP4 11
V
verify
connectivity to database 21
version
.NET Data Provider for Teradata 14
Microsoft .NET Framework 19
V2R6.0 11
.NET Data Provider for Teradata Release Definition Including Installation Instructions
31
Index
V2R6.1 11
V2R6.2 11
Visual Studio 2005 13
32
.NET Data Provider for Teradata Release Definition Including Installation Instructions