Прокрутка и выборка строк — создание закладок строк в ODBC
Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)
Закладка представляет собой значение, используемое для идентификации строки данных. Содержание значения закладки понятно только драйверу или источнику данных. Например, оно может быть простым (номером строки) или сложным (адрес на диске). В ODBC приложение запрашивает закладку для конкретной строки, сохраняет ее и передает обратно курсору для возврата к строке.
При выборе строк с помощью SQLFetchScroll приложение может использовать закладку в качестве основы для выбора начальной строки. Такой способ представляет собой форму абсолютной адресации, поскольку не зависит от текущей позиции курсора. Чтобы прокрутить страницу до закладок, приложение вызывает SQLFetchScroll с помощью FetchOrientation SQL_FETCH_BOOKMARK. Эта операция использует закладку, на которую указывает атрибут параметра SQL_ATTR_FETCH_BOOKMARK_PTR. Она возвращает набор строк, начинающийся со строки, определяемой закладкой. Приложение может указать смещение для этой операции в аргументе FetchOffset вызова SQLFetchScroll. При указании смещения первая строка возвращаемого набора строк определяется сложением числа в аргументе FetchOffset с номером строки, определяемой закладкой. Драйвер ODBC собственного клиента SQL Server поддерживает только закладки на статических и ключевых курсорах. Если при включенных закладках запрошен динамический курсор, то вместо него открывается курсор, управляемый набором ключей.
Закладки также можно использовать с функцией SQLBulkOperations для выполнения операций с набором строк, начиная с закладки.