sys.sp_create_event_stream_group (Transact-SQL)

Gäller för: SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL-databas i Microsoft Fabric

Skapar en händelsegruppström för funktionen change event streaming (CES) som introducerades i SQL Server 2025 (17.x).

Transact-SQL syntaxkonventioner

Syntax

sys.sp_create_event_stream_group
    [ @stream_group_name = ] N'stream_group_name'
    , [ @destination_type = ] N'destination_type'
    , [ @destination_location = ] N'destination_location'
    , [ @destination_credential = ] N'destination_credential'
    [ , [ @max_message_size_kb = ] max_message_size_kb ]
    [ , [ @partition_key_scheme = ] N'partition_key_scheme' ]
    [ , [ @partition_key_column_name = ] N'partition_key_column_name' ]
    [ , [ @encoding = ] N'encoding' ]
[ ; ]

Argumentpunkter

[ @stream_group_name = ] N'stream_group_name'

Anger namnet på den händelseströmsgrupp som du vill skapa. @stream_group_name är sysname, utan standard och kan inte vara NULL.

[ @destination_type = ] N'destination_type'

Anger måltypen för direktuppspelning. @destination_type är sysname, utan standard och kan inte vara NULL.

@destination_type kan vara något av följande värden:

[ @destination_location = ] N'destination_location'

Beskriver Azure Event Hubs-namnområdet och instansnamnet. @destination_location är nvarchar(4000), utan standard och kan inte vara NULL.

För Apache Kafka-protokollet anger du porten.

[ @destination_credential = ] N'destination_credential'

Anger namnet på databasomfattningen för autentiseringsuppgifter som ska användas. @destination_credential är sysname, utan standard och kan inte vara NULL.

[ @max_message_size_kb = ] max_message_size_kb

Om det anges definierar du den maximala CES-meddelandestorleken i kilobyte. @max_message_size_kb är int och kan inte vara NULL. Meddelandet delas om det överskrider den angivna maxstorleken. Den här parametern är valfri.

@max_message_size_kb har följande egenskaper:

Parametern @max_message_size_kb bör justeras till målets gränser. Den maximala meddelandestorleken för Azure Event Hubs är till exempel 1 MB för nivåerna Standard och Premium. Mer information finns i kvoter för Azure Event Hubs.

[ @partition_key_scheme = ] N'partition_key_scheme'

Definierar typen av partitionering. @partition_key_scheme är sysname och får inte vara NULL.

@partition_key_scheme kan vara något av följande värden:

[ @partition_key_column_name = ] N'partition_key_column_name'

Definierar vilken kolumn som ska användas för partitionering när @partition_key_scheme är inställt på Column. @partition_key_column_name är sysname och får inte vara NULL.

Använd ett tvådelade namn för kolumnen som innehåller både schemanamnet och kolumnnamnet. Ett giltigt värde är dbo.Addressestill exempel .

[ @encoding = ] N'encoding'

Anger meddelandekodningen. @encoding är sysname och kan inte vara NULL.

@encoding kan vara något av följande värden:

• JSON (standardinställning)
• Binary

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Behörigheter

En användare med CONTROL databasbehörigheter, db_owner databasrollmedlemskap eller sysadmin-serverrollmedlemskap kan utföra den här proceduren.

Exempel

A. Create event stream group on Azure SQL Database

EXECUTE sys.sp_create_event_stream_group
    @stream_group_name = N'myStreamGroup',
    @destination_type = N'AzureEventHubs',
    @destination_location = N'myEventHubsNamespace.servicebus.windows.net:9093/myEventHubsInstance',
    @destination_credential = MyDatabaseScopedCredentialForCes;

B. Skapa event stream-grupp på Azure SQL Managed Instance eller SQL Server 2025

EXECUTE sys.sp_create_event_stream_group
    @stream_group_name = N'myStreamGroup',
    @destination_type = N'AzureEventHubsApacheKafka',
    @destination_location = N'myEventHubsNamespace.servicebus.windows.net:9093/myEventHubsInstance',
    @destination_credential = MyDatabaseScopedCredentialForCes;

Relaterat innehåll

• Vad är ändringshändelseströmning (förhandsversion)?
• Configure change event streaming (preview) to Azure Event Hubs