Funkce ODBC a knihovna kurzorů

platí pro: SQL Server Azure SQL DatabaseAzure SQL Managed Instance

Důležité

Tato funkce se odebere v budoucí verzi Windows. Nepoužívejte tuto funkci v nové vývojové práci a naplánujte úpravu aplikací, které tuto funkci aktuálně používají. Microsoft doporučuje používat funkci kurzoru ovladače.

Knihovna kurzorů ODBC poskytuje podporu posouvání kurzorů pro ovladače ODBC 2.x, které podporují pouze kurzory pouze vpřed. Když povolíte knihovnu kurzorů pro připojení, Správce ovladačů zachytí volání funkcí a směruje je přes knihovnu kurzorů místo přímo na ovladač. Knihovna kurzorů buď spustí samotnou funkci, nebo ji předá podkladovému ovladači.

Funkce spouštěné knihovnou kurzorů

Tyto články popisují, které funkce ODBC knihovna kurzoru zpracovává a které prochází ovladači.

Article Description
Funkce ODBC spouštěné knihovnou kurzorů Uvádí funkce, které knihovna kurzorů implementuje, aby poskytovala posouvání funkcí kurzoru.
Funkce ODBC, které knihovna kurzorů nespustí Uvádí funkce, které knihovna kurzorů prochází ovladačem beze změny.

Vazby sloupců a parametrů

Tyto funkce zpracovávají vazby vyrovnávací paměti aplikace k nastavení sloupců a parametrů příkazů výsledků. Knihovna kurzorů upraví jejich chování tak, aby podporovala umístěné aktualizace a blokové kurzory.

Funkce Description
SQLBindCol (knihovna kurzorů) Vytvoří vazbu vyrovnávacích pamětí aplikace na sloupce sady výsledků. Knihovna kurzorů sleduje vazby pro podporu operací umístěných aktualizací a odstranění.
SQLBindParameter (knihovna kurzorů) Vytvoří vazbu vyrovnávací paměti aplikace se značkami parametrů. Knihovna kurzorů předá toto volání ovladači.

Hromadné a umístěné operace

Tyto funkce provádějí hromadné operace se sadami řádků a umístěnými aktualizacemi na jednotlivých řádcích v aktuální sadě řádků kurzoru.

Funkce Description
SQLBulkOperations (knihovna kurzorů) Provádí hromadné vkládání, aktualizace, odstraňování nebo načítání pomocí operací záložek. Knihovna kurzoru ji mapuje při SQLSetPos práci s ovladači ODBC 2.x.
SQLSetPos (knihovna kurzorů) Umístí kurzor do sady řádků a umožní aplikacím aktualizovat, aktualizovat nebo odstranit data v sadě řádků.

Správa kurzorů a transakce

Tyto funkce spravují životnost kurzoru a hranice transakcí.

Funkce Description
SQLCloseCursor (knihovna kurzorů) Zavře kurzor na příkaz a zahodí čekající výsledky.
SQLEndTran (knihovna kurzorů) Potvrzení nebo vrácení transakce zpět. Knihovna kurzorů spravuje stav kurzoru napříč hranicemi transakcí na SQL_CURSOR_COMMIT_BEHAVIOR základě nastavení a SQL_CURSOR_ROLLBACK_BEHAVIOR nastavení.
SQLFreeStmt (knihovna kurzorů) Zastaví zpracování příkazů, zavře všechny přidružené kurzory, zahodí čekající výsledky a volitelně uvolní všechny prostředky přidružené k popisovači příkazu.

Načtení dat

Tyto funkce načítají data ze sad výsledků. Knihovna kurzorů poskytuje posouvání funkcí kurzoru pro ovladače, které podporují pouze kurzory jen dopředu.

