Associazione di parametri in base al nome (parametri denominati)

Alcuni DBMS consentono a un'applicazione di specificare i parametri in una stored procedure in base al nome anziché alla posizione nella chiamata di procedura. Tali parametri sono chiamati parametri denominati. ODBC supporta l'uso di parametri denominati. In ODBC i parametri denominati vengono usati solo nelle chiamate alle stored procedure e non possono essere usati in altre istruzioni SQL.

Il driver controlla il valore del campo SQL_DESC_UNNAMED del DP per determinare se vengono utilizzati parametri denominati. Se SQL_DESC_UNNAMED non è impostato su SQL_UNNAMED, il driver usa il nome nel campo SQL_DESC_NAME del DP per identificare il parametro. Per associare il parametro, un'applicazione può chiamare SQLBindParameter per specificare le informazioni sul parametro e quindi chiamare SQLSetDescField per impostare il campo SQL_DESC_NAME del DP. Quando si usano parametri denominati, l'ordine del parametro nella chiamata di procedura non è importante e il numero di record del parametro viene ignorato.

La differenza tra parametri senza nome e parametri denominati sta nella relazione tra il numero di record del descrittore e il numero di parametro nella procedura. Quando si usano parametri senza nome, il primo marcatore di parametro è correlato al primo record nel descrittore dei parametri, che a sua volta è correlato al primo parametro (in ordine di creazione) della chiamata di procedura. Quando si usano parametri denominati, il primo marcatore di parametro è ancora correlato al primo record del descrittore di parametro, ma la relazione tra il numero di record del descrittore e il numero di parametro della procedura non esiste più. I parametri denominati non usano il mapping del numero di record del descrittore alla posizione del parametro della procedura; viene invece eseguito il mapping del nome del record descrittore al nome del parametro della procedura.

Se viene usato un parametro denominato, tutti i parametri devono essere parametri denominati. Se un parametro non è un parametro denominato, allora nessuno dei parametri può essere denominato. Se ci fosse una combinazione di parametri denominati e parametri senza nome, il comportamento sarebbe dipendente dal driver.

Come esempio di parametri denominati, si supponga che una stored procedure di SQL Server sia stata definita come segue:

CREATE PROCEDURE test @title_id int = 1, @quote char(30) AS <blah>  

In questa procedura, il primo parametro, @title_id, ha un valore predefinito di 1. Un'applicazione può usare il codice seguente per richiamare questa procedura in modo che specifichi un solo parametro dinamico. Questo parametro è un parametro denominato con il nome "@quote".

// Prepare the procedure invocation statement.  
SQLPrepare(hstmt, "{call test(?)}", SQL_NTS);  
  
// Populate record 1 of ipd.  
SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR,  
                  30, 0, szQuote, 0, &cbValue);  
  
// Get ipd handle and set the SQL_DESC_NAMED and SQL_DESC_UNNAMED fields  
// for record #1.  
SQLGetStmtAttr(hstmt, SQL_ATTR_IMP_PARAM_DESC, &hIpd, 0, 0);  
SQLSetDescField(hIpd, 1, SQL_DESC_NAME, "@quote", SQL_NTS);  
  
// Assuming that szQuote has been appropriately initialized,  
// execute.  
SQLExecute(hstmt);