Penyebaran Paket Lama (SSIS)

  • Artikel

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

SQL Server Integration Services mencakup alat dan wizard yang memudahkan penyebaran paket dari komputer pengembangan ke server produksi atau ke komputer lain.

Ada empat langkah dalam proses penyebaran paket:

  1. Langkah pertama bersifat opsional dan melibatkan pembuatan konfigurasi paket yang memperbarui properti elemen paket pada durasi. Konfigurasi secara otomatis disertakan saat Anda menyebarkan paket.

  2. Langkah kedua adalah membangun proyek Integration Services untuk membuat utilitas penyebaran paket. Utilitas penyebaran untuk proyek berisi paket yang ingin Anda sebarkan

  3. Langkah ketiga adalah menyalin folder penyebaran yang dibuat saat Anda membangun proyek Layanan Integrasi ke komputer target.

  4. Langkah keempat adalah menjalankan, pada komputer target, Wizard Penginstalan Paket untuk menginstal paket ke sistem file atau ke instans SQL Server.

Konfigurasi Paket

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 untuk memindahkan 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.

Layanan Integrasi 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 proses.)

  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 2019 dan versi yang lebih lama, lihat Perubahan Perilaku pada Fitur Layanan Integrasi di SQL Server 2016.

Jenis Konfigurasi Paket

Tabel berikut 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 menyertakan 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 Nilai. Nilainya bisa berupa DWORD atau string.

Jika Anda memilih jenis konfigurasi entri Registri , Ketik nama kunci Registri ke dalam 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 bisa 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, Layanan Integrasi 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

Buat konfigurasi paket dengan menggunakan kotak dialog Pengelola Konfigurasi Paket dan Wizard Konfigurasi Paket. Untuk mengakses alat ini, pilih Konfigurasi Paket pada menu SSIS di SQL Server Data Tools (SSDT).

Catatan

Anda juga dapat mengakses Package Configuration Organizer dengan mengklik tombol elipsis di samping properti Konfigurasi . Properti Konfigurasi muncul di jendela properti untuk paket.

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.

Dalam kotak dialog Pengelola Konfigurasi Paket , Anda dapat mengaktifkan paket untuk menggunakan konfigurasi, menambahkan dan menghapus konfigurasi, dan mengatur urutan pilihan di mana konfigurasi harus dimuat.

Saat konfigurasi paket dimuat dalam urutan yang disukai, konfigurasi dimuat dari bagian atas daftar yang ditampilkan dalam kotak dialog Pengelola Konfigurasi Paket ke bagian bawah daftar. Namun, pada waktu proses, konfigurasi paket mungkin tidak dimuat dalam urutan yang disukai. Secara khusus, konfigurasi paket induk dimuat setelah konfigurasi jenis lain.

Jika beberapa konfigurasi mengatur properti objek yang sama, nilai yang dimuat terakhir digunakan pada durasi.

Dari kotak dialog Pengelola Konfigurasi Paket , Anda menjalankan Panduan Konfigurasi Paket, yang memandu Anda melalui langkah-langkah untuk membuat konfigurasi. Untuk menjalankan Panduan Konfigurasi Paket, tambahkan konfigurasi baru dalam kotak dialog Pengelola Konfigurasi Paket atau edit yang sudah ada. Pada halaman wizard, Anda memilih jenis konfigurasi, memilih apakah Anda ingin mengakses konfigurasi secara langsung atau menggunakan variabel lingkungan, dan memilih properti untuk disimpan dalam konfigurasi.

Contoh berikut menunjukkan properti target variabel dan paket saat muncul di halaman Menyelesaikan Wizard panduan Konfigurasi Paket:

\Package.Variables[User::TodaysDate]. Properties[RaiseChangedEvent]

\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]

\Package\My SQL Task.Variables[User::varTableName]. Properti[Nilai]

Dalam contoh ini, konfigurasi memperbarui properti ini:

  • Properti RaiseChangedEvent dari variabel yang ditentukan pengguna, TodaysDate.

  • Properti MaximumErrorCount, LoggingMode, dan LocaleID paket.

  • Properti Nilai variabel yang ditentukan pengguna, , varTableNamedalam cakupan tugas, Tugas SQL Saya.

"\Package" mewakili root, dan titik (.) memisahkan objek yang menentukan jalur ke properti yang diperbarui konfigurasi. Nama variabel dan properti diapit dalam tanda kurung siku. Istilah Paket selalu digunakan dalam konfigurasi, terlepas dari nama paket; namun, semua objek lain di jalur menggunakan nama yang ditentukan pengguna.

Setelah wizard selesai, konfigurasi baru ditambahkan ke daftar konfigurasi dalam kotak dialog Pengelola Konfigurasi Paket .

Catatan

Halaman terakhir dalam Panduan Konfigurasi Paket, Menyelesaikan Wizard, mencantumkan properti target dalam konfigurasi. Jika Anda ingin memperbarui properti saat menjalankan paket dengan menggunakan utilitas prompt perintah dtexec , Anda dapat membuat string yang mewakili jalur properti dengan menjalankan Panduan Konfigurasi Paket lalu menyalin dan menempelkannya ke jendela prompt perintah untuk digunakan dengan opsi set dtexec.

Tabel berikut ini menjelaskan kolom dalam daftar konfigurasi dalam kotak dialog Pengelola Konfigurasi Paket .

Kolom Deskripsi
Nama Konfigurasi Nama konfigurasi.
Jenis Konfigurasi Jenis konfigurasi.
String Konfigurasi Lokasi konfigurasi. Lokasi dapat berupa jalur, variabel lingkungan, kunci Registri, nama variabel paket induk, atau tabel dalam database SQL Server.
Objek Target Nama objek dengan properti yang memiliki konfigurasi. Jika konfigurasi adalah file konfigurasi XML, kolom kosong, karena konfigurasi dapat memperbarui beberapa objek.
Properti Target Nama properti. Jika konfigurasi menulis ke file konfigurasi XML atau tabel SQL Server, kolom kosong, karena konfigurasi dapat memperbarui beberapa objek.

Untuk membuat konfigurasi paket

  1. Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang Anda inginkan.

  2. Di Penjelajah Solusi, klik dua kali paket untuk membukanya.

  3. Di Designer SSIS, pilih tab Alur Kontrol, Aliran Data, Penanganan Aktivitas, atau Penjelajah Paket.

  4. Pada menu SSIS , pilih Konfigurasi Paket.

  5. Dalam kotak dialog Pengelola Konfigurasi Paket , pilih Aktifkan konfigurasi paket, lalu pilih Tambahkan.

  6. Pada halaman selamat datang dari halaman Panduan Konfigurasi Paket, pilih Berikutnya.

  7. Pada halaman Pilih Jenis Konfigurasi, tentukan jenis konfigurasi, lalu atur properti yang relevan dengan jenis konfigurasi. Untuk informasi selengkapnya, lihat Referensi UI Panduan Konfigurasi Paket.

  8. Pada halaman Pilih Properti untuk Diekspor, pilih properti objek paket untuk disertakan dalam konfigurasi. Jika jenis konfigurasi hanya mendukung satu properti, judul halaman wizard ini adalah Pilih Properti Target. Untuk informasi selengkapnya, lihat Referensi UI Panduan Konfigurasi Paket.

    Catatan

    Hanya dukungan File Konfigurasi XML dan jenis konfigurasi SQL Server termasuk beberapa properti dalam konfigurasi.

  9. Pada halaman Menyelesaikan Wizard, ketik nama konfigurasi, lalu pilih Selesai.

  10. Lihat konfigurasi dalam kotak dialog Pengelola Konfigurasi Paket .

  11. Pilih Tutup.

Pengelola Konfigurasi Paket

Gunakan kotak dialog Package Configurations Organizer untuk mengaktifkan konfigurasi paket, melihat daftar konfigurasi untuk paket saat ini, dan tentukan urutan pilihan di mana konfigurasi harus dimuat.

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.

Jika beberapa konfigurasi memperbarui properti yang sama, nilai dari konfigurasi yang tercantum lebih rendah dalam daftar konfigurasi akan menggantikan nilai dari konfigurasi yang lebih tinggi dalam daftar. Nilai terakhir yang dimuat ke dalam properti adalah nilai yang digunakan saat paket berjalan. Selain itu, jika paket menggunakan kombinasi konfigurasi langsung seperti file konfigurasi XML dan konfigurasi tidak langsung seperti variabel lingkungan, konfigurasi tidak langsung yang menunjuk ke lokasi konfigurasi langsung harus lebih tinggi dalam daftar.

Catatan

Saat konfigurasi paket dimuat dalam urutan yang disukai, konfigurasi dimuat dari bagian atas daftar yang ditampilkan dalam kotak dialog Pengelola Konfigurasi Paket ke bagian bawah daftar. Namun, pada waktu proses, konfigurasi paket mungkin tidak dimuat dalam urutan yang disukai. Secara khusus, Konfigurasi Paket Induk dimuat setelah konfigurasi jenis lain.

Konfigurasi paket memperbarui nilai properti objek paket pada durasi. Saat paket dimuat, nilai dari konfigurasi menggantikan nilai yang ditetapkan saat paket dikembangkan. Integration Services mendukung berbagai jenis konfigurasi. Misalnya, Anda dapat menggunakan file XML yang dapat berisi beberapa konfigurasi, atau variabel lingkungan yang berisi satu konfigurasi. Untuk informasi selengkapnya, lihat Konfigurasi Paket.

