catalog.set_execution_parameter_value (Database SSISDB)

  • Artikel

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

Berlaku untuk:SQL Server

Menetapkan nilai parameter untuk instans eksekusi dalam katalog Layanan Integrasi.

Nilai parameter tidak dapat diubah setelah instans eksekusi dimulai.

Sintaks

catalog.set_execution_parameter_value [ @execution_id = execution_id  
    , [ @object_type = ] object_type  
    , [ @parameter_name = ] parameter_name  
    , [ @parameter_value = ] parameter_value

Argumen

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

[ @object_type = ] object_type
Jenis parameter.

Untuk parameter berikut, atur object_type ke 50

  • LOGGING_LEVEL

  • CUSTOMIZED_LOGGING_LEVEL

  • DUMP_ON_ERROR

  • DUMP_ON_EVENT

  • DUMP_EVENT_CODE

  • CALLER_INFO

  • DISINKRONISASI

Gunakan nilai 20 untuk menunjukkan parameter proyek atau nilai 30 untuk menunjukkan parameter paket.

Object_typekecil.

[ @parameter_name = ] parameter_name
Nama parameter. parameter_name adalah nvarchar(128).

[ @parameter_value = ] parameter_value
Nilai untuk parameter. Parameter_valuesql_variant.

Keterangan

Untuk mengetahui nilai parameter yang digunakan untuk eksekusi tertentu, kueri tampilan catalog.execution_parameter_values.

Untuk menentukan cakupan informasi yang dicatat selama eksekusi paket, atur parameter_name ke LOGGING_LEVEL dan atur parameter_value ke salah satu nilai berikut.

Atur parameter object_type ke 50.

Nilai Deskripsi
0 Tidak ada

Pengelogan dimatikan. Hanya status eksekusi paket yang dicatat.
1 Dasar

Semua peristiwa dicatat, kecuali peristiwa kustom dan diagnostik. Ini adalah nilai default.
2 Performa

Hanya statistik performa, dan peristiwa OnError dan OnWarning, yang dicatat.
3 Verbose

Semua peristiwa dicatat, termasuk peristiwa kustom dan diagnostik.
Peristiwa kustom mencakup peristiwa yang dicatat oleh tugas Integration Services. Untuk informasi selengkapnya, lihat Pesan Kustom untuk Pengelogan
4 Silsilah data runtime

Mengumpulkan data yang diperlukan untuk melacak silsilah dalam aliran data.
100 Tingkat pengelogan kustom

Tentukan pengaturan dalam parameter CUSTOMIZED_LOGGING_LEVEL. Untuk informasi selengkapnya tentang nilai yang bisa Anda tentukan, lihat catalog.create_customized_logging_level.

Untuk informasi selengkapnya tentang tingkat pengelogan yang dikustomisasi, lihat Mengaktifkan Pengelogan untuk Eksekusi Paket di Server SSIS.

Untuk menentukan bahwa server Integration Services menghasilkan file cadangan ketika terjadi kesalahan selama eksekusi paket, atur nilai parameter berikut untuk instans eksekusi yang belum berjalan.

Parameter Nilai
execution_id Pengidentifikasi unik untuk instans eksekusi
object_type 50
parameter_name 'DUMP_ON_ERROR
parameter_value 1

Untuk menentukan bahwa server Integration Services menghasilkan file cadangan saat peristiwa terjadi selama eksekusi paket, atur nilai parameter berikut untuk instans eksekusi yang belum berjalan.

Parameter Nilai
execution_id Pengidentifikasi unik untuk instans eksekusi
object_type 50
parameter_name 'DUMP_ON_EVENT
parameter_value 1

Untuk menentukan peristiwa selama eksekusi paket yang menyebabkan server Integration Services menghasilkan file cadangan, atur nilai parameter berikut untuk instans eksekusi yang belum berjalan. Pisahkan beberapa kode peristiwa menggunakan titik koma.

Parameter Nilai
execution_id Pengidentifikasi unik untuk instans eksekusi
object_type 50
parameter_name DUMP_EVENT_CODE
parameter_value Satu atau beberapa kode peristiwa

Contoh

A. Membuat file cadangan untuk kesalahan

Contoh berikut menentukan bahwa server Integration Services menghasilkan file cadangan ketika terjadi kesalahan selama eksekusi paket.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1

B. Membuat file cadangan untuk peristiwa

Contoh berikut menentukan bahwa server Layanan Integrasi menghasilkan file cadangan ketika peristiwa terjadi selama eksekusi paket, dan menentukan peristiwa yang menyebabkan server menghasilkan file.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1  
  
declare @event_code nvarchar(50)  
set @event_code = '0xC020801C'  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code

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

  • 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

  • Nama parameter tidak valid

  • Jenis data nilai parameter tidak cocok dengan jenis data parameter

Lihat juga

catalog.execution_parameter_values (Database SSISDB)
Menghasilkan File Cadangan untuk Eksekusi Paket