Używanie parametrów zapytań

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

Parametr to zmienna w instrukcji SQL, która może umożliwić aplikacji ODBC na:

  • Efektywnie dostarczaj wartości dla kolumn w tabeli.

  • Zwiększ interakcję użytkownika przy tworzeniu kryteriów zapytań.

  • Zarządzanie danymi tekstowymi, ntextowymi i obrazowymi oraz specyficznymi dla SQL Server typami danych w C.

Na przykład tabela Części ma kolumny o nazwach PartID,Description oraz Price. Aby dodać część bez parametrów, konieczne jest skonstruowanie instrukcji SQL takiej jak:

INSERT INTO Parts (PartID, Description, Price) VALUES (2100, 'Drive shaft', 50.00)  

Chociaż to stwierdzenie jest dopuszczalne do wstawiania jednego wiersza z znanym zestawem wartości, jest niewygodne, gdy aplikacja wymaga wstawienia kilku wierszy. ODBC rozwiązuje ten problem, pozwalając aplikacji zastąpić dowolną wartość danych w instrukcji SQL znacznikiem parametru. Jest to oznaczone znakiem zapytania (?). W poniższym przykładzie trzy wartości danych zastępuje się markerami parametrów:

INSERT INTO Parts (PartID, Description, Price) VALUES (?, ?, ?)  

Znaczniki parametrów są następnie powiązane ze zmiennymi aplikacji. Aby wstawić nowy wiersz, aplikacja musi jedynie ustawić wartości zmiennych i wykonać polecenie. Następnie sterownik pobiera bieżące wartości zmiennych i wysyła je do źródła danych. Jeśli polecenie jest wykonywane wielokrotnie, aplikacja może uczynić proces jeszcze bardziej efektywnym, przygotowując oświadczenie.

Każdy marker parametru jest odwoływany przez jego numer porządkowy przypisany parametrom od lewej do prawej. Najbardziej lewy marker parametru w instrukcji SQL ma wartość porządkową 1; następny to porządkowy 2 i tak dalej.

W tej Sekcji