Query multiple SQL Statements in a single function call. A single statement is permitted and differs from the link{query}
and link{send}
functions by having providing the profile
, progressBar
, reportOverallTime
, errorReportFile
, and runAsBatch
arguments that are passed to the link[DatabaseConnector]{executeSql}
. If this function is throwing an error, the function will conversely loop over the sql statements individually.
execute_n( conn, conn_fun, sql_statements, verbose = TRUE, render_sql = TRUE, render_only = FALSE, profile = FALSE, progressBar = TRUE, reportOverallTime = TRUE, errorReportFile = file.path(getwd(), "errorReportSql.txt"), runAsBatch = FALSE )
conn | Connection object |
---|---|
sql_statements | A list or vector of SQL Statements of length 1 or greater. |
verbose | If TRUE, details on the activity are returned in the console, such as when the querying starting and was completed. |
render_sql | If TRUE, the SQL statement for the operation is returned in the console. |
profile | When true, each separate statement is written to file prior to sending to the server, and the time taken to execute a statement is displayed. |
progressBar | When true, a progress bar is shown based on the statements in the SQL code. |
reportOverallTime | When true, the function will display the overall time taken to execute all statements. |
errorReportFile | The file where an error report will be written if an error occurs. Defaults to 'errorReportSql.txt' in the current working directory. |
runAsBatch | When true the SQL statements are sent to the server as a single batch, and executed there. This will be faster if you have many small SQL statements, but there will be no progress bar, and no per-statement error messages. If the database platform does not support batched updates the query is executed without batching. |