Opsi

Mengaktifkan konfigurasi paket
Pilih untuk menggunakan konfigurasi dengan paket.

Nama Konfigurasi
Lihat nama konfigurasi.

Jenis Konfigurasi
Lihat jenis lokasi tempat konfigurasi disimpan.

String Konfigurasi
Lihat lokasi tempat nilai konfigurasi disimpan. Lokasi dapat menjadi jalur file, nama variabel lingkungan, nama variabel paket induk, kunci Registri, atau nama tabel SQL Server.

Objek Target
Lihat nama objek yang diperbarui konfigurasi. Jika konfigurasi adalah file konfigurasi XML atau tabel SQL Server, kolom kosong karena konfigurasi dapat menyertakan beberapa objek.

Properti Target
Lihat nama properti yang dimodifikasi oleh konfigurasi. Kolom ini kosong jika jenis konfigurasi mendukung beberapa konfigurasi.

Tambahkan
Tambahkan konfigurasi dengan menggunakan Panduan Konfigurasi Paket.

Edit
Edit konfigurasi yang sudah ada dengan menjalankan ulang Panduan Konfigurasi Paket.

Hapus
Pilih konfigurasi, lalu pilih Hapus.

Panah
Pilih konfigurasi dan gunakan panah atas dan bawah untuk memindahkannya ke atas atau ke bawah dalam daftar. Konfigurasi dimuat dalam urutan kemunculannya dalam daftar.

Referensi UI Panduan Konfigurasi Paket

Gunakan Panduan Konfigurasi Paket untuk membuat konfigurasi yang memperbarui properti paket Layanan Integrasi dan objeknya pada durasi. Panduan ini berjalan ketika Anda menambahkan konfigurasi baru atau mengubah konfigurasi yang sudah ada dalam kotak dialog Pengelola Konfigurasi Paket . Untuk membuka kotak dialog Pengelola Konfigurasi Paket, pilih Konfigurasi Paket pada menu SSIS di SQL Server Data Tools (SSDT). Untuk informasi selengkapnya, lihat Membuat Konfigurasi Paket.

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.

Bagian berikut ini menjelaskan halaman Panduan.

Selamat Datang di Halaman Panduan Konfigurasi Paket

Gunakan Wizard Konfigurasi SSIS untuk membuat konfigurasi yang memperbarui properti paket dan objeknya pada durasi.

Opsi

Jangan perlihatkan halaman ini lagi
Lewati halaman selamat datang saat berikutnya Anda membuka wizard.

Berikutnya
Masuk ke halaman berikutnya dalam wizard.

Pilih Halaman Tipe Konfigurasi

Gunakan halaman Pilih Jenis Konfigurasi untuk menentukan jenis konfigurasi yang akan dibuat.

Jika Anda memerlukan informasi tambahan untuk menentukan jenis konfigurasi mana yang akan digunakan, lihat Konfigurasi Paket.

Opsi Statis

Jenis konfigurasi
Pilih jenis sumber untuk menyimpan konfigurasi, menggunakan opsi berikut:

Nilai Deskripsi
File konfigurasi XML Simpan konfigurasi sebagai file XML. Memilih nilai ini menampilkan opsi dinamis di bagian, Jenis Konfigurasi.
Variabel lingkungan Simpan konfigurasi di salah satu variabel lingkungan. Memilih nilai ini menampilkan opsi dinamis di bagian, Jenis Konfigurasi.
Entri registri Simpan konfigurasi di Registri. Memilih nilai ini menampilkan opsi dinamis di bagian, Jenis Konfigurasi.
Variabel paket induk Simpan konfigurasi sebagai variabel dalam paket yang berisi tugas. Memilih nilai ini menampilkan opsi dinamis di bagian, Jenis Konfigurasi.
SQL Server Simpan konfigurasi dalam tabel di SQL Server. Memilih nilai ini menampilkan opsi dinamis di bagian, Jenis Konfigurasi.

Berikutnya
Tampilkan halaman berikutnya dalam urutan wizard.

Opsi Dinamis

Opsi Jenis Konfigurasi = File Konfigurasi XML

Tentukan pengaturan konfigurasi secara langsung
Gunakan untuk menentukan pengaturan secara langsung.

Nilai Deskripsi
Nama file konfigurasi Ketik jalur file konfigurasi yang dihasilkan wizard.
Telusuri Gunakan kotak dialog Pilih Lokasi File Konfigurasi untuk menentukan jalur file konfigurasi yang dihasilkan wizard. Jika file tidak ada, file dibuat oleh wizard.

