catalog.create_environment_variable (Database SSISDB)

Artikel
05/23/2023

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.)

Bagikan melalui