Send feedback on this topic.
Teradata.Client.Provider
Restrictions
.NET Data Provider for Teradata > Developer's Guide > Visual Studio Integration Overview > Restrictions
  1. Microsoft SQL Server 2008 metadata cube generation requires identification of primary keys and foreign keys in fact or dimension tables utilized in generating metadata cubes. There are 2 steps required prior to creating a metadata cube. The first step creates a data source, and the second step creates a data source view containing selected tables to be utilized in fact or dimension tables. The data source view contains a wizard to facilitate selection of tables or views. Following selection of a data source, a dialog box will be displayed containing this message -> No foreign keys were found. You can create logical relationships on matching columns. Please select the default -> Same name as primary key and continue the wizard. Continue in the wizard, selecting the tables and views for the data source view.

    The designer display of the tables enables primary keys to be selected (right clicking the column and selecting Set logical primary key) and foreign key relationships to be identified by dragging the foreign key columns from the child table to the parent table on the designer pane. Setting the primary keys and the foreign keys must be performed prior to the third step of generating a metadata cube.

  2. Configuration of the Teradata TdDataAdapter within a Microsoft Visual Studio Windows Application project contains 2 limitations: a limitation utilizing the data adapter configuration wizard and a limitation in the UpdateBatchSize property. Generation of the Update and Delete commands created during the TdDataAdapter wizard requires a Primary Key in the database source table.

    Utilizing the wizard and selecting Use Existing Stored Procedures contains options to map parameters in insert, update or delete commands to source columns. These commands, once selected from the drop down list will display a list of parameters with a drop down list of Source Columns. The Source Columns will not contain any available columns, as the Teradata stored procedure does not return schema information on dynamic result sets.

    After selecting the Select and Insert and/or Update and/or Delete commands, select Next and select OK on the dialog box warning of missing parameter bindings. The generated Microsoft Windows Form Designer application code will contain parameter information for the stored procedure output parameters. The parameter information must be edited to reflect the correct values. One value that will be incorrectly generated is the size value.  For example, the size below is generated incorrectly.

    tdParameter1.Direction = System.Data.ParameterDirection.InputOutput;
    tdParameter1.Offset = 0;
    tdParameter1.ParameterName = "p1DecInOut";
    tdParameter1.Precision = ((byte) (18));
    tdParameter1.Scale = ((byte) (2));
    tdParameter1.Size = 2147483647;
    tdParameter1.TdType = Teradata.Client.Provider.TdType.Decimal;

    The second limitation of the TdDataAdapter concerns setting the UpdateBatchSize property. This property enables changes to the DataTable to be cached and send to the Advanced SQL Engine as a multi-statement query. Due to a limitation in the UpdatedRowSource property of the TdDataAdapter's InsertCommand, UpdateCommand and DeleteCommand, the UpdateBatchSize is only supported as a batch size of 1. Microsoft Visual Studio limits the UpdatedRowSource values to None or OutputParameters for batch updates. OutputParameters UpdatedRowSource property is not supported in our Provider.

    The UpdateBatchSize may be set to a value > 1 if the application does not require updates to be reflected in the DataTable. For example, auto-generated key retrieval is now supported which updates the identity column value in the DataTable from a Teradata generated column during insert, insert-select or multi-statement insert statement types. The updated identity column is supported only while utilizing TdDataAdapter UpdateBatchSize = 1. If the application does not require updated values in the DataTable, a workaround is available. Configuration of the TdDataAdapter within Visual Studio will by default set the UpdatedRowSource to Both. Setting this value to None will enable the Visual Studio Windows application to execute without error, but this disables any updates to the DataTable.

  3. The Microsoft Visual Studio Data Source Designer contains two known restrictions:
    • Object names containing spaces ("column 1") or the period ("column.1") character cannot be utilized in selection of the the database objects requested while utilizing the Microsoft Visual Studio Data Source Wizard.
    • Stored Procedures are not supported in selection of the database objects from within the Data Source Wizard. Dragging and dropping stored procedures onto the Visual Studio DataSet Designer design surface from the Microsoft Server Explorer data connections is also not supported. Teradata stored procedures do not return/support result sets.
  4. The Microsoft Visual Studio Windows Application project contains a limitation utilizing the Dataset Designer. Datasets may be created from the Data Sources panel in Visual Studio and may be edited in the Dataset Designer. Defining a Data Source with database tables or views generates a TableAdapter. Right clicking the TableAdapter in the Dataset designer and selecting Add Query is not supported. The generation of the TableAdapter Delete and Update commands requires a Primary Key in the database source table while utilizing the TableAdapter configuration wizard.
  5. Visual Studio supported applications must use characters that are representable in the current session character set. If an object name, containing any character that is not compatible in the current session character set is used to generate a query, an error 6706 "The string contains an untranslatable character" will be returned. For example in Visual Studio Server Explorer, a table name may contain a character not representable in the current session character set. Attempts to display the columns of the table (by selecting the plus sign next to the table) will return an error 6706. For more information see Using Extended Object Names in Schema Collections and Visual Studio.
  6. VisualStudio supported applications will not be supported in Redrive or Recoverable Network Protocol. The Redrive and Recoverable Network Protocol Recovery setting will be set to "Off".