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 memberikan 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
  • {i>Host<i} tempat Anda menginstal dan menjalankan SSRS. Host ini dapat berupa VM Compute Engine atau host yang tidak menggunakan Compute Engine. Untuk petunjuk penginstalan, lihat Menginstal Layanan Pelaporan SQL Server.

  • 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 Anda sendiri, buat data A yang memetakan nama host pilihan Anda ke alamat IP instance Anda.
    • Pemetaan nama host lokal: Ubah file hosts sistem Anda guna membuat alias kustom untuk instance Anda.

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

    Jika ingin menggunakan autentikasi Windows, Anda harus menggunakan Managed Active Directory untuk bergabung dengan instance SQL Server dan host yang menjalankan SSRS. Untuk informasi selengkapnya, lihat Menggunakan Microsoft AD Terkelola dengan Cloud SQL.

Prosedur

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

  1. Memperoleh lease SSRS.
  2. Menyiapkan SSRS.
  3. Melepaskan lease SSRS.

Mendapatkan sewa SSRS

SSRS memerlukan izin yang lebih tinggi selama penyiapan. Guna memperoleh lease SSRS untuk instance Anda, gunakan perintah berikut:

gcloud

Gunakan perintah berikut untuk mendapatkan lease:

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 dalam Report Server Configuration Manager saat menyiapkan database server laporan. Ini harus berupa 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 dalam Report Server Configuration Manager saat menyiapkan database server laporan. Ini harus berupa login SQL Server yang sudah ada dan harus berbeda dari login penyiapan. Tidak ada.
--report-database Wajib. Nama database laporan yang sudah ada atau yang baru pada 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 selama Anda dapat 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 memperoleh sewa SSRS, tentukan hal berikut:
  • Dua login SQL Server yang berbeda, yaitu login penyiapan dan login layanan
  • Nama database laporan
  • Durasi lease 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 dalam 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 dalam Report Server Configuration Manager saat menyetel Database Server Laporan.
  • REPORT_DATABASE: nama database laporan yang sudah ada atau baru pada instance. Microsoft tidak mengizinkan karakter khusus tertentu dalam nama database laporan, seperti spasi, tanda kurung, karakter non-bahasa Inggris.
  • DURATION: Opsional. Jumlah jam sewa SSRS aktif selama Anda dapat 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 memperoleh sewa SSRS, tentukan hal berikut:
  • Dua login SQL Server yang berbeda, yaitu login penyiapan dan login layanan
  • Nama database laporan
  • Durasi lease 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 dalam 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 dalam Report Server Configuration Manager saat menyetel Database Server Laporan.
  • REPORT_DATABASE: nama database laporan yang sudah ada atau baru pada instance. Microsoft tidak mengizinkan karakter khusus tertentu dalam nama database laporan, seperti spasi, tanda kurung, karakter non-bahasa Inggris.
  • DURATION: Opsional. Jumlah jam sewa SSRS aktif selama Anda dapat 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 sewa 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 langkah terakhir.
  4. Jika belum disetel, konfigurasikan URL Layanan Web dan URL Portal Web. Portal Web akan berhasil dimuat dalam beberapa detik.

Melepaskan lease SSRS

Anda dapat melepas lease secara manual, atau menunggu hingga periode sewa berakhir secara otomatis. Melepaskan lease diperlukan untuk mengembalikan izin yang lebih tinggi yang diperlukan untuk penyiapan dan untuk memungkinkan login layanan terhubung ke database laporan. Login layanan tidak dapat mengakses database laporan hingga lease berakhir masa berlakunya atau dirilis secara manual. Perintah berikut melepaskan lease SSRS.

gcloud

Gunakan perintah berikut untuk merilis lease:

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

REST v1

Dengan menggunakan REST API, Anda dapat merilis lease SSRS untuk sebuah 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 lease SSRS untuk sebuah 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

  • 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 info login yang digunakan untuk terhubung ke database laporan melalui Pengelola Konfigurasi Server Laporan.
  • Untuk database yang diproses dengan login layanan, mengimpor file sql dan menghapus operasi database yang direplikasi dapat mengalami kegagalan antara penyelesaian penyiapan SSRS dan rilis lease.
  • Anda harus menghapus dan membuat ulang pengguna database untuk login layanan di database laporan yang diimpor. Hal ini disebabkan pengguna yang ada dalam database yang diimpor bukan milik instance baru.
  • Saat menambahkan server laporan baru untuk deployment penyebaran skala di SSRS, Anda harus mendapatkan dan melepaskan lease 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 lease baru setiap kali ingin mengubah kredensial login untuk database server laporan di Pengelola Konfigurasi Server Laporan.