catalog.create_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 maakt u een exemplaar van uitvoering in de integration services-catalogus.

Deze opgeslagen procedure maakt gebruik van het standaardniveau voor serverlogboekregistratie.

Syntaxis

catalog.create_execution [ @folder_name = ] folder_name  
     , [ @project_name = ] project_name  
     , [ @package_name = ] package_name  
  [  , [ @reference_id = ] reference_id ]  
  [  , [ @use32bitruntime = ] use32bitruntime ] 
  [  , [ @runinscaleout = ] runinscaleout ]
  [  , [ @useanyworker = ] useanyworker ] 
     , [ @execution_id = ] execution_id OUTPUT

Argumenten

[@folder_name =] folder_name
De naam van de map die het pakket bevat dat moet worden uitgevoerd. De folder_name is nvarchar(128).

[@project_name =] project_name
De naam van het project dat het pakket bevat dat moet worden uitgevoerd. De project_name is nvarchar(128).

[@package_name =] package_name
De naam van het pakket dat moet worden uitgevoerd. De package_name is nvarchar(260).

[@reference_id =] reference_id
Een unieke id voor een omgevingsreferentie. Deze parameter is optioneel. De reference_id is grote.

[@use32bitruntime =] use32bitruntime
Geeft aan of de 32-bits runtime moet worden gebruikt om het pakket uit te voeren op een 64-bits besturingssysteem. Gebruik de waarde van 1 om het pakket uit te voeren met de 32-bits runtime bij uitvoering op een 64-bits besturingssysteem. Gebruik de waarde van 0 om het pakket uit te voeren met de 64-bits runtime bij uitvoering op een 64-bits besturingssysteem. Deze parameter is optioneel. De Use32bitruntime is bit.

[@runinscaleout =] runinscaleout
Geef aan of de uitvoering in Uitschalen is. Gebruik de waarde 1 om het pakket uit te voeren in Uitschalen. Gebruik de waarde 0 om het pakket uit te voeren zonder uitschalen. Deze parameter is optioneel. Als deze niet is opgegeven, wordt de waarde ingesteld op DEFAULT_EXECUTION_MODE in [SSISDB]. [catalogus]. [catalog_properties]. De runinscaleout- is bit.

[@useanyworker =] useanyworker
Geef aan of een Scale Out Worker de uitvoering mag uitvoeren.

Gebruik de waarde 1 om het pakket uit te voeren met een Scale Out Worker. Wanneer u @useanyworker instelt op true, is een werkrol waarvan het maximumaantal taken (zoals opgegeven in het configuratiebestand van de werkrol) nog niet is bereikt om het pakket uit te voeren. Zie Integration Services (SSIS) Scale Out Workervoor informatie over het werkrolconfiguratiebestand.
Gebruik de waarde 0 om aan te geven dat niet alle Scale Out Workers het pakket mogen uitvoeren. Wanneer u @useanyworker instelt op false, moet u de werkrollen opgeven die het pakket mogen uitvoeren met scale-outbeheer of door de opgeslagen procedure aan te roepen [catalog].[add_execution_worker]. Als u een werkrol opgeeft die al een ander pakket uitvoert, voltooit de werkrol het huidige pakket voordat er een andere uitvoering wordt aangevraagd.

Deze parameter is optioneel. Als deze niet is opgegeven, wordt de waarde ingesteld op 1. De useanyworker- is bit.

[@execution_id =] execution_id
Retourneert de unieke id voor een exemplaar van uitvoering. De execution_id is grote.

Opmerkingen

Een uitvoering wordt gebruikt om de parameterwaarden op te geven die een pakket gebruikt tijdens één exemplaar van pakketuitvoering.

Als een omgevingsreferentie wordt opgegeven met de parameter reference_id, vult de opgeslagen procedure het project en pakketparameters met letterlijke waarden of waarden waarnaar wordt verwezen uit de bijbehorende omgevingsvariabelen. Als de omgevingsreferentie is opgegeven, worden standaardparameterwaarden gebruikt tijdens de uitvoering van het pakket. Als u precies wilt bepalen welke waarden worden gebruikt voor een bepaald exemplaar van uitvoering, gebruikt u de execution_id uitvoerparameterwaarde uit deze opgeslagen procedure en voert u een query uit op de execution_parameter_values weergave.

Alleen pakketten die zijn gemarkeerd als toegangspuntpakketten, kunnen worden opgegeven in een uitvoering. Als een pakket dat geen toegangspunt is opgegeven, mislukt de uitvoering.

Voorbeeld

In het volgende voorbeeld wordt catalog.create_execution aanroepen om een exemplaar van uitvoering te maken voor het Child1.dtsx-pakket, dat zich niet in Scale Out bevindt. 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 EXECUTE-machtigingen voor het project en, indien van toepassing, LEESmachtigingen voor de omgeving waarnaar wordt verwezen
Lidmaatschap van de ssis_admin-databaserol
Lidmaatschap van de sysadmin serverfunctie

Als @runinscaleout 1 is, is voor de opgeslagen procedure een van de volgende machtigingen vereist:

Lidmaatschap van de ssis_admin-databaserol
Lidmaatschap van de ssis_cluster_executor-databaserol
Lidmaatschap van de sysadmin serverfunctie

Fouten en waarschuwingen

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

Het pakket bestaat niet.
De gebruiker heeft niet de juiste machtigingen.
De omgevingsreferentie, reference_id, is ongeldig.
Het opgegeven pakket is geen toegangspuntpakket.
Het gegevenstype van de omgevingsvariabele waarnaar wordt verwezen, verschilt van het gegevenstype van het project of de pakketparameter.
Het project of pakket bevat parameters waarvoor waarden zijn vereist, maar er zijn geen waarden toegewezen.
De omgevingsvariabelen waarnaar wordt verwezen, kunnen niet worden gevonden in de omgeving waarin de omgevingsreferentie, reference_id, aangeeft.

Zie ook

catalog.start_execution (SSISDB-database)
catalog.set_execution_parameter_value (SSISDB-database)
catalog.add_execution_worker (SSISDB-database)

Delen via