SQL Server Reporting Services (SSRS)

Cloud SQL supporta SQL Server Reporting Services (SSRS), che ti consente di creare, implementare e gestire report paginati.

Questa pagina fornisce i prerequisiti, la procedura di configurazione e le limitazioni per l'utilizzo SSRS in Cloud SQL.

Prima di iniziare

Prima di utilizzare SSRS su Cloud SQL, devi disporre di quanto segue:

  • Un'istanza Cloud SQL per ospitare il database del server di report
  • Un host in cui installi ed esegui SSRS. Può essere una VM Compute Engine o un host che non utilizza Compute Engine. Per le istruzioni di installazione, consulta Installare SQL Server Reporting Services.

  • Un record Cloud DNS per assegnare un nome host per l'istanza Cloud SQL. Puoi creare un nome host utilizzando una delle seguenti opzioni:

    • Cloud DNS: utilizza Cloud DNS per creare un nome host che punti alla tua istanza.
    • Zona DNS personalizzata: se gestisci la tua zona DNS, crea un record A che mappa il tuo nome host preferito all'indirizzo IP della tua istanza.
    • Mappatura dei nomi host locali: modifica il file hosts del sistema per creare un alias personalizzato per l'istanza.

  • Due accessi Cloud SQL esistenti, uno per la configurazione e uno per il servizio. Per creare un accesso, vedi gcloud sql users create.

    Se vuoi usare l'autenticazione Windows, devi usare Managed Active Directory per unire l'istanza SQL Server e l'host che esegue SSRS. Per ulteriori informazioni, consulta Utilizzare Microsoft Active Directory gestito con Cloud SQL.

Procedura

Per configurare SSRS in Cloud SQL, segui questi passaggi:

  1. Ottieni un leasing SSRS.
  2. Configura SSRS.
  3. Rilascia un contratto di locazione SSRS.

Acquisire un leasing SSRS

SSRS richiede autorizzazioni elevate durante la configurazione. Per acquisire un leasing SSRS per la tua istanza, utilizza il seguente comando:

gcloud

Usa il comando seguente per acquisire un 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 \

La seguente tabella descrive i parametri gcloud di questa operazione:

Parametro Descrizione Valori consentiti Valore predefinito
--setup-login Obbligatorio. L'accesso utilizzato per connettersi all'istanza durante la configurazione di SSRS. Si tratta del primo accesso richiesto in Report Server Configuration Manager quando viene impostato un database del report server. Deve essere un nome utente SQL Server esistente, ad esempio sqlserver Nessuno
--service-login Obbligatorio. L'account di accesso a SQL Server utilizzato dal report server per connettersi al database del report server durante la configurazione di SSRS. Questo è il secondo accesso richiesto in Gestore configurazione server di report durante l'impostazione di un database del server di report. Deve essere un nome utente SQL Server esistente e deve essere diverso da quello di accesso alla configurazione. Nessuno.
--report-database Obbligatorio. Un nome di database di report esistente o nuovo nell'istanza. Alcuni caratteri speciali non sono consentiti nel nome del database del report, ad esempio spazi, parentesi e caratteri non inglesi. Nessuno
--duration Facoltativo. Il numero di ore durante le quali il leasing SSRS è attivo e durante le quali puoi eseguire la configurazione di SSRS. Tra 1 e 12 ore. Ad esempio, 4h 5 ore

REST v1

Utilizzando l'API REST, puoi acquisire un lease SSRS su un'istanza. Per acquisire un lease SSRS, specifica quanto segue:
  • Due diversi login SQL Server, l'accesso per la configurazione e l'accesso al servizio
  • Il nome del database dei report
  • La durata per cui il contratto di locazione è attivo

Solo il campo DURATION è facoltativo. Per ulteriori informazioni, vedi AcquireSsrsLeaseContext:

  • PROJECT_ID: l'ID del progetto.
  • INSTANCE_NAME: il nome dell'istanza.
  • SETUP_LOGIN: l'account di accesso a SQL Server utilizzato per connettersi all'istanza SQL Server durante la configurazione di SSRS. Si tratta del primo accesso richiesto in Gestore configurazione server di report durante l'impostazione di un database del server di report.
  • SERVICE_LOGIN: l'account di accesso a SQL Server utilizzato dal report server per connettersi al database del report server durante la configurazione di SSRS. Si tratta del secondo accesso richiesto in Configuration Manager del report server quando viene impostato un database del report server.
  • REPORT_DATABASE: un nome del database di report esistente o nuovo nell'istanza. Microsoft non consente l'utilizzo di determinati caratteri speciali nel nome del database del report, ad esempio spazi, parentesi e caratteri non inglesi.
  • DURATION: facoltativo. Il numero di ore in cui il lease SSRS è attivo durante le quali puoi eseguire la configurazione SSRS. Tra 1 e 12 ore, ad esempio 4h.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

