Alapvető felületi megfelelőség

Minden ODBC-illesztőnek legalább Core szintű megfelelőséget kell tanúsítania. Mivel a Core-szinten a legtöbb általános interoperábilis alkalmazás által megkövetelt funkciók szükségesek, az illesztőprogram képes együttműködni az ilyen alkalmazásokkal. A core szinten lévő funkciók megfelelnek az ISO CLI specifikációjában meghatározott funkcióknak és az Open Group CLI specifikációjában meghatározott nemoptionális funkcióknak is. A core szintű interfész-konformáló ODBC-illesztő lehetővé teszi az alkalmazás számára az alábbi műveletek mindegyikét:

• Az SQLAllocHandle és az SQLFreeHandle meghívásával lefoglalhat és felszabadíthat minden típusú leírót.

• Használja az SQLFreeStmt függvény összes formáját .

• Az eredményhalmaz oszlopainak kötése az SQLBindCol meghívásával.

• Az SQLBindParameter és az SQLNumParams meghívásával csak a bemeneti irányban kezelheti a dinamikus paramétereket, beleértve a paramétertömböket is. (A kimeneti irány paraméterei a 2. szintű interfész megfelelőség 203. funkciójában találhatóak.)

• Adjon meg egy kötéseltolást.

• Használja az adatvégrehajtási párbeszédpanelt, amely az SQLParamData és az SQLPutData hívásait is magában foglalja.

• A kurzorok és a kurzornevek kezelése az SQLCloseCursor, az SQLGetCursorName és az SQLSetCursorName meghívásával.

• Az eredményhalmazok leírásához (metaadataihoz) az SQLColAttribute, az SQLDescribeCol, az SQLNumResultCols és az SQLRowCount meghívásával férhet hozzá. (Ezeknek a függvényeknek a használata a 0 oszlopban a könyvjelző metaadatainak lekéréséhez a 204-es funkció a 2. szintű felületi megfelelőségben.)

• Az adatszótár lekérdezéséhez hívja meg az SQLColumns, az SQLGetTypeInfo, az SQLStatistics és az SQLTables katalógusfüggvényeket.

  Az illesztő nem szükséges az adatbázistáblák és nézetek többrészes nevének támogatásához. (További információ: 101. funkció az 1. szintű felületi megfelelőségben és a 201. funkció a 2. szintű felületi megfelelőségben.) Az SQL-92 specifikáció egyes funkciói, például az oszlop minősítése és az indexek nevei azonban szintaktikailag összehasonlíthatók a többrészes elnevezéssel. Az ODBC-funkciók jelenlegi listája nem célja, hogy új lehetőségeket vezessen be az SQL-92 ezen aspektusaiba.

• Az SQLConnect, az SQLDataSources, az SQLDisconnect és az SQLDriverConnect meghívásával kezelheti az adatforrásokat és a kapcsolatokat. Az SQLDrivers meghívásával információt szerezhet az illesztőprogramokról, függetlenül attól, hogy melyik ODBC-szintet támogatják.

• Sql-utasítások előkészítése és végrehajtása az SQLExecDirect, az SQLExecute és az SQLPrepare meghívásával.

• Az SQLFetch vagy az SQLFetchScroll függvények meghívásával olvasson be egy eredménysorozat egy vagy több sorát, egyesével, kizárólag előrefelé haladva, ahol a FetchOrientation argumentum értéke SQL_FETCH_NEXT.

• Szerezze be részletekben a kötetlen oszlopot az SQLGetData meghívásával.

• Szerezze be az összes attribútum aktuális értékeit az SQLGetConnectAttr, az SQLGetEnvAttr és az SQLGetStmtAttr meghívásával, és állítsa be az összes attribútumot az alapértelmezett értékekre, és állítson be bizonyos attribútumokat nemdefault értékekre az SQLSetConnectAttr, az SQLSetEnvAttr és az SQLSetStmtAttr meghívásával.

• A leírók bizonyos mezőinek manipulálása az SQLCopyDesc, az SQLGetDescField, az SQLGetDescRec, az SQLSetDescField és az SQLSetDescRec meghívásával.

• Diagnosztikai információk beszerzése az SQLGetDiagField és az SQLGetDiagRec meghívásával.

• Az SQLGetFunctions és az SQLGetInfo meghívásával észlelheti az illesztőprogram-képességeket. Emellett az SQLNativeSql meghívásával észlelheti az SQL-utasításban végrehajtott szöveghelyettesítések eredményét, mielőtt elküldené őket az adatforrásnak.

• Tranzakció véglegesítéséhez használja az SQLEndTran szintaxisát. Az alapvető szintű illesztőprogramoknak nem kell támogatniuk a valódi tranzakciókat; Ezért az alkalmazás nem tud SQL_ROLLBACK és SQL_AUTOCOMMIT_OFF megadni a SQL_ATTR_AUTOCOMMIT kapcsolatattribútumhoz. (További információ: 109-es funkció a 2. szintű felületi megfelelőségben.)

• Hívja meg az SQLCancelt , hogy szakítsa meg az adatvégrehajtási párbeszédpanelt, és többszálas környezetekben szakítsa meg egy másik szálon végrehajtó ODBC-függvényt. Az alapszintű felületmegfelelőség nem teszi lehetővé a függvények aszinkron végrehajtását, és az SQLCancel használatát sem az aszinkron módon végrehajtó ODBC-függvények megszakítására. Sem a platformnak, sem az ODBC-illesztőnek nem kell többszálúnak lennie ahhoz, hogy az illesztőprogram független tevékenységeket végezzen egyszerre. Többszálas környezetekben azonban az ODBC-illesztőnek szálbiztosnak kell lennie. Az alkalmazástól érkező kérések szerializálása a specifikáció implementálásának megfelelő módja annak ellenére, hogy súlyos teljesítményproblémákat eredményezhet.

• Az SQLSpecialColumns meghívásával szerezze be a táblák SQL_BEST_ROWID sor-azonosító oszlopát. (Az SQL_ROWVER támogatása a 2. szintű interfész-megfelelőség funkciók 208-as funkciója.)

  Fontos

  Az ODBC-illesztőprogramoknak implementálniuk kell a függvényeket a Core felület megfelelőségi szintjén.