Lokasi konfigurasi disimpan dalam variabel lingkungan
Gunakan untuk menentukan variabel lingkungan untuk menyimpan konfigurasi.

Nilai Deskripsi
Variabel lingkungan Pilih variabel lingkungan dari daftar.
Opsi Jenis Konfigurasi = Variabel Lingkungan

Variabel lingkungan
Pilih variabel lingkungan yang berisi informasi konfigurasi.

Opsi Jenis Konfigurasi = Entri Registri

Tentukan pengaturan konfigurasi secara langsung
Gunakan untuk menentukan pengaturan secara langsung.

Nilai Deskripsi
Entri registri Ketik kunci Registri yang berisi informasi konfigurasi. Formatnya adalah <kunci> registri.

Kunci Registri harus sudah ada dan HKEY_CURRENT_USER memiliki nilai bernama Nilai. Nilainya bisa berupa DWORD atau string.

Jika Anda ingin menggunakan kunci Registri tidak berada di akar HKEY_CURRENT_USER, gunakan format <Kunci registri\kunci registri\...> untuk mengidentifikasi kunci.

Lokasi konfigurasi disimpan dalam variabel lingkungan
Gunakan untuk menentukan variabel lingkungan untuk menyimpan konfigurasi.

Nilai Deskripsi
Variabel lingkungan Pilih variabel lingkungan dari daftar.
Opsi Jenis Konfigurasi = Variabel Paket Induk

Tentukan pengaturan konfigurasi secara langsung
Gunakan untuk menentukan pengaturan secara langsung.

Nilai Deskripsi
Variabel induk Tentukan variabel dalam paket induk yang berisi informasi konfigurasi.

Lokasi konfigurasi disimpan dalam variabel lingkungan
Gunakan untuk menentukan variabel lingkungan yang menyimpan konfigurasi.

Nilai Deskripsi
Variabel lingkungan Pilih variabel lingkungan dari daftar.
Opsi Jenis Konfigurasi = SQL Server

Tentukan pengaturan konfigurasi secara langsung
Gunakan untuk menentukan pengaturan secara langsung.

Nilai Deskripsi
Koneksi Pilih koneksi dari daftar, atau pilih Baru untuk membuat koneksi baru.
Tabel konfigurasi Pilih tabel yang sudah ada, atau pilih Baru untuk menulis pernyataan SQL yang membuat tabel baru.
Filter konfigurasi Pilih nama konfigurasi yang sudah ada atau ketik nama baru.

Banyak konfigurasi SQL Server dapat disimpan dalam tabel yang sama, dan setiap konfigurasi dapat menyertakan beberapa item konfigurasi.

Nilai yang ditentukan pengguna ini disimpan dalam tabel untuk mengidentifikasi item konfigurasi milik konfigurasi tertentu

Lokasi konfigurasi disimpan dalam variabel lingkungan
Gunakan untuk menentukan variabel lingkungan tempat konfigurasi disimpan.

Nilai Deskripsi
Variabel lingkungan Pilih variabel lingkungan dari daftar.

Pilih Objek untuk Diekspor Halaman

Gunakan halaman Pilih Properti Target atau Pilih Properti untuk Diekspor untuk menentukan properti objek yang dikandung konfigurasi. Kemampuan untuk memilih beberapa properti hanya tersedia jika Anda memilih jenis konfigurasi XML.

Opsi

Objek
Perluas hierarki paket dan pilih properti yang akan diekspor.

Atribut properti
Lihat atribut properti.

Berikutnya
Masuk ke halaman berikutnya dalam panduan.

Menyelesaikan Halaman Panduan

Gunakan halaman Menyelesaikan Wizard untuk memberikan nama untuk konfigurasi dan pengaturan tampilan yang digunakan oleh wizard untuk membuat konfigurasi. Setelah wizard selesai, Pengelola Konfigurasi Paket ditampilkan, yang mencantumkan semua konfigurasi untuk paket.

Opsi

Nama konfigurasi
Ketik nama konfigurasi.

Pratinjau
Lihat pengaturan yang digunakan oleh wizard untuk membuat konfigurasi.

Selesai
Buat konfigurasi dan keluar dari Wizard Konfigurasi Paket.

Menggunakan Nilai Variabel dan Parameter dalam Paket Anak

Prosedur ini menjelaskan cara membuat konfigurasi paket yang menggunakan jenis konfigurasi variabel induk. Jenis konfigurasi ini memungkinkan paket anak yang dijalankan dari paket induk untuk mengakses variabel di induk.

Catatan

Anda juga dapat meneruskan nilai ke paket anak dengan mengonfigurasi Tugas Eksekusi Paket untuk memetakan variabel atau parameter paket induk, atau parameter proyek, ke parameter paket anak. Untuk informasi selengkapnya, lihat Menjalankan Tugas Paket.

