MULTISTMT= LIBNAME Option

Specifies whether insert statements are sent to Teradata one at a time or in a group.
Valid in: SAS/ACCESS LIBNAME statement
Default: NO
Restriction: You currently cannot use MULTISTMT= with ERRLIMIT=.
Data source: Teradata
See: MULTISTMT= data set option

Syntax

MULTISTMT=YES | NO

Syntax Description

YES
tries to send as many inserts to Teradata that can fit in a 64K buffer. If multistatement inserts are not possible, processing reverts to single-row inserts.
NO
send inserts to Teradata one row at a time.

Details

When you request multistatement inserts, SAS first determines how many insert statements it can send to Teradata. Several factors determine the actual number of statements that SAS can send—for example, how many:
  • SQL insert statements can fit in a 64K buffer.
  • data rows can fit in the 64K data buffer.
  • inserts the Teradata server chooses to accept.
When you need to insert large volumes of data, you can significantly improve performance by using MULTISTMT= instead of inserting only single-row.
If you also specify DBCOMMIT=, SAS uses the smaller of these: the DBCOMMIT= value and the number of insert statements that can fit in a buffer as the number of insert statements to send together at one time.