Bagikan melalui

Contoh Skrip rs.exe Reporting Services untuk Memigrasikan Konten antar Server Laporan

  • Artikel

Topik ini mencakup dan menjelaskan contoh skrip RSS Reporting Services yang menyalin item konten dan pengaturan dari satu server laporan SQL Server Reporting Services ke server laporan lain, menggunakan utilitas RS.exe. RS.exe diinstal dengan Reporting Services, baik mode asli maupun sharePoint. Skrip menyalin item Reporting Services, misalnya laporan dan langganan, dari server ke server lain. Skrip ini mendukung server laporan mode SharePoint dan mode Asli.
Berlaku untuk: Mode SharePoint Reporting Services | Mode Asli Reporting Services

Dalam Topik ini:

Untuk Mengunduh Skrip ssrs_migration.rss

Unduh skrip dari situs CodePlex Reporting Services RS.exe skrip memigrasikan konten ke folder lokal. Lihat bagian Cara menggunakan skrip dalam topik ini untuk informasi selengkapnya.

Skenario yang Didukung

Skrip ini mendukung server laporan mode SharePoint dan mode Asli. Skrip mendukung versi server laporan berikut:

  • SQL Server 2014

  • SQL Server 2012

  • SQL Server 2008 R2

Skrip dapat digunakan untuk menyalin konten antara server laporan dengan mode yang sama atau mode yang berbeda. Misalnya, Anda dapat menjalankan skrip untuk menyalin konten dari server laporan mode asli SQL Server 2008 R2 ke server laporan mode SharePoint SQL Server 2012 SP1. Anda dapat menjalankan skrip dari server mana pun tempat RS.exe diinstal. Misalnya, dalam penyebaran berikut, Anda dapat:

  • Jalankan RS.exe dan skrip ON Server A.

  • Untuk menyalin konten DARI Server B

  • UNTUK Server C

Nama server Mode Server Laporan
Server A Asli
Server B SharePoint
Server C SharePoint

Untuk informasi selengkapnya tentang utilitas RS.exe, lihat utilitasRS.exe (SSRS).

Item dan sumber daya skrip bermigrasi

Skrip tidak akan menulis atas item konten yang ada dengan nama yang sama. Jika skrip mendeteksi item dengan nama yang sama di server tujuan yang ada di server sumber, item individual akan mengakibatkan pesan "kegagalan" dan skrip akan dilanjutkan. Tabel berikut mencantumkan jenis konten dan sumber daya yang dapat dimigrasikan skrip ke mode server laporan target.

Item Dimigrasikan SharePoint Deskripsi
Sandi Tidak Tidak Kata sandi TIDAK dimigrasikan. Setelah item konten dimigrasikan, perbarui informasi kredensial di server tujuan. Misalnya, sumber data dengan kredensial tersimpan.
Laporan Saya Tidak Tidak Fitur Mode asli "Laporan Saya" didasarkan pada login pengguna individual oleh karena itu layanan pembuatan skrip tidak memiliki akses ke konten di folder "Laporan Saya" untuk pengguna selain parameter -u yang digunakan untuk menjalankan skrip rss. Selain itu, "Laporan Saya" bukan fitur mode SharePoint Reporting Services dan item dalam folder tidak dapat disalin ke lingkungan SharePoint. Oleh karena itu, skrip tidak menyalin item laporan yang ada di folder "Laporan Saya" di server laporan mode asli sumber. Untuk memigrasikan konten di folder "Laporan Saya" dengan skrip ini, selesaikan hal berikut:

1) Buat folder baru di Manajer Laporan. Secara opsional, Anda dapat membuat folder atau subfolder untuk setiap pengguna.

2) Masuk sebagai salah satu pengguna dengan konten "Laporan Saya".

3) Di Manajer Laporan, klik folder Laporan Saya .

4) Klik tampilan Detail untuk folder.

5) Pilih setiap laporan yang ingin Anda salin.

