Partilhar via

catalog.start_execution (Banco de Dados SSISDB)

se aplica a:SQL Server SSIS Integration Runtime no Azure Data Factory

Aplica-se a:SQL Server

Inicia uma instância de execução no catálogo do Integration Services.

Sintaxe

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

Argumentos

[@execution_id =] execution_id
O identificador exclusivo para a instância de execução. O execution_id é bigint.

[@retry_count =] retry_count
A repetição conta se a execução falhar. Só entra em vigor se a execução estiver em Scale out. Este parâmetro é opcional. Se não for especificado, seu valor será definido como 0. O retry_count é int.

Comentários

Uma execução é usada para especificar os valores de parâmetro que são usados por um pacote durante uma única instância de execução do pacote. Depois que uma instância de execução tiver sido criada, antes de ser iniciada, o projeto correspondente poderá ser reimplantado. Nesse caso, a instância de execução faz referência a um projeto que está desatualizado. Essa referência inválida faz com que o procedimento armazenado falhe.

Observação

As execuções só podem ser iniciadas uma vez. Para iniciar uma instância de execução, ela deve estar no estado criado (um valor de 1 na coluna status da exibição catalog.operations).

Exemplo

O exemplo a seguir chama catalog.create_execution para criar uma instância de execução para o pacote Child1.dtsx. O Integration Services Project1 contém o pacote. O exemplo chama catalog.set_execution_parameter_value para definir valores para os parâmetros Parameter1, Parameter2 e LOGGING_LEVEL. O exemplo chama catalog.start_execution para iniciar uma instância de execução.

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

Valor do código de retorno

0 (sucesso)

Conjuntos de resultados

Nenhum

Permissões

Este procedimento armazenado requer uma das seguintes permissões:

  • Permissões READ e MODIFY na instância de execução, permissões READ e EXECUTE no projeto e, se aplicável, permissões READ no ambiente referenciado

  • Associação à função de banco de dados ssis_admin

  • Associação à função de servidor sysadmin

Erros e Avisos

A lista a seguir descreve algumas condições que podem gerar um erro ou aviso:

  • O usuário não tem as permissões apropriadas

  • O identificador de execução não é válido

  • A execução já foi iniciada ou já foi concluída; As execuções podem ser iniciadas apenas uma vez

  • A referência de ambiente associada ao projeto não é válida

  • Os valores dos parâmetros necessários não foram definidos

  • A versão do projeto associada à instância de execução está desatualizada; apenas a versão mais atual de um projeto pode ser executada

  • Last updated on