Anda tidak perlu membuat variabel dalam paket induk sebelum Anda membuat konfigurasi paket dalam paket anak. Anda dapat menambahkan variabel ke paket induk kapan saja, tetapi Anda harus menggunakan nama yang tepat dari variabel induk dalam konfigurasi paket. Namun, sebelum Anda dapat membuat konfigurasi variabel induk, harus ada variabel yang ada dalam paket anak yang dapat diperbarui oleh konfigurasi. Untuk informasi selengkapnya tentang menambahkan dan mengonfigurasi variabel, lihat Menambahkan, Menghapus, Mengubah Cakupan Variabel User-Defined dalam Paket.

Cakupan variabel dalam paket induk yang digunakan dalam konfigurasi variabel induk dapat diatur ke tugas Jalankan Paket, ke kontainer yang memiliki tugas, atau ke paket. Jika beberapa variabel dengan nama yang sama didefinisikan dalam paket, variabel yang paling dekat dalam cakupan dengan tugas Jalankan Paket digunakan. Cakupan terdekat dengan tugas Jalankan Paket adalah tugas itu sendiri.

Untuk menambahkan variabel ke paket induk

  1. Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang ingin Anda tambahkan variabel untuk diteruskan ke paket anak.

  2. Di Penjelajah Solusi, klik dua kali paket untuk membukanya.

  3. Dalam Designer SSIS, untuk menentukan cakupan variabel, lakukan salah satu hal berikut:

    • Untuk mengatur cakupan ke paket, pilih di mana saja pada permukaan desain tab Alur Kontrol .

    • Untuk mengatur cakupan ke kontainer induk dari tugas Jalankan Paket, pilih kontainer.

    • Untuk mengatur cakupan ke tugas Jalankan Paket, pilih tugas.

  4. Menambahkan dan mengonfigurasi variabel.

    Catatan

    Pilih jenis data yang kompatibel dengan data yang akan disimpan variabel.

  5. Untuk menyimpan paket yang diperbarui, pilih Simpan Item Terpilih pada menu File .

Untuk menambahkan variabel ke paket anak

  1. Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang ingin Anda tambahkan konfigurasi variabel induknya.

  2. Di Penjelajah Solusi, klik dua kali paket untuk membukanya.

  3. Di SSIS Designer, untuk mengatur cakupan ke paket, pilih di mana saja pada permukaan desain tab Alur Kontrol.

  4. Menambahkan dan mengonfigurasi variabel.

    Catatan

    Pilih jenis data yang kompatibel dengan data yang akan disimpan variabel.

  5. Untuk menyimpan paket yang diperbarui, pilih Simpan Item Terpilih pada menu File .

Membuat Utilitas Penyebaran

Langkah pertama dalam menyebarkan paket adalah membuat utilitas penyebaran untuk proyek Integration Services. Utilitas penyebaran adalah folder yang berisi file yang Anda butuhkan untuk menyebarkan paket dalam proyek Integration Services di server yang berbeda. Utilitas penyebaran dibuat di komputer tempat proyek Integration Services disimpan.

Anda membuat utilitas penyebaran paket untuk proyek Integration Services dengan terlebih dahulu mengonfigurasi proses build untuk membuat utilitas penyebaran, lalu membangun proyek. Saat Anda membangun proyek, semua paket dan konfigurasi paket dalam proyek disertakan secara otomatis. Untuk menyebarkan file tambahan seperti file Readme dengan proyek, tempatkan file di folder Lain-lain dari proyek Integration Services. Ketika proyek dibangun, file-file ini juga secara otomatis disertakan.

Anda dapat mengonfigurasi setiap penyebaran proyek secara berbeda. Sebelum Anda membangun proyek dan membuat utilitas penyebaran paket, Anda dapat mengatur properti pada utilitas penyebaran untuk menyesuaikan cara paket dalam proyek akan disebarkan. Misalnya, Anda dapat menentukan apakah konfigurasi paket dapat diperbarui saat proyek disebarkan. Untuk mengakses properti proyek Integration Services, klik kanan proyek dan pilih Properti.

Tabel berikut mencantumkan properti utilitas penyebaran.

Properti Deskripsi
AllowConfigurationChange Nilai yang menentukan apakah konfigurasi dapat diperbarui selama penyebaran.
CreateDeploymentUtility Nilai yang menentukan apakah utilitas penyebaran paket dibuat saat proyek dibuat. Properti ini harus True untuk membuat utilitas penyebaran.
DeploymentOutputPath Lokasi, relatif terhadap proyek Integration Services, dari utilitas penyebaran.

