Servicios de informes de SQL Server (SSRS)

Cloud SQL es compatible con SQL Server Reporting Services (SSRS) , que le ayuda a crear, implementar y administrar informes paginados.

Esta página proporciona los requisitos previos, el procedimiento de configuración y las limitaciones para usar SSRS en Cloud SQL.

Antes de empezar

Antes de usar SSRS en Cloud SQL, debe tener lo siguiente:

  • Una instancia de Cloud SQL para alojar la base de datos del servidor de informes
  • Un host donde se instala y ejecuta SSRS. Puede ser una máquina virtual de Compute Engine o un host que no lo use. Para obtener instrucciones de instalación, consulte Instalar SQL Server Reporting Services .
  • Un registro DNS de Cloud para asignar un nombre de host a tu instancia de Cloud SQL. Puedes crear un nombre de host con una de las siguientes opciones:

    • DNS en la nube: utilice DNS en la nube para crear un nombre de host que apunte a su instancia.
    • Zona DNS personalizada: si administra su propia zona DNS, cree un registro A que asigne su nombre de host preferido a la dirección IP de su instancia.
    • Asignación de nombre de host local: modifique el archivo hosts de su sistema para crear un alias personalizado para su instancia.
  • Dos inicios de sesión de Cloud SQL: uno de configuración y otro de servicio. Para crear un inicio de sesión, consulte gcloud sql users create .

    Si desea usar la autenticación de Windows, debe usar Active Directory administrado para conectar la instancia de SQL Server y el host que ejecuta SSRS. Para obtener más información, consulte Usar Microsoft AD administrado con Cloud SQL .

Procedimiento

Para configurar SSRS en Cloud SQL, realice los siguientes pasos:

  1. Adquirir un contrato de arrendamiento SSRS .
  2. Configurar SSRS .
  3. Liberar un contrato de arrendamiento de SSRS .

Adquirir un contrato de arrendamiento SSRS

SSRS requiere permisos elevados durante la configuración. Para obtener una concesión de SSRS para su instancia, utilice el siguiente comando:

nube g

Utilice el siguiente comando para adquirir un contrato de arrendamiento:

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 siguiente tabla describe los parámetros gcloud de esta operación:

Parámetro Descripción Valores permitidos Valor predeterminado
--setup-login Obligatorio. El nombre de usuario utilizado para conectarse a la instancia durante la configuración de SSRS. Este es el primer nombre de usuario que se solicita en el Administrador de configuración del servidor de informes al configurar una base de datos del servidor de informes. Debe ser un inicio de sesión de SQL Server existente, como sqlserver Ninguno
--service-login Obligatorio. El inicio de sesión de SQL Server que utiliza el servidor de informes para conectarse a la base de datos del servidor de informes durante la configuración de SSRS. Este es el segundo inicio de sesión que se solicita en el Administrador de configuración del servidor de informes al configurar una base de datos del servidor de informes. Este debe ser un inicio de sesión de SQL Server existente y debe ser diferente del inicio de sesión configurado. Ninguno.
--report-database Obligatorio. Nombre de la base de datos de informes existente o nueva en la instancia. No se permiten ciertos caracteres especiales en el nombre de la base de datos del informe, como espacios, corchetes y caracteres no ingleses. Ninguno
--duration Opcional. El número de horas que la concesión de SSRS está activa durante las cuales puede realizar la configuración de SSRS. Entre 1 y 12 horas. Por ejemplo, 4h 5 horas

REST versión 1

Con la API REST, puede adquirir una concesión SSRS en una instancia. Para ello, especifique lo siguiente:
  • Dos inicios de sesión diferentes de SQL Server: el inicio de sesión de configuración y el inicio de sesión de servicio
  • El nombre de la base de datos del informe
  • La duración durante la cual el contrato de arrendamiento está activo

Solo el campo DURATION es opcional. Para más información, consulte AcquireSsrsLeaseContext :

  • PROJECT_ID : el ID del proyecto.
  • INSTANCE_NAME : el nombre de la instancia.
  • SETUP_LOGIN : el inicio de sesión de SQL Server que se utiliza para conectarse a la instancia de SQL Server durante la configuración de SSRS. Este es el primer inicio de sesión que se solicita en el Administrador de configuración del servidor de informes al configurar una base de datos del servidor de informes.
  • SERVICE_LOGIN : el inicio de sesión de SQL Server que utiliza el servidor de informes para conectarse a su base de datos durante la configuración de SSRS. Este es el segundo inicio de sesión que se solicita en el Administrador de configuración del servidor de informes al configurar una base de datos.
  • REPORT_DATABASE : nombre de una base de datos de informes existente o nueva en la instancia. Microsoft no permite ciertos caracteres especiales en el nombre de la base de datos de informes, como espacios, corchetes y caracteres no ingleses.
  • DURATION : Opcional. El número de horas que la concesión de SSRS está activa durante las cuales se puede realizar la configuración de SSRS. Entre 1 y 12 horas, por ejemplo, 4h .

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

REST v1beta4

