catalog.start_execution (Banco de dados SSISDB)

  • Artigo

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

Sintaxe

start_execution [ @execution_id = ] execution_id

Argumentos

  • [ @execution\_id = ] execution_id
    O identificador exclusivo da instância de execução. A execution_id é bigint.

Comentários

Uma execução é usada para especificar os valores de parâmetro que serão utilizados por um pacote durante uma única instância de execução do pacote. Depois que uma instância de execução tiver sido criada e antes que ela tenha sido iniciada, o projeto correspondente deve ser reimplantado. Nesse caso, a instância de execução fará referência a um projeto que está desatualizado. Isso irá gerar falha no procedimento armazenado.

ObservaçãoObservação

As execuções podem ser iniciadas apenas 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. Project1 do Integration Services 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 (êxito)

Conjuntos de resultados

Nenhum

Permissões

Esse procedimento armazenado exige 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 erros ou avisos:

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

  • O identificador da 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 do ambiente associada ao projeto não é válida

  • Os valores do parâmetro exigido não foram definidos

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