catalog.create_environment_variable (Database SSISDB)

  • Artikel

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

Berlaku untuk:SQL Server

Buat variabel lingkungan di katalog Layanan Integrasi.

Sintaks

catalog.create_environment_variable [ @folder_name = ] folder_name  
    , [ @environment_name = ] environment_name  
    , [ @variable_name = ] variable_name  
    , [ @data_type = ] data_type  
    , [ @sensitive = ] sensitive  
    , [ @value = ] value  
    , [ @description = ] description

Argumen

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

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

[@variable_name =] variable_name
Nama variabel lingkungan. variable_name adalah nvarchar(128).

[@data_type =] data_type
Jenis data variabel. Jenis data variabel lingkungan yang didukung termasuk Boolean, Byte, DateTime, Double, Int16, Int32, Int64, Single, String, UInt32, dan UInt64. Jenis data variabel lingkungan yang tidak didukung termasuk Char, DBNull, Object, dan Sbyte. Jenis data parameter data_type adalah nvarchar(128).

[@sensitive =] Sensitif
Menunjukkan apakah variabel berisi nilai sensitif atau tidak. Gunakan nilai 1 untuk menunjukkan bahwa nilai variabel lingkungan sensitif atau nilai 0 untuk menunjukkan bahwa itu tidak. Nilai sensitif dienkripsi saat disimpan. Nilai yang tidak sensitif disimpan dalam teks biasa. Sensitifadalah bit.

[@value =] Nilai
Nilai variabel lingkungan. Nilainyasql_variant.

[@description =] Deskripsi
Deskripsi variabel lingkungan. Nilainya adalah nvarchar(1024).

Mengembalikan Nilai Kode

0 (berhasil)

Tataan Hasil

Tidak ada

Izin

Prosedur tersimpan ini memerlukan salah satu izin berikut:

  • Izin BACA dan MODIFIKASI pada lingkungan

  • 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:

  • Nama folder, nama lingkungan, atau nama variabel lingkungan tidak valid

  • Nama variabel sudah ada di lingkungan

  • Pengguna tidak memiliki izin yang sesuai

Keterangan

Variabel lingkungan dapat digunakan untuk menetapkan nilai secara efisien ke parameter proyek atau parameter paket untuk digunakan dalam eksekusi paket. Variabel lingkungan memungkinkan organisasi nilai parameter. Nama variabel harus unik dalam lingkungan.

Prosedur tersimpan memvalidasi jenis data variabel untuk memastikannya didukung oleh katalog Layanan Integrasi.

Tip

Pertimbangkan untuk menggunakan jenis data Int16 di Layanan Integrasi alih-alih jenis data Sbyte yang tidak didukung.

Nilai yang diteruskan ke prosedur tersimpan ini dengan parameter nilai dikonversi dari jenis data Layanan Integrasi ke jenis data SQL Server sesuai dengan tabel berikut:

Tipe Data Layanan Integrasi Tipe Data SQL Server
Boolean bit
Byte biner, varbinary
DateTime datetime, datetime2, datetimeoffset, smalldatetime
Double Numerik yang tepat: desimal, numerik; Perkiraan numerik: float, nyata
Int16 smallint
Int32 int
Int64 bigint
Tunggal Numerik yang tepat: desimal, numerik; Perkiraan numerik: float, nyata
String varchar, nvarchar, char
UInt32 int (int adalah pemetaan terdekat yang tersedia ke Uint32.)
UInt64 bigint (int adalah pemetaan terdekat yang tersedia ke Uint64.)