Layanan Pelaporan Server SQL (SSRS)

Cloud SQL mendukung SQL Server Reporting Services (SSRS) yang membantu Anda membuat, men-deploy, dan mengelola laporan yang dipaginasi.

Halaman ini menyediakan prasyarat, prosedur penyiapan, dan batasan untuk menggunakan SSRS di Cloud SQL.

Sebelum memulai

Sebelum menggunakan SSRS di Cloud SQL, Anda harus memiliki hal berikut:

  • Instance Cloud SQL untuk menghosting database server laporan
  • Host tempat Anda menginstal dan menjalankan SSRS. Host ini dapat berupa VM Compute Engine atau host yang tidak menggunakan Compute Engine. Untuk mengetahui petunjuk penginstalan, lihat Menginstal SQL Server Reporting Services.

  • Data Cloud DNS untuk menetapkan nama host bagi instance Cloud SQL Anda. Anda dapat membuat nama host menggunakan salah satu opsi berikut:

    • Cloud DNS: Gunakan Cloud DNS untuk membuat nama host yang mengarah ke instance Anda.
    • Zona DNS kustom: Jika Anda mengelola zona DNS sendiri, buat data A yang memetakan nama host pilihan Anda ke alamat IP instance Anda.
    • Pemetaan nama host lokal: Ubah file hosts sistem Anda untuk membuat alias kustom untuk instance Anda.

  • Dua login Cloud SQL yang ada, yaitu login penyiapan dan login layanan. Untuk membuat login, lihat gcloud sql users create.

Prosedur

Untuk menyiapkan SSRS di Cloud SQL, lakukan langkah-langkah berikut:

  1. Mendapatkan sewa SSRS.
  2. Siapkan SSRS.
  3. Melepaskan sewa SSRS.

Mendapatkan sewa SSRS

SSRS memerlukan izin yang ditingkatkan selama penyiapan. Untuk mendapatkan sewa SSRS untuk instance Anda, gunakan perintah berikut:

gcloud

Gunakan perintah berikut untuk mendapatkan sewa:

gcloud sql instances acquire-ssrs-lease INSTANCE_NAME \
--project=PROJECT_NAME \
--setup-login=SETUP_LOGIN \
--service-login=SERVICE_LOGIN \
--report-database=REPORT_DATABASE \
--duration=DURATION \

Tabel berikut menjelaskan parameter gcloud operasi ini:

Parameter Deskripsi Nilai yang diizinkan Nilai default
--setup-login Wajib. Login yang digunakan untuk terhubung ke instance selama penyiapan SSRS. Ini adalah login pertama yang diminta di Report Server Configuration Manager saat menetapkan database server laporan. Login ini harus merupakan login SQL Server yang sudah ada, seperti sqlserver Tidak ada
--service-login Wajib. Login SQL Server yang digunakan oleh server laporan untuk terhubung ke database server laporan selama penyiapan SSRS. Ini adalah login kedua yang diminta di Report Server Configuration Manager saat menyiapkan database server laporan. Login ini harus merupakan login SQL Server yang sudah ada dan harus berbeda dengan login penyiapan. Tidak ada.
--report-database Wajib. Nama database laporan yang sudah ada atau baru di instance. Karakter khusus tertentu tidak diizinkan dalam nama database laporan, seperti spasi, tanda kurung, karakter non-bahasa Inggris. Tidak ada
--duration Opsional. Jumlah jam sewa SSRS aktif, yang dapat Anda gunakan untuk melakukan penyiapan SSRS. Antara 1 dan 12 jam. Contoh, 4h 5 jam

REST v1

Dengan menggunakan REST API, Anda dapat memperoleh sewa SSRS pada instance. Untuk mendapatkan sewa SSRS, tentukan hal berikut:
  • Dua login SQL Server yang berbeda, login penyiapan dan login layanan
  • Nama database laporan
  • Durasi sewa aktif

Hanya kolom DURATION yang bersifat opsional. Untuk informasi selengkapnya, lihat AcquireSsrsLeaseContext:

  • PROJECT_ID: ID project.
  • INSTANCE_NAME: nama instance.
  • SETUP_LOGIN: login SQL Server yang digunakan untuk terhubung ke instance SQL Server selama penyiapan SSRS. Ini adalah login pertama yang diminta di Report Server Configuration Manager saat menetapkan database server laporan.
  • SERVICE_LOGIN: login SQL Server yang digunakan oleh server laporan untuk terhubung ke database server laporan selama penyiapan SSRS. Ini adalah login kedua yang diminta di Report Server Configuration Manager saat menyiapkan Database Server Laporan.
  • REPORT_DATABASE: nama database laporan yang sudah ada atau baru di instance. Microsoft tidak mengizinkan karakter khusus tertentu dalam nama database laporan, seperti spasi, tanda kurung, karakter non-Inggris.
  • DURATION: Opsional. Jumlah jam sewa SSRS aktif, yang dapat Anda gunakan untuk melakukan penyiapan SSRS. Antara 1 dan 12 jam, misalnya, 4h.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/acquireSsrsLease

Meminta isi JSON: 

