sp_cursorprepexec (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-databas i Förhandsversion av Microsoft Fabric

Kompilerar en plan för den skickade markörsatsen eller batchen och skapar och fyller sedan markören. sp_cursorprepexec kombinerar funktionerna i sp_cursorprepare och sp_cursorexecute. Den här proceduren anropas genom att ange ID = 5 i ett TDS-paket (Tabular Data Stream).

Transact-SQL syntaxkonventioner

Syntax

sp_cursorprepexec prepared handle OUTPUT , cursor OUTPUT , params , statement , options
    [ , scrollopt [ , ccopt [ , rowcount ] ] ]
    [ , '@parameter_name [ , ...n ]' ]

Argument

förberett handtag

En SQL Server-genererad förberedd handtag identifierare. Den förberedda referensparametern krävs och returnerar int.

markören

DEN SQL Server-genererade markören identifierare. Markörparametern är en obligatorisk parameter som måste anges för alla efterföljande procedurer som agerar på den här markören, till exempel sp_cursorfetch.

params

Identifierar parametriserade instruktioner. params definition av variabler ersätts med parametermarkörer i -instruktionen. Parametern params krävs. När detta anges anropar params ett ntext-, nchar- eller nvarchar-indatavärde .

-instruktion

Definierar markörens resultatuppsättning. Parametern -instruktionen krävs och anropar ett ntext-, nchareller nvarchar indatavärde.

alternativ

En valfri parameter som returnerar en beskrivning av kolumnerna i markörresultatuppsättningen. Alternativparametern kräver följande indatavärde i int.

scrollopt

Rullningsalternativ. Parametern scrollopt är valfri. När detta anges kräver scrollopt något av följande indatavärden i indata .

På grund av möjligheten att det begärda alternativet inte är lämpligt för markören som definieras av -instruktionenfungerar den här parametern både som indata och utdata. I sådana fall tilldelar SQL Server en lämplig typ och ändrar det här värdet.

ccopt

Alternativ för samtidighetskontroll. Ccopt-parametern är valfri. När den anges kräver ccopt-parametern något av följande indatavärden.

Precis som med scrolloptkan SQL Server tilldela ett annat värde än det som begärdes.

rowcount

En valfri parameter som anger antalet hämtningsbuffertar som ska användas med AUTO_FETCH. Standardvärdet är 20 rader. Parametern rowcount fungerar annorlunda när den tilldelas som ett indatavärde jämfört med ett returvärde.

parameter_name

Anger ett eller flera parameternamn enligt definitionen i parametern params . Det måste finnas en parameter som anges för varje parameter som ingår i params. Den här parametern krävs inte när Transact-SQL-instruktionen eller batchen i params inte har några definierade parametrar.

Returnera kodvärden

Om värdet params returnerar NULLparameteriseras inte -instruktionen.

Exempel

Det här exemplet visar användningen av sp_cursorprepexec. Den kör en fråga mot Person tabellen i AdventureWorks2022 databasen som returnerar alla poster där förnamnet är "Kirby".

USE AdventureWorks2022;
GO

DECLARE @prep_handle INT,
    @cursor INT,
    @scrollopt INT = 4104,
    @ccopt INT = 8193,
    @rowcnt INT;

EXECUTE sp_cursorprepexec
    @prep_handle OUTPUT,
    @cursor OUTPUT,
    N'@fName nvarchar(100)',
    N'SELECT FirstName, LastName FROM Person.Person WHERE FirstName = @fName',
    @scrollopt,
    @ccopt,
    @rowcnt OUTPUT,
    'Kirby';

EXECUTE sp_cursorfetch @cursor;

Relaterat innehåll

• sp_cursoropen (Transact-SQL)
• sp_cursorexecute (Transact-SQL)
• sp_cursorprepare (Transact-SQL)
• sp_cursorfetch (Transact-SQL)
• System lagrade procedurer (Transact-SQL)