catalog.start_execution (Database SSISDB)

  • Artikel

Berlaku untuk: Integration Runtime SSIS SQL Server di Azure Data Factory

Berlaku untuk:SQL Server

Memulai instans eksekusi di katalog Layanan Integrasi.

Sintaks

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

Argumen

[@execution_id =] execution_id
Pengidentifikasi unik untuk instans eksekusi. Execution_id itu besar.

[@retry_count =] retry_count
Jumlah coba lagi jika eksekusi gagal. Ini berlaku hanya jika eksekusi berada dalam Peluasan Skala. Parameter ini bersifat opsional. Jika tidak ditentukan, nilainya diatur ke 0. retry_countadalah int.

Keterangan

Eksekusi digunakan untuk menentukan nilai parameter yang digunakan oleh paket selama satu instans eksekusi paket. Setelah instans eksekusi dibuat, sebelum dimulai, proyek yang sesuai mungkin disebarkan ulang. Dalam hal ini, instans eksekusi mereferensikan proyek yang sudah kedaluarsa. Referensi yang tidak valid ini menyebabkan prosedur tersimpan gagal.

Catatan

Eksekusi hanya dapat dimulai sekali. Untuk memulai instans eksekusi, instans harus dalam status dibuat (nilai 1 di kolom status tampilan catalog.operations ).

Contoh

Contoh berikut memanggil catalog.create_execution untuk membuat instans eksekusi untuk paket Child1.dtsx. Integration Services Project1 berisi paket. Contoh memanggil catalog.set_execution_parameter_value untuk mengatur nilai untuk parameter Parameter1, Parameter2, dan LOGGING_LEVEL. Contoh memanggil catalog.start_execution untuk memulai instans eksekusi.

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

Mengembalikan Nilai Kode

0 (berhasil)

Tataan Hasil

Tidak ada

Izin

Prosedur tersimpan ini memerlukan salah satu izin berikut:

  • Izin BACA dan MODIFIKASI pada instans eksekusi, izin READ dan EXECUTE pada proyek, dan jika berlaku, izin READ pada lingkungan yang dirujuk

  • Keanggotaan ke peran database ssis_admin

  • Keanggotaan ke peran server sysadmin

Kesalahan dan peringatan

Daftar berikut ini menjelaskan beberapa kondisi yang mungkin menimbulkan kesalahan atau peringatan:

  • Pengguna tidak memiliki izin yang sesuai

  • Pengidentifikasi eksekusi tidak valid

  • Eksekusi telah dimulai, atau telah selesai; eksekusi hanya dapat dimulai sekali

  • Referensi lingkungan yang terkait dengan proyek tidak valid

  • Nilai parameter yang diperlukan belum ditetapkan

  • Versi proyek yang terkait dengan instans eksekusi sudah kedaluarsa; hanya versi proyek terbaru yang dapat dijalankan