catalog.start_execution (SSISDB-database)

Artikel
2025-03-05

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

van toepassing op:SQL Server-

Hiermee start u een exemplaar van de uitvoering in de integration services-catalogus.

Syntaxis

catalog.start_execution [ @execution_id = ] execution_id [, [ @retry_count = ] retry_count]

Argumenten

[@execution_id =] execution_id
De unieke id voor het exemplaar van uitvoering. De execution_id is grote.

[@retry_count =] retry_count
Het aantal nieuwe pogingen als de uitvoering mislukt. Dit wordt alleen van kracht als de uitvoering in Uitschalen is. Deze parameter is optioneel. Als deze niet is opgegeven, wordt de waarde ingesteld op 0. De retry_count is int.

Opmerkingen

Een uitvoering wordt gebruikt om de parameterwaarden op te geven die door een pakket worden gebruikt tijdens één exemplaar van pakketuitvoering. Nadat een exemplaar van de uitvoering is gemaakt, kan het bijbehorende project opnieuw worden geïmplementeerd voordat het is gestart. In dit geval verwijst het exemplaar van de uitvoering naar een project dat verouderd is. Deze ongeldige verwijzing zorgt ervoor dat de opgeslagen procedure mislukt.

Notitie

Uitvoeringen kunnen slechts eenmaal worden gestart. Als u een instantie van uitvoering wilt starten, moet deze de status gemaakt hebben (een waarde van 1 in de kolom status kolom van de catalog.operations weergave).

Voorbeeld

In het volgende voorbeeld wordt catalog.create_execution aanroepen om een exemplaar van uitvoering te maken voor het child1.dtsx-pakket. Integration Services Project1 bevat het pakket. In het voorbeeld wordt catalog.set_execution_parameter_value aanroepen om waarden in te stellen voor de parameters Parameter1, Parameter2 en LOGGING_LEVEL. In het voorbeeld wordt catalog.start_execution aanroepen om een exemplaar van uitvoering te starten.

Declare @execution_id bigint  
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Child1.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'TestDeply4', @project_name=N'Integration Services Project1', @use32bitruntime=False, @reference_id=Null  
Select @execution_id  
DECLARE @var0 sql_variant = N'Child1.dtsx'  
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter1', @parameter_value=@var0  
DECLARE @var1 sql_variant = N'Child2.dtsx'  
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter2', @parameter_value=@var1  
DECLARE @var2 smallint = 1  
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var2  
EXEC [SSISDB].[catalog].[start_execution] @execution_id  
GO

Retourcodewaarde

0 (geslaagd)

Resultatensets

Geen

Machtigingen

Voor deze opgeslagen procedure zijn een van de volgende machtigingen vereist:

LEES- en WIJZIGINGsmachtigingen voor het exemplaar van uitvoering, LEES- en EXECUTE-machtigingen voor het project, en, indien van toepassing, LEES-machtigingen voor de omgeving waarnaar wordt verwezen
Lidmaatschap van de ssis_admin-databaserol
Lidmaatschap van de sysadmin serverfunctie

Fouten en waarschuwingen

In de volgende lijst worden enkele voorwaarden beschreven die een fout of waarschuwing kunnen veroorzaken:

De gebruiker beschikt niet over de juiste machtigingen
De uitvoerings-id is ongeldig
De uitvoering is al gestart of is al voltooid; uitvoeringen kunnen slechts eenmaal worden gestart
De omgevingsreferentie die aan het project is gekoppeld, is ongeldig
Vereiste parameterwaarden zijn niet ingesteld
De projectversie die is gekoppeld aan het uitvoeringsexemplaar is verouderd; alleen de meest recente versie van een project kan worden uitgevoerd

Delen via