catalog.set_object_parameter_value (Database SSISDB)

  • Artikel

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

Berlaku untuk:SQL Server

Mengatur nilai parameter di katalog Layanan Integrasi. Mengaitkan nilai ke variabel lingkungan atau menetapkan nilai harfiah yang digunakan secara default ketika tidak ada nilai lain yang ditetapkan.

Sintaks

catalog.set_object_parameter_value [ @object_type = ] object_type   
    , [ @folder_name = ] folder_name   
    , [ @project_name = ] project_name   
    , [ @parameter_name = ] parameter_name   
    , [ @parameter_value = ] parameter_value   
 [  , [ @object_name = ] object_name ]  
 [  , [ @value_type = ] value_type ]

Argumen

[@object_type =] object_type
Jenis parameter. Gunakan nilai 20 untuk menunjukkan parameter proyek atau nilai 30 untuk menunjukkan parameter paket. Object_typekecilInt.

[@folder_name =] folder_name
Nama folder yang berisi parameter . folder_name adalah nvarchar(128).

[@project_name =] project_name
Nama proyek yang berisi parameter . project_name adalah nvarchar(128).

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

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

[@object_name =] object_name
Nama paket. Argumen ini diperlukan ketika parameter adalah parameter paket. object_name adalah nvarchar(260).

[@value_type =] value_type
Jenis nilai parameter. Gunakan karakter V untuk menunjukkan bahwa parameter_value adalah nilai harfiah yang digunakan secara default ketika tidak ada nilai lain yang ditetapkan sebelum eksekusi. Gunakan karakter R untuk menunjukkan bahwa parameter_value adalah nilai yang dirujuk dan telah diatur ke nama variabel lingkungan. Argumen ini bersifat opsional, karakter V digunakan secara default. value_type adalah char(1).

Mengembalikan Nilai Kode

0 (berhasil)

Tataan Hasil

Tidak ada

Izin

Prosedur tersimpan ini memerlukan salah satu izin berikut:

  • Izin BACA dan MODIFIKASI pada proyek

  • Keanggotaan ke peran database ssis_admin

  • Keanggotaan ke peran server sysadmin

Kesalahan dan peringatan

Daftar berikut menjelaskan beberapa kondisi yang dapat menyebabkan prosedur tersimpan memunculkan kesalahan:

  • Jenis parameter tidak valid

  • Nama proyek tidak valid

  • Untuk parameter paket, nama paket tidak valid

  • Tipe nilai tidak valid

  • Pengguna tidak memiliki izin yang sesuai

Keterangan

  • Jika tidak ada value_type yang ditentukan, nilai harfiah untuk parameter_value digunakan secara default. Saat nilai harfiah digunakan, value_set dalam tampilan object_parameters diatur ke 1. Nilai parameter NULL tidak diperbolehkan.

  • Jika value_type berisi karakter R, yang menunjukkan nilai yang dirujuk, parameter_value mengacu pada nama variabel lingkungan.

  • Nilai 20 dapat digunakan untuk object_type untuk menunjukkan parameter proyek. Dalam hal ini, nilai untuk object_name tidak diperlukan, dan nilai apa pun yang ditentukan untuk object_name diabaikan. Nilai ini digunakan ketika pengguna ingin mengatur parameter proyek.

  • Nilai 30 dapat digunakan untuk object_type untuk menunjukkan parameter paket. Dalam hal ini, nilai untuk object_name digunakan untuk menunjukkan paket yang sesuai. Jika object_name tidak ditentukan, prosedur tersimpan mengembalikan kesalahan dan mengakhiri.