catalog.create_execution (Database SSISDB)

  • Artikel

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

Berlaku untuk:SQL Server

Membuat instans eksekusi di katalog Layanan Integrasi.

Prosedur tersimpan ini menggunakan tingkat pengelogan server default.

Sintaks

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

Argumen

[@folder_name =] folder_name
Nama folder yang berisi paket yang akan dijalankan. folder_name adalah nvarchar(128).

[@project_name =] project_name
Nama proyek yang berisi paket yang akan dijalankan. project_name adalah nvarchar(128).

[@package_name =] package_name
Nama paket yang akan dijalankan. package_name adalah nvarchar(260).

[@reference_id =] reference_id
Pengidentifikasi unik untuk referensi lingkungan. Parameter ini bersifat opsional. Reference_id itu besar.

[@use32bitruntime =] use32bitruntime
Menunjukkan apakah runtime 32-bit harus digunakan untuk menjalankan paket pada sistem operasi 64-bit. Gunakan nilai 1 untuk menjalankan paket dengan runtime 32-bit saat berjalan pada sistem operasi 64-bit. Gunakan nilai 0 untuk menjalankan paket dengan runtime 64-bit saat berjalan pada sistem operasi 64-bit. Parameter ini bersifat opsional. Use32bitruntimeadalah bit.

[@runinscaleout =] runinscaleout
Menunjukkan apakah eksekusi berada dalam Peluasan Skala. Gunakan nilai 1 untuk menjalankan paket di Scale Out. Gunakan nilai 0 untuk menjalankan paket tanpa Peluasan Skala. Parameter ini bersifat opsional. Jika tidak ditentukan, nilainya diatur ke DEFAULT_EXECUTION_MODE di [SSISDB]. [katalog]. [catalog_properties]. Runinscaleoutadalah bit.

[@useanyworker =] useanyworker
Menunjukkan apakah ada Pekerja Peluasan Skala yang diizinkan untuk melakukan eksekusi.

  • Gunakan nilai 1 untuk menjalankan paket dengan Scale Out Worker apa pun. Ketika Anda mengatur @useanyworker ke true, setiap pekerja yang jumlah tugas maksimumnya (seperti yang ditentukan dalam file konfigurasi pekerja) belum tercapai tersedia untuk menjalankan paket. Untuk informasi tentang file konfigurasi pekerja, lihat Integration Services (SSIS) Scale Out Worker.

  • Gunakan nilai 0 untuk menunjukkan bahwa tidak semua Pekerja Peluasan Skala diizinkan untuk menjalankan paket. Ketika Anda mengatur @useanyworker ke false, Anda harus menentukan pekerja yang diizinkan untuk menjalankan paket dengan menggunakan Scale Out Manager atau dengan memanggil prosedur [catalog].[add_execution_worker]tersimpan . Jika Anda menentukan pekerja yang sudah menjalankan paket lain, pekerja selesai menjalankan paket saat ini sebelum meminta eksekusi lain.

Parameter ini bersifat opsional. Jika tidak ditentukan, nilainya diatur ke 1. Useanyworkersedikit.

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

Keterangan

Eksekusi digunakan untuk menentukan nilai parameter yang digunakan paket selama satu instans eksekusi paket.

Jika referensi lingkungan ditentukan dengan parameter reference_id , prosedur tersimpan mengisi parameter proyek dan paket dengan nilai harfiah atau nilai yang dirujuk dari variabel lingkungan yang sesuai. Jika referensi lingkungan ditentukan, nilai parameter default digunakan selama eksekusi paket. Untuk menentukan dengan tepat nilai mana yang digunakan untuk instans eksekusi tertentu, gunakan nilai parameter output execution_id dari prosedur tersimpan ini dan kueri tampilan execution_parameter_values .

Hanya paket yang ditandai sebagai paket titik masuk yang dapat ditentukan dalam eksekusi. Jika paket yang bukan titik masuk ditentukan, eksekusi gagal.

Contoh

Contoh berikut memanggil catalog.create_execution untuk membuat instans eksekusi untuk paket Child1.dtsx, yang tidak dalam Peluasan Skala. 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 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

Jika @runinscaleout adalah 1, prosedur tersimpan memerlukan salah satu izin berikut:

  • Keanggotaan ke peran database ssis_admin

  • Keanggotaan ke peran database ssis_cluster_executor

  • Keanggotaan ke peran server sysadmin

Kesalahan dan peringatan

Daftar berikut ini menjelaskan beberapa kondisi yang dapat memunculkan kesalahan atau peringatan:

  • Paket tidak ada.

  • Pengguna tidak memiliki izin yang sesuai.

  • Referensi lingkungan, reference_id, tidak valid.

  • Paket yang ditentukan bukan paket titik masuk.

  • Jenis data variabel lingkungan yang dirujuk berbeda dari jenis data parameter proyek atau paket.

  • Proyek atau paket berisi parameter yang memerlukan nilai, tetapi tidak ada nilai yang ditetapkan.

  • Variabel lingkungan yang dirujuk tidak dapat ditemukan di lingkungan yang ditentukan oleh referensi lingkungan, reference_id.

Lihat juga

catalog.start_execution (Database SSISDB)
catalog.set_execution_parameter_value (Database SSISDB)
catalog.add_execution_worker (Database SSISDB)