{
  "acquireSsrsLeaseContext": {
    "setupLogin": SETUP_LOGIN,
    "serviceLogin": SERVICE_LOGIN,
    "reportDatabase": REPORT_DATABASE,
    "duration": DURATION,
  }
}

REST v1beta4

Dengan menggunakan REST API, Anda dapat memperoleh sewa SSRS pada instance. Untuk mendapatkan sewa SSRS, tentukan hal berikut:
  • Dua login SQL Server yang berbeda, login penyiapan dan login layanan
  • Nama database laporan
  • Durasi sewa aktif

Hanya kolom DURATION yang bersifat opsional. Untuk informasi selengkapnya, lihat AcquireSsrsLeaseContext:

  • PROJECT_ID: ID project.
  • INSTANCE_NAME: nama instance.
  • SETUP_LOGIN: login SQL Server yang digunakan untuk terhubung ke instance SQL Server selama penyiapan SSRS. Ini adalah login pertama yang diminta di Report Server Configuration Manager saat menetapkan database server laporan.
  • SERVICE_LOGIN: login SQL Server yang digunakan oleh server laporan untuk terhubung ke database server laporan selama penyiapan SSRS. Ini adalah login kedua yang diminta di Report Server Configuration Manager saat menyiapkan Database Server Laporan.
  • REPORT_DATABASE: nama database laporan yang sudah ada atau baru di instance. Microsoft tidak mengizinkan karakter khusus tertentu dalam nama database laporan, seperti spasi, tanda kurung, karakter non-Inggris.
  • DURATION: Opsional. Jumlah jam sewa SSRS aktif, yang dapat Anda gunakan untuk melakukan penyiapan SSRS. Antara 1 dan 12 jam, misalnya, 4h.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/acquireSsrsLease

Meminta isi JSON: 

{
  "acquireSsrsLeaseContext": {
    "setupLogin": SETUP_LOGIN,
    "serviceLogin": SERVICE_LOGIN,
    "reportDatabase": REPORT_DATABASE,
    "duration": DURATION,
  }
}

Menyiapkan SSRS

Untuk melakukan penyiapan SSRS, ikuti langkah-langkah berikut:

  1. Buka Reporting Services Configuration Manager di host tempat SSRS diinstal.
  2. Hubungkan ke instance server laporan lokal Anda.
  3. Klik Change Database.
    1. Masukkan nama host SQL Server yang dibuat di Cloud DNS dan kredensial login SQL Server untuk login penyiapan yang digunakan untuk penyewaan SSRS.
    2. Masukkan nama database server laporan baru atau database laporan yang ada yang digunakan untuk sewa SSRS.
    3. Masukkan kredensial login SQL Server untuk login layanan yang digunakan untuk sewa SSRS.
    4. Klik Berikutnya dan selesaikan hingga langkah terakhir.
  4. Jika belum ditetapkan, konfigurasikan Web Service URL dan Web Portal URL. Portal Web akan berhasil dimuat dalam beberapa detik.

Merilis sewa SSRS

Anda dapat merilis sewa secara manual, atau menunggu hingga sewa berakhir secara otomatis. Pelepasan sewa diperlukan untuk mengembalikan izin yang ditingkatkan yang diperlukan untuk penyiapan dan untuk mengizinkan login layanan terhubung ke database laporan. Login layanan tidak dapat mengakses database laporan hingga sewa berakhir atau dirilis secara manual. Perintah berikut akan merilis sewa SSRS.

gcloud

Gunakan perintah berikut untuk merilis sewa:

gcloud sql instances release-ssrs-lease INSTANCE_NAME \
--project=PROJECT_NAME

REST v1

Dengan menggunakan REST API, Anda dapat merilis sewa SSRS untuk instance. Seperti yang ditunjukkan dalam contoh permintaan berikut, Anda hanya perlu memberikan nama instance dan project ID.

  • PROJECT_ID: ID project.
  • INSTANCE_NAME: nama instance.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/releaseSsrsLease

REST v1beta4

Dengan menggunakan REST API, Anda dapat merilis sewa SSRS untuk instance. Seperti yang ditunjukkan dalam contoh permintaan berikut, Anda hanya perlu memberikan nama instance dan project ID.

  • PROJECT_ID: ID project.
  • INSTANCE_NAME: nama instance.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/releaseSsrsLease

Batasan

  • Anda tidak dapat menghosting laporan SSRS atau menjalankannya dari Cloud SQL.
  • Login Active Directory tidak didukung untuk menyiapkan database laporan.
  • Nama database laporan hanya boleh berisi karakter alfanumerik dan tanda hubung.
  • Anda harus mendapatkan sewa untuk mengubah login yang digunakan untuk terhubung ke database laporan melalui Report Server Configuration Manager.
  • Untuk database yang diproses oleh login layanan, operasi impor file sql dan penghapusan database yang direplikasi dapat gagal antara penyelesaian penyiapan SSRS dan rilis sewa.
  • Anda harus menghapus dan membuat ulang pengguna database untuk login layanan di database laporan yang diimpor. Hal ini karena pengguna yang ada di database yang diimpor bukan milik instance baru.
  • Saat menambahkan server laporan baru untuk deployment penyebaran skala di SSRS, Anda harus memperoleh dan merilis sewa SSRS untuk setiap VM Windows baru yang menghosting server laporan. Setiap instance Cloud SQL mengharuskan Anda mengonfigurasi database laporan baru menggunakan database laporan yang ada.
  • Anda harus membuat sewa baru setiap kali ingin mengubah kredensial login untuk database server laporan di Report Server Configuration Manager.