Saat Anda membangun proyek Integration Services, file manifes, <nama> proyek.SSISDeploymentManifest.xml, dibuat dan ditambahkan, bersama dengan salinan paket proyek dan dependensi paket, ke folder bin\Deployment dalam proyek, atau ke lokasi yang ditentukan dalam properti DeploymentOutputPath. File manifes mencantumkan paket, konfigurasi paket, dan file lain-lain dalam proyek.

Konten folder penyebaran di-refresh setiap kali Anda membangun proyek. Ini berarti bahwa setiap file yang disimpan ke folder ini yang tidak disalin ke folder lagi oleh proses build akan dihapus. Misalnya, file konfigurasi paket yang disimpan ke folder penyebaran akan dihapus.

Untuk membuat utilitas penyebaran paket

  1. Di SQL Server Data Tools (SSDT), buka solusi yang berisi proyek Layanan Integrasi yang ingin Anda buat utilitas penyebaran paketnya.

  2. Klik kanan proyek dan pilih Properti.

  3. Dalam kotak <dialog Nama> proyek Halaman Properti , pilih Utilitas Penyebaran.

  4. Untuk memperbarui konfigurasi paket saat paket disebarkan, atur AllowConfigurationChanges ke True.

  5. Atur CreateDeploymentUtility ke True.

  6. Secara opsional, perbarui lokasi utilitas penyebaran dengan memodifikasi properti DeploymentOutputPath .

  7. PilihOK.

  8. Di Penjelajah Solusi, klik kanan proyek, lalu pilih Bangun.

  9. Lihat kemajuan build dan kesalahan build di jendela Output .

Menyebarkan Paket dengan Menggunakan Utilitas Penyebaran

Ketika Anda telah membangun utilitas penyebaran untuk menginstal paket dari proyek Layanan Integrasi di komputer yang berbeda dari yang dibangun utilitas penyebaran, Anda harus terlebih dahulu menyalin folder penyebaran ke komputer tujuan.

Jalur folder penyebaran ditentukan di properti DeploymentOutputPath dari proyek Integration Services tempat Anda membuat utilitas penyebaran. Jalur default adalah bin\Deployment, relatif terhadap proyek Integration Services. Untuk informasi selengkapnya, lihat Membuat Utilitas Penyebaran.

Anda menggunakan Wizard Penginstalan Paket untuk menginstal paket. Untuk meluncurkan wizard, klik dua kali file utilitas penyebaran setelah Anda menyalin folder penyebaran ke server. File ini bernama <nama> proyek. SSISDeploymentManifest, dan dapat ditemukan di folder penyebaran di komputer tujuan.

Catatan

Bergantung pada versi paket yang Anda sebarkan, Anda mungkin mengalami kesalahan jika Anda memiliki versi SQL Server yang berbeda yang diinstal berdampingan. Kesalahan ini dapat terjadi karena . Ekstensi nama file SSISDeploymentManifest sama untuk semua versi Layanan Integrasi. Mengklik dua kali file memanggil alat penginstal (dtsinstall.exe) untuk versi Layanan Integrasi yang paling baru diinstal, yang mungkin bukan versi yang sama dengan file utilitas penyebaran. Untuk mengatasi masalah ini, jalankan versi dtsinstall.exe yang benar dari baris perintah, dan berikan jalur file utilitas penyebaran.

Panduan Penginstalan Paket memandu Anda melalui langkah-langkah untuk menginstal paket ke sistem file atau SQL Server. Anda dapat mengonfigurasi penginstalan dengan cara berikut:

  • Memilih jenis lokasi dan lokasi untuk menginstal paket.

  • Memilih lokasi untuk menginstal dependensi paket.

  • Memvalidasi paket setelah diinstal pada server target.

Dependensi berbasis file untuk paket selalu diinstal ke sistem file. Jika Anda menginstal paket ke sistem file, dependensi diinstal di folder yang sama dengan yang Anda tentukan untuk paket tersebut. Jika Anda menginstal paket untuk SQL Server, Anda dapat menentukan folder untuk menyimpan dependensi berbasis file.

Jika paket menyertakan konfigurasi yang ingin Anda ubah untuk digunakan di komputer tujuan, Anda bisa memperbarui nilai properti dengan menggunakan wizard.

Selain menginstal paket dengan menggunakan Wizard Penginstalan Paket, Anda dapat menyalin dan memindahkan paket dengan menggunakan utilitas prompt perintah dtutil . Untuk informasi selengkapnya, lihat Utilitas dtutil.

