Podsumowanie interfejsu API parametrów wartości tabeli ODBC

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

ODBC obsługuje parametry tabelowe (parametry tabelowe) poprzez ulepszenia kilku istniejących funkcji API. Funkcje te współpracują przy opisywaniu schematów parametrów o wartościach tabelowych, wiązaniu i przesyłaniu zestawów wierszy, pobieraniu metadanych oraz zarządzaniu rekordami deskryptorów.
Poniższe sekcje organizują odpowiednie funkcje ODBC w grupy logiczne, aby pomóc Ci zrozumieć, jak działa każda część potoku parametrów tabelowych.

Funkcje odkrywania schematu parametrów i metadanych o wartościach tabelowych

Te funkcje ułatwiają aplikacji odnajdywanie struktury parametrów wartości tabeli, w tym metadanych kolumn, definicji parametrów i dostępnych typów danych SQL.

Funkcja Przeznaczenie
Sqlcolumns Pobiera metadane kolumn dla parametru lub typu tabeli
Sqldescribeparam Zwraca metadane parametru tabelowego, w tym typ, precyzję i skalę
Sqlgettypeinfo Pobiera typy danych SQL obsługiwane przez sterownik dla kolumn parametrów tabelowych
Sqlprimarykeys Dostarcza informacji o kluczowych kolumnach w typach tabel używanych z parametrami tabelowymi
Sqlprocedurecolumns Pobiera metadane dla parametrów procedur przechowywanych o parametrach tabelowych
Sqltables Lista tabel i typów tabel dostępnych jako źródła deklaracji parametrów tabelowych

Wiązanie parametrów według tabel i transmisja danych

Te funkcje obsługują powiązanie danych strukturalnych z parametrami, przekazywanie danych do serwera lub wiersze przesyłania strumieniowego podczas wykonywania.

Funkcja Przeznaczenie
Sqlbindparameter Wiąże parametr z wartością tabeli z buforem aplikacji lub zestawem wierszy
Sqlparamdata Pobiera kolejną część parametru tabelowego w strumieniu podczas wykonywania danych
Sqlputdata Wysyła dane parametrów tabelowych w fragmentach podczas operacji danych przy wykonywaniu danych

Wykonanie instrukcji dla parametrów tabelowych

Funkcje te wykonują instrukcje SQL odwołujące się do parametrów tabelowych i zarządzają cyklem życia wykonywania.

Funkcja Przeznaczenie
Sqlexecdirect Wykonuje polecenie SQL używające parametrów tabelowych bez wcześniejszego przygotowania
Sqlexecute Wykonuje wcześniej przygotowane polecenie SQL, które zawiera parametry parametrów tabelowych

Zarządzanie deskryptorami i atrybutami dla parametrów tabelowych

Te funkcje umożliwiają zarządzanie polami deskryptora i atrybutami instrukcji wymaganymi do poprawnego opisywania zestawów wierszy i parametrów strukturalnych.

Funkcja Przeznaczenie
Sqlgetdescfield Pobiera metadane deskryptorów dla kolumn lub zestawów wierszy o wartości tabelowej
SQLSetDescField Ustala metadane deskryptorów dla kolumn lub zestawów wierszy o wartości tabelowej
Sqlsetdescrec Ustawia pełny rekord deskryptorowy dla strukturyzowanych danych parametrów tabelowych
SQLGetStmtAttr Pobiera atrybuty instrukcji wpływające na zachowanie parametrów tabelowych
SQLSetStmtAttr Ustawia atrybuty instrukcji, takie jak rozmiary wierszy czy flagi strumieniowe dla operacji parametrów tabelowych

Diagnostyka i obsługa błędów parametrów tabelowych

Wykorzystaj te funkcje, aby pomóc swoim aplikacjom wykrywać błędy, ostrzeżenia lub komunikaty statusowe podczas wiązania i wykonywania parametrów według tabeli.

Funkcja Przeznaczenie
Sqlgetdiagfield Pobiera informacje diagnostyczne generowane podczas przetwarzania parametrów tabelowych