Pertanyaan umum (FAQ)

Bagian berikut membantu menjawab pertanyaan umum (FAQ) terkait SSRS.

Mekanisme penyiapan dan penyewaan

Bagian berikut membantu menjawab pertanyaan terkait penyiapan dan penyewaan SSRS.

Bagaimana cara menyiapkan SSRS dengan Cloud SQL?

Anda perlu menginstal SSRS di host Windows terpisah, seperti VM Compute Engine. Kemudian, konfigurasikan SSRS agar menggunakan instance Cloud SQL Anda untuk database ReportServer dan ReportServerTempDB. "Penyewaan SSRS" adalah bagian penting dari proses ini jika Anda mengelola penyiapan menggunakan Cloud SQL.

Apa yang dimaksud dengan sewa SSRS dan mengapa diperlukan?

Penyiapan SSRS biasanya memerlukan izin sysadmin, yang tidak diberikan kepada pengguna di Cloud SQL. Mekanisme sewa memberikan izin yang ditingkatkan yang diperlukan untuk sementara ke login SQL Server yang ditentukan, misalnya, --setup-login, untuk menyelesaikan penyiapan database.

Anda mendapatkan sewa menggunakan gcloud sql instances acquire-ssrs-lease sebelum konfigurasi dan merilisnya setelahnya dengan gcloud sql instances release-ssrs-lease. Penyewaan memiliki durasi yang dapat dikonfigurasi.

Autentikasi

Bagian berikut membantu menjawab pertanyaan terkait autentikasi.

Tidak, Anda harus menggunakan login SQL Server untuk parameter --setup-login dan --service-login saat memperoleh sewa dan mengonfigurasi database server laporan. Login Windows tidak didukung untuk proses penyiapan awal ini.

Meskipun penyiapan memerlukan login SQL, Anda berpotensi menggunakan Autentikasi Windows untuk mengakses laporan jika instance Cloud SQL dan host SSRS sama-sama bergabung ke salah satu jenis domain berikut:

Pembatasan

Bagian berikut membantu menjawab pertanyaan terkait pembatasan atau batasan.

Apa saja batasan penggunaan SSRS dengan Cloud SQL?

  • Tidak ada login Microsoft Active Directory untuk fase penyiapan database.
  • Nama database laporan hanya boleh berisi karakter alfanumerik dan tanda hubung.
  • Anda harus mendapatkan sewa baru jika ingin mengubah kredensial akun layanan nanti.
  • Deployment penyebaran skala memerlukan proses sewa untuk setiap host SSRS baru.
  • Mengimpor database server laporan yang ada memerlukan langkah-langkah manual untuk memetakan ulang pengguna login layanan.

Pertimbangan harga

Bagian berikut membantu membahas pertimbangan harga.

Berapa biaya yang terkait dengan pemberian lisensi?

  • Lisensi SQL Server diperlukan untuk instance Cloud SQL Anda.

  • Karena SSRS menjalankan mesin Windows terpisah, pastikan OS Windows dan komponen SQL Server apa pun di mesin tersebut memiliki lisensi yang sesuai. Menurut kebijakan Microsoft, menjalankan SSRS di server terpisah mungkin memerlukan lisensi SQL Server tambahan. Sebagai opsi, Cloud SQL menawarkan image SQL Server bawaan.

    Untuk mengetahui informasi selengkapnya, lihat SQL Server di Google Cloud.

Otomatisasi

Bagian berikut membantu menjawab pertanyaan terkait otomatisasi.

Dapatkah Anda mengotomatiskan proses penginstalan dan konfigurasi host SSRS?

Anda dapat menjalankan operasi untuk memperoleh dan merilis sewa SSRS dalam Cloud SQL menggunakan gcloud CLI atau REST API.

Penginstalan dan konfigurasi SSRS dalam lingkungan Windows itu sendiri biasanya melibatkan langkah-langkah manual melalui antarmuka Reporting Services Configuration Manager, sehingga otomatisasi menyeluruh yang lengkap menjadi lebih sulit.

Untuk mengetahui informasi selengkapnya, lihat Menginstal dan mengonfigurasi SSRS.

Pemeliharaan

Bagian berikut membantu menjawab pertanyaan terkait pemeliharaan.

Apa saja potensi aktivitas pengelolaan dan pemeliharaan yang terkait dengan penggunaan SSRS?

Sebelum memulai, pertimbangkan overhead pengelolaan berkelanjutan yang terkait dengan server SSRS terpisah. Anda bertanggung jawab untuk mengelola, menerapkan patch, dan mengamankan VM Windows yang menjalankan layanan SSRS. Cloud SQL hanya mengelola instance database.