Direct Execution

Direct execution is the simplest way to execute a statement. When the statement is submitted for execution, the data source compiles it into an access plan and then executes that access plan.

Direct execution is commonly used by generic applications that build and execute statements at run time. For example, the following code builds an SQL statement and executes it a single time:

SQLCHAR *SQLStatement;

// Build an SQL statement.

BuildStatement(SQLStatement);

// Execute the statement.

SQLExecDirect(hstmt, SQLStatement, SQL_NTS);

Direct execution works best for statements that will be executed a single time. Its major drawback is that the SQL statement is parsed every time it is executed. In addition, the application cannot retrieve information about the result set created by the statement (if any) until after the statement is executed; this is possible if the statement is prepared and executed in two separate steps.

To execute a statement directly, the application:

1 Sets the values of any parameters. For more information, see “Statement Parameters,” later in this chapter.

2 Calls SQLExecDirect and passes it a string containing the SQL statement.

When SQLExecDirect is called, the driver:

1 Modifies the SQL statement to use the data source’s SQL grammar without parsing the statement; this includes replacing the escape sequences discussed in “Escape Sequences in ODBC” in Chapter 8, “SQL Statements.” The application can retrieve the modified form of an SQL statement by calling SQLNativeSql. Note that escape sequences are not replaced if the SQL_ATTR_NOSCAN statement attribute is set.

2 Retrieves the current parameter values and converts them as necessary. For more information, see “Statement Parameters,” later in this chapter.

3 Sends the statement and converted parameter values to the data source for execution.

4 Returns any errors. These include sequencing or state diagnostics such as SQLSTATE 24000 (Invalid cursor state), syntactic errors such as SQLSTATE 42000 (Syntax error or access violation), and semantic errors such as SQLSTATE 42S02 (Base table or view not found).