Bagikan melalui

Konfigurasi Paket

  • Artikel

SQL Server Integration Services menyediakan konfigurasi paket yang dapat Anda gunakan untuk memperbarui nilai properti pada durasi.

Catatan

Konfigurasi tersedia untuk model penyebaran paket. Parameter digunakan sebagai pengganti konfigurasi untuk model penyebaran proyek. Model penyebaran proyek memungkinkan Anda menyebarkan proyek Integration Services ke server Integration Services. Untuk informasi selengkapnya tentang model penyebaran, lihat Penyebaran Proyek dan Paket.

Konfigurasi adalah pasangan properti/nilai yang Anda tambahkan ke paket yang telah selesai. Biasanya, Anda membuat properti kumpulan paket pada objek paket selama pengembangan paket, lalu menambahkan konfigurasi ke paket. Saat paket berjalan, paket mendapatkan nilai baru properti dari konfigurasi. Misalnya, dengan menggunakan konfigurasi, Anda dapat mengubah string koneksi manajer koneksi, atau memperbarui nilai variabel.

Konfigurasi paket memberikan manfaat berikut:

  • Konfigurasi memudahkan pemindahan paket dari lingkungan pengembangan ke lingkungan produksi. Misalnya, konfigurasi dapat memperbarui jalur file sumber, atau mengubah nama database atau server.

  • Konfigurasi berguna saat Anda menyebarkan paket ke banyak server yang berbeda. Misalnya, variabel dalam konfigurasi untuk setiap paket yang disebarkan dapat berisi nilai ruang disk yang berbeda, dan jika ruang disk yang tersedia tidak memenuhi nilai ini, paket tidak berjalan.

  • Konfigurasi membuat paket lebih fleksibel. Misalnya, konfigurasi dapat memperbarui nilai variabel yang digunakan dalam ekspresi properti.

Integration Services mendukung beberapa metode berbeda untuk menyimpan konfigurasi paket, seperti file XML, tabel dalam database SQL Server, serta variabel lingkungan dan paket.

Setiap konfigurasi adalah pasangan properti/nilai. File konfigurasi XML dan jenis konfigurasi SQL Server dapat menyertakan beberapa konfigurasi.

Konfigurasi disertakan saat Anda membuat utilitas penyebaran paket untuk menginstal paket. Saat Anda menginstal paket, konfigurasi dapat diperbarui sebagai langkah dalam penginstalan paket.

Memahami Bagaimana Konfigurasi Paket Diterapkan pada Run Time

Saat Anda menggunakan utilitas prompt perintah dtexec (dtexec.exe) untuk menjalankan paket yang disebarkan, utilitas menerapkan konfigurasi paket dua kali. Utilitas menerapkan konfigurasi baik sebelum dan sesudah menerapkan opsi yang Anda tentukan pada baris perintah.

Saat utilitas memuat dan menjalankan paket, peristiwa terjadi dalam urutan berikut:

  1. Utilitas dtexec memuat paket.

  2. Utilitas menerapkan konfigurasi yang ditentukan dalam paket pada waktu desain dan dalam urutan yang ditentukan dalam paket. (Satu pengecualian untuk ini adalah konfigurasi Variabel Paket Induk. Utilitas hanya menerapkan konfigurasi ini sekali dan nanti dalam prosesnya.)

  3. Utilitas kemudian menerapkan opsi apa pun yang Anda tentukan pada baris perintah.

  4. Utilitas kemudian memuat ulang konfigurasi yang ditentukan dalam paket pada waktu desain dan dalam urutan yang ditentukan dalam paket. (Sekali lagi, pengecualian untuk aturan ini adalah konfigurasi Variabel Paket Induk). Utilitas menggunakan opsi baris perintah apa pun yang ditentukan untuk memuat ulang konfigurasi. Oleh karena itu, nilai yang berbeda mungkin dimuat ulang dari lokasi yang berbeda.

  5. Utilitas menerapkan konfigurasi Variabel Paket Induk.

  6. Utilitas menjalankan paket.

Cara utilitas dtexec menerapkan konfigurasi memengaruhi opsi baris perintah berikut:

  • Anda dapat menggunakan opsi /Connection atau /Set pada run time untuk memuat konfigurasi paket dari lokasi selain lokasi yang Anda tentukan pada waktu desain.

  • Anda dapat menggunakan opsi /ConfigFile untuk memuat konfigurasi tambahan yang tidak Anda tentukan pada waktu desain.

Namun, opsi baris perintah ini memang memiliki beberapa batasan:

  • Anda tidak dapat menggunakan opsi /Set atau /Connection untuk mengambil alih nilai tunggal yang juga diatur oleh konfigurasi.

  • Anda tidak dapat menggunakan opsi /ConfigFile untuk memuat konfigurasi yang menggantikan konfigurasi yang Anda tentukan pada waktu desain.

