123 lines
6.7 KiB
HTML
123 lines
6.7 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="Block insert and block fetch C example" />
|
|
<meta name="abstract" content="Block inserts and block fetches can be used to enhance the performance of an ODBC application." />
|
|
<meta name="description" content="Block inserts and block fetches can be used to enhance the performance of an ODBC application." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikdirectcodeodbcapis.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="extfetch" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Block insert and block fetch C example</title>
|
|
</head>
|
|
<body id="extfetch"><a name="extfetch"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Block insert and block fetch C example</h1>
|
|
<div><p>Block inserts and block fetches can be used to enhance the performance
|
|
of an ODBC application.</p>
|
|
<div class="section"><p>They allow you to insert or retrieve rows in blocks, rather than
|
|
individually. This reduces the data flows and line turnaround between the
|
|
client and the server. Block fetches can be accomplished using either the
|
|
SQLFetch (forward only) or <span class="apiname">SQLExtendedFetch</span> or <span class="apiname">SQLFetchScroll</span> API. </p>
|
|
</div>
|
|
<div class="section"><p>A block fetch:</p>
|
|
<ul><li>Returns a block of data (one row set) in the form of an array for each
|
|
bound column.</li>
|
|
<li>Scrolls through the result set according to the setting of a scroll type
|
|
argument; forward, backward, or by row number.</li>
|
|
<li>Uses the row set size specified with the <span class="apiname">SQLSetStmtAttr</span> API.</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section"><p>The C example below does a block insert of 6 rows of data followed
|
|
by two block fetches of two rows. </p>
|
|
</div>
|
|
<div class="example"><pre>#define NUM_ROWS_INSERTED 6
|
|
#define NAME_LEN 10
|
|
|
|
HSTMT hstmt;
|
|
SQLINTEGER rowcnt = NUM_ROWS_INSERTED;
|
|
SQLCHAR itemNames[NUM_ROWS_INSERTED][NAME_LEN+1] = { "puzzle ", "candy bar ",
|
|
"gum ","kite ", "toy car ", "crayons " };
|
|
SQLINTEGER itemPrices[NUM_ROWS_INSERTED] = { 5, 2, 1, 10, 3, 4 };
|
|
SQLCHAR queryItemNames[NUM_ROWS_INSERTED][NAME_LEN+1]; // Name return array
|
|
SQLINTEGER queryItemPrices[NUM_ROWS_INSERTED]; // price return array
|
|
SQLINTEGER cbqueryItemNames[NUM_ROWS_INSERTED], cbqueryItemPrices[NUM_ROWS_INSERTED];
|
|
|
|
rc = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);
|
|
|
|
rc = SQLExecDirect(hstmt, "CREATE TABLE ITEMS (NAME VARCHAR(10), PRICE INT)", SQL_NTS);
|
|
|
|
// set the paramset size to 6 as we are block inserting 6 rows of data
|
|
rc = SQLSetStmtAttr(hstmt, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)rowcnt, SQL_IS_INTEGER);
|
|
|
|
// bind the arrays to the parameters
|
|
rc = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_VARCHAR,
|
|
NAME_LEN, 0, itemNames[0], NAME_LEN + 1, NULL);
|
|
rc = SQLBindParameter(hstmt, 2, SQL_PARAM_INPUT, SQL_C_LONG, SQL_INTEGER,
|
|
NUM_ROWS_INSERTED, 0, &itemPrices[0],
|
|
sizeof(long), NULL);
|
|
|
|
// do the block insert
|
|
rc = SQLExecDirect(hstmt, "INSERT INTO ITEMS ? ROWS VALUES(?,?)", SQL_NTS);
|
|
|
|
// set up things for the block fetch
|
|
|
|
// We set the concurrency below to SQL_CONCUR_READ_ONLY, but since SQL_CONCUR_READ_ONLY
|
|
// is the default this API call is not necessary. If update was required then you would use
|
|
// SQL_CONCUR_LOCK value as the last parameter.
|
|
rc = SQLSetStmtAttr(hstmt, SQL_ATTR_CONCURRENCY, (SQLPOINTER)SQL_CONCUR_READ_ONLY,
|
|
SQL_IS_INTEGER);
|
|
|
|
// We set the cursor type to SQL_CURSOR_FORWARD_ONLY, but since SQL_CURSOR_FORWARD_ONLY
|
|
// is the default this API call is not necessary.
|
|
rc = SQLSetStmtAttr(hstmt, SQL_ATTR_CURSOR_TYPE,
|
|
(SQLPOINTER)SQL_CURSOR_FORWARD_ONLY, SQL_IS_INTEGER);
|
|
|
|
// We want to block fetch 2 rows at a time so we need to set SQL_ATTR_ROW_ARRAY_SIZE to 2.
|
|
// If we were going to use SQLExtendedFetch instead of SQLFetchScroll we would instead need
|
|
// to set the statement attribute SQL_ROWSET_SIZE to 2.
|
|
rc = SQLSetStmtAttr(hstmt, SQL_ATTR_ROW_ARRAY_SIZE, (SQLPOINTER)2, SQL_IS_INTEGER);
|
|
|
|
rc = SQLExecDirect(hstmt, "SELECT NAME, PRICE FROM ITEMS WHERE PRICE < 5", SQL_NTS);
|
|
|
|
// bind arrays to hold the data for each column in the result set
|
|
rc = SQLBindCol(hstmt, 1, SQL_C_CHAR, queryItemNames, NAME_LEN + 1, cbqueryItemNames);
|
|
rc = SQLBindCol(hstmt, 2, SQL_C_LONG, queryItemPrices, sizeof(long), cbqueryItemPrices);
|
|
|
|
// We know that there are 4 rows that fit the criteria for the SELECT statement so we call
|
|
// two fetches to get all the data
|
|
rc = SQLFetchScroll(hstmt, SQL_FETCH_FIRST, 0);
|
|
// at this point 2 rows worth of data will have been fetched and put into the buffers
|
|
// that were bound by SQLBindCol
|
|
|
|
rc = SQLFetchScroll(hstmt, SQL_FETCH_NEXT, 0);
|
|
// at this point 2 rows worth of data will have been fetched and put into the buffers
|
|
// that were bound by SQLBindCol. Note that this second fetch overwrites the data in
|
|
// those buffers with the new data
|
|
// ...
|
|
// Application processes the data in bound columns...
|
|
// ... </pre>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaikdirectcodeodbcapis.htm" title="Many PC applications make ODBC calls that allow the user to seamlessly access data on different platforms. Before you begin developing your own application with ODBC APIs, you should understand how an ODBC application connects to and exchanges information with a database server.">Code directly to ODBC APIs</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |