Implementación de soluciones de modelo mediante el Asistente para la implementación

  • Artículo
  • Tiempo de lectura: 19 minutos

Se aplica a: SQL Server Analysis Services Azure Analysis Services Power BI Premium

El Analysis Services implementación de aplicaciones usa archivos de salida JSON generados a partir de Analysis Services proyecto como archivos de entrada. Estos archivos de entrada se pueden modificar fácilmente para personalizar la implementación de un Analysis Services proyecto. El script de implementación generado puede ejecutarse inmediatamente o guardarse para su implementación posterior.

El Asistente para la implementación o utilidad se instala con SQL Server Management Studio (SSMS). Asegúrese de que usa la versión más reciente. Si se ejecuta desde el símbolo del sistema, de forma predeterminada, la versión más reciente del asistente para la implementación se instala en C:\Archivos de programa (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

Puede implementar mediante el asistente como se describe aquí. También puede automatizarla o utilizar la capacidad Sincronizar. Si la base de datos implementada es grande, considere la posibilidad de utilizar particiones en los sistemas de destino. Puede automatizar la creación y el poblamiento de particiones mediante tabular object model (TOM), tabular model Scriting Language (TMSL) y Objetos de administración de análisis (AMO).

Importante

Ni los archivos de salida ni el script de implementación contendrán el identificador de usuario o la contraseña si se especifican en la cadena de conexión para un origen de datos o para fines de suplantación. Puesto que en este escenario se requieren para el procesamiento, deberá agregar manualmente esta información. Si la implementación no incluye el procesamiento, puede agregar esta información de conexión y suplantación cuando lo desee después de la implementación. Si la implementación incluye el procesamiento, puede agregar esta información en el asistente o en el script de implementación una vez guardado.

Ejecutar el Asistente para implementación

El Asistente para implementación se puede ejecutar de las maneras siguientes:

  • Interactivamente : cuando se ejecuta de forma interactiva, el Asistente para implementación genera un script de implementación basado en los archivos de entrada, modificado interactivamente por la entrada del usuario. El asistente solo aplica las modificaciones del usuario al script de implementación. El asistente no modifica los archivos de entrada.

  • Desde el símbolo del sistema : cuando se ejecuta en el símbolo del sistema, el Asistente para implementación genera un script de implementación basado en los modificadores que se usan para ejecutar el asistente. El asistente puede realizar cualquier de las siguientes tareas: solicitar la entrada de usuario y, en función de esa entrada, modificar los archivos de entrada, ejecutar una implementación desatendida en modo silencioso utilizando los archivos de entrada sin cambios o crear un script de implementación para utilizarlo posteriormente.

Ejecución interactiva

Cuando se ejecuta de forma interactiva, el Asistente para implementación lee los valores de los archivos de entrada y le presenta esta información. Puede modificar estos valores de entrada (como el destino de implementación, los valores de configuración, las opciones de implementación y las contraseñas de cadena de conexión) o dejarlos tal y como están. Si cambia algún valor de entrada, el asistente usa estos cambios al generar el script de implementación. Sin embargo, el asistente no realiza ningún cambio en los valores del archivo de entrada.

Nota

Si desea que el Asistente para la implementación modifique los valores de entrada, ejecute el asistente en el símbolo del sistema y establezca el asistente para que se ejecute en modo de archivo de respuesta.

Después de revisar los valores de entrada y realizar los cambios deseados, el asistente genera el script de implementación. Este script de implementación puede ejecutarse de inmediato en el servidor de destino o guardarse para utilizarlo en otra ocasión.

Para ejecutar interactivamente el Asistente para la implementación de Analysis Services

  • Haga clic en Inicio y, a continuación, escriba Analysis Services Asistente para implementación.

    O bien

  • En la carpeta Proyectos del Analysis Services proyecto, haga doble clic en el archivo <nombre> del proyecto.asdatabase.

    Nota

    Si no consigue encontrar el archivo.asdatabase, pruebe a utilizar Buscar especificando *.asdatabase. O bien, es posible que tenga que compilar el proyecto en SSDT.

Ejecución en el símbolo del sistema

El Asistente para implementación también se puede ejecutar en el símbolo del sistema. Cuando se ejecuta en el símbolo del sistema, se proporciona la ruta de acceso completa al archivo .asdatabase y se ejecuta el asistente en uno de los modos siguientes:

Modo de archivo de respuesta
En el modo de archivo de respuesta, el asistente permite modificar interactivamente los archivos de entrada que se generaron originalmente cuando el proyecto de Analysis Services se creó SQL Server Data Tools. El asistente guarda estos archivos de entrada modificados antes de generar el script de implementación. Los archivos de entrada modificados se convierten en el nuevo punto de partida la próxima vez que se ejecuta el asistente.

Para ejecutar el asistente en modo de archivo de respuesta, use el modificador /a .

Modo silencioso
En este modo, el asistente ejecuta una implementación silenciosa desatendida basada en la información que reside en los archivos de entrada.

Para ejecutar el asistente en modo silencioso, use el modificador /s . Al ejecutar el asistente en modo silencioso, los mensajes se muestran en la consola o en un archivo de registro si se proporciona uno.

Modo de salida
En el modo de salida, el asistente genera un script de implementación para su posterior ejecución en función de los archivos de entrada.

Para ejecutar el asistente en modo de salida, use el modificador /o y proporcione un nombre de archivo de salida.

Para obtener más información sobre estos modificadores de línea de comandos, vea Implementar soluciones de modelo con la utilidad de implementación.

Para ejecutar el Asistente para la implementación de Analysis Services desde el símbolo del sistema

  1. Si se instala con SSMS 18.x, abra un símbolo del sistema y vaya a la ruta de acceso predeterminada C:\Archivos de programa (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

  2. Escriba Microsoft.AnalysisServices.Deployment.exe seguido de los modificadores correspondientes al modo en que desee ejecutar el asistente.

Descripción del script de implementación

El script de implementación XMLA generado por el Asistente para implementación consta de dos secciones:

  • La primera parte del script de implementación contiene los comandos necesarios para crear, modificar o eliminar los objetos Microsoft SQL Server adecuados en la base de datos de destino. De forma predeterminada, los archivos de entrada generados por Analysis Services proyecto se basan en una implementación incremental. En consecuencia, el script de implementación XMLA solamente afectará a los objetos que se cambiaron o se eliminaron.

  • La segunda parte del script de implementación contiene los comandos necesarios para procesar únicamente los objetos creados o modificados en el servidor de destino (opción Procesar predeterminado) o para procesar completamente la base de datos de destino. Además, puede elegir que el script de implementación no contenga comandos de procesamiento.

El script de implementación completa se puede ejecutar en una única transacción o en varias transacciones. Si el script se ejecuta en varias transacciones, la primera parte del mismo se ejecuta en una única transacción y cada objeto se procesa en su propia transacción.

Importante

El Analysis Services implementación de archivos solo implementa objetos en una base de datos Analysis Services única. No implementa ningún objeto o datos en el nivel de servidor.

Archivos de script de implementación: entrada utilizada para crear el script de implementación

Al compilar un proyecto, SQL Server Data Tools genera archivos para el proyecto. SQL Server Data Tools a continuación, coloca estos archivos en la carpeta Salida del proyecto. De forma predeterminada, la salida se coloca en la carpeta \Bin. En la tabla siguiente se enumeran los archivos XML SQL Server Data Tools crea:

Archivo Descripción
<nombre del proyecto>. asdatabase Un archivo XMLA para proyectos de modelos tabulares multidimensionales o 1100/1103, o un archivo JSON para proyectos de modelos tabulares 1200 y posteriores. Contiene las definiciones declarativas de todos los objetos Analysis Services en el proyecto.
<nombre del proyecto>. deploymenttargets Contiene el nombre de la instancia Analysis Services y la base de datos en la que se Analysis Services objetos.
<nombre del proyecto>. configsettings Contiene configuración específica del entorno, como información sobre la conexión del origen de datos y ubicaciones de almacenamiento de objetos. Configuración en este archivo invalidan la configuración del archivo <name.asdatabase> del proyecto.
<nombre del proyecto>. deploymentoptions Contiene opciones de implementación como, por ejemplo, si la implementación es transaccional y si los objetos implementados deben procesarse después de la implementación.

SQL Server Data Tools nunca almacena contraseñas en los archivos del proyecto.

Modificación de archivos de entrada

La modificación de los valores de los archivos de entrada o los valores recuperados de los archivos de entrada permite cambiar el destino de la implementación, < las opciones de configuración y las opciones de implementación sin editar todo el archivo name.asdatabase> del proyecto (o un archivo de script completo si genera un script a partir de una base de datos Analysis Services existente). La posibilidad de modificar archivos individuales le permite crear fácilmente diferentes scripts de implementación para distintos fines.

Archivos de script de implementación: especificación del destino de instalación

El Asistente para la implementación lee la información de destino de instalación del archivo <nombre> del proyecto.deploymenttargets. SQL Server Data Tools crea este archivo al compilar el proyecto. SQL Server Data Tools la base <> de datos y el servidor especificados en la página Implementación del cuadro de diálogo Nombre del proyectoPropiedades Pages< para crear el archivo name.targets> del proyecto.

Modificación del destino de instalación

En algunas situaciones, es posible que tenga que implementar un proyecto en una base de datos o instancia diferente de la especificada en la página Implementación . Por ejemplo, puede que desee implementar el proyecto en un servidor para realizar pruebas antes de la implementación y, a continuación, implementarlo en un servidor de producción. Puede que también desee implementar un proyecto finalizado y probado en varios servidores de producción de un clúster de equilibrio de carga de red (NLB), o en un servidor de ensayo y un servidor de producción.

Para implementar un proyecto en otra base de datos o instancia, cambie el destino de instalación en el archivo de entrada mediante uno de los métodos descritos en el procedimiento siguiente:

Para cambiar el destino de instalación después de haber generado los archivos de entrada

  • Ejecute el Asistente Analysis Services implementación de datos de forma interactiva. En la página Destino de instalación , especifique un nuevo destino para la Analysis Services y la base de datos.

    O bien

  • Ejecute el Asistente Analysis Services implementación en el símbolo del sistema y establezca el asistente para que se ejecute en modo de archivo de respuesta.

    O bien

  • Modifique el archivo < name.deploymenttargets> del proyecto mediante cualquier editor de texto.

Archivos de scripts de implementación: opciones de partición e implementación de roles

El Asistente para implementación lee las opciones de implementación de roles y particiones del archivo <nombre> del proyecto.deploymentoptions. SQL Server Data Tools crea este archivo al compilar el proyecto. SQL Server Data Tools a continuación, usa las opciones de implementación < de roles y particiones del proyecto actual cuando se crea el archivo name.deploymentoptions> del proyecto.

Revisión de las opciones de implementación de roles y particiones

Entre las opciones de implementación del archivo <nombre> del proyecto.deploymentoptions se incluyen las siguientes:

Opciones de implementación de particiones
El <archivo name.deploymentoptions >del proyecto especifica si las particiones existentes en la base de datos de destino se conservan o sobrescriben (valor predeterminado). Si las particiones existentes se conservan, solo se implementarán nuevas particiones, y el diseño de las particiones y agregaciones de todos los grupos de medida existentes permanecerán inalterados.

Si se elimina el grupo de medida en el que existe la partición, la partición se elimina también automáticamente.

Opciones de implementación de roles
El <archivo nombre> del proyecto.deploymentoptions especifica una de las siguientes opciones de implementación de roles:

  • Los roles y miembros de roles existentes en la base de datos de destino se conservan, y solo se implementan los roles y miembros de roles nuevos.

  • Todos los miembros y roles existentes en la base de datos de destino se reemplazan por los roles y los miembros implementados.

  • Los roles y miembros de roles existentes en la base de datos de destino se conservan, y no se implementan los roles nuevos.

Cuando se conservan los roles y miembros existentes, los permisos asociados a esos roles se restablecen en ninguno. Los permisos de seguridad están incluidos en los objetos que protegen, no en los roles de seguridad a los que están asociados. Para obtener más información sobre cómo trabajar con este comportamiento mediante el Asistente para implementación de Analysis Service, vea "Conservar roles y miembros" en el Microsoft Knowledge Base.

Modificación de las opciones de implementación de roles y particiones

Es posible que tenga que implementar el proyecto con diferentes opciones de partición y rol que < las almacenadas en el archivo nombre> del proyecto.deploymentoptions. Por ejemplo, puede conservar las particiones, los roles y los miembros de rol existentes, en lugar de reemplazar todas las particiones, roles < y miembros existentes, tal como se indica en el archivo nombre> del proyecto.deploymentoptions.

Para modificar la implementación de particiones y roles en un proyecto, no puede cambiar la configuración de particiones y roles <> dentro del proyecto porque el cuadro de diálogo nombre del proyectoPropiedades Pages de SQL Server Data Tools no muestra estas opciones. Si desea cambiar las opciones de implementación de roles y particiones, < debe cambiar esta información en el propio archivo name.deploymentoptions> del proyecto. En el procedimiento siguiente se describe cómo cambiar las opciones de implementación de particiones y roles en el <archivo nombre> del proyecto.deploymentoptions.

Para cambiar la implementación de particiones o roles después de haber generado los archivos de entrada

  • Ejecute el Asistente para implementación de forma interactiva y, en la página Opciones de implementación de roles y particiones, especifique nuevas opciones de implementación para las particiones y roles.

    O bien

  • Ejecute el Asistente para implementación en el símbolo del sistema y establezca el asistente para que se ejecute en modo de archivo de respuesta.

    O bien

  • Abra el <proyecto name.deploymentoptions >en cualquier editor de texto y cambie manualmente las opciones. Las opciones de PartitionDeployment son DeployPartitions y RetainPartitions. Las opciones para RoleDeployment son DeployRolesAndMembers, DeployRolesRolesRolesMembers y RetainRoles.

Archivos de script de implementación: configuración de implementación de soluciones

El Asistente para implementación lee las opciones de implementación de roles y particiones que se usan en el script < de implementación del archivo nombre> del proyecto.configsettings. Para los proyectos multidimensionales, SQL Server Data Tools este archivo al compilar el proyecto. Para los proyectos tabulares, dependiendo de la versión, puede que sea necesario ejecutar el Asistente para implementación en modo de respuesta para generar el archivo .configsettings. SQL Server Data Tools usa las opciones de configuración del proyecto actual para crear el archivo <name.configsettings> del proyecto.

Revisión de las opciones de configuración

Estas son las opciones de configuración almacenadas en el archivo <name.configsettings> del proyecto:

  • Cadenas de conexión del origen de datos: son las cadenas de conexión de cada origen de datos en función de los valores especificados en el proyecto. El Id. de usuario y la contraseña siempre se quitan de la cadena de conexión antes de que el resto de la cadena se almacene en este archivo. Sin embargo, si el Asistente para la implementación está implementando directamente en una instancia de Analysis Services, puede agregar la información de Id. de usuario y contraseña correspondiente en el asistente para que el procesamiento de la base de datos de implementación sea correcto. Esta información de conexión no se almacenará en el script de implementación si el Asistente para la implementación guarda

  • Cuentas de suplantación : esta configuración especifica el nombre de usuario que Analysis Services para ejecutar instrucciones en cada origen de datos. Si no se especifica ninguna cuenta de suplantación, Analysis Services usa su cuenta de inicio de sesión para ejecutar instrucciones. Si a la cuenta de inicio de sesión se le conceden permisos directamente en el origen de datos, todos los administradores de bases de datos de todas las bases de datos de la instancia de Analysis Services tienen acceso al origen de datos a través de la cuenta de inicio de sesión. Si se especifica una cuenta de usuario y una contraseña, esta información siempre se quita antes de que la información de suplantación se almacene en este archivo. Sin embargo, si el Asistente para la implementación está implementando directamente en una instancia de Analysis Services, puede agregar la información de Id. de usuario y contraseña correspondiente en el asistente para que el procesamiento de la base de datos de implementación sea correcto. Esta información de suplantación no se almacenará en el script de implementación si el Asistente para la implementación guarda uno.

  • Archivos de registro de errores de clave: esta configuración especifica el nombre de archivo y la ruta de acceso del archivo de registro de errores de clave para cada cubo, grupo de medida, partición y dimensión de la base de datos.

  • Storage: esta configuración especifica la ubicación de almacenamiento para cada cubo, grupo de medida y partición de la base de datos. Si no se proporciona ningún valor para un objeto, el Asistente para implementación utiliza la ubicación predeterminada para el objeto. Por ejemplo, las particiones usan la ubicación para el grupo de medida, los grupos de medida usan la ubicación del cubo y los cubos usan la ubicación predeterminada para los objetos de la instancia del servidor. La ubicación de almacenamiento puede ser una ruta de acceso UNC (Convención de nomenclatura universal) o local.

  • Servidor de informes: esta configuración especifica el servidor de informes y la ubicación de la carpeta para cada acción de informe definida en cada cubo de la base de datos.

Modificación de las opciones de configuración

En algunos casos, es posible que tenga que implementar el < proyecto con valores de configuración diferentes a los almacenados en el archivo nombre> del proyecto.configsettings. Por ejemplo, puede que desee cambiar la cadena de conexión a uno o más orígenes de datos, o especificar ubicaciones de almacenamiento para particiones o grupos de medida específicos.

Para modificar la implementación de particiones y roles en un proyecto, < debe cambiar esta información en el archivo nombre> del proyecto.configsettings, como se describe en el procedimiento siguiente. No se puede cambiar la configuración de particiones y roles <> dentro del proyecto porque el cuadro de diálogo nombre del proyectoPropiedades Pages SQL Server Data Tools no muestra estas opciones.

Nota

Los valores de configuración se pueden aplicar a todos los objetos o solo a los recientemente creados. Aplique las opciones de configuración a los objetos recién creados solo cuando implemente objetos adicionales en una base de datos Analysis Services implementada previamente y no desee sobrescribir los objetos existentes. Para especificar si los valores de configuración se aplican a todos los objetos o solo a los recién creados, < establezca esta opción en el archivo nombre> del proyecto.deploymentoptions.

Para cambiar los valores de configuración después de haber generado los archivos de entrada

  • Ejecute el Asistente para implementación de forma interactiva y, en la página Configuración Configuración, especifique la configuración de los objetos que se implementan.

    O bien

  • Ejecute el Asistente para implementación en el símbolo del sistema y establezca el asistente para que se ejecute en modo de archivo de respuesta.

    O bien

  • Modifique el archivo <name.configsettings> del proyecto mediante cualquier editor de texto.

Archivos de script de implementación: opciones de procesamiento

El Asistente para implementación lee las opciones de procesamiento del archivo < nombre del proyecto.deploymentoptions>. SQL Server Data Tools crea este archivo al compilar el proyecto. SQL Server Data Tools usa las opciones <> de procesamiento especificadas en la página Implementación del cuadro de diálogo Nombre del proyectoPropiedades Pages< para crear el archivo nombre> del proyecto.deploymentoptions.

Revisión de las opciones de procesamiento

Las opciones de configuración almacenadas en el <archivo name.deploymentoptions >del proyecto son:

  • Método de procesamiento: esta configuración controla si los objetos implementados se procesan después de la implementación y el tipo de procesamiento que se realizará. Existen tres opciones de procesamiento:

    • El procesamiento predeterminado (valor predeterminado) detecta el estado de proceso de los objetos de base de datos y realiza el procesamiento necesario para entregar objetos no procesados o parcialmente procesados a un estado totalmente procesado.

    • El procesamiento completo procesa un objeto y todos los objetos que contiene. Cuando se ejecuta Procesar completo en un objeto que ya se ha procesado, Analysis Services quita todos los datos del objeto y, a continuación, lo procesa.

    • Ninguno significa que no se realiza ningún procesamiento.

  • Opciones de la tabla de reescribición: si la reescribición está habilitada en el proyecto, esta configuración define cómo se controla la reescribición. Existen tres opciones de tabla de reescritura:

    • De forma predeterminada, si existe una tabla de reescritura, se utilizará. Si no existe ninguna tabla de reescritura, se creará una nueva.

    • Si ya existe una tabla de reescritura, la implementación producirá errores. Si no existe ninguna tabla de reescritura, se creará una nueva.

    • Independientemente de si existe ya una tabla de reescritura o no, se crea una nueva tabla de reescritura. En este caso, el Asistente para implementación eliminará cualquier tabla existente y la reemplazará por una nueva tabla de reescribir.

  • Implementación transaccional : esta configuración controla si la implementación de los cambios de metadatos y los comandos de proceso se produce en una sola transacción o en transacciones independientes.

    • Si esta opción es True (valor predeterminado), Analysis Services todos los cambios de metadatos y todos los comandos de proceso dentro de una única transacción.

    • Si esta opción es False, Analysis Services los cambios de metadatos en una única transacción e implementa cada comando de procesamiento en su propia transacción.

Modificación de las opciones de procesamiento

Sin embargo, puede que tenga que implementar el proyecto con diferentes opciones de procesamiento que < las almacenadas en el archivo name.deploymentoptions> del proyecto. Por ejemplo, puede que desee tener todos los objetos totalmente procesados, o procesados con la opción de procesamiento predeterminada, o que no se produzca ningún procesamiento. Si los cubos o las dimensiones están habilitadas para escritura, puede especificar si se utilizará una tabla de reescritura nueva o ya existente.

Para modificar las opciones de procesamiento utilizadas durante la implementación, puede editar y volver a generar el proyecto, o cambiar las opciones de procesamiento del archivo de entrada mediante uno de los métodos descritos en el siguiente procedimiento.

Para cambiar las opciones de procesamiento después de haber generado los archivos de entrada

  • Ejecute el Asistente para implementación de forma interactiva. En la página Opciones de procesamiento , especifique las opciones de procesamiento del proyecto que se está implementando.

    O bien

  • Ejecute el Asistente para implementación en el símbolo del sistema y establezca el asistente para que se ejecute en modo de archivo de respuesta.

    O bien

  • Modifique el <archivo name.deploymentoptions >del proyecto mediante cualquier editor de texto.

Consulte también

Implementación de soluciones de modelo mediante XMLA
Implementación de soluciones de modelo con la utilidad de implementación