catalog.create_execution (Banco de dados SSISDB)

  • Artigo

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

Este procedimento armazenado usa o nível padrão de registro em log do servidor.

Sintaxe

create_execution [ @folder_name = folder_name
     , [ @project_name = ] project_name
     , [ @package_name = ] package_name
  [  , [ @reference_id = ] reference_id ]
  [  , [ @use32bitruntime = ] use32bitruntime ]
     , [ @execution_id = ] execution_id OUTPUT

Argumentos

  • [ @folder\_name = ] folder_name
    O nome da pasta que contém o pacote a ser executado. O folder_name é nvarchar(128).

  • [ @project\_name = ] project_name
    O nome do projeto que contém o pacote a ser executado. O project_name é nvarchar(128).

  • [ @package\_name = ] package_name
    O nome do pacote a ser executado. O package_name é nvarchar(260).

  • [ @reference\_id = ] reference_id
    Um identificador exclusivo para uma referência do ambiente. Esse parâmetro é opcional. O reference_id é bigint.

  • [ @use32bitruntime = ] use32bitruntime
    Indica se o tempo de execução de 32 bits deve ser usado para executar o pacote em um sistema operacional de 64 bits. Use o valor 1 para executar o pacote com o tempo de execução de 32 bits ao executar em um sistema operacional de 64 bits. Use o valor 0 para executar o pacote com o tempo de execução de 64 bits ao executar em um sistema operacional de 64 bits. Esse parâmetro é opcional. O Use32bitruntime é bit.

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

Comentários

Uma execução é usada para especificar os valores de parâmetro que um pacote usa durante uma única instância de execução do pacote.

Se uma referência de ambiente for especificada com o parâmetro reference_id, o procedimento armazenado populará os parâmetros de projeto e pacote com valores literais ou valores referenciados das variáveis de ambiente correspondentes. Se referência de ambiente for especificada, valores de parâmetro padrão serão usados durante a execução do pacote. Para determinar exatamente quais valores são usados para uma determinada instância de execução, use o valor de parâmetro de saída execution_id desse procedimento armazenado e consulte a exibição execution_parameter_values.

Somente pacotes marcados como pacotes de ponto de entrada podem ser especificados em uma execução. Se um pacote que não for ponto de entrada for especificado, a execução falhará.

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 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 pacote não existe.

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

  • A referência de ambiente reference_id não é válida.

  • O pacote especificado não é um pacote de ponto de entrada.

  • O tipo de dados da variável de ambiente referenciada é diferente do tipo de dados do projeto ou parâmetro de pacote.

  • O projeto ou pacote contém parâmetros que requerem valores, mas nenhum valor foi atribuído.

  • As variáveis de ambiente referenciadas não podem ser localizadas no ambiente especificado pela referência de ambiente reference_id.

Consulte também

Referência

catalog.start_execution (Banco de dados SSISDB)

catalog.set_execution_parameter_value (Banco de Dados SSISDB)