Con la API REST, puede adquirir una concesión SSRS en una instancia. Para ello, especifique lo siguiente:
  • Dos inicios de sesión diferentes de SQL Server: el inicio de sesión de configuración y el inicio de sesión de servicio
  • El nombre de la base de datos del informe
  • La duración durante la cual el contrato de arrendamiento está activo

Solo el campo DURATION es opcional. Para más información, consulte AcquireSsrsLeaseContext :

  • PROJECT_ID : el ID del proyecto.
  • INSTANCE_NAME : el nombre de la instancia.
  • SETUP_LOGIN : el inicio de sesión de SQL Server que se utiliza para conectarse a la instancia de SQL Server durante la configuración de SSRS. Este es el primer inicio de sesión que se solicita en el Administrador de configuración del servidor de informes al configurar una base de datos del servidor de informes.
  • SERVICE_LOGIN : el inicio de sesión de SQL Server que utiliza el servidor de informes para conectarse a su base de datos durante la configuración de SSRS. Este es el segundo inicio de sesión que se solicita en el Administrador de configuración del servidor de informes al configurar una base de datos.
  • REPORT_DATABASE : nombre de una base de datos de informes existente o nueva en la instancia. Microsoft no permite ciertos caracteres especiales en el nombre de la base de datos de informes, como espacios, corchetes y caracteres no ingleses.
  • DURATION : Opcional. El número de horas que la concesión de SSRS está activa durante las cuales se puede realizar la configuración de SSRS. Entre 1 y 12 horas, por ejemplo, 4h .

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Configurar SSRS

Para realizar la configuración de SSRS, siga estos pasos:

  1. Abra el Administrador de configuración de Reporting Services en el host donde está instalado SSRS.
  2. Conéctese a su instancia de servidor de informes local.
  3. Haga clic en Cambiar base de datos .
    1. Ingrese el nombre de host de SQL Server creado en Cloud DNS y las credenciales de inicio de sesión de SQL Server para el inicio de sesión de configuración utilizado para la concesión de SSRS.
    2. Ingrese el nombre de una nueva base de datos de servidor de informes o una base de datos de informes existente utilizada para la concesión de SSRS.
    3. Ingrese las credenciales de inicio de sesión de SQL Server para el inicio de sesión del servicio utilizado para la concesión de SSRS.
    4. Haga clic en Siguiente y finalice el último paso.
  4. Si aún no está configurado, configure la URL del servicio web y la URL del portal web . El portal web debería cargarse correctamente en unos segundos.

Liberar un contrato de arrendamiento de SSRS

Puede liberar una concesión manualmente o esperar a que expire automáticamente. Liberar la concesión es necesario para revertir los permisos elevados necesarios para la configuración y para que el inicio de sesión del servicio se conecte a la base de datos de informes. El inicio de sesión del servicio no puede acceder a la base de datos de informes hasta que la concesión expire o se libere manualmente. El siguiente comando libera una concesión de SSRS.

nube g

Utilice el siguiente comando para liberar un contrato de arrendamiento:

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

REST versión 1

Con la API REST, puede liberar una concesión SSRS para una instancia. Como se muestra en el siguiente ejemplo de solicitud, solo necesita proporcionar el nombre de la instancia y el ID del proyecto.

  • PROJECT_ID : el ID del proyecto.
  • INSTANCE_NAME : el nombre de la instancia.

Método HTTP y URL:

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

REST v1beta4

Con la API REST, puede liberar una concesión SSRS para una instancia. Como se muestra en el siguiente ejemplo de solicitud, solo necesita proporcionar el nombre de la instancia y el ID del proyecto.

  • PROJECT_ID : el ID del proyecto.
  • INSTANCE_NAME : el nombre de la instancia.

Método HTTP y URL:

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

Limitaciones

  • Los inicios de sesión de Active Directory no son compatibles para configurar la base de datos de informes.
  • El nombre de la base de datos del informe solo puede contener caracteres alfanuméricos y guiones.
  • Debe adquirir un contrato de arrendamiento para cambiar el inicio de sesión utilizado para conectarse a la base de datos de informes a través del Administrador de configuración del servidor de informes.
  • En el caso de una base de datos procesada por un inicio de sesión de servicio, las operaciones de importación de archivos SQL y eliminación de bases de datos replicadas pueden fallar entre la finalización de la configuración de SSRS y la liberación de la concesión.
  • Debe eliminar y volver a crear el usuario de la base de datos para el inicio de sesión del servicio en una base de datos de informes importada. Esto se debe a que el usuario existente en la base de datos importada no pertenece a la nueva instancia.
  • Al agregar nuevos servidores de informes para una implementación escalable en SSRS, debe adquirir y liberar la concesión de SSRS para cada nueva máquina virtual Windows que aloje un servidor de informes. Cada instancia de Cloud SQL requiere que configure la nueva base de datos de informes utilizando la base de datos de informes existente.
  • Debe crear un nuevo contrato de arrendamiento cada vez que desee cambiar las credenciales de inicio de sesión para la base de datos del servidor de informes en el Administrador de configuración del servidor de informes.