sp_sequence_get_range (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse Analytics

Gibt einen Bereich von Sequenzwerten eines Sequenzobjekts zurück. Das Sequenzobjekt generiert die angeforderte Anzahl der Werte, gibt diese aus und stellt Metadaten bezüglich des Bereichs für die Anwendung bereit.

Weitere Informationen zu Sequenznummern finden Sie unter Sequenznummern.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_sequence_get_range [ @sequence_name = ] N'<sequence>'   
     , [ @range_size = ] range_size  
     , [ @range_first_value = ] range_first_value OUTPUT   
    [, [ @range_last_value = ] range_last_value OUTPUT ]  
    [, [ @range_cycle_count = ] range_cycle_count OUTPUT ]  
    [, [ @sequence_increment = ] sequence_increment OUTPUT ]  
    [, [ @sequence_min_value = ] sequence_min_value OUTPUT ]  
    [, [ @sequence_max_value = ] sequence_max_value OUTPUT ]  
    [ ; ]  

Argumente

[ @sequence_name = ] N'sequence' Der Name des Sequenzobjekts. Das Schema ist optional. sequence_name ist nvarchar(776).

[ @range_size = ] range_size Die Anzahl der Werte, die aus der Sequenz abgerufen werden sollen. @range_size ist bigint.

[ @range_first_value = ] range_first_value Der Ausgabeparameter gibt den ersten (minimalen oder maximalen) Wert des Sequenzobjekts zurück, das zum Berechnen des angeforderten Bereichs verwendet wird. @range_first_value wird mit demselben Basistyp wie das in der Anforderung verwendete Sequenzobjekt sql_variant .

[ @range_last_value = ] range_last_value Der optionale Ausgabeparameter gibt den letzten Wert des angeforderten Bereichs zurück. @range_last_value wird mit demselben Basistyp wie das in der Anforderung verwendete Sequenzobjekt sql_variant .

[ @range_cycle_count = ] range_cycle_count Der optionale Ausgabeparameter gibt die Häufigkeit zurück, mit der das Sequenzobjekt gezyklust wurde, um den angeforderten Bereich zurückzugeben. @range_cycle_count ist int.

[ @sequence_increment = ] sequence_increment Der optionale Ausgabeparameter gibt das Inkrement des Sequenzobjekts zurück, das zum Berechnen des angeforderten Bereichs verwendet wird. @sequence_increment wird mit demselben Basistyp wie das in der Anforderung verwendete Sequenzobjekt sql_variant .

[ @sequence_min_value = ] sequence_min_value Der optionale Ausgabeparameter gibt den Mindestwert des Sequenzobjekts zurück. @sequence_min_value wird mit demselben Basistyp wie das in der Anforderung verwendete Sequenzobjekt sql_variant .

[ @sequence_max_value = ] sequence_max_value Der optionale Ausgabeparameter gibt den maximalen Wert des Sequenzobjekts zurück. @sequence_max_value wird mit demselben Basistyp wie das in der Anforderung verwendete Sequenzobjekt sql_variant .

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Bemerkungen

sp_sequence_get_rangeis in sys. schema und kann als sys.sp_sequence_get_range referenziert werden.

Zyklussequenzen

Falls erforderlich, durchläuft das Sequenzobjekt die entsprechende Anzahl von Zyklen, um den angeforderten Bereich zu versorgen. Die Anzahl der Zyklussequenzen wird mit dem @range_cycle_count-Parameter an den Aufrufer zurückgegeben.

Hinweis

Der Durchlauf des Sequenzobjekts beginnt beim Minimalwert, wenn es sich um eine aufsteigende Sequenz handelt, und beim Maximalwert, wenn es sich um eine absteigende Sequenz handelt, nicht beim Startwert des Sequenzobjekts.

Nicht-zyklische Sequenzen

Wenn die Anzahl der Werte im angeforderten Bereich größer als die Anzahl der verbleibenden Werte im Sequenzobjekt ist, kann der angeforderte Bereich nicht vom Sequenzobjekt abgezogen werden, und der folgende Fehler 11732 wird zurückgegeben:

The requested range for sequence object '%.*ls' exceeds the maximum or minimum limit. Retry with a smaller range.

Berechtigungen

Erfordert die UPDATE-Berechtigung für das Sequenzobjekt oder das Schema des Sequenzobjekts.

Beispiele

In den folgenden Beispielen wird ein Sequenzobjekt namens Test.RangeSeq verwendet. Verwenden Sie die folgende Anweisung, um die Test.RangeSeq-Sequenz zu erstellen.

CREATE SCHEMA Test ;  
GO  
  
CREATE SEQUENCE Test.RangeSeq  
    AS int   
    START WITH 1  
    INCREMENT BY 1  
    MINVALUE 1  
    MAXVALUE 25  
    CYCLE  
    CACHE 10  
;  

A. Abrufen eines Bereichs von Sequenzwerten

Die folgende Anweisung ruft vier Sequenznummern aus dem Test.RangeSeq-Sequenzobjekt ab und gibt die erste der Zahlen an den Benutzer zurück.

DECLARE @range_first_value_output sql_variant ;  
  
EXEC sys.sp_sequence_get_range  
@sequence_name = N'Test.RangeSeq'  
, @range_size = 4  
, @range_first_value = @range_first_value_output OUTPUT ;  
  
SELECT @range_first_value_output AS FirstNumber ;  
  

B. Zurückgeben aller Ausgabeparameter

Im folgenden Beispiel werden alle Ausgabewerte aus der sp_sequence_get_range-Prozedur zurückgegeben.

DECLARE    
  @FirstSeqNum sql_variant  
, @LastSeqNum sql_variant  
, @CycleCount int  
, @SeqIncr sql_variant  
, @SeqMinVal sql_variant  
, @SeqMaxVal sql_variant ;  
  
EXEC sys.sp_sequence_get_range  
@sequence_name = N'Test.RangeSeq'  
, @range_size = 5  
, @range_first_value = @FirstSeqNum OUTPUT   
, @range_last_value = @LastSeqNum OUTPUT   
, @range_cycle_count = @CycleCount OUTPUT  
, @sequence_increment = @SeqIncr OUTPUT  
, @sequence_min_value = @SeqMinVal OUTPUT  
, @sequence_max_value = @SeqMaxVal OUTPUT ;  
  
-- The following statement returns the output values  
SELECT  
  @FirstSeqNum AS FirstVal  
, @LastSeqNum AS LastVal  
, @CycleCount AS CycleCount  
, @SeqIncr AS SeqIncrement  
, @SeqMinVal AS MinSeq  
, @SeqMaxVal AS MaxSeq ;  
  

Eine Änderung des @range_size-Arguments in einen sehr großen Wert wie 75 führt dazu, dass das Sequenzobjekt Zyklen durchläuft. Überprüfen Sie das @range_cycle_count-Argument, um zu ermitteln, ob und in welchem Ausmaß Zyklen vom Sequenzobjekt durchlaufen wurden.

C. Beispiel für die Verwendung von ADO.NET

Im folgenden Beispiel wird ein Bereich von Test.RangeSeq mithilfe von ADO.NET abgerufen.

SqlCommand cmd = new SqlCommand();  
cmd.Connection = conn;  
cmd.CommandType = CommandType.StoredProcedure;  
cmd.CommandText = "sys.sp_sequence_get_range";  
cmd.Parameters.AddWithValue("@sequence_name", "Test.RangeSeq");  
cmd.Parameters.AddWithValue("@range_size", 10);  
  
// Specify an output parameter to retrieve the first value of the generated range.  
SqlParameter firstValueInRange = new SqlParameter("@range_first_value", SqlDbType.Variant);  
firstValueInRange.Direction = ParameterDirection.Output;  
cmd.Parameters.Add(firstValueInRange);  
  
conn.Open();  
cmd.ExecuteNonQuery();  
  
// Output the first value of the generated range.  
Console.WriteLine(firstValueInRange.Value);  
  

Weitere Informationen

CREATE SEQUENCE (Transact-SQL)
ALTER SEQUENCE (Transact-SQL)
DROP SEQUENCE (Transact-SQL)
NEXT VALUE FOR (Transact-SQL)
Sequenznummern