6) Klik Pindahkan di toolbar Manajer Laporan.

7) Pilih folder tujuan yang diinginkan.

8) Ulangi langkah 2-7 untuk setiap pengguna.

9) Jalankan skrip.
Riwayat Tidak Tidak
Pengaturan riwayat Ya Ya Pengaturan riwayat dimigrasikan namun detail riwayat TIDAK dimigrasikan.
Jadwal ya ya Untuk memigrasikan jadwal, diperlukan SQL Server Agent berjalan di server target. Jika SQL Server Agent tidak berjalan pada target, Anda akan melihat pesan kesalahan yang mirip dengan yang berikut ini:

Migrating schedules: 1 items found. Migrating schedule: theMondaySchedule ... FAILURE: The SQL Agent service is not running. This operation requires the SQL Agent service. ---> Microsoft.ReportingServices.Diagnostics.Utilities.SchedulerNotResponding Exception: The SQL Agent service is not running. This operation requires the SQL Agent service.
Peran dan kebijakan sistem Ya Ya Secara default skrip tidak akan menyalin skema izin kustom antar server. Perilaku default adalah item akan dikoi ke server tujuan dengan bendera 'warisi izin induk' diatur ke TRUE. Jika Anda ingin skrip menyalin izin untuk item individual, gunakan sakelar KEAMANAN.

Jika server sumber dan target bukan mode server laporan yang sama, misalnya dari mode asli ke mode SharePoint, dan Anda menggunakan sakelar KEAMANAN, skrip akan mencoba memetakan peran dan grup default berdasarkan perbandingan dalam topik berikut Bandingkan Peran dan Tugas di Reporting Services ke Grup dan Izin SharePoint. Peran dan grup kustom tidak disalin ke server tujuan.

Ketika skrip menyalin antara server yang memiliki mode yang sama, dan Anda menggunakan sakelar SECURITY, skrip akan membuat peran baru (mode asli) atau grup (mode SharePoint) di server tujuan.

Jika peran sudah ada di server tujuan, skrip akan membuat pesan "Kegagalan" yang mirip dengan yang berikut ini, dan terus memigrasikan item lain. Setelah skrip selesai, verifikasi peran di server tujuan dikonfigurasi untuk memenuhi kebutuhan Anda. peran Migrasi: 8 item ditemukan.

Migrating role: Browser ... FAILURE: The role 'Browser' already exists and cannot be created. ---> Microsoft.ReportingServices.Diagnostics.Utilities.RoleAlreadyExistsException: The role 'Browser' already exists and cannot be created.

Untuk informasi selengkapnya, lihat Memberikan Akses Pengguna ke Server Laporan (Manajer Laporan)

Catatan: jika pengguna yang ada di server sumber tidak ada di server tujuan, skrip tidak dapat menerapkan penetapan peran di server tujuan, skrip tidak dapat menerapkan penetapan peran, bahkan jika sakelar KEAMANAN digunakan.
Sumber data bersama Ya Ya Skrip tidak akan menimpa item yang ada pada server target. Jika item di server target sudah ada dengan nama yang sama, Anda akan melihat pesan kesalahan yang mirip dengan yang berikut ini:

Migrating DataSource: /Data Sources/Aworks2012_oltp ... FAILURE:The item '/Data Sources/Aworks2012_oltp' already exists. ---> Microsoft.ReportingServices.Diagnostics.Utilities.ItemAlreadyExistsException: The item '/Data Source s/Aworks2012_oltp' already exists.

Kredensial TIDAK disalin sebagai bagian dari sumber data. Setelah item konten dimigrasikan, perbarui informasi kredensial di server tujuan.
Himpunan data bersama Ya Ya
Folder Ya Ya Skrip tidak akan menimpa item yang ada pada server target. Jika item di server target sudah ada dengan nama yang sama, Anda akan melihat pesan kesalahan yang mirip dengan yang berikut ini:

Migrating Folder: /Reports ... FAILURE: The item '/Reports' already exists. ---> Microsoft.ReportingServices.Diagnostics.Utilities.ItemAlreadyExistsException: The item '/Reports' already exists.
Laporan Ya Ya Skrip tidak akan menimpa item yang ada pada server target. Jika item di server target sudah ada dengan nama yang sama, Anda akan melihat pesan kesalahan yang mirip dengan yang berikut ini:

Migrating Report: /Reports/testThe item '/Reports/test' already exists. ---> Microsoft.ReportingServices.Diagnostics.Utilities.ItemAlreadyExistsException: The item '/Reports/test' already exists.
Parameter Ya Ya
Langganan Ya Ya
Pengaturan Riwayat Ya Ya Pengaturan riwayat dimigrasikan namun detail riwayat TIDAK dimigrasikan.
opsi pemrosesan Ya Ya
opsi refresh cache Ya Ya Pengaturan dependen dimigrasikan sebagai bagian dari item katalog. Berikut ini adalah sampel dari skrip saat memigrasikan laporan (.rdl) dan pengaturan terkait seperti opsi refresh cache:

Migrasi parameter untuk laporan item TitleOnly.rdl 0 ditemukan.

Memigrasikan langganan untuk laporan TitleOnly.rdl: 1 item ditemukan.

Memigrasikan langganan Simpan di \\server\public\savedreports sebagai TitleOnly ... SUKSES

Migrasi pengaturan riwayat untuk laporan TitleOnly.rdl ... SUKSES

Opsi pemrosesan migrasi untuk laporan TitleOnly.rdl ... 0 item ditemukan.

Memigrasikan opsi refresh cache untuk laporan TitleOnly.rdl ... SUKSES

Memigrasikan paket refresh cache untuk laporan TitleOnly.rdl: 1 item ditemukan.

Memigrasikan rencana refresh cache titleonly_refresh735amM2F ... SUKSES
Rencana refresh cache Ya Ya
Gambar Ya Ya
Bagian laporan Ya Ya

Izin yang Diperlukan

Izin yang diperlukan untuk membaca atau menulis item dan sumber daya tidak sama untuk semua metode yang digunakan dalam skrip. Tabel berikut ini meringkas metode yang digunakan untuk setiap item atau sumber daya dan tautan ke konten terkait. Navigasi ke topik individual untuk melihat izin yang diperlukan. Misalnya topik metode ListChildren mencatat izin yang diperlukan dari:

  • Izin Yang Diperlukan Mode Asli: ReadProperties pada Item

  • Izin yang Diperlukan Mode SharePoint: ViewListItems

Item atau Sumber Daya Sumber Target
Item katalog ListChildren

GetProperties

GetItemDataSources

GetItemReferences

GetDataSourceContents

GetItemLink		 CreateCatalogItem

SetItemDataSources

GetItemReferences

CreateDataSource

CreateLinkedItem

CreateFolder
Peran ListRoles

GetRoleProperties		 CreateRole
Kebijakan Sistem GetSystemPolicies SetSystemPolicies
Jadwal ListSchedules CreateSchedule
Langganan ListSubscriptions

GetSubscriptionProperties

GetDataDrivenSubscriptionProperties		 CreateSubscription

CreateDataDrivenSubscription
Rencana refresh cache ListCacheRefreshPlans

GetCacheRefreshPlanProperties		 CreateCacheRefreshPlan
Parameter GetItemParameters SetItemParameters
Opsi eksekusi GetExecutionOptions SetExecutionOptions
Opsi cache GetCacheOptions SetCacheOptions
Pengaturan riwayat GetItemHistoryOptions SetItemHistoryOptions
Kebijakan Item GetPolicies SetPolicies

Untuk informasi selengkapnya, lihat Membandingkan Peran dan Tugas di Reporting Services dengan Grup dan Izin SharePoint.

Cara menggunakan skrip

  1. Unduh file skrip ke folder lokal, misalnya c:\rss\ssrs_migration.rss.

  2. Buka prompt perintah dengan hak istimewa admin.

  3. Navigasi ke folder yang berisi file ssrs_migration.rss.

  4. Jalankan perintah dengan parameter yang sesuai untuk skenario Anda.

Contoh Dasar, server laporan mode asli ke server laporan mode asli:

Contoh berikut memigrasikan konten dari Sourceserver mode asli ke mode asli Targetserver.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://SourceServer/ReportServer -u Domain\User -p password -v ts="http://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password"

Catatan penggunaan:

  • Skrip berjalan dalam dua langkah.

    Langkah pertama adalah audit, untuk mengembalikan daftar item yang akan dimigrasikan dan langkah kedua adalah proses migrasi.

    Anda dapat membatalkan skrip setelah langkah pertama jika Anda hanya ingin melihat daftar migrasi yang mungkin atau Anda ingin mengubah parameter. Pengaturan dependen tidak tercantum di langkah pertama. Misalnya, opsi cache laporan tidak tercantum tetapi laporan itu sendiri.

    Tip

    Jika Anda hanya ingin mengaudit satu server, gunakan server yang sama untuk sumber dan tujuan dan batalkan setelah langkah 1

    Penggunaan yang baik dari informasi audit langkah 1 adalah meninjau peran yang ada di server mode Asli sumber dan target. Berikut ini adalah contoh langkah satu daftar audit. Perhatikan bahwa daftar menyertakan bagian "peran" karena switch-v security="True" digunakan:

    • Retrieve and report the list of items that will be migrated. You can cancel the script after step 1 if you do not want to start the actual migration.

      Retrieving roles:

      Role: Browser

      Role: Content Manager

      Role: Model Item Browser

      Retrieve and report the list of items that will be migrated. You can cancel the script after step 1 if you do not want to start the actual migration.

      Retrieving roles:

      Role: Browser

      Role: Content Manager

      Role: CustomRole

      Role: Model Item Browser

      Role: My Reports

      Role: Publisher

      Role: Report Builder

      Role: System Administrator

      Role: System User

      Retrieving system policies:

      Retrieving system policies:

      System policy: BUILTIN\Administrators

      System policy: domain\user1

      System policy: domain\ueser2

      Retrieving schedules:

      Schedule: theMondaySchedule

      Retrieving catalog items. This may take a while.

      Folder: /Data Sources

      DataSource: /Data Sources/Aworks2012_oltp

      Folder: /images

      Resource: /images/Boba Fett.png

      Resource: /images/R2-D2.png

      Folder: /Reports

      Report: /Reports/products

      Report: /Reports/test

      Report: /Reports/TitleOnly

  • SOURCE_URL dan TARGET_URL harus berupa URL server laporan yang valid yang menunjuk ke server laporan Reporting Services sumber dan target. Dalam mode asli, URL server laporan terlihat seperti berikut ini:

    • https://servername/reportserver

    Dalam mode SharePoint URL terlihat seperti berikut ini:

    • https://servername/_vti_bin/reportserver

  • Struktur folder virtual yang disajikan kepada pengguna di SharePoint mungkin berbeda dari yang mendasar. Buka https://servername/_vti_bin/reportserver atau https://servername/sites/site_name/_vti_bin/reportserver di browser untuk melihat struktur folder non-virtual. Ini berguna untuk mengatur folder sumber dan folder target ke sesuatu selain "/", untuk server dalam mode SharePoint.

  • Kata sandi tidak dimigrasikan, dan harus dimasukkan kembali, misalnya sumber data dengan kredensial yang disimpan.

Deskripsi Parameter

Parameter Deskripsi Diperlukan
-S Source_URL URL server laporan sumber Ya
-U Domain\password -p password Kredensial untuk server sumber. OPSIONAL, kredensial default digunakan jika hilang
-v st="SITE" OPSIONAL. Parameter ini hanya digunakan untuk server laporan mode SharePoint.
- v f="SOURCEFOLDER" Atur ke "/" untuk memigrasikan semuanya, atau ke sesuatu seperti "/folder/subfolder" untuk migrasi parsial. Semua yang ada di dalam folder ini akan disalin OPSIONAL, defaultnya adalah "/".
-v ts="TARGET_URL" 'URL server RS target"
-v tu="domain\username" -v tp="password" 'Kredensial untuk server target. OPSIONAL, kredensial default digunakan jika hilang. Catatan: pengguna akan terdaftar sebagai "pembuat" jadwal bersama dan akun "dimodifikasi oleh" untuk item laporan, di server target.
-v tst="SITE" OPSIONAL. Parameter ini hanya digunakan untuk server laporan mode SharePoint.
-v tf ="TARGETFOLDER" 'Atur ke "/" untuk migrasi ke tingkat akar. Atur ke "/folder/subfolder" untuk menyalin ke dalam yang sudah ada. Segala sesuatu dalam "SOURCEFOLDER" akan disalin ke dalam "TARGETFOLDER. OPSIONAL, defaultnya adalah "/".
-v security= "True/False" Jika diatur ke "False", item katalog tujuan akan mewarisi pengaturan keamanan sesuai dengan pengaturan sistem target. Ini adalah pengaturan yang direkomendasikan untuk migrasi antara berbagai jenis server laporan, misalnya mode asli ke mode SharePoint. Jika diatur ke "True", skrip mencoba untuk memigrasikan pengaturan keamanan. OPSIONAL, defaultnya adalah "False".

Contoh Lainnya

Server Laporan Mode Asli ke Server Laporan Mode Asli

Contoh berikut memigrasikan konten dari Sourceserver mode asli ke mode asli Targetserver.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://SourceServer/ReportServer -u Domain\User -p password -v ts="http://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password"

Contoh berikut menambahkan sakelar keamanan:

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://SourceServer/ReportServer -u Domain\User -p password -v ts="http://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password" -v security="True"

Mode Asli ke Mode SharePoint - situs akar

Contoh berikut memigrasikan konten dari SourceServer mode asli ke "situs akar" pada server mode SharePoint TargetServer. Folder "Laporan" dan "Sumber Data" di server mode asli sebagai dimigrasikan sebagai pustaka baru pada penyebaran SharePoint.

ssrs_rss_migrate_root_site ssrs_rss_migrate_root_site

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://SourceServer/ReportServer -u Domain\User -p Password -v ts="http://TargetServer/_vti_bin/ReportServer" -v tu="Domain\User" -v tp="Password"

Mode asli ke Mode SharePoint -'bi' kumpulan situs

Contoh berikut memigrasikan konten dari server mode asli ke server SharePoint yang berisi kumpulan situs "sites/bi" dan pustaka dokumen bersama. Skrip membuat folder dalam dokumen pustaka tujuan. Misalnya, skrip akan membuat folder "Laporan" dan "Sumber Data" di pustaka dokumen target.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://SourceServer/ReportServer -u Domain\User -p Password -v ts="http://TargetServer/sites/bi/_vti_bin/reportserver" -v tst="sites/bi" -v tf="Shared Documents" -v tu="Domain\User" -v tp="Password"

Mode SharePoint ke Mode SharePoint -'bi' kumpulan situs

Contoh berikut memigrasikan konten:

  • Dari Server Server SharePointServer yang berisi kumpulan situs "situs/bi" dan pustaka dokumen bersama.

  • Ke server TargetServer SharePoint yang berisi kumpulan situs "situs/bi" dan pustaka dokumen bersama.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://SourceServer/_vti_bin/reportserver -v st="sites/bi" -v f="Shared Documents" -u Domain\User1 -p Password -v ts="http://TargetServer/sites/bi/_vti_bin/reportserver" -v tst="sites/bi" -v tf="Shared Documents" -v tu="Domain\User" -v tp="Password"

Mode Asli ke Mode Asli - Azure Virtual Machine

Contoh berikut memigrasikan konten:

  • Dari server laporan mode Asli SourceServer.

  • Ke server laporan mode Asli TargetServer yang berjalan di komputer virtual Azure. TargetServer tidak bergabung ke domain SourceServer dan User2 adalah administrator di Komputer virtual Azure TargetServer.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://SourceServer/ReportServer -u Domain\user1 -p Password -v ts="http://ssrsnativeazure.cloudapp.net/ReportServer" -v tu="user2" -v tp="Password2"

Tip

Untuk informasi tentang cara menggunakan Windows PowerShell untuk membuat server laporan Reporting Services di komputer virtual Azure, lihat Menggunakan PowerShell untuk Membuat Azure VM Dengan Server Laporan Mode Asli.

Mode SharePoint -'bi' kumpulan situs ke Server Mode Asli di Azure Virtual Machine

Contoh berikut memigrasikan konten:

  • Dari server laporan mode SharePoint SourceServer yang berisi kumpulan situs "situs/bi" dan pustaka dokumen bersama.

  • Ke server laporan mode Asli TargetServer yang berjalan di komputer virtual Azure. TargetServer tidak bergabung ke domain SourceServer dan User2 adalah administrator di Komputer virtual Azure TargetServer.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://uetesta02/_vti_bin/reportserver -u user1 -p Password -v ts="http://ssrsnativeazure.cloudapp.net/ReportServer" -v tu="user2" -v tp="Passowrd2"

Verifikasi

Bagian ini merangkum beberapa langkah yang harus dilakukan di server tujuan untuk memverifikasi konten dan kebijakan berhasil dimigrasikan.

Jadwal

Untuk memverifikasi jadwal pada server target:

Mode Asli

  1. Telusuri ke Manajer Laporan di server tujuan.

  2. Klik Pengaturan Situs di menu atas.

  3. Klik Jadwal di panel kiri.

Mode SharePoint:

  1. Telusuri pengaturan Situs.

  2. Di grup Reporting Services , klik Kelola Jadwal Bersama.

Peran dan Grup

Mode Asli

  1. Buka SQL Server Management Studio dan sambungkan ke server laporan mode asli Anda.

  2. Di Object Explorer klik Keamanan.

  3. Klik Peran.

Pemecahan Masalah

Gunakan bendera pelacakan -t untuk menerima informasi lebih lanjut. Misalnya, jika Anda menjalankan skrip dan melihat pesan yang mirip dengan yang berikut ini

  • Tidak dapat tersambung ke server: http://< servername>/ReportServer/ReportService2010.asmx

Jalankan skrip lagi dengan bendera -t , untuk melihat pesan yang mirip dengan yang berikut ini:

  • System.Exception: Tidak dapat tersambung ke server: http:// servername>/ReportServer/ReportService2010.asmx ---> System.Net.WebException: Permintaan gagal dengan status HTTP 401: Tidak sah.< di System.Web.Services.Protocols.SoapHttpClientProtocol.ReadResponse(Pesan SoapClientMessage, respons WebResponse, Stream responseStream, Boolean asyncCall) di System.Web.Services.Protocols.SoapHttpClientProtocol.Invoke(String methodName, Parameter Object[] di Microsoft.SqlServer.ReportingServices2010.ReportingService2010.IsSSLRequired() di Microsoft.ReportingServices.ScriptHost.Management2010Endpoint.PingService(String url, String userName, String password, Domain string, batas waktu Int32) di Microsoft.ReportingServices.ScriptHost.ScriptHost.DetermineServerUrlSecurity() --- Akhir dari jejak tumpukan pengecualian dalam ---

Lihat juga

Utilitas RS.exe (SSRS)
Membandingkan Peran dan Tugas di SQL Server Reporting Services dengan Grup dan Izin SharePoint