Untuk menyebarkan paket ke instans SQL Server

  1. Buka folder penyebaran pada komputer target.

  2. Klik dua kali file manifes, <nama> proyek. SSISDeploymentManifest, untuk memulai Wizard Penginstalan Paket.

  3. Pada halaman Sebarkan Paket SSIS, pilih opsi penyebaran SQL Server.

  4. Secara opsional, pilih Validasi paket setelah penginstalan untuk memvalidasi paket setelah diinstal di server target.

  5. Pada halaman Tentukan target SQL Server, tentukan instans SQL Server untuk menginstal paket dan memilih mode autentikasi. Jika Anda memilih Autentikasi SQL Server, Anda harus memberikan nama pengguna dan kata sandi.

  6. Pada halaman Pilih Folder Penginstalan , tentukan folder dalam sistem file untuk dependensi paket yang akan diinstal.

  7. Jika paket menyertakan konfigurasi, Anda dapat mengedit konfigurasi dengan memperbarui nilai di daftar Nilai di halaman Konfigurasi Paket.

  8. Jika Anda memilih untuk memvalidasi paket setelah penginstalan, lihat hasil validasi paket yang disebarkan.

Penyebaran Ulang Paket

Setelah proyek disebarkan, Anda mungkin perlu memperbarui atau memperluas fungsionalitas paket, lalu menyebarkan ulang proyek Integration Services yang berisi paket yang diperbarui. Sebagai bagian dari proses penyebaran ulang paket, Anda harus meninjau properti konfigurasi yang disertakan dalam utilitas penyebaran. Misalnya, Anda mungkin tidak ingin mengizinkan perubahan konfigurasi setelah paket disebarkan ulang.

Proses untuk Penyebaran Ulang

Setelah Anda selesai memperbarui paket, Anda membangun kembali proyek, menyalin folder penyebaran ke komputer target, lalu menjalankan kembali Wizard Penginstalan Paket.

Jika Anda hanya memperbarui beberapa paket dalam proyek, Anda mungkin tidak ingin menyebarkan ulang seluruh proyek. Untuk menyebarkan hanya beberapa paket, Anda dapat membuat proyek Integration Services baru, menambahkan paket yang diperbarui ke proyek baru, lalu membangun dan menyebarkan proyek. Konfigurasi paket secara otomatis disalin dengan paket saat Anda menambahkan paket ke proyek yang berbeda.

Referensi UI Panduan Penginstalan Paket

Gunakan Wizard Penginstalan Paket untuk menyebarkan proyek Layanan Integrasi, termasuk paket dan file lain-lain yang dikandungnya dan dependensi paket apa pun.

Sebelum menyebarkan paket, Anda dapat membuat konfigurasi lalu menyebarkannya dengan paket. Layanan Integrasi menggunakan konfigurasi untuk memperbarui properti paket dan objek paket secara dinamis pada durasi. Misalnya, string koneksi koneksi OLE DB dapat diatur secara dinamis pada durasi dengan menyediakan konfigurasi yang memetakan nilai ke properti yang berisi string koneksi.

Anda tidak dapat menjalankan Wizard Penginstalan Paket hingga Anda membuat proyek Integration Services dan membuat utilitas penyebaran. Untuk informasi selengkapnya, lihat Menyebarkan Paket dengan Menggunakan Utilitas Penyebaran.

Bagian berikut ini menjelaskan halaman panduan.

Selamat Datang di Halaman Wizard Penginstalan Paket

Gunakan Wizard Penginstalan Paket untuk menyebarkan proyek Layanan Integrasi tempat Anda membuat utilitas penyebaran paket.

Jangan perlihatkan halaman awal ini lagi
Pilih untuk melewati halaman awal saat Anda menjalankan wizard lagi.

Berikutnya
Masuk ke halaman berikutnya dalam wizard.

Selesai
Lewati ke halaman Selesaikan Wizard Penginstalan Paket. Gunakan opsi ini jika Anda telah melakukan backtrack melalui halaman wizard untuk merevisi pilihan Anda dan telah menentukan semua opsi yang diperlukan.

Mengonfigurasi Halaman Paket

Gunakan halaman Konfigurasi Paket untuk mengedit konfigurasi paket.

Opsi

File konfigurasi
Edit konten file konfigurasi dengan memilih file dari daftar.

Topik Terkait:Membuat Konfigurasi Paket

Jalur
Lihat jalur properti yang akan dikonfigurasi.

Jenis
Lihat jenis data properti.

Nilai
Tentukan nilai konfigurasi.

Berikutnya
Masuk ke halaman berikutnya dalam wizard.

Selesai
Lewati ke halaman Selesaikan Wizard Penginstalan Paket. Gunakan opsi ini jika Anda telah melakukan backtrack melalui halaman wizard untuk merevisi pilihan Anda dan telah menentukan semua opsi yang diperlukan.

Konfirmasi Halaman Penginstalan