Untuk informasi selengkapnya tentang opsi ini, dan bagaimana perilaku opsi ini berbeda antara Layanan Integrasi (SSIS) SQL Server 2014 dan versi yang lebih lama, lihat Perubahan Perilaku pada Fitur Layanan Integrasi di SQL Server 2014.

Jenis Konfigurasi Paket

Tabel berikut ini menjelaskan jenis konfigurasi paket.

Jenis Deskripsi
File konfigurasi XML File XML berisi konfigurasi. File XML dapat menyertakan beberapa konfigurasi.
Variabel lingkungan Variabel lingkungan berisi konfigurasi.
Entri registri Entri Registri berisi konfigurasi.
Variabel paket induk Variabel dalam paket berisi konfigurasi. Jenis konfigurasi ini biasanya digunakan untuk memperbarui properti dalam paket anak.
Tabel SQL Server Tabel dalam database SQL Server berisi konfigurasi. Tabel dapat menyertakan beberapa konfigurasi.

File Konfigurasi XML

Jika Anda memilih jenis konfigurasi file konfigurasi XML , Anda dapat membuat file konfigurasi baru, menggunakan kembali file yang ada dan menambahkan konfigurasi baru, atau menggunakan kembali file yang ada tetapi menimpa konten file yang ada.

File konfigurasi XML mencakup dua bagian:

  • Judul yang berisi informasi tentang file konfigurasi. Elemen ini mencakup atribut seperti ketika file dibuat dan nama orang yang menghasilkan file.

  • Elemen konfigurasi yang berisi informasi tentang setiap konfigurasi. Elemen ini mencakup atribut seperti jalur properti dan nilai properti yang dikonfigurasi.

Kode XML berikut menunjukkan sintaks file konfigurasi XML. Contoh ini menunjukkan konfigurasi untuk properti Nilai dari variabel bilangan bulat bernama MyVar.

<?xml version="1.0"?>  
<DTSConfiguration>  
   <DTSConfigurationHeading>  
      <DTSConfigurationFileInfo  
          GeneratedBy="DomainName\UserName"  
          GeneratedFromPackageName="Package"  
          GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"  
          GeneratedDate="2/01/2005 5:58:09 PM"/>  
   </DTSConfigurationHeading>  
   <Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">  
      <ConfiguredValue>0</ConfiguredValue>  
   </Configuration>  
</DTSConfiguration>

Entri Registri

Jika Anda ingin menggunakan entri Registri untuk menyimpan konfigurasi, Anda dapat menggunakan kunci yang ada atau membuat kunci baru di HKEY_CURRENT_USER. Kunci Registri yang Anda gunakan harus memiliki nilai bernama Value. Nilainya bisa berupa DWORD atau string.

Jika Anda memilih jenis konfigurasi entri Registri , Ketik nama kunci Registri di kotak entri Registri. Formatnya adalah <kunci> registri. Jika Anda ingin menggunakan kunci Registri yang tidak berada di akar HKEY_CURRENT_USER, gunakan format <Kunci registri\kunci registri\...> untuk mengidentifikasi kunci. Misalnya, untuk menggunakan kunci MyPackage yang terletak di SSISPackages, ketik SSISPackages\MyPackage.

SQL Server

Jika Anda memilih jenis konfigurasi SQL Server, Anda menentukan koneksi ke database SQL Server tempat Anda ingin menyimpan konfigurasi. Anda dapat menyimpan konfigurasi ke tabel yang sudah ada atau membuat tabel baru di database yang ditentukan.

Pernyataan SQL berikut menunjukkan pernyataan CREATE TABLE default yang disediakan Panduan Konfigurasi Paket.

CREATE TABLE [dbo].[SSIS Configurations]  
(  
ConfigurationFilter NVARCHAR(255) NOT NULL,  
ConfiguredValue NVARCHAR(255) NULL,  
PackagePath NVARCHAR(255) NOT NULL,  
ConfiguredValueType NVARCHAR(20) NOT NULL  
)

Nama yang Anda berikan untuk konfigurasi adalah nilai yang disimpan di kolom ConfigurationFilter .

Konfigurasi Langsung dan Tidak Langsung

Layanan Integrasi menyediakan konfigurasi langsung dan tidak langsung. Jika Anda menentukan konfigurasi secara langsung, Integration Services membuat tautan langsung antara item konfigurasi dan properti objek paket. Konfigurasi langsung adalah pilihan yang lebih baik ketika lokasi sumber tidak berubah. Misalnya, jika Anda yakin bahwa semua penyebaran dalam paket menggunakan jalur file yang sama, Anda dapat menentukan file konfigurasi XML.

Konfigurasi tidak langsung menggunakan variabel lingkungan. Alih-alih menentukan pengaturan konfigurasi secara langsung, konfigurasi menunjuk ke variabel lingkungan, yang pada gilirannya berisi nilai konfigurasi. Menggunakan konfigurasi tidak langsung adalah pilihan yang lebih baik ketika lokasi konfigurasi dapat berubah untuk setiap penyebaran paket.

Membuat Konfigurasi Paket

Konten terkait