Recordset Methods - OLE DB Provider for Teradata

OLE DB Provider for Teradata User Guide

Product
OLE DB Provider for Teradata
Release Number
15.00
Language
English (United States)
Last Update
2018-09-28
dita:id
B035-2498
Product Category
Teradata Tools and Utilities

Recordset Methods

The following table lists the Recordset Methods and shows whether client-side and server-side cursors support the methods. The Restrictions column shows any restrictions that affect the methods.

 

Table 46: Recordset Methods 

Method

Supported

Restrictions

Client-Side

Server-Side

AddNew

Yes

Yes

 

Cancel

Yes

Yes

 

CancelBatch

Yes

Yes

 

CancelUpdate

Yes

Yes

 

Clone

No

No

 

Close

Yes

Yes

 

Delete

Yes

Yes

Client Side Cursors restriction:

Rows in a recordset that contains TIME or TIMESTAMP columns can only be modified using the Update and Delete methods under the following conditions:

  • The Underlying table contains a UNIQUE PRIMARY INDEX.
  • The columns of the unique primary index are included in the recordset.
  • The TIME or TIMESTAMP columns are not being modified. This only applies when using the Update method.
  • TIME or TIMESTAMP columns cannot be included in the UNIIQUE PRIMARY INDEX.
  • If the consumer does not meet these conditions, and the consumer attempts to Update or Delete a row in a recordset that contains a TIME or TIMESTAMP column, the following error message is generated by Teradata Database:

    [Teradata Database]Invalid operation on an ANSI Datetime or Interval value.

    Server-Side Cursors do not have this restriction.

    Find

    Yes

    No

    Server-Side Cursors:

    Although the Supports method indicates that Find is supported, OLE DB Provider for Teradata does not support the Find method.

    GetRows

    Yes

    Yes

    Server-Side Cursors Restriction:

    Rows can only be retrieved starting from the current position.

    Move

    Yes

    Yes

    Server-Side Cursors Restrictions:

  • Cursor can only move forward. Therefore, the NumRecords parameter can only be positive.
  • Bookmarks are not supported.
  • MoveFirst

    Yes

    Yes

     

    MoveLast

    Yes

    No

     

    MoveNext

    Yes

    Yes

     

    MovePrevious

    Yes

    No

     

    NextRecordset

    Yes

    Yes

     

    Notifications

    Yes

    Yes

     

    Open

    Yes

    Yes

     

    Requery

    Yes

    Yes

     

    Resync

    Yes

    Yes

     

    Seek

    No

    No

     

    Supports

    Yes

    Yes

     

    Update

    Yes

    Yes

    See restrictions for the Delete method.

    UpdateBatch

    Yes

    Yes

    See restrictions for the Delete method.