Cloud SQL supporta SQL Server Reporting Services (SSRS), che consente di creare, eseguire il deployment e gestire i report impaginati.
Questa pagina fornisce i prerequisiti, la procedura di configurazione e le limitazioni per l'utilizzo di 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 installare ed eseguire 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 all'istanza Cloud SQL. Puoi creare un nome host utilizzando una delle seguenti opzioni:
- Cloud DNS: utilizza Cloud DNS per creare un nome host che rimandi alla tua istanza.
- Zona DNS personalizzata: se gestisci una zona DNS, crea un record A che mappa il tuo nome host preferito all'indirizzo IP dell'istanza.
- Mappatura del nome host locale: modifica il file
hosts
del sistema per creare un alias personalizzato per la tua istanza.
Due accessi Cloud SQL esistenti, un accesso di configurazione e un accesso al servizio. Per creare un accesso, consulta
gcloud sql users create
.Se vuoi utilizzare l'autenticazione Windows, devi utilizzare Managed Active Directory per unire l'istanza SQL Server e l'host che esegue SSRS. Per saperne di più, vedi Utilizzare Microsoft Active Directory gestito con Cloud SQL.
Procedura
Per configurare SSRS in Cloud SQL, segui questi passaggi:
Acquisisci un lease SSRS
SSRS richiede autorizzazioni elevate durante la configurazione. Per acquisire un lease SSRS per l'istanza, utilizza il comando seguente:
gcloud
Utilizza questo comando 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 tabella seguente descrive i parametri gcloud
di questa operazione:
Parametro | Description | Valori consentiti | Valore predefinito |
--setup-login |
obbligatorio. L'accesso utilizzato per la connessione all'istanza durante la configurazione di SSRS. Questo è il primo accesso richiesto in Gestione configurazione server di report durante l'impostazione del database di un server di report. | Deve essere un accesso a SQL Server esistente, ad esempio sqlserver |
Nessuna |
--service-login |
obbligatorio. L'accesso SQL Server utilizzato dal server di report per connettersi al database del server di report durante la configurazione di SSRS. Questo è il secondo accesso richiesto in Gestione configurazione server di report quando si imposta il database di un server di report. | Deve essere un accesso a SQL Server esistente e deve essere diverso dall'accesso di configurazione. | Nessuno. |
--report-database |
obbligatorio. Un nome di database di report esistente o nuovo nell'istanza. | Alcuni caratteri speciali non sono ammessi nel nome del database del report, come spazi, parentesi o caratteri non inglesi. | Nessuna |
--duration |
Facoltativo. Il numero di ore di attività del lease SSRS durante le quali puoi eseguire la configurazione SSRS. | Da 1 a 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 accessi a SQL Server, l'accesso di configurazione e l'accesso al servizio
- Il nome del database del report
- La durata del lease attivo
Solo il campo DURATION
è facoltativo. Per maggiori informazioni, consulta
AcquireSsrsLeaseContext:
- PROJECT_ID: l'ID del progetto.
- INSTANCE_NAME: il nome dell'istanza.
- SETUP_LOGIN: l'accesso a SQL Server utilizzato per la connessione all'istanza SQL Server durante la configurazione di SSRS. Si tratta del primo accesso richiesto in Gestione configurazione server di report durante l'impostazione del database di un server di report.
- SERVICE_LOGIN: l'accesso a SQL Server utilizzato dal server di report per connettersi al database del server di report durante la configurazione di SSRS. Questo è il secondo accesso richiesto in Gestione configurazione server di report quando si imposta un database del server di report.
- REPORT_DATABASE: un nome di database di report esistente o nuovo nell'istanza. Microsoft non consente determinati caratteri speciali nel nome del database dei report, come spazi, parentesi o caratteri non inglesi.
- DURATION: facoltativo. Il numero di ore di attività del lease SSRS durante le quali puoi eseguire la configurazione SSRS.
Tra 1 e 12 ore, ad esempio
4h
.
Metodo HTTP e URL:
POST http://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 lease SSRS su un'istanza. Per acquisire un lease SSRS, specifica quanto segue:- Due diversi accessi a SQL Server, l'accesso di configurazione e l'accesso al servizio
- Il nome del database del report
- La durata del lease attivo
Solo il campo DURATION
è facoltativo. Per maggiori informazioni, consulta
AcquireSsrsLeaseContext:
- PROJECT_ID: l'ID del progetto.
- INSTANCE_NAME: il nome dell'istanza.
- SETUP_LOGIN: l'accesso a SQL Server utilizzato per la connessione all'istanza SQL Server durante la configurazione di SSRS. Si tratta del primo accesso richiesto in Gestione configurazione server di report durante l'impostazione del database di un server di report.
- SERVICE_LOGIN: l'accesso a SQL Server utilizzato dal server di report per connettersi al database del server di report durante la configurazione di SSRS. Questo è il secondo accesso richiesto in Gestione configurazione server di report quando si imposta un database del server di report.
- REPORT_DATABASE: un nome di database di report esistente o nuovo nell'istanza. Microsoft non consente determinati caratteri speciali nel nome del database dei report, come spazi, parentesi o caratteri non inglesi.
- DURATION: facoltativo. Il numero di ore di attività del lease SSRS durante le quali puoi eseguire la configurazione SSRS.
Tra 1 e 12 ore, ad esempio
4h
.
Metodo HTTP e URL:
POST http://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, } }
Configura SSRS
Per eseguire la configurazione SSRS, segui questi passaggi:
- Apri Gestione configurazione di Reporting Services nell'host in cui è installato SSRS.
- Connettersi all'istanza del server di report locale.
- Fai clic su Modifica database.
- Inserisci il nome host di SQL Server creato in Cloud DNS e le credenziali di accesso a SQL Server per l'accesso di configurazione utilizzato per il lease SSRS.
- Inserisci il nome di un nuovo database del server di report o di un database di report esistente utilizzato per il lease SSRS.
- Inserisci le credenziali di accesso a SQL Server per l'accesso al servizio utilizzato per il lease SSRS.
- Fai clic su Avanti e concludi l'ultimo passaggio.
- Se non è già impostato, configura l'URL del servizio web e l'URL del portale web. Il portale web dovrebbe caricarsi correttamente in pochi secondi.
Rilascia un lease SSRS
Puoi rilasciare un lease manualmente o attendere la scadenza automatica del lease. È necessario rilasciare il lease per ripristinare eventuali autorizzazioni elevate necessarie per la configurazione e per consentire all'accesso al servizio di connettersi al database del report. L'accesso al servizio non può accedere al database dei report fino alla scadenza del lease o al rilascio manuale. Il comando seguente rilascia un lease SSRS.
gcloud
Utilizza questo comando 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 http://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 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 http://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 dei report.
- Il nome del database del report può contenere solo caratteri alfanumerici e trattini.
- È necessario acquisire un lease per la modifica dell'accesso utilizzato per la connessione al database del report tramite Gestione configurazione server di report.
- Per un database elaborato tramite l'accesso al servizio, le operazioni di importazione ed eliminazione dei file SQL possono non riuscire tra il completamento della configurazione 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 di 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 server di report in Gestione configurazione server di report.