REST v1beta4

Utilizzando l'API REST, puoi acquisire un leasing SSRS per un'istanza. Per acquisire un lease SSRS, specifica quanto segue:
  • Due diversi login SQL Server, l'accesso per la configurazione e l'accesso al servizio
  • Il nome del database dei report
  • La durata per cui il contratto di locazione è attivo

Solo il campo DURATION è facoltativo. Per ulteriori informazioni, vedi AcquireSsrsLeaseContext:

  • PROJECT_ID: l'ID del progetto.
  • INSTANCE_NAME: il nome dell'istanza.
  • SETUP_LOGIN: l'account di accesso a SQL Server utilizzato per connettersi all'istanza SQL Server durante la configurazione di SSRS. Si tratta del primo accesso richiesto in Gestore configurazione server di report durante l'impostazione di un database del server di report.
  • SERVICE_LOGIN: l'account di accesso a SQL Server utilizzato dal report server per connettersi al database del report server durante la configurazione di SSRS. Si tratta del secondo accesso richiesto in Configuration Manager del report server quando viene impostato un database del report server.
  • REPORT_DATABASE: un nome del database di report esistente o nuovo nell'istanza. Microsoft non consente l'utilizzo di determinati caratteri speciali nel nome del database del report, ad esempio spazi, parentesi e caratteri non inglesi.
  • DURATION: facoltativo. Il numero di ore in cui il lease SSRS è attivo durante le quali puoi eseguire la configurazione SSRS. Tra 1 e 12 ore, ad esempio 4h.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Configurare SSRS

Per eseguire la configurazione di SSRS:

  1. Apri Gestore configurazione di Reporting Services nell'host in cui è installato SSRS.
  2. Connettiti all'istanza del server di report locale.
  3. Fai clic su Cambia database.
    1. Inserisci il nome host SQL Server creato in Cloud DNS e le credenziali di accesso a SQL Server per l'accesso di configurazione utilizzato per il lease SSRS.
    2. Inserisci il nome di un nuovo database del server di report o di un database di report esistente utilizzato per il lease SSRS.
    3. Inserisci le credenziali di accesso a SQL Server per l'accesso al servizio utilizzato per il lease di SSRS.
    4. Fai clic su Avanti e termina l'ultimo passaggio.
  4. Se non è già impostato, configura l'URL del servizio web e l'URL del portale web. Il portale web dovrebbe caricarsi entro pochi secondi.

Rilasciare un contratto di locazione SSRS

Puoi rilasciare un contratto di locazione manualmente o attendere che scada automaticamente. È necessario rilasciare il lease per ripristinare le autorizzazioni elevate necessarie per la configurazione e consentire all'accesso al servizio di connettersi al database dei report. L'accesso al servizio non può accedere al database dei report finché il lease non scade o non viene rilasciato manualmente. Il seguente comando rilascia un lease SSRS.

gcloud

Utilizza il comando seguente per rilasciare un lease:

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

REST v1

Utilizzando l'API REST, puoi rilasciare un lease SSRS per un'istanza. Come mostrato nell'esempio di richiesta seguente, devi solo fornire il nome dell'istanza e l'ID progetto.

  • PROJECT_ID: l'ID del progetto.
  • INSTANCE_NAME: il nome dell'istanza.

Metodo HTTP e URL: 

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

REST v1beta4

Utilizzando l'API REST, puoi rilasciare un lease SSRS per un'istanza. Come mostrato nell'esempio di richiesta che segue, devi fornire solo il nome dell'istanza e l'ID progetto.

  • PROJECT_ID: l'ID del progetto.
  • INSTANCE_NAME: il nome dell'istanza.

Metodo HTTP e URL: 

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

Limitazioni

  • Gli accessi ad Active Directory non sono supportati per la configurazione del database del report.
  • Il nome del database dei report può contenere solo caratteri alfanumerici e trattini.
  • Devi acquisire un lease per la modifica dell'accesso utilizzato per la connessione al database dei report tramite Gestore configurazione server di report.
  • Per un database elaborato da un accesso al servizio, le operazioni di importazione dei file SQL ed eliminazione dei database replicati possono non riuscire tra il completamento della configurazione di SSRS e il rilascio del lease.
  • Devi eliminare e ricreare l'utente del database per l'accesso al servizio in un database di report importato. Questo perché l'utente esistente nel database importato non appartiene alla nuova istanza.
  • Quando aggiungi nuovi server di report per un deployment con scale out in SSRS, devi acquisire e rilasciare il lease SSRS per ogni nuova VM Windows che ospita un server di report. Ogni istanza Cloud SQL richiede la configurazione del nuovo database dei report utilizzando il database dei report esistente.
  • Devi creare un nuovo lease ogni volta che vuoi modificare le credenziali di accesso per il database del report server in Report Server Configuration Manager.