Using SQL Adapters with Ensemble - InterSystems Documentation

Creating Adapter Methods for SQLTo perform such tasks, your custom methods will use the methods of the SQL inbound and outboundadapters, both of which inherit a core set of methods from the EnsLib.Common class. These methodscan execute queries, run stored procedures, insert records, and so on.5.2 Using ParametersIf you use parameters when you run queries, perform updates, or execute procedures, you should obtaininformation on the ODBC driver you are using. You should look for information on the following:• Whether this driver supports the ODBC SQLDescribeParam function.- If so, you can use the SQL adapter methods ExecuteQuery, ExecuteUpdate, andExecuteProcedure. Each of these methods accepts any number of parameter names, callsSQLDescribeParam, and uses the resulting information to automatically bind those parametersappropriately.- If not, you must use the alternative methods ExecuteQueryParmArray,ExecuteUpdateParmArray, and ExecuteProcedureParmArray. In this case, you mustcreate and pass a multidimensional array that contains the parameters and all their attributes.• Whether the driver supports input, output, and input/output type parameters. When you includeparameters in an SQL statement, you specify these types, not all of which are supported by alldrivers.5.2.1 Parameter AttributesTo use parameters in your SQL statements, if the ODBC driver does not support theSQLDescribeParam function, you will have to create a Caché multidimensional array that containsthe parameters and all their appropriate attributes. This information is passed to the ODBC driver, sostart by finding out how the driver represents the following parameter attributes:• SQL data types — These are generally represented by integers (C types), and the driver includefile contains a table that defines them.A typical subset is as follows:- 1 represents SQL_CHAR- 4 represents SQL_INTEGER- 6 represents SQL_FLOAT- 8 represents SQL_DOUBLE- 12 represents SQL_VARCHAR36 Using SQL Adapters with Ensemble