Funkce Description
SQLFetch (knihovna kurzorů) Načte další sadu řádků dat ze sady výsledků. Při práci s ovladači ODBC 2.x je knihovna kurzorů mapovat na SQLExtendedFetch.
SQLFetchScroll (knihovna kurzorů) Načte zadanou sadu řádků dat ze sady výsledků a vrátí data pro všechny vázané sloupce. Podporuje různé směry posouvání, včetně prvního, posledního, dalšího, předchozího, absolutního a relativního umístění.
SQLExtendedFetch (knihovna kurzorů) Načte zadanou sadu řádků ze sady výsledků. Tato funkce je v rozhraní ODBC 3.x zastaralá; místo toho použijte SQLFetchScroll .
SQLGetData (knihovna kurzorů) Načte data pro jeden sloupec v sadě výsledků po SQLFetch zavolání nebo SQLFetchScroll zavolání.

Operace popisovače

Tyto funkce získávají a nastavují hodnoty polí popisovače. Popisovače definují atributy parametrů a sloupců sady výsledků.

Funkce Description
SQLGetDescField a SQLGetDescRec (knihovna kurzorů) Načtěte hodnoty jednotlivých polí nebo úplné záznamy popisovače. Knihovna kurzorů je zpracovává pro své interní popisovače.
SQLSetDescField a SQLSetDescRec (knihovna kurzorů) Nastavte hodnoty jednotlivých polí nebo úplné záznamy popisovače. Knihovna kurzorů sleduje změny polí popisovače.

Dotazy na možnosti ovladače

Tyto funkce vrací informace o možnostech ovladače a knihovny kurzorů.

Funkce Description
SQLGetFunctions (knihovna kurzorů) Vrátí informace o tom, které funkce ODBC ovladač podporuje. Knihovna kurzoru upraví odpověď tak, aby zahrnovala funkce, které implementuje.
SQLGetInfo (knihovna kurzorů) Vrátí obecné informace o ovladači a zdroji dat. Knihovna kurzorů upravuje určité typy informací související s kurzorem tak, aby odrážely jeho schopnosti.

Atributy příkazů a připojení

Tyto funkce získávají a nastavují příkazy, připojení a atributy prostředí, které ovlivňují chování kurzoru.

Funkce Description
SQLGetStmtAttr (knihovna kurzorů) Vrátí aktuální hodnotu atributu příkazu. Knihovna kurzorů zpracovává atributy související s chováním kurzoru.
SQLGetStmtOption (knihovna kurzorů) Vrátí hodnoty možností příkazu. Tato funkce je v rozhraní ODBC 3.x zastaralá; místo toho použijte SQLGetStmtAttr .
SQLSetStmtAttr (knihovna kurzorů) Nastaví atribut příkazu. Knihovna kurzorů zpracovává atributy související s kurzory k implementaci podpory posouvání kurzoru.
SQLSetScrollOptions (knihovna kurzorů) Nastaví možnosti, které řídí chování kurzoru. Tato funkce je v rozhraní ODBC 3.x zastaralá; místo toho použijte SQLSetStmtAttr atributy související s kurzorem.
SQLSetConnectAttr (knihovna kurzorů) Nastaví atribut připojení. Knihovna kurzorů SQL_ATTR_ODBC_CURSORS zpracovává atribut tak, aby povolil nebo zakázal použití knihovny kurzorů.
SQLSetEnvAttr (knihovna kurzorů) Nastaví atribut prostředí. Knihovna kurzorů předá toto volání správci ovladačů.

Operace překladu a řádku SQL

Tyto funkce zpracovávají překlad příkazů SQL a načítání počtu řádků.

Funkce Description
SQLNativeSql (knihovna kurzorů) Vrátí řetězec SQL upravený ovladačem. Knihovna kurzorů předá toto volání ovladači beze změny.
SQLRowCount (knihovna kurzorů) Vrací počet řádků ovlivněných UPDATE, INSERT, nebo DELETE tvrzením. Knihovna kurzorů sleduje počty řádků pro poziční operace aktualizace a odstranění.

Související obsah

  • Last updated on