catalog.rename_environment (Database SSISDB)

  • Artikel

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

Berlaku untuk:SQL Server

Mengganti nama lingkungan dalam katalog Layanan Integrasi.

Sintaks

catalog.rename_environment [ @folder_name = ] folder_name  
    , [ @environment_name = ] environment_name  
    , [ @new_environment_name= ] new_environment_name

Argumen

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

[ @environment_name = ] environment_name
Nama asli lingkungan. environment_name adalah nvarchar(128).

[ @new_environment_name = ] new_environment_name
Nama baru lingkungan. new_environment_name adalah nvarchar(128).

Mengembalikan Nilai Kode

0 (berhasil)

Tataan Hasil

Tidak ada

Izin

Prosedur tersimpan ini memerlukan salah satu izin berikut:

  • IZIN MODIFIKASI pada lingkungan

  • Keanggotaan ke peran database ssis_admin

  • Keanggotaan ke peran server sysadmin

Kesalahan dan peringatan

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

  • Nama lingkungan asli tidak valid

  • Nama baru telah digunakan pada lingkungan yang ada

Keterangan

Referensi lingkungan dari proyek tidak diperbarui secara otomatis saat Anda mengganti nama lingkungan. Referensi lingkungan harus diperbarui sesuai dengan itu. Prosedur tersimpan ini akan berhasil meskipun referensi lingkungan rusak dengan mengubah nama lingkungan. Referensi lingkungan harus diperbarui setelah prosedur tersimpan ini selesai.

Catatan

Ketika referensi lingkungan tidak valid, validasi dan eksekusi paket terkait yang menggunakan referensi tersebut akan gagal.