Menyebarkan Proyek dan Paket Layanan Integrasi (SSIS)
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Integration Services mendukung dua model penyebaran, model penyebaran proyek dan model penyebaran paket warisan. Model penyebaran proyek memungkinkan Anda menyebarkan proyek anda ke server Integration Services.
Untuk informasi selengkapnya tentang model penyebaran paket warisan, lihat Penyebaran Paket Warisan (SSIS).
Catatan
Model penyebaran proyek diperkenalkan di SQL Server 2012 Integration Services (SSIS). Dengan model penyebaran ini, Anda tidak dapat menyebarkan satu atau beberapa paket tanpa menyebarkan seluruh proyek. SQL Server 2016 (13.x) Integration Services (SSIS) memperkenalkan fitur Penyebaran Paket Bertahap, yang memungkinkan Anda menyebarkan satu atau beberapa paket tanpa menyebarkan seluruh proyek.
Catatan
Artikel ini menjelaskan cara menyebarkan paket SSIS secara umum, dan cara menyebarkan paket secara lokal. Anda juga dapat menyebarkan paket SSIS ke platform berikut:
- Cloud Microsoft Azure. Untuk informasi selengkapnya, lihat Mengangkat dan mengalihkan beban kerja SQL Server Integration Services ke cloud.
- Linux. Untuk informasi selengkapnya, lihat Mengekstrak, mengubah, dan memuat data di Linux dengan SSIS.
Membandingkan Model Penyebaran Proyek dan Model Penyebaran Paket warisan
Jenis model penyebaran yang Anda pilih untuk proyek menentukan opsi pengembangan dan administratif mana yang tersedia untuk proyek tersebut. Tabel berikut menunjukkan perbedaan dan kesamaan antara menggunakan model penyebaran proyek dan menggunakan model penyebaran paket.
| Saat Menggunakan Model Penyebaran Proyek | Saat Menggunakan Model Penyebaran Paket warisan |
|---|---|
| Proyek adalah unit penyebaran. | Paket adalah unit penyebaran. |
| Parameter digunakan untuk menetapkan nilai ke properti paket. | Konfigurasi digunakan untuk menetapkan nilai ke properti paket. |
| Proyek, yang berisi paket dan parameter, dibangun ke file penyebaran proyek (ekstensi.ispac). | Paket (ekstensi.dtsx) dan konfigurasi (ekstensi.dtsConfig) disimpan satu per satu ke sistem file. |
| Proyek, yang berisi paket dan parameter, disebarkan ke katalog SSISDB pada instans SQL Server. | Paket dan konfigurasi disalin ke sistem file pada komputer lain. Paket juga dapat disimpan ke database MSDB pada instans SQL Server. |
| Integrasi CLR diperlukan pada mesin database. | Integrasi CLR tidak diperlukan pada mesin database. |
| Nilai parameter khusus lingkungan disimpan dalam variabel lingkungan. | Nilai konfigurasi khusus lingkungan disimpan dalam file konfigurasi. |
| Proyek dan paket dalam katalog dapat divalidasi di server sebelum eksekusi. Anda dapat menggunakan SQL Server Management Studio, prosedur tersimpan, atau kode terkelola untuk melakukan validasi. | Paket divalidasi tepat sebelum eksekusi. Anda juga dapat memvalidasi paket dengan dtExec atau kode terkelola. |
| Paket dijalankan dengan memulai eksekusi pada mesin database. Pengidentifikasi proyek, nilai parameter eksplisit (opsional), dan referensi lingkungan (opsional) ditetapkan ke eksekusi sebelum dimulai. Anda juga dapat menjalankan paket menggunakan dtExec. |
Paket dijalankan menggunakan utilitas eksekusi dtExec dan DTExecUI . Konfigurasi yang berlaku diidentifikasi oleh argumen prompt perintah (opsional). |
| Selama eksekusi, peristiwa yang diproduksi oleh paket diambil secara otomatis dan disimpan ke katalog. Anda dapat mengkueri peristiwa ini dengan tampilan Transact-SQL. | Selama eksekusi, peristiwa yang dihasilkan oleh paket tidak diambil secara otomatis. Penyedia log harus ditambahkan ke paket untuk mengambil peristiwa. |
| Paket dijalankan dalam proses Windows terpisah. | Paket dijalankan dalam proses Windows terpisah. |
| SQL Server Agent digunakan untuk menjadwalkan eksekusi paket. | SQL Server Agent digunakan untuk menjadwalkan eksekusi paket. |
Fitur Model Penyebaran Proyek
Tabel berikut mencantumkan fitur yang tersedia untuk proyek yang dikembangkan hanya untuk model penyebaran proyek.
| Fitur | Deskripsi |
|---|---|
| Parameter | Parameter menentukan data yang akan digunakan oleh paket. Anda dapat mencakup parameter ke tingkat paket atau tingkat proyek dengan parameter paket dan parameter proyek. Parameter dapat digunakan dalam ekspresi atau tugas. Saat proyek disebarkan ke katalog, Anda dapat menetapkan nilai harfiah untuk setiap parameter atau menggunakan nilai default yang ditetapkan pada waktu desain. Sebagai ganti nilai harfiah, Anda juga dapat mereferensikan variabel lingkungan. Nilai variabel lingkungan diselesaikan pada saat eksekusi paket. |
| Lingkungan | Lingkungan adalah kontainer variabel yang dapat dirujuk oleh proyek Integration Services. Setiap proyek dapat memiliki beberapa referensi lingkungan, tetapi satu instans eksekusi paket hanya dapat mereferensikan variabel dari satu lingkungan. Lingkungan memungkinkan Anda mengatur nilai yang Anda tetapkan ke paket. Misalnya, Anda mungkin memiliki lingkungan bernama "Dev", "test", dan "Production". |
| Variabel lingkungan | Variabel lingkungan mendefinisikan nilai harfiah yang dapat ditetapkan ke parameter selama eksekusi paket. Untuk menggunakan variabel lingkungan, buat referensi lingkungan (dalam proyek yang sesuai dengan lingkungan yang memiliki parameter), tetapkan nilai parameter ke nama variabel lingkungan, dan tentukan referensi lingkungan yang sesuai saat Anda mengonfigurasi instans eksekusi. |
| Katalog SSISDB | Semua objek Integration Services disimpan dan dikelola pada instans SQL Server dalam database yang disebut sebagai katalog SSISDB. Katalog memungkinkan Anda menggunakan folder untuk mengatur proyek dan lingkungan Anda. Setiap instans SQL Server dapat memiliki satu katalog. Setiap katalog dapat memiliki nol atau lebih folder. Setiap folder dapat memiliki nol atau lebih proyek dan nol atau lebih lingkungan. Folder dalam katalog juga dapat digunakan sebagai batas untuk izin ke objek Layanan Integrasi. |
| Prosedur dan tampilan tersimpan katalog | Sejumlah besar prosedur dan tampilan tersimpan dapat digunakan untuk mengelola objek Layanan Integrasi dalam katalog. Misalnya, Anda dapat menentukan nilai ke parameter dan variabel lingkungan, membuat dan memulai eksekusi, dan memantau operasi katalog. Anda bahkan dapat melihat dengan tepat nilai mana yang akan digunakan oleh paket sebelum eksekusi dimulai. |
Penyebaran Proyek
Di pusat model penyebaran proyek adalah file penyebaran proyek (ekstensi.ispac). File penyebaran proyek adalah unit penyebaran mandiri yang hanya mencakup informasi penting tentang paket dan parameter dalam proyek. File penyebaran proyek tidak mengambil semua informasi yang terkandung dalam file proyek Integration Services (ekstensi.dtproj). Misalnya, file teks tambahan yang Anda gunakan untuk menulis catatan tidak disimpan dalam file penyebaran proyek dan dengan demikian tidak disebarkan ke katalog.
Izin yang Diperlukan untuk Menyebarkan Proyek dan Paket SSIS
Jika Anda mengubah akun layanan SSIS dari default, Anda mungkin harus memberikan izin tambahan ke akun layanan non-default sebelum Anda dapat menyebarkan paket dengan sukses. Jika akun layanan non-default tidak memiliki izin yang diperlukan, Anda mungkin melihat pesan kesalahan berikut.
A .NET Framework error occurred during execution of user-defined routine or aggregate "deploy_project_internal": System.ComponentModel.Win32Exception: A required privilege is not held by the client.
Kesalahan ini biasanya merupakan hasil dari izin DCOM yang hilang. Untuk memperbaiki kesalahan, lakukan hal berikut:
- Buka konsol Layanan Komponen (atau jalankan Dcomcnfg.exe).
- Di konsol Layanan Komponen, perluas Komputer>Layanan>Komponen Konfigurasi DCOM Komputer>Saya.
- Dalam daftar, temukan Microsoft SQL Server Integration Services xx.0 untuk versi SQL Server yang Anda gunakan. Misalnya, SQL Server 2016 adalah versi 13.
- Klik kanan dan pilih Properti.
- Dalam kotak dialog Properti Microsoft SQL Server Integration Services 13.0, pilih tab Keamanan .
- Untuk masing-masing dari tiga set izin - Luncurkan dan Aktivasi, Akses, dan Konfigurasi - pilih Kustomisasi, lalu pilih Edit untuk membuka kotak dialog Izin.
- Dalam kotak dialog Izin , tambahkan akun layanan non-default dan berikan Izinkan izin sesuai kebutuhan. Biasanya, akun memiliki izin Peluncuran Lokal dan Aktivasi Lokal.
- Klik OK dua kali, lalu tutup konsol Layanan Komponen.
Untuk informasi selengkapnya tentang kesalahan yang dijelaskan di bagian ini dan tentang izin yang diperlukan oleh akun layanan SSIS, lihat posting blog berikut ini:
Menyebarkan Proyek ke Server Layanan Integrasi
Dalam rilis Layanan Integrasi saat ini, Anda dapat menyebarkan proyek Anda ke server Layanan Integrasi. Server Integration Services memungkinkan Anda mengelola paket, menjalankan paket, dan mengonfigurasi nilai runtime untuk paket dengan menggunakan lingkungan.
Catatan
Seperti versi Integration Services sebelumnya, dalam rilis saat ini Anda juga dapat menyebarkan paket Anda ke instans SQL Server dan menggunakan layanan Layanan Integrasi untuk menjalankan dan mengelola paket. Anda menggunakan model penyebaran paket. Untuk informasi selengkapnya, lihat Penyebaran Paket Warisan (SSIS).
Untuk menyebarkan proyek ke server Integration Services, selesaikan tugas berikut:
Buat katalog SSISDB, jika Anda belum melakukannya. Untuk informasi selengkapnya, lihat Katalog SSIS.
Konversikan proyek ke model penyebaran proyek dengan menjalankan Wizard Konversi Proyek Layanan Integrasi. Untuk informasi selengkapnya, lihat instruksi berikut: Untuk mengonversi proyek ke model penyebaran proyek
Jika Anda membuat proyek di SQL Server 2014 Integration Services (SSIS) atau yang lebih baru, secara default proyek menggunakan model penyebaran proyek.
Jika Anda membuat proyek dalam rilis Integration Services sebelumnya, setelah Anda membuka file proyek di Visual Studio, konversikan proyek ke model penyebaran proyek.
Catatan
Jika proyek berisi satu atau beberapa sumber data, sumber data akan dihapus saat konversi proyek selesai. Untuk membuat koneksi ke sumber data yang dapat dibagikan paket dalam proyek, tambahkan manajer koneksi di tingkat proyek. Untuk informasi selengkapnya, lihat Menambahkan, Menghapus, atau Berbagi Pengelola Sambungan dalam Paket.
Bergantung pada apakah Anda menjalankan Wizard Konversi Proyek Layanan Integrasi dari Visual Studio atau dari SQL Server Management Studio, wizard melakukan tugas konversi yang berbeda.
Jika Anda menjalankan wizard dari Visual Studio, paket yang terkandung dalam proyek dikonversi dari Integration Services 2005, 2008, atau 2008 R2 ke format yang digunakan oleh versi Integration Services saat ini. File proyek asli (.dtproj) dan paket (.dtsx) ditingkatkan.
Jika Anda menjalankan wizard dari SQL Server Management Studio, wizard menghasilkan file penyebaran proyek (.ispac) dari paket dan konfigurasi yang terkandung dalam proyek. File paket asli (.dtsx) tidak ditingkatkan.
Anda bisa memilih file yang sudah ada atau membuat file baru, di halaman Tujuan Pilihan wizard.
Untuk meningkatkan file paket saat proyek dikonversi, jalankan Wizard Konversi Proyek Layanan Integrasi dari Visual Studio. Untuk meningkatkan file paket secara terpisah dari konversi proyek, jalankan Wizard Konversi Proyek Layanan Integrasi dari SQL Server Management Studio lalu jalankan Wizard Peningkatan Paket SSIS. Jika Anda meningkatkan file paket secara terpisah, pastikan Anda menyimpan perubahan. Jika tidak, ketika Anda mengonversi proyek ke model penyebaran proyek, setiap perubahan yang belum disimpan ke paket tidak dikonversi.
Untuk informasi selengkapnya tentang peningkatan paket, lihat Meningkatkan Paket Layanan Integrasi dan Meningkatkan Paket Layanan Integrasi Menggunakan Wizard Peningkatan Paket SSIS.
Sebarkan proyek ke server Integration Services. Untuk informasi selengkapnya, lihat instruksi di bawah ini: Untuk menyebarkan proyek ke Server Layanan Integrasi.
(Opsional) Buat lingkungan untuk proyek yang disebarkan.
Untuk mengonversi proyek ke model penyebaran proyek
Buka proyek di Visual Studio, lalu di Penjelajah Solusi, klik kanan proyek dan klik Konversi ke Model Penyebaran Proyek.
-atau-
Dari Object Explorer di Management Studio, klik kanan simpul Proyek dan pilih Impor Paket.
Selesaikan wizard.
Untuk menyebarkan proyek ke Server Layanan Integrasi
Buka proyek di Visual Studio, lalu Dari menu Proyek , pilih Sebarkan untuk meluncurkan Wizard Penyebaran Layanan Integrasi.
or
Di SQL Server Management Studio, perluas simpul SSISDB Layanan >Integrasi di Object Explorer, dan temukan folder Proyek untuk proyek yang ingin Anda sebarkan. Klik kanan folder Proyek, lalu klik Sebarkan Proyek.
or
Dari prompt perintah, jalankan isdeploymentwizard.exe dari %ProgramFiles%\Microsoft SQL Server\130\DTS\Binn. Pada komputer 64-bit, ada juga alat versi 32-bit di %ProgramFiles(x86)%\Microsoft SQL Server\130\DTS\Binn.
Pada halaman Pilih Sumber , klik File penyebaran proyek untuk memilih file penyebaran untuk proyek.
or
Klik katalog Layanan Integrasi untuk memilih proyek yang telah disebarkan ke katalog SSISDB.
Selesaikan wizard.
Menyebarkan Paket ke Server Layanan Integrasi
Fitur Penyebaran Paket Tambahan yang diperkenalkan di SQL Server 2016 (13.x) Integration Services (SSIS) memungkinkan Anda menyebarkan satu atau beberapa paket ke proyek yang ada atau baru tanpa menyebarkan seluruh proyek.
Menyebarkan paket dengan menggunakan Wizard Penyebaran Layanan Integrasi
Dari prompt perintah, jalankan isdeploymentwizard.exe dari %ProgramFiles%\Microsoft SQL Server\130\DTS\Binn. Pada komputer 64-bit, ada juga alat versi 32-bit di %ProgramFiles(x86)%\Microsoft SQL Server\130\DTS\Binn.
Pada halaman Pilih Sumber , beralihlah ke model Penyebaran Paket. Kemudian, pilih folder yang berisi paket sumber dan konfigurasikan paket.
Selesaikan wizard. Ikuti langkah-langkah lain yang dijelaskan dalam Model Penyebaran Paket.
Menyebarkan paket dengan menggunakan SQL Server Management Studio
Di SQL Server Management Studio, perluas simpul SSISDB Katalog>Layanan Integrasi di Object Explorer.
Klik kanan folder Proyek, lalu klik Sebarkan Proyek.
Jika Anda melihat halaman Pengenalan , klik Berikutnya untuk melanjutkan.
Pada halaman Pilih Sumber , beralihlah ke model Penyebaran Paket. Kemudian, pilih folder yang berisi paket sumber dan konfigurasikan paket.
Selesaikan wizard. Ikuti langkah-langkah lain yang dijelaskan dalam Model Penyebaran Paket.
Menyebarkan paket dengan menggunakan SQL Server Data Tools (Visual Studio)
Di Visual Studio, dengan proyek Integration Services terbuka, pilih paket atau paket yang ingin Anda sebarkan.
Klik kanan dan pilih Sebarkan Paket. Wizard Penyebaran terbuka dengan paket yang dipilih yang dikonfigurasi sebagai paket sumber.
Selesaikan wizard. Ikuti langkah-langkah lain yang dijelaskan dalam Model Penyebaran Paket.
Menyebarkan paket dengan menggunakan prosedur tersimpan deploy_packages
Anda dapat menggunakan [katalog].[ deploy_packages] prosedur tersimpan untuk menyebarkan satu atau beberapa paket SSIS ke Katalog SSIS. Contoh kode berikut menunjukkan penggunaan prosedur tersimpan ini untuk menyebarkan paket ke server SSIS. Untuk informasi selengkapnya, lihat catalog.deploy_packages.
private static void Main(string[] args)
{
// Connection string to SSISDB
var connectionString = "Data Source=.;Initial Catalog=SSISDB;Integrated Security=True;MultipleActiveResultSets=false";
using (var sqlConnection = new SqlConnection(connectionString))
{
sqlConnection.Open();
var sqlCommand = new SqlCommand
{
Connection = sqlConnection,
CommandType = CommandType.StoredProcedure,
CommandText = "[catalog].[deploy_packages]"
};
var packageData = Encoding.UTF8.GetBytes(File.ReadAllText(@"C:\Test\Package.dtsx"));
// DataTable: name is the package name without extension and package_data is byte array of package.
var packageTable = new DataTable();
packageTable.Columns.Add("name", typeof(string));
packageTable.Columns.Add("package_data", typeof(byte[]));
packageTable.Rows.Add("Package", packageData);
// Set the destination project and folder which is named Folder and Project.
sqlCommand.Parameters.Add(new SqlParameter("@folder_name", SqlDbType.NVarChar, ParameterDirection.Input, "Folder", -1));
sqlCommand.Parameters.Add(new SqlParameter("@project_name", SqlDbType.NVarChar, ParameterDirection.Input, "Project", -1));
sqlCommand.Parameters.Add(new SqlParameter("@packages_table", SqlDbType.Structured, ParameterDirection.Input, packageTable, -1));
var result = sqlCommand.Parameters.Add("RetVal", SqlDbType.Int);
result.Direction = ParameterDirection.ReturnValue;
sqlCommand.ExecuteNonQuery();
}
}
Menyebarkan paket menggunakan API Model Objek Manajemen
Contoh kode berikut menunjukkan penggunaan API Model Objek Manajemen untuk menyebarkan paket ke server.
static void Main()
{
// Before deploying packages, make sure the destination project exists in SSISDB.
var connectionString = "Data Source=.;Integrated Security=True;MultipleActiveResultSets=false";
var catalogName = "SSISDB";
var folderName = "Folder";
var projectName = "Project";
// Get the folder instance.
var sqlConnection = new SqlConnection(connectionString);
var store = new Microsoft.SqlServer.Management.IntegrationServices.IntegrationServices(sqlConnection);
var folder = store.Catalogs[catalogName].Folders[folderName];
// Key is package name without extension and value is package binaries.
var packageDict = new Dictionary<string, string>();
var packageData = File.ReadAllText(@"C:\Folder\Package.dtsx");
packageDict.Add("Package", packageData);
// Deploy package to the destination project.
folder.DeployPackages(projectName, packageDict);
}
Kotak Dialog Konversi ke Model Penyebaran Paket
Perintah Konversi ke Model Penyebaran Paket memungkinkan Anda mengonversi paket ke model penyebaran paket setelah memeriksa proyek dan setiap paket dalam proyek untuk kompatibilitas dengan model tersebut. Jika paket menggunakan fitur unik untuk model penyebaran proyek, seperti parameter, maka paket tidak dapat dikonversi.
Mengonversi paket ke model penyebaran paket memerlukan dua langkah.
Saat Anda memilih perintah Konversi ke Model Penyebaran Paket dari menu Proyek , proyek dan setiap paket diperiksa kompatibilitasnya dengan model ini. Hasilnya ditampilkan dalam tabel Hasil .
Jika proyek atau paket gagal dalam pengujian kompatibilitas, klik Gagal di kolom Hasil untuk informasi selengkapnya. Klik Simpan Laporan untuk menyimpan salinan informasi ini ke file teks.
Jika proyek dan semua paket lulus uji kompatibilitas, klik OK untuk mengonversi paket.
Catatan
Untuk mengonversi proyek ke model penyebaran proyek, gunakan Wizard Konversi Proyek Layanan Integrasi. Untuk informasi selengkapnya, lihat Wizard Konversi Proyek Integration Services.
Wizard Penyebaran Layanan Integrasi
Wizard Penyebaran Layanan Integrasi mendukung dua model penyebaran:
- Model penyebaran proyek
- Model penyebaran paket
Model Penyebaran Proyek memungkinkan Anda menyebarkan proyek SQL Server Integration Services (SSIS) sebagai satu unit ke Katalog SSIS.
Model Penyebaran Paket memungkinkan Anda menyebarkan paket yang telah Anda perbarui ke Katalog SSIS tanpa harus menyebarkan seluruh proyek.
Catatan
Penyebaran default Wizard adalah model Penyebaran Proyek.
Luncurkan wizard
Luncurkan wizard dengan:
- Mengetik "Wizard Penyebaran SQL Server" di Windows Search
or
- Cari file yang dapat dieksekusi ISDeploymentWizard.exe di bawah folder penginstalan SQL Server; misalnya: "C:\Program Files (x86)\Microsoft SQL Server\130\DTS\Binn".
Catatan
Jika Anda melihat halaman Pengenalan , klik Berikutnya untuk beralih ke halaman Pilih Sumber .
Pengaturan di halaman ini berbeda untuk setiap model penyebaran. Ikuti langkah-langkah di bagian Model Penyebaran Proyek atau Model Penyebaran Paket berdasarkan model yang Anda pilih di halaman ini.
Model Penyebaran Proyek
Pilih Sumber
Untuk menyebarkan file penyebaran proyek yang Anda buat, pilih File penyebaran proyek dan masukkan jalur ke file .ispac. Untuk menyebarkan proyek yang berada di katalog Layanan Integrasi, pilih katalog Layanan Integrasi, lalu masukkan nama server dan jalur ke proyek di katalog. Klik Berikutnya untuk melihat halaman Pilih Tujuan .
Pilih Tujuan
Untuk memilih folder tujuan untuk proyek di katalog Layanan Integrasi, masukkan instans SQL Server atau klik Telusuri untuk memilih dari daftar server. Masukkan jalur proyek di SSISDB atau klik Telusuri untuk memilihnya. Klik Berikutnya untuk melihat halaman Tinjau .
Tinjau (dan sebarkan)
Halaman ini memungkinkan Anda meninjau pengaturan yang telah Anda pilih. Anda bisa mengubah pilihan Anda dengan mengklik Sebelumnya, atau dengan mengklik salah satu langkah di panel kiri. Klik Sebarkan untuk memulai proses penyebaran.
Hasil
Setelah proses penyebaran selesai, Anda akan melihat halaman Hasil . Halaman ini menampilkan keberhasilan atau kegagalan setiap tindakan. Jika tindakan gagal, klik Gagal di kolom Hasil untuk menampilkan penjelasan tentang kesalahan. Klik Simpan Laporan... untuk menyimpan hasil ke file XML atau Klik Tutup untuk keluar dari panduan.
Model Penyebaran Paket
Pilih Sumber
Halaman Pilih Sumber di Wizard Penyebaran Layanan Integrasi memperlihatkan pengaturan khusus untuk model penyebaran paket saat Anda memilih opsi Penyebaran Paket untuk model penyebaran.
Untuk memilih paket sumber, klik tombol Telusuri... untuk memilih folder yang berisi paket atau ketik jalur folder di kotak teks jalur folder Paket dan klik tombol Refresh di bagian bawah halaman. Sekarang, Anda akan melihat semua paket dalam folder yang ditentukan dalam kotak daftar. Secara default, semua paket dipilih. Klik kotak centang di kolom pertama untuk memilih paket mana yang ingin Anda sebarkan ke server.
Lihat kolom Status dan Pesan untuk memverifikasi status paket. Jika status diatur ke Siap atau Peringatan, wizard penyebaran tidak akan memblokir proses penyebaran. Jika status diatur ke Kesalahan, wizard tidak akan melanjutkan untuk menyebarkan paket yang dipilih. Untuk melihat pesan Peringatan atau Kesalahan terperinci, klik tautan di kolom Pesan .
Jika data sensitif atau data paket dienkripsi dengan kata sandi, ketik kata sandi di kolom Kata Sandi dan klik tombol Refresh untuk memverifikasi apakah kata sandi diterima. Jika kata sandi benar, status akan berubah menjadi Siap dan pesan peringatan akan hilang. Jika ada beberapa paket dengan kata sandi yang sama, pilih paket dengan kata sandi enkripsi yang sama, ketik kata sandi di kotak teks Kata Sandi dan pilih tombol Terapkan . Kata sandi akan diterapkan ke paket yang dipilih.
Jika status semua paket yang dipilih tidak diatur ke Kesalahan, tombol Berikutnya akan diaktifkan sehingga Anda dapat melanjutkan proses penyebaran paket.
Pilih Tujuan
Setelah memilih sumber paket, klik tombol Berikutnya untuk beralih ke halaman Pilih Tujuan . Paket harus disebarkan ke proyek di Katalog SSIS (SSISDB). Sebelum menyebarkan paket, pastikan proyek tujuan sudah ada di Katalog SSIS. Buat proyek kosong jika proyek tidak ada. Di halaman Pilih Tujuan , ketik nama server di kotak teks Nama Server atau klik tombol Telusuri... untuk memilih instans server. Kemudian klik tombol Telusuri... di samping kotak teks Jalur untuk menentukan proyek tujuan. Jika proyek tidak ada, klik tombol Proyek baru... untuk membuat proyek kosong sebagai proyek tujuan. Proyek harus dibuat di bawah folder.
Meninjau dan menyebarkan
Klik Berikutnya pada halaman Pilih Tujuan untuk beralih ke halaman Tinjau di Wizard Penyebaran Layanan Integrasi. Di halaman tinjau, tinjau laporan ringkasan tentang tindakan penyebaran. Setelah verifikasi, klik tombol Sebarkan untuk melakukan tindakan penyebaran.
Hasil
Setelah penyebaran selesai, Anda akan melihat halaman Hasil . Pada halaman Hasil , tinjau hasil dari setiap langkah dalam proses penyebaran. Klik Simpan Laporan untuk menyimpan laporan penyebaran atau Tutup ke wizard tutup.
Membuat dan Memetakan Lingkungan Server
Anda membuat lingkungan server untuk menentukan nilai runtime untuk paket yang terkandung dalam proyek yang telah Anda sebarkan ke server Layanan Integrasi. Anda kemudian dapat memetakan variabel lingkungan ke parameter, untuk paket tertentu, untuk paket titik masuk, atau untuk semua paket dalam proyek tertentu. Paket titik masuk biasanya merupakan paket induk yang menjalankan paket anak.
Penting
Untuk eksekusi tertentu, paket hanya dapat dijalankan dengan nilai yang terkandung dalam satu lingkungan server.
Anda dapat mengkueri tampilan untuk daftar lingkungan server, referensi lingkungan, dan variabel lingkungan. Anda juga dapat memanggil prosedur tersimpan untuk menambahkan, menghapus, dan memodifikasi lingkungan, referensi lingkungan, dan variabel lingkungan. Untuk informasi selengkapnya, lihat bagian Lingkungan Server, Variabel Server, dan Referensi Lingkungan Server di Katalog SSIS.
Untuk membuat dan menggunakan lingkungan server
Di Management Studio, perluas simpul SSISDB Katalog Layanan Integrasi di Object Explorer, dan temukan folder Lingkungan proyek yang ingin Anda buat lingkungannya.
Klik kanan folder Lingkungan, lalu klik Buat Lingkungan.
Ketik nama untuk lingkungan dan secara opsional tambahkan deskripsi. Klik OK.
Klik kanan lingkungan baru lalu klik Properti.
Pada halaman Variabel , lakukan hal berikut untuk menambahkan variabel.
Pilih Jenis untuk variabel. Nama variabel tidak perlu cocok dengan nama parameter proyek yang Anda petakan ke variabel .
Masukkan Deskripsi opsional untuk variabel .
Masukkan Nilai untuk variabel lingkungan.
Untuk informasi tentang aturan untuk nama variabel lingkungan, lihat bagian Variabel Lingkungan di Katalog SSIS.
Tunjukkan apakah variabel berisi nilai sensitif, dengan memilih atau menghapus kotak centang Sensitif .
Jika Anda memilih Sensitif, nilai variabel tidak ditampilkan di bidang Nilai .
Nilai sensitif dienkripsi dalam katalog SSISDB. Untuk informasi selengkapnya tentang enkripsi, lihat Katalog SSIS.
Pada halaman Izin , berikan atau tolak izin untuk pengguna dan peran yang dipilih dengan melakukan hal berikut ini.
Klik Telusuri, lalu pilih satu atau beberapa pengguna dan peran dalam kotak dialog Telusuri Semua Prinsipal .
Di area Masuk atau peran, pilih pengguna atau peran yang ingin Anda berikan atau tolak izinnya.
Di area Eksplisit, pilih Berikan atau Tolak di samping setiap izin.
Untuk membuat skrip lingkungan, klik Skrip. Secara default, skrip ditampilkan di jendela Editor Kueri baru.
Tip
Anda perlu mengklik Skrip setelah membuat satu atau perubahan pada properti lingkungan, seperti menambahkan variabel, dan sebelum Anda mengklik OK dalam kotak dialog Properti Lingkungan. Jika tidak, skrip tidak dihasilkan.
Klik OK untuk menyimpan perubahan Anda ke properti lingkungan.
Di bawah simpul SSISDB di Object Explorer, perluas folder Proyek , klik kanan proyek, lalu klik Konfigurasikan.
Pada halaman Referensi , klik Tambahkan untuk menambahkan lingkungan, lalu klik OK untuk menyimpan referensi ke lingkungan.
Klik kanan proyek lagi, lalu klik Konfigurasikan.
Untuk memetakan variabel lingkungan ke parameter yang Anda tambahkan ke paket pada waktu desain atau ke parameter yang dihasilkan saat Anda mengonversi proyek Integration Services ke model penyebaran proyek, lakukan hal berikut:
Di tab Parameter pada halaman Parameter , klik tombol telusuri di samping bidang Nilai .
Klik Gunakan variabel lingkungan, lalu pilih variabel lingkungan yang Anda buat.
Untuk memetakan variabel lingkungan ke properti pengelola koneksi, lakukan hal berikut. Parameter secara otomatis dihasilkan di server SSIS untuk properti pengelola koneksi.
Di tab Pengelola Sambungan pada halaman Parameter, klik tombol telusuri di samping bidang Nilai.
Klik Gunakan variabel lingkungan, lalu pilih variabel lingkungan yang Anda buat.
Klik OK dua kali untuk menyimpan perubahan Anda.
Menyebarkan dan Menjalankan Paket SSIS menggunakan Prosedur Tersimpan
Saat mengonfigurasi proyek Integration Services untuk menggunakan model penyebaran proyek, Anda dapat menggunakan prosedur tersimpan di katalog SSIS untuk menyebarkan proyek dan menjalankan paket. Untuk informasi tentang model penyebaran proyek, lihat Penyebaran Proyek dan Paket.
Anda juga dapat menggunakan SQL Server Management Studio atau SQL Server Data Tools (SSDT) untuk menyebarkan proyek dan menjalankan paket. Untuk informasi selengkapnya, lihat topik di bagian Lihat Juga .
Tip
Anda dapat dengan mudah membuat pernyataan Transact-SQL untuk prosedur tersimpan yang tercantum dalam prosedur di bawah ini, dengan pengecualian catalog.deploy_project, dengan melakukan hal berikut:
Di SQL Server Management Studio, perluas simpul Katalog Layanan Integrasi di Object Explorer dan navigasikan ke paket yang ingin Anda jalankan.
Klik kanan paket, lalu klik Jalankan.
Sesuai kebutuhan, atur nilai parameter, properti pengelola koneksi, dan opsi di tab Tingkat Lanjut seperti tingkat pengelogan.
Untuk informasi selengkapnya tentang tingkat pengelogan, lihat Mengaktifkan Pengelogan untuk Eksekusi Paket di Server SSIS.
Sebelum mengklik OK untuk menjalankan paket, klik Skrip. Transact-SQL muncul di jendela Editor Kueri di SQL Server Management Studio.
Untuk menyebarkan dan menjalankan paket menggunakan prosedur tersimpan
Panggil catalog.deploy_project (Database SSISDB) untuk menyebarkan proyek Layanan Integrasi yang berisi paket ke server Layanan Integrasi.
Untuk mengambil konten biner file penyebaran proyek Integration Services, untuk parameter_ @project_stream , gunakan pernyataan SELECT dengan fungsi OPENROWSET dan penyedia set baris MASSAL. Penyedia himpunan baris MASSAL memungkinkan Anda membaca data dari file. Argumen SINGLE_BLOB untuk penyedia set baris MASSAL mengembalikan konten file data sebagai kumpulan baris tunggal dan kolom tunggal dari jenis varbinary(maks). Untuk informasi selengkapnya, lihat OPENROWSET (Transact-SQL).
Dalam contoh berikut, proyek SSISPackages_ProjectDeployment disebarkan ke folder Paket SSIS di server Layanan Integrasi. Data biner dibaca dari file proyek (SSISPackage_ProjectDeployment.ispac) dan disimpan dalam parameter _@ProjectBinary jenis varbinary(maks). Nilai parameter @ProjectBinary ditetapkan ke parameter @project_stream .
DECLARE @ProjectBinary as varbinary(max) DECLARE @operation_id as bigint Set @ProjectBinary = (SELECT * FROM OPENROWSET(BULK 'C:\MyProjects\ SSISPackage_ProjectDeployment.ispac', SINGLE_BLOB) as BinaryData) Exec catalog.deploy_project @folder_name = 'SSIS Packages', @project_name = 'DeployViaStoredProc_SSIS', @Project_Stream = @ProjectBinary, @operation_id = @operation_id outPanggil catalog.create_execution (Database SSISDB) untuk membuat instans eksekusi paket, dan secara opsional memanggil catalog.set_execution_parameter_value (Database SSISDB) untuk mengatur nilai parameter runtime.
Dalam contoh berikut, catalog.create_execution membuat instans eksekusi untuk package.dtsx yang terkandung dalam proyek SSISPackage_ProjectDeployment. Proyek ini terletak di folder Paket SSIS. execution_id yang dikembalikan oleh prosedur tersimpan digunakan dalam panggilan ke catalog.set_execution_parameter_value. Prosedur tersimpan kedua ini mengatur parameter LOGGING_LEVEL ke 3 (pengelogan verbose) dan mengatur parameter paket bernama Parameter1 ke nilai 1.
Untuk parameter seperti LOGGING_LEVEL nilai object_type adalah 50. Untuk parameter paket, nilai object_type adalah 30.
Declare @execution_id bigint EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'SSIS Packages', @project_name=N'SSISPackage_ProjectDeployment', @use32bitruntime=False, @reference_id=1 Select @execution_id DECLARE @var0 smallint = 3 EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0 DECLARE @var1 int = 1 EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=30, @parameter_name=N'Parameter1', @parameter_value=@var1 GOPanggil catalog.start_execution (Database SSISDB) untuk menjalankan paket.
Dalam contoh berikut, panggilan ke catalog.start_execution ditambahkan ke Transact-SQL untuk memulai eksekusi paket. Execution_id yang dikembalikan oleh prosedur tersimpan catalog.create_execution digunakan.
Declare @execution_id bigint EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'SSIS Packages', @project_name=N'SSISPackage_ProjectDeployment', @use32bitruntime=False, @reference_id=1 Select @execution_id DECLARE @var0 smallint = 3 EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0 DECLARE @var1 int = 1 EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=30, @parameter_name=N'Parameter1', @parameter_value=@var1 EXEC [SSISDB].[catalog].[start_execution] @execution_id GO
Untuk menyebarkan proyek dari server ke server menggunakan prosedur tersimpan
Anda dapat menyebarkan proyek dari server ke server dengan menggunakan prosedur tersimpan catalog.get_project (Database SSISDB) dan catalog.deploy_project (Database SSISDB).
Anda perlu melakukan hal berikut sebelum menjalankan prosedur tersimpan.
Buat objek server tertaut. Untuk informasi selengkapnya, lihat Membuat Server Tertaut (SQL Server Database Engine).
Pada halaman Opsi Server dari kotak dialog Properti Server Tertaut, atur RPC dan RPC Keluar ke True. Selain itu, atur Aktifkan Promosi Transaksi Terdistribusi untuk RPC ke False.
Aktifkan parameter dinamis untuk penyedia yang Anda pilih untuk server tertaut, dengan memperluas simpul Penyedia di bawah Server Tertaut di Object Explorer, mengklik kanan penyedia, lalu mengklik Properti. Pilih Aktifkan di samping Parameter dinamis.
Konfirmasikan bahwa Koordinator Transaksi Terdistribusi (DTC) dimulai di kedua server.
Panggil catalog.get_project untuk mengembalikan biner untuk proyek, lalu panggil catalog.deploy_project. Nilai yang dikembalikan oleh catalog.get_project dimasukkan ke dalam variabel tabel jenis varbinary(maks). Server tertaut tidak dapat mengembalikan hasil yang varbinary(maks).
Dalam contoh berikut, catalog.get_project mengembalikan biner untuk proyek SSISPackages di server tertaut. catalog.deploy_project menyebarkan proyek ke server lokal, ke folder bernama DestFolder.
declare @resultsTableVar table (
project_binary varbinary(max)
)
INSERT @resultsTableVar (project_binary)
EXECUTE [MyLinkedServer].[SSISDB].[catalog].[get_project] 'Packages', 'SSISPackages'
declare @project_binary varbinary(max)
select @project_binary = project_binary from @resultsTableVar
exec [SSISDB].[CATALOG].[deploy_project] 'DestFolder', 'SSISPackages', @project_binary
Wizard Konversi Proyek Integration Services
Wizard Konversi Proyek Integration Services mengonversi proyek ke model penyebaran proyek.
Catatan
Jika proyek berisi satu atau beberapa sumber data, sumber data akan dihapus saat konversi proyek selesai. Untuk membuat koneksi ke sumber data yang dapat dibagikan oleh paket dalam proyek, tambahkan manajer koneksi di tingkat proyek. Untuk informasi selengkapnya, lihat Menambahkan, Menghapus, atau Berbagi Pengelola Sambungan dalam Paket.
Apa yang ingin Anda lakukan?
Buka Wizard Konversi Proyek Integration Services
Lakukan salah satu hal berikut ini untuk membuka Wizard Konversi Proyek Layanan Integrasi.
Buka proyek di Visual Studio, lalu di Penjelajah Solusi, klik kanan proyek dan klik Konversi ke Model Penyebaran Proyek.
Dari Object Explorer di Management Studio, klik kanan simpul Proyek di Katalog Layanan Integrasi dan pilih Impor Paket.
Bergantung pada apakah Anda menjalankan Wizard Konversi Proyek Layanan Integrasi dari Visual Studio atau dari SQL Server Management Studio, wizard melakukan tugas konversi yang berbeda.
Atur Opsi di Halaman Temukan Paket
Catatan
Halaman Temukan Paket hanya tersedia saat Anda menjalankan wizard dari Management Studio.
Opsi berikut ini ditampilkan di halaman saat Anda memilih Sistem file di daftar drop-down Sumber . Pilih opsi ini saat paket berada di sistem file.
Folder
Ketik jalur paket, atau navigasi ke paket dengan mengklik Telusuri.
Opsi berikut ini ditampilkan di halaman saat Anda memilih Penyimpanan Paket SSIS di daftar drop-down Sumber . Untuk informasi selengkapnya tentang penyimpanan paket, lihat Manajemen Paket (Layanan SSIS).
Server
Ketik nama server atau pilih server.
Folder
Ketik jalur paket, atau navigasi ke paket dengan mengklik Telusuri.
Opsi berikut ini ditampilkan di halaman saat Anda memilih Microsoft SQL Server di daftar drop-down Sumber . Pilih opsi ini saat paket berada di Microsoft SQL Server.
Server
Ketik nama server atau pilih server.
Menggunakan autentikasi Windows
Mode Autentikasi Microsoft Windows memungkinkan pengguna untuk tersambung melalui akun pengguna Windows. Jika Anda menggunakan Autentikasi Windows, Anda tidak perlu memberikan nama pengguna atau kata sandi.
Menggunakan autentikasi SQL Server
Ketika pengguna terhubung dengan nama masuk dan kata sandi tertentu dari koneksi yang tidak tepercaya, SQL Server mengautentikasi koneksi dengan memeriksa apakah akun masuk SQL Server telah disiapkan dan jika kata sandi yang ditentukan cocok dengan yang direkam sebelumnya. Jika SQL Server tidak memiliki set akun masuk, autentikasi gagal, dan pengguna menerima pesan kesalahan.
Nama pengguna
Tentukan nama pengguna saat Anda menggunakan Autentikasi SQL Server.
Password
Berikan kata sandi saat Anda menggunakan Autentikasi SQL Server.
Folder
Ketik jalur paket, atau navigasi ke paket dengan mengklik Telusuri.
Atur Opsi di Halaman Pilih Paket
Nama Paket
Mencantumkan file paket.
Keadaan
Menunjukkan apakah paket siap untuk dikonversi ke model penyebaran proyek.
Pesan
Menampilkan pesan yang terkait dengan paket.
Password
Menampilkan kata sandi yang terkait dengan paket. Teks kata sandi disembunyikan.
Terapkan ke pilihan
Klik untuk menerapkan kata sandi dalam kotak teks Kata Sandi , ke paket atau paket yang dipilih.
Refresh
Menyegarkan daftar paket.
Atur Opsi di Halaman Pilih Tujuan
Pada halaman ini, tentukan nama dan jalur untuk file penyebaran proyek baru (.ispac) atau pilih file yang sudah ada.
Catatan
Halaman Pilih Tujuan hanya tersedia saat Anda menjalankan wizard dari Management Studio.
Jalur output
Ketik jalur untuk file penyebaran atau navigasi ke file dengan mengklik Telusuri.
Nama proyek
Ketik nama proyek.
Tingkat perlindungan
Pilih tingkat perlindungan. Untuk informasi selengkapnya, lihat Kontrol Akses untuk Data Sensitif dalam Paket.
Deskripsi proyek
Ketik deskripsi opsional untuk proyek.
Atur Opsi di Halaman Tentukan Properti Proyek
Catatan
Halaman Tentukan Properti Proyek hanya tersedia saat Anda menjalankan wizard dari Visual Studio.
Nama proyek
Mencantumkan nama proyek.
Tingkat perlindungan
Pilih tingkat perlindungan untuk paket yang terkandung dalam proyek. Untuk informasi selengkapnya tentang tingkat perlindungan, lihat Kontrol Akses untuk Data Sensitif dalam Paket.
Deskripsi proyek
Ketik deskripsi proyek opsional.
Atur Opsi di Halaman Tugas Eksekusi Paket Eksekusi Pembaruan
Perbarui Tugas Eksekusi Paket yang ada dalam paket, untuk menggunakan referensi berbasis proyek. Untuk informasi selengkapnya, lihat Menjalankan Editor Tugas Paket.
Paket Induk
Mencantumkan nama paket yang menjalankan paket anak menggunakan tugas Jalankan Paket.
Nama tugas
Mencantumkan nama tugas Jalankan Paket.
Referensi asli
Mencantumkan jalur paket anak saat ini.
Tetapkan referensi
Pilih paket anak yang disimpan dalam proyek.
Atur Opsi di Halaman Pilih Konfigurasi
Pilih konfigurasi paket yang ingin Anda ganti dengan parameter.
Paket
Mencantumkan file paket.
Jenis
Mencantumkan jenis konfigurasi, seperti file konfigurasi XML.
String Konfigurasi
Mencantumkan jalur file konfigurasi.
Keadaan
Menampilkan pesan status untuk konfigurasi. Klik pesan untuk menampilkan seluruh teks pesan.
Tambahkan Konfigurasi
Tambahkan konfigurasi paket yang terkandung dalam proyek lain ke daftar konfigurasi yang tersedia yang ingin Anda ganti dengan parameter. Anda dapat memilih konfigurasi yang disimpan dalam sistem file atau disimpan di SQL Server.
Refresh
Klik untuk menyegarkan daftar konfigurasi.
Menghapus konfigurasi dari semua paket setelah konversi
Disarankan agar Anda menghapus semua konfigurasi dari proyek dengan memilih opsi ini.
Jika Anda tidak memilih opsi ini, hanya konfigurasi yang Anda pilih untuk diganti dengan parameter yang dihapus.
Atur Opsi di Halaman Buat Parameter
Pilih nama parameter dan cakupan untuk setiap properti konfigurasi.
Paket
Mencantumkan file paket.
Nama Parameter
Mencantumkan nama parameter.
Cakupan
Pilih cakupan parameter, baik paket atau proyek.
Atur Opsi di Halaman Konfigurasi Parameter
Nama
Mencantumkan nama parameter.
Cakupan
Mencantumkan cakupan parameter.
Nilai
Mencantumkan nilai parameter.
Klik tombol elipsis di samping bidang nilai untuk mengonfigurasi properti parameter.
Dalam kotak dialog Atur Detail Parameter, Anda dapat mengedit nilai parameter. Anda juga dapat menentukan apakah nilai parameter harus disediakan saat Menjalankan paket.
Anda dapat mengubah nilai di halaman Parameter dari kotak dialog Konfigurasi di Management Studio, dengan mengklik tombol telusuri di samping parameter . Kotak dialog Atur Nilai Parameter muncul.
Kotak dialog Atur Detail Parameter juga mencantumkan jenis data nilai parameter dan asal parameter.
Atur Opsi di halaman Tinjau
Gunakan halaman Tinjau untuk mengonfirmasi opsi yang telah Anda pilih untuk konversi proyek.
Sebelumnya
Klik untuk mengubah opsi.
Mengonversi
Klik untuk mengonversi proyek ke model penyebaran proyek.
Atur Opsi pada Konversi Perform
Halaman Lakukan Konversi memperlihatkan status konversi proyek.
Perbuatan
Mencantumkan langkah konversi tertentu.
Hasil
Mencantumkan status setiap langkah konversi. Klik pesan status untuk informasi selengkapnya.
Konversi proyek tidak disimpan hingga proyek disimpan di Visual Studio.
Simpan laporan
Klik untuk menyimpan ringkasan konversi proyek dalam file .xml.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk