Anropa en lagrad proprodur

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

SQL Server Native Client ODBC-drivrutinen stöder både ODBC CALL-escapesekvensen och Transact-SQLEXEVER-satsen för att köra lagrade procedurer; ODBC CALL-escapesekvensen är den föredragna metoden. Med ODBC-syntax kan en applikation hämta returkoder från lagrade procedurer och SQL Server Native Client ODBC-drivrutinen är också optimerad för att använda ett protokoll som ursprungligen utvecklades för att skicka fjärrprocedurer (RPC)-anrop mellan datorer som kör SQL Server. Detta RPC-protokoll ökar prestandan genom att eliminera mycket av parameterbearbetningen och satsparsningen som görs på servern.

Note

När man anropar SQL Server stored procedures med namngivna parametrar med ODBC (för mer information, se Binding Parameters by Name (Named Parameters)), måste parameternamnen börja med tecknet '@'. Detta är en specifik begränsning för SQL Server. SQL Server Native Client ODBC-drivrutinen upprätthåller denna begränsning striktare än Microsoft Data Access Components (MDAC).

ODBC CALL-escapesekvensen för att anropa en procedur är:

{[?=]anropaprocedure_name[([parameter][,[parameter]]...)]}

där procedure_name anger namnet på en procedur och parametern anger en procedurparameter. Namngivna parametrar stöds endast i satser som använder ODBC CALL escape-sekvensen.

En procedur kan ha noll eller fler parametrar. Den kan också returnera ett värde (som indikeras av den valfria parametermarkören ?= i början av syntaxen). Om en parameter är en indata eller en in-/utmatningsparameter kan den vara en literal eller en parametermarkör. Om parametern är en utgångsparameter måste den vara en parametermarkör eftersom utgången är okänd. Parametermarkörer måste vara bundna med SQLBindParameter innan proceduranropsinstrukeringen körs.

In- och in-/utdataparametrar kan utelämnas från proceduranrop. Om en procedur anropas inom parentes men utan några parametrar, instruerar drivrutinen datakällan att använda standardvärdet för den första parametern. Ett exempel:

{ringprocedure_name( )}

Om proceduren inte har några parametrar kan den misslyckas. Om en procedur anropas utan parenteser skickar drivrutinen inga parametervärden. Ett exempel:

{ringprocedure_name}

Literaler kan anges för in- och indata-/utdataparametrar i proceduranrop. Till exempel har proceduren InsertOrder fem indataparametrar. Följande anrop till InsertOrder utelämnar den första parametern, ger en literal för den andra parametern och använder en parametermarkör för den tredje, fjärde och femte parametern. (Parametrarna numreras sekventiellt, med början på värdet 1.)

{call InsertOrder(, 10, ?, ?, ?)}  

Observera att om en parameter utelämnas måste kommatecknet som avgränsar den från andra parametrar fortfarande förekomma. Om en indata- eller indata-/utdataparameter utelämnas använder proceduren parameterns standardvärde. Andra sätt att ange standardvärdet för en indata eller en in-/utdataparameter är att ställa in värdet på längd-/indikatorbufferten som är bundet till parametern till SQL_DEFAULT_PARAM, eller att använda DEFAULT nyckelordet.

Om en in-/utgångsparameter utelämnas, eller om en literal anges för parametern, kasserar drivrutinen utgångsvärdet. På samma sätt, om parametermarkören för returvärdet för en procedur utelämnas, tar drivrutinen bort returvärdet. Om ett program slutligen anger en returvärdeparameter för en procedur som inte returnerar ett värde anger drivrutinen värdet för den längd-/indikatorbuffert som är bunden till parametern till SQL_NULL_DATA.

Avgränsare i CALL-uttalanden

SQL Server Native Client ODBC-drivrutinen stöder som standard också ett kompatibilitetsalternativ specifikt för ODBC { CALL }-escapesekvensen. Drivrutinen accepterar CALL-satser med endast en uppsättning dubbla citattecken som avgränsar hela namnet på den lagrade proceduren:

{ CALL "master.dbo.sp_who" }  

Som standard accepterar SQL Server Native Client ODBC-drivrutin också CALL-satser som följer ISO-reglerna och omsluter varje identifierare med dubbla citattecken:

{ CALL "master"."dbo"."sp_who" }  

När man kör med standardinställningarna stöder dock inte SQL Server Native Client ODBC-drivrutinen användning av någon form av citerad identifierare med identifierare som innehåller tecken som inte specificerats som lagliga i identifierare enligt ISO-standarden. Till exempel kan drivrutinen inte komma åt en lagrad procedur som heter "My.Proc" med en CALL-sats med citerade identifierare:

{ CALL "MyDB"."MyOwner"."My.Proc" }  

Detta uttalande tolkas av föraren som:

{ CALL MyDB.MyOwner.My.Proc }  

Servern ger ett felmeddelande om att en länkad server vid namn MyDB inte existerar.

Problemet uppstår inte när identifierare används inom parentes, detta påstående tolkas korrekt:

{ CALL [MyDB].[MyOwner].[My.Table] }