Gunakan halaman Konfirmasi Penginstalan untuk memulai penginstalan paket, untuk melihat status, dan untuk melihat informasi yang akan digunakan wizard untuk menginstal file dari proyek yang ditentukan.

Berikutnya
Instal paket dan dependensinya dan buka halaman wizard berikutnya saat penginstalan selesai.

Status
Memperlihatkan kemajuan penginstalan paket.

Selesai
Buka halaman Selesaikan Wizard Penginstalan Paket. Gunakan opsi ini jika Anda telah melakukan backtrack melalui halaman wizard untuk merevisi pilihan Anda dan telah menentukan semua opsi yang diperlukan.

Sebarkan Halaman Paket SSIS

Gunakan halaman Sebarkan Paket SSIS untuk menentukan tempat menginstal paket Layanan Integrasi dan dependensinya.

Opsi

Penyebaran sistem file
Menyebarkan paket dan dependensi dalam folder tertentu dalam sistem file.

penyebaran SQL Server
Menyebarkan paket dan dependensi dalam instans SQL Server. Gunakan opsi ini jika SQL Server berbagi paket antar server. Dependensi paket apa pun diinstal di folder yang ditentukan dalam sistem file.

Memvalidasi paket setelah penginstalan
Menunjukkan apakah akan memvalidasi paket setelah penginstalan.

Berikutnya
Masuk ke halaman berikutnya dalam panduan.

Selesai
Lewati ke halaman Selesaikan Panduan Penginstalan Paket. Gunakan opsi ini jika Anda telah melakukan backtrack melalui halaman wizard untuk merevisi pilihan Anda dan telah menentukan semua opsi yang diperlukan.

Halaman Validasi Paket

Gunakan halaman Validasi Paket untuk melihat kemajuan dan hasil validasi paket.

Berikutnya
Masuk ke halaman berikutnya dalam panduan.

Pilih Halaman Folder Penginstalan

Gunakan halaman Pilih Folder Penginstalan untuk menentukan folder sistem file untuk menginstal paket dan dependensinya.

Opsi

Folder
Tentukan jalur dan folder untuk menyalin paket dan dependensinya.

Telusuri
Telusuri ke folder target dengan menggunakan kotak dialog Telusuri Folder .

Berikutnya
Masuk ke halaman berikutnya dalam panduan.

Selesai
Lewati ke halaman Selesaikan Panduan Penginstalan Paket. Gunakan opsi ini jika Anda telah melakukan backtrack melalui halaman wizard untuk merevisi pilihan Anda dan jika telah menentukan semua opsi yang diperlukan.

Tentukan Halaman SQL Server Target

Gunakan halaman Tentukan SQL Server Target untuk menentukan opsi untuk menyebarkan paket ke instans SQL Server.

Opsi

Nama server
Tentukan nama server untuk menyebarkan paket.

Gunakan Autentikasi Windows
Tentukan apakah akan menggunakan Autentikasi Windows untuk masuk ke server. Autentikasi Windows direkomendasikan untuk keamanan yang lebih baik.

Gunakan Autentikasi SQL Server
Tentukan apakah paket harus menggunakan Autentikasi SQL Server untuk masuk ke server. Jika Anda menggunakan Autentikasi SQL Server, Anda harus memberikan nama pengguna dan kata sandi.

Nama pengguna
Tentukan nama pengguna.

Kata sandi
Tentukan kata sandi.

Jalur paket
Tentukan nama folder logis, atau masukkan "/" untuk folder default.

Untuk memilih folder dalam kotak dialog Paket SSIS , pilih telusuri (...). Namun, kotak dialog tidak menyediakan sarana untuk memilih folder default. Jika Anda ingin menggunakan folder default, Anda harus memasukkan "/" di kotak teks.

Catatan

Jika Anda tidak memasukkan jalur paket yang valid, pesan kesalahan berikut muncul: "Satu atau beberapa argumen tidak valid."

Mengandalkan penyimpanan server untuk enkripsi
Pilih untuk menggunakan fitur keamanan Mesin Database untuk membantu mengamankan paket.

Berikutnya
Masuk ke halaman berikutnya dalam panduan.

Selesai
Lewati ke halaman Selesaikan Panduan Penginstalan Paket. Gunakan opsi ini jika Anda telah melakukan backtrack melalui halaman wizard untuk merevisi pilihan Anda dan telah menentukan semua opsi yang diperlukan.

Selesaikan Halaman Penginstalan Paket

Gunakan halaman Selesaikan Wizard Penginstalan Paket untuk melihat ringkasan hasil penginstalan paket. Halaman ini menyediakan detail seperti nama proyek Integration Services yang disebarkan, paket yang diinstal, file konfigurasi, dan lokasi penginstalan.

Selesai
Keluar dari wizard dengan mengklik Selesai.