Enable Generation 2 Bulk Load Error Handling
The second generation of Hyper-Q bulk load error handling, generation 2 improves performance and provides more information about errors than the previous version of bulk load error handling, advanced adaptive error handling (AAEH). You enable generation 2 bulk load error handling using the Hyper-Q hint bulk_load_err_gen2.
If generation 2 bulk load error processing encounters an error, it will fall back to AAEH error handling for errors on DML operations other than INSERT. If you enable AAEH and generation 2 error handling in your Hyper-Q environment, AAEH (which you enable using the configuration parameter bulk_load_retry_max_error_rows), is ignored.
The syntax for bulk_load_err_gen2 is:
bulk_load_err_gen2 = true | false | force
where:
Parameter | Description |
|---|---|
| Enable generation 2 to bulk load error handling. |
| Disables generation 2 bulk load error handling. |
| When set to |
Hint Scope
The bulk_load_err_gen2 hint can be specified at the request, session, and global level. To learn more about Hyper-Q SQL hints, and how to use them within a SQL query, see About Hyper-Q SQL Hints.
You can specify bulk_load_err_gen2 as a global setting in the Hyper-Q configuration file (dtm.ini). To enable bulk_load_err_gen2, set it to true. The default value is false.
"gateway".bulk_load_err_gen2 = true
To learn more about specifying a hint as a gateway option in the Hyper-Q configuration file, see Gateway Configuration Parameters
You can specify bulk_load_err_gen2 as a query hint at either the session or request level. This example specifies that the hint be used at the for session level.
SET QUERY_BAND = 'UtilityDataSize=LARGE;' FOR SESSION --@dtm_bulk_load_err_gen2=true for session BEGIN LOADING Employee ERRORFILES ErrorTable1,ErrorTable2 CHECKPOINT 50000;
To learn more about Hyper-Q SQL hints, and how to use them within a SQL query, see About Hyper-Q SQL Hints.