Menerapkan solusi model menggunakan Panduan Penerapan

Artikel
05/08/2023

Berlaku untuk: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Wizard Penyebaran SQL Server Analysis Services menggunakan file output JSON yang dihasilkan dari proyek SQL Server Analysis Services sebagai file input. File input ini mudah dimodifikasi untuk menyesuaikan penyebaran proyek SQL Server Analysis Services. Skrip penyebaran yang dihasilkan kemudian dapat segera dijalankan atau disimpan untuk penyebaran nanti.

Deployment Wizard/Utility diinstal dengan SQL Server Management Studio (SSMS). Pastikan Anda menggunakan versi terbaru. Jika berjalan dari prompt perintah, secara default, versi terbaru wizard penyebaran diinstal ke C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

Anda dapat menyebarkan dengan menggunakan wizard seperti yang dijelaskan di sini. Anda juga dapat mengotomatiskan penyebaran atau menggunakan kemampuan Sinkronisasi. Jika database yang disebarkan besar, pertimbangkan untuk menggunakan partisi pada sistem target. Anda dapat mengotomatiskan pembuatan dan populasi partisi dengan menggunakan Model Objek Tabular (TOM), Tabular Model Scriting Language (TMSL), dan Analysis Management Objects (AMO).

Penting

Baik file output maupun skrip penyebaran tidak akan berisi id pengguna atau kata sandi jika ini ditentukan dalam string koneksi untuk sumber data atau untuk tujuan peniruan. Karena ini diperlukan untuk tujuan pemrosesan dalam skenario ini, Anda akan menambahkan informasi ini secara manual. Jika penyebaran tidak akan menyertakan pemrosesan, Anda dapat menambahkan koneksi ini dan informasi peniruan sesuai kebutuhan setelah penyebaran. Jika penyebaran akan menyertakan pemrosesan, Anda dapat menambahkan informasi ini dalam wizard atau dalam skrip penyebaran setelah disimpan.

Jalankan Panduan Penyebaran

Panduan Penyebaran dapat dijalankan dengan cara berikut:

Secara interaktif - Saat dijalankan secara interaktif, Deployment Wizard menghasilkan skrip penyebaran berdasarkan file input, seperti yang dimodifikasi secara interaktif oleh input pengguna. Wizard menerapkan modifikasi pengguna hanya untuk skrip penyebaran. Panduan tidak mengubah file input.
Dari prompt perintah - Saat dijalankan pada prompt perintah, Wizard Penyebaran menghasilkan skrip penyebaran berdasarkan sakelar yang Anda gunakan untuk menjalankan wizard. Wizard mungkin salah satu hal berikut: meminta Anda untuk memasukkan pengguna dan memodifikasi file input berdasarkan input tersebut; jalankan penyebaran senyap tanpa pengawas menggunakan file input apa adanya; atau buat skrip penyebaran yang dapat Anda gunakan nanti.

Jalankan secara interaktif

Saat dijalankan secara interaktif, Deployment Wizard membaca nilai dari file input dan menyajikan informasi ini kepada Anda. Anda dapat mengubah nilai input ini-seperti tujuan penyebaran, pengaturan konfigurasi, opsi penyebaran, dan kata sandi string koneksi-atau membiarkannya apa adanya. Jika Anda mengubah nilai input apa pun, wizard menggunakan perubahan ini saat membuat skrip penyebaran. Namun, wizard tidak membuat perubahan apa pun pada nilai dalam file input.

Catatan

Jika Anda ingin Wizard Penyebaran mengubah nilai input, jalankan wizard di prompt perintah dan atur wizard untuk dijalankan dalam mode file jawaban.

Setelah Anda meninjau nilai input dan membuat perubahan yang diinginkan, wizard menghasilkan skrip penyebaran. Anda dapat segera menjalankan skrip penyebaran ini di server tujuan atau menyimpan skrip untuk digunakan nanti.

Untuk menjalankan Wizard Penyebaran Analysis Services secara interaktif

Klik Mulai, lalu ketik Wizard Penyebaran Analysis Services.

-atau-
Di folder Proyek proyek SQL Server Analysis Services, klik <dua kali file nama> proyek.asdatabase.

Catatan

Jika Anda tidak dapat menemukan file .asdatabase, coba gunakan Cari dan tentukan *.asdatabase. Atau, Anda mungkin perlu membangun proyek di SSDT.

Jalankan pada prompt perintah

Wizard Penyebaran juga dapat dijalankan pada prompt perintah. Saat menjalankan di prompt perintah, Anda menyediakan jalur lengkap ke file .asdatabase dan menjalankan wizard dalam salah satu mode berikut:

Mode file jawaban
Dalam mode file jawaban, wizard memungkinkan Anda memodifikasi file input yang awalnya dihasilkan secara interaktif saat proyek SQL Server Analysis Services dibangun di SQL Server Data Tools. Wizard menyimpan file input yang dimodifikasi ini sebelum membuat skrip penyebaran. File input yang dimodifikasi menjadi titik awal baru saat berikutnya wizard dijalankan.

Untuk menjalankan wizard dalam mode file jawaban, gunakan tombol /a .

Mode senyap
Dalam mode senyap, wizard menjalankan penyebaran senyap tanpa pengawas berdasarkan informasi yang ada dalam file input.

Untuk menjalankan wizard dalam mode senyap, gunakan sakelar /s . Saat Anda menjalankan wizard dalam mode senyap, pesan adalah output ke konsol atau ke file log jika disediakan.

Mode output
Dalam mode output, wizard menghasilkan skrip penyebaran untuk eksekusi nanti berdasarkan file input.

Untuk menjalankan wizard dalam mode output, gunakan sakelar /o dan berikan nama file output.

Untuk informasi selengkapnya tentang sakelar baris perintah ini, lihat Menyebarkan solusi model dengan Utilitas Penyebaran.

Untuk menjalankan Wizard Penyebaran Analysis Services pada prompt perintah

Jika diinstal dengan SSMS 18.x, buka prompt perintah dan navigasikan ke jalur default C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.
Ketik Microsoft.AnalysisServices.Deployment.exe diikuti oleh sakelar yang sesuai dengan mode tempat Anda ingin menjalankan wizard.

Memahami skrip penyebaran

Skrip penyebaran XMLA yang dihasilkan oleh Wizard Penyebaran terdiri dari dua bagian:

Bagian pertama dari skrip penyebaran berisi perintah yang diperlukan untuk membuat, mengubah, atau menghapus objek Microsoft SQL Server yang sesuai di database tujuan. Secara default, file input yang dihasilkan oleh proyek SQL Server Analysis Services didasarkan pada penyebaran bertambah bertahap. Akibatnya, skrip penyebaran XMLA hanya akan memengaruhi objek yang diubah atau dihapus.
Bagian kedua dari skrip penyebaran berisi perintah yang diperlukan untuk memproses hanya objek yang dibuat atau diubah pada server tujuan (opsi Default Proses) atau untuk sepenuhnya memproses database tujuan. Anda juga dapat memilih untuk memiliki skrip penyebaran yang tidak berisi perintah pemrosesan.

Seluruh skrip penyebaran dapat dijalankan dalam satu transaksi atau dalam beberapa transaksi. Jika skrip dijalankan dalam beberapa transaksi, bagian pertama dari skrip dijalankan sebagai satu transaksi, dan setiap objek diproses dalam transaksinya sendiri.

Penting

Wizard Penyebaran SQL Server Analysis Services hanya menyebarkan objek ke dalam satu database SQL Server Analysis Services. Ini tidak menyebarkan objek atau data tingkat server apa pun.

File skrip penyebaran - Input digunakan untuk membuat skrip penyebaran

Saat Anda membuat proyek, SQL Server Data Tools menghasilkan file untuk proyek. SQL Server Data Tools kemudian menempatkan file-file ini di folder Output proyek. Secara default output dimasukkan ke dalam folder \Bin. Tabel berikut ini mencantumkan file XML yang SQL Server Data Tools buat:

File	Deskripsi
<nama> proyek. asdatabase	File XMLA untuk proyek model Tabular Multidimensi atau 1100/1103, atau file JSON untuk proyek model Tabular 1200 dan yang lebih tinggi. Berisi definisi deklaratif untuk semua objek SQL Server Analysis Services dalam proyek.
<nama> proyek. deploymenttargets	Berisi nama instans dan database SQL Server Analysis Services tempat objek SQL Server Analysis Services akan dibuat.
<nama> proyek. configsettings	Berisi pengaturan khusus lingkungan, seperti informasi koneksi sumber data dan lokasi penyimpanan objek. Pengaturan dalam file ini mengambil alih pengaturan dalam < file nama> proyek.asdatabase.
<nama> proyek. deploymentoptions	Berisi opsi penyebaran, seperti apakah penyebaran bersifat transaksi dan apakah objek yang disebarkan harus diproses setelah penyebaran.

SQL Server Data Tools tidak pernah menyimpan kata sandi dalam file proyek.

Memodifikasi file input

Memodifikasi nilai dalam file input, atau nilai yang diambil dari file input, memungkinkan untuk mengubah tujuan penyebaran, pengaturan konfigurasi, dan opsi penyebaran tanpa mengedit seluruh < file nama> proyek.asdatabase (atau seluruh file skrip jika Anda membuat skrip dari database SQL Server Analysis Services yang ada). Mampu memodifikasi file individual memungkinkan Anda dengan mudah membuat skrip penyebaran yang berbeda untuk tujuan yang berbeda.

File skrip penyebaran - Menentukan target penginstalan

Wizard Penyebaran membaca informasi target penginstalan dari < file project name.deploymenttargets>. SQL Server Data Tools membuat file ini saat Anda membangun proyek. SQL Server Data Tools menggunakan database dan server yang ditentukan pada halaman Penyebaran dari <kotak dialog Nama>proyekHalaman Properti untuk membuat < file nama> proyek.targets.

Memodifikasi target penginstalan

Dalam beberapa situasi, Anda mungkin perlu menyebarkan proyek ke database atau instans yang berbeda dari yang ditentukan di halaman Penyebaran . Misalnya, Anda mungkin ingin menyebarkan proyek ke server untuk pengujian sebelum penyebaran, lalu menyebarkannya ke server produksi setelah pengujian selesai. Anda mungkin juga ingin menyebarkan proyek yang telah selesai dan diuji ke beberapa server produksi dalam kluster Penyeimbangan Beban Jaringan, atau ke server penahapan dan server produksi.

Untuk menyebarkan proyek ke database atau instans yang berbeda, ubah target penginstalan dalam file input dengan menggunakan salah satu metode yang dijelaskan dalam prosedur berikut:

Untuk mengubah target penginstalan setelah file input dibuat

Jalankan Wizard Penyebaran SQL Server Analysis Services secara interaktif. Pada halaman Target Penginstalan, tentukan tujuan baru untuk instans dan database SQL Server Analysis Services.

-atau-
Jalankan Wizard Penyebaran SQL Server Analysis Services pada prompt perintah dan atur wizard untuk dijalankan dalam mode file jawaban.

-atau-
< Ubah file name.deploymenttargets >proyek dengan menggunakan editor teks apa pun.

File skrip penyebaran - Opsi partisi dan penyebaran peran

Wizard Penyebaran membaca opsi partisi dan penyebaran peran dari < file nama> proyek.deploymentoptions. SQL Server Data Tools membuat file ini saat Anda membangun proyek. SQL Server Data Tools kemudian menggunakan opsi partisi dan penyebaran peran proyek saat ini ketika < file nama> proyek.deploymentoptions dibuat.

Meninjau opsi partisi dan penyebaran peran

Opsi penyebaran dalam < file name.deploymentoptions >proyek meliputi yang berikut ini:

Opsi penyebaran partisi
File < name.deploymentoptions >proyek menentukan apakah partisi yang ada dalam database tujuan dipertahankan atau ditimpa (default). Jika partisi yang ada dipertahankan, hanya partisi baru yang akan disebarkan, dan partisi dan desain agregasi pada semua grup ukuran yang ada dibiarkan tidak berubah.

Jika grup pengukuran tempat partisi ada dihapus, partisi akan dihapus secara otomatis.

Opsi penyebaran peran
File < name.deploymentoptions >proyek menentukan salah satu opsi penyebaran peran berikut:

Peran dan anggota peran yang ada dalam database tujuan dipertahankan, dan hanya peran dan anggota peran baru yang disebarkan.
Semua peran dan anggota yang ada dalam database tujuan digantikan oleh peran dan anggota yang disebarkan.
Peran dan anggota peran yang ada dalam database tujuan dipertahankan, dan tidak ada peran baru yang disebarkan.

Ketika peran dan anggota yang ada dipertahankan, izin yang terkait dengan peran tersebut diatur ulang ke tidak ada. Izin keamanan dimuat oleh objek yang diamankan, bukan oleh peran keamanan yang terkait dengannya. Untuk informasi selengkapnya tentang cara bekerja dengan perilaku ini dengan menggunakan Wizard Penyebaran Analysis Service, lihat 'Pertahankan Peran dan Anggota' di Pangkalan Pengetahuan Microsoft.

Memodifikasi opsi partisi dan penyebaran peran

Anda mungkin harus menyebarkan proyek menggunakan partisi dan opsi peran yang berbeda dari yang disimpan dalam < file nama> proyek.deploymentoptions. Misalnya, Anda mungkin ingin mempertahankan partisi, peran, dan anggota peran yang ada, alih-alih mengganti semua partisi, peran, dan anggota yang ada seperti yang ditunjukkan dalam < file nama> proyek.deploymentoptions.

Untuk mengubah penyebaran partisi dan peran dalam proyek, Anda tidak dapat mengubah pengaturan partisi dan peran dalam proyek karena <kotak dialog Nama>proyekHalaman Properti di SQL Server Data Tools tidak menampilkan opsi ini. Jika Anda ingin mengubah opsi penyebaran untuk peran dan partisi, Anda harus mengubah informasi ini dalam file name.deploymentoptions >proyek itu < sendiri. Prosedur berikut menjelaskan cara mengubah opsi partisi dan penyebaran peran dalam < file nama> proyek.deploymentoptions.

Untuk mengubah penyebaran partisi atau peran setelah file input dibuat

Jalankan Wizard Penyebaran secara interaktif, dan pada halaman Opsi Partisi dan Penyebaran Peran , tentukan opsi penyebaran baru untuk partisi dan peran.

-atau-
Jalankan Wizard Penyebaran pada perintah, dan atur wizard untuk dijalankan dalam mode file jawaban.

-atau-
< Buka name.deploymentoptions >proyek di editor teks apa pun dan ubah opsi secara manual. Opsi untuk PartitionDeployment adalah DeployPartitions, RetainPartitions. Opsi untuk RoleDeployment adalah DeployRolesAndMembers, DeployRolesRetainMembers, RetainRoles.

File skrip penyebaran - Pengaturan konfigurasi penyebaran solusi

Wizard Penyebaran membaca opsi partisi dan penyebaran peran yang Anda gunakan dalam skrip penyebaran dari < file nama> proyek.configsettings. Untuk proyek multidansa, SQL Server Data Tools membuat file ini saat Anda membangun proyek. Untuk proyek tabular, tergantung pada versinya, mungkin perlu menjalankan Wizard Penyebaran dalam mode Jawaban untuk menghasilkan file .configsettings. SQL Server Data Tools menggunakan pengaturan konfigurasi proyek saat ini untuk membuat < file name.configsettings >proyek.

Meninjau pengaturan konfigurasi

Berikut ini adalah pengaturan konfigurasi yang disimpan dalam < file nama> proyek.configsettings:

String Koneksi Sumber Data - Ini adalah string koneksi untuk setiap sumber data berdasarkan nilai yang ditentukan dalam proyek. Id pengguna dan kata sandi selalu dihapus dari string koneksi sebelum sisa string disimpan dalam file ini. Namun, jika Wizard Penyebaran menyebarkan langsung ke instans Analysis Services, Anda dapat menambahkan id pengguna dan informasi kata sandi yang sesuai dalam wizard untuk mengaktifkan pemrosesan database penyebaran yang berhasil. Informasi koneksi ini tidak akan disimpan dalam skrip penyebaran itu sendiri jika disimpan oleh Panduan Penyebaran.
Akun Peniruan - Pengaturan ini menentukan nama pengguna yang SQL Server Analysis Services gunakan untuk menjalankan pernyataan di setiap sumber data. Jika tidak ada akun peniruan yang ditentukan, SQL Server Analysis Services menggunakan akun masuknya untuk menjalankan pernyataan. Jika akun masuk diberikan izin langsung di sumber data, semua administrator database di semua database dalam instans SQL Server Analysis Services memiliki akses ke sumber data melalui akun masuk. Jika akun pengguna dan kata sandi ditentukan, informasi ini selalu dihapus sebelum informasi peniruan disimpan dalam file ini. Namun, jika Wizard Penyebaran menyebarkan langsung ke instans Analysis Services, Anda dapat menambahkan id pengguna dan informasi kata sandi yang sesuai dalam wizard untuk mengaktifkan pemrosesan database penyebaran yang berhasil. Informasi peniruan ini tidak akan disimpan dalam skrip penyebaran itu sendiri jika disimpan oleh Wizard Penyebaran.

Catatan

Untuk model tabular pada tingkat kompatibilitas 1400 dan lebih tinggi dengan koneksi sumber data penyedia terstruktur, saat memilih Pertahankan pengaturan konfigurasi untuk objek yang ada di halaman Tentukan Properti Konfigurasi wizard, nama pengguna dan kata sandi yang disimpan pada database model tabular server target tidak dipertahankan. Administrator harus mengatur nama pengguna dan kata sandi secara manual dengan menggunakan SSMS setelah penyebaran selesai.
File Log Kesalahan Kunci - Pengaturan ini menentukan nama file dan jalur file log kesalahan kunci untuk setiap kubus, grup pengukuran, partisi, dan dimensi dalam database.
Lokasi Penyimpanan - Pengaturan ini menentukan lokasi penyimpanan untuk setiap kubus, grup pengukuran, dan partisi dalam database. Jika tidak ada nilai yang disediakan untuk objek, Panduan Penyebaran menggunakan lokasi default untuk objek tersebut. Misalnya, partisi menggunakan lokasi untuk grup pengukuran, grup pengukuran menggunakan lokasi untuk kubus, dan kubus menggunakan lokasi default untuk objek pada instans server. Lokasi penyimpanan dapat berupa jalur lokal atau Universal Naming Convention (UNC).
Server Laporan - Pengaturan ini menentukan server laporan dan lokasi folder untuk setiap tindakan laporan yang ditentukan di setiap kubus dalam database.

Mengubah pengaturan konfigurasi

Dalam beberapa kasus, Anda mungkin perlu menyebarkan proyek menggunakan pengaturan konfigurasi yang berbeda dari yang disimpan dalam < file nama> proyek.configsettings. Misalnya, Anda mungkin ingin mengubah string koneksi ke satu atau beberapa sumber data, atau menentukan lokasi penyimpanan untuk partisi atau grup pengukuran tertentu.

Untuk mengubah penyebaran partisi dan peran dalam proyek, Anda harus mengubah informasi ini dalam < file name.configsettings >proyek, seperti yang dijelaskan dalam prosedur di bawah ini. Anda tidak dapat mengubah pengaturan partisi dan peran dalam proyek karena <kotak dialog Nama>proyekHalaman Properti di SQL Server Data Tools tidak menampilkan opsi ini.

Catatan

Pengaturan konfigurasi dapat berlaku untuk semua objek atau hanya untuk objek yang baru dibuat. Terapkan pengaturan konfigurasi ke objek yang baru dibuat hanya saat Anda menyebarkan objek tambahan ke database SQL Server Analysis Services yang disebarkan sebelumnya dan tidak ingin menimpa objek yang ada. Untuk menentukan apakah pengaturan konfigurasi berlaku untuk semua objek atau hanya untuk yang baru dibuat, atur opsi ini dalam < file nama> proyek.deploymentoptions.

Untuk mengubah pengaturan konfigurasi setelah file input dibuat

Jalankan Wizard Penyebaran secara interaktif, dan pada halaman Pengaturan Konfigurasi , tentukan pengaturan konfigurasi untuk objek yang sedang disebarkan.

-atau-
Jalankan Wizard Penyebaran pada perintah dan atur wizard untuk dijalankan dalam mode file jawaban.

-atau-
< Ubah file name.configsettings >proyek dengan menggunakan editor teks apa pun.

File skrip penyebaran - Opsi pemrosesan

Panduan Penyebaran membaca opsi pemrosesan dari < file nama> proyek.deploymentoptions. SQL Server Data Tools membuat file ini saat Anda membangun proyek. SQL Server Data Tools menggunakan opsi pemrosesan yang ditentukan pada halaman <Penyebaran dari kotak dialog Halaman Properti nama>proyek untuk membuat < file nama> proyek.deploymentoptions.

Meninjau opsi pemrosesan

Pengaturan konfigurasi yang < disimpan dalam file nama> proyek.deploymentoptions adalah:

Metode Pemrosesan - Pengaturan ini mengontrol apakah objek yang disebarkan diproses setelah penyebaran dan jenis pemrosesan yang akan dilakukan. Ada tiga opsi pemrosesan:
- Pemrosesan default (default) mendeteksi status proses objek database, dan melakukan pemrosesan yang diperlukan untuk mengirimkan objek yang tidak diproses atau diproses sebagian ke status yang sepenuhnya diproses.
- Pemrosesan penuh memproses objek dan semua objek yang dikandungnya. Ketika Proses Penuh dijalankan terhadap objek yang telah diproses, Analysis Services menghilangkan semua data dalam objek, lalu memproses objek.
- Tidak ada berarti tidak ada pemrosesan yang dilakukan.
Opsi tabel tulis balik - Jika tulis balik diaktifkan dalam proyek, pengaturan ini menentukan bagaimana penulisan balik ditangani. Ada tiga opsi tabel tulis balik:
- Secara default, jika ada tabel tulis balik, tabel tersebut akan digunakan. Jika tabel tulis balik tidak ada, tabel tulis balik baru akan dibuat.
- Jika tabel tulis balik sudah ada, penyebaran gagal. Jika tabel tulis balik tidak ada, tabel tulis balik baru akan dibuat.
- Terlepas dari apakah tabel tulis balik sudah ada, tabel tulis balik baru akan dibuat. Dalam hal ini, Wizard Penyebaran akan menghapus tabel yang ada dan menggantinya dengan tabel tulis balik baru.
Penyebaran transaksional - Pengaturan ini mengontrol apakah penyebaran perubahan metadata dan perintah proses terjadi dalam satu transaksi atau dalam transaksi terpisah.
- Jika opsi ini True (default), SQL Server Analysis Services menyebarkan semua perubahan metadata dan semua perintah proses dalam satu transaksi.
- Jika opsi ini False, SQL Server Analysis Services menyebarkan perubahan metadata dalam satu transaksi, dan menyebarkan setiap perintah pemrosesan dalam transaksinya sendiri.

Memodifikasi opsi pemrosesan

Namun, Anda mungkin perlu menyebarkan proyek menggunakan opsi pemrosesan yang berbeda dari yang disimpan dalam < file name.deploymentoptions >proyek. Misalnya, Anda mungkin ingin semua objek diproses sepenuhnya, atau diproses menggunakan opsi pemrosesan default, atau tidak ada pemrosesan yang terjadi. Jika kubus atau dimensi diaktifkan untuk menulis, Anda dapat menentukan apakah tabel tulis balik baru atau yang sudah ada digunakan.

Untuk mengubah opsi pemrosesan yang digunakan selama penyebaran, Anda dapat mengedit dan membangun kembali proyek, atau mengubah opsi pemrosesan dalam file input dengan menggunakan salah satu metode seperti yang dijelaskan dalam prosedur berikut.

Untuk mengubah opsi pemrosesan setelah file input dibuat

Jalankan Wizard Penyebaran secara interaktif. Pada halaman Opsi Pemrosesan , tentukan opsi pemrosesan untuk proyek yang sedang disebarkan.

-atau-
Jalankan Wizard Penyebaran pada perintah dan atur wizard untuk dijalankan dalam mode file jawaban.

-atau-
< Ubah file name.deploymentoptions >proyek dengan menggunakan editor teks apa pun.

Lihat juga

Menyebarkan solusi model dengan menggunakan XMLA
Menyebarkan solusi model dengan Utilitas Penyebaran

Bagikan melalui