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

Artículo
05/08/2023

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

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

El Asistente para la implementación o la 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 realizar la implementación 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 rellenado de particiones mediante el modelo de objetos tabulares (TOM), el lenguaje de scriting de modelos tabulares (TMSL) y los 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 el 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 la implementación

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

Interactivamente : cuando se ejecuta de forma interactiva, el Asistente para la implementación genera un script de implementación basado en los archivos de entrada, tal y como lo modifica de forma interactiva 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 la 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 de forma interactiva

Cuando se ejecuta de forma interactiva, el Asistente para la 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 la implementación, las opciones de configuración, las opciones de implementación y cadena de conexión contraseñas, o dejarlos tal como están. Si cambia los valores 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 escriba Asistente para la implementación de Analysis Services.

O bien
En la carpeta Proyectos del proyecto de SQL Server Analysis Services, 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.

Ejecutar en el símbolo del sistema

El Asistente para la 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 le permite modificar interactivamente los archivos de entrada que se generaron originalmente cuando el proyecto de SQL Server Analysis Services se creó en 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, consulte Implementación de 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

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.
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 la 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 de Microsoft SQL Server adecuados en la base de datos de destino. De forma predeterminada, los archivos de entrada generados por el proyecto de SQL Server Analysis Services 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 Asistente para la implementación de SQL Server Analysis Services solo implementa objetos en una base de datos SQL Server 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 luego 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 que 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 superiores. Contiene las definiciones declarativas de todos los objetos SQL Server Analysis Services del proyecto.
<nombre del> proyecto. deploymenttargets	Contiene el nombre de la instancia de SQL Server Analysis Services y la base de datos en la que se crearán los objetos SQL Server Analysis Services.
<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. La configuración de este archivo invalida la configuración en el < archivo nombre> del proyecto.asdatabase.
<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

Modificar 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 el nombre> completo < del proyecto.asdatabase (o un archivo de script completo si genera un script a partir de una base de datos de SQL Server 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 name.deploymenttargets >del <proyecto. SQL Server Data Tools crea este archivo al compilar el proyecto. SQL Server Data Tools usa la base de datos y el servidor especificados en la página Implementación del <cuadro de diálogo Páginas de propiedades del nombre>del proyecto para crear el < archivo nombre> del proyecto.targets.

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 una base de datos o instancia diferente, 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 para la implementación de SQL Server Analysis Services de forma interactiva. En la página Destino de instalación, especifique un nuevo destino para la instancia de SQL Server Analysis Services y la base de datos.

O bien
Ejecute el Asistente para la implementación de SQL Server Analysis Services 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 project name.deploymenttargets >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 partición e implementación de roles 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 particiones y roles del proyecto actual cuando se crea el < archivo nombre> del proyecto.deploymentoptions.

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

Las opciones de implementación en el archivo nombre> del < proyecto.deploymentoptions incluyen lo siguiente:

Opciones de implementación de particiones
El < archivo project name.deploymentoptions> especifica si las particiones existentes de 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 project name.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 a 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 Microsoft Knowledge Base.

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

Es posible que tenga que implementar el proyecto con distintas opciones de partición y rol que las almacenadas en el archivo nombre> del < proyecto.deploymentoptions. Por ejemplo, puede que desee conservar las particiones, roles y 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 Páginas de propiedades del nombre>del proyecto en 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 project name.deploymentoptions>. En el procedimiento siguiente se describe cómo cambiar las opciones de partición e implementación de 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 particiones y roles, especifique nuevas opciones de implementación para las particiones y los roles.

O bien
Ejecute el Asistente para la 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 nombre> del < proyecto.deploymentoptions en cualquier editor de texto y cambie manualmente las opciones. Las opciones de PartitionDeployment son DeployPartitions, RetainPartitions. Las opciones de RoleDeployment son DeployRolesAndMembers, DeployRolesRetainMembers, RetainRoles.

Archivos de script de implementación: configuración de configuración de implementación de la solución

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

Revisión de los valores de configuración

A continuación se muestran los valores de configuración almacenados en el < archivo project name.configsettings>:

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 SQL Server Analysis Services usa para ejecutar instrucciones en cada origen de datos. Si no se especifica ninguna cuenta de suplantación, SQL Server Analysis Services usa su cuenta de inicio de sesión para ejecutar instrucciones. Si se conceden permisos a la cuenta de inicio de sesión directamente en el origen de datos, todos los administradores de bases de datos de todas las bases de datos de la instancia de SQL Server 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.

Nota:

En el caso de los modelos tabulares en el nivel de compatibilidad 1400 y superior con conexiones de origen de datos del proveedor estructurado, al seleccionar Conservar las opciones de configuración para los objetos existentes en la página Especificar propiedades de configuración del Asistente, el nombre de usuario y la contraseña almacenados en la base de datos del modelo tabular del servidor de destino no se conservan. Los administradores deben establecer manualmente el nombre de usuario y la contraseña mediante SSMS una vez completada la implementación.
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.
Ubicaciones de almacenamiento : esta opción especifica la ubicación de almacenamiento de 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 usa la ubicación predeterminada para el objeto . Por ejemplo, las particiones usan la ubicación del 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 la ubicación del servidor de informes y de la carpeta para cada acción de informe definida en cada cubo de la base de datos.

Modificación de los valores 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 project name.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 Páginas de propiedades del nombre>del proyecto en 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 de SQL Server Analysis Services implementada previamente y no quiera sobrescribir los objetos existentes. Para especificar si las opciones 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 de configuración , especifique la configuración para los objetos que se implementan.

O bien
Ejecute el Asistente para la 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 project name.configsettings >mediante cualquier editor de texto.

Archivos de script de implementación: opciones de procesamiento

El Asistente para la 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 Páginas de propiedades del nombre>del< proyecto para crear el archivo nombre> del < proyecto.deploymentoptions.

Revisión de las opciones de procesamiento

Las opciones de configuración almacenadas en el archivo nombre> del < proyecto.deploymentoptions 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 del proceso de los objetos de base de datos y realiza el procesamiento necesario para entregar objetos sin procesar 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 tabla de reescritura: si la escritura diferida está habilitada en el proyecto, esta configuración define cómo se controla la escritura diferida. 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 la implementación eliminará cualquier tabla existente y la reemplazará por una nueva tabla de reescritura.
Implementación transaccional : esta configuración controla si la implementación de los cambios de metadatos y los comandos de proceso se producen en una sola transacción o en transacciones independientes.
- Si esta opción es True (valor predeterminado), SQL Server Analysis Services implementa todos los cambios de metadatos y todos los comandos de proceso dentro de una sola transacción.
- Si esta opción es False, SQL Server Analysis Services implementa los cambios de metadatos en una sola transacción e implementa cada comando de procesamiento en su propia transacción.

Modificación de las opciones de procesamiento

Sin embargo, es posible que tenga que implementar el proyecto con diferentes opciones de procesamiento que las almacenadas en el archivo nombre> del < proyecto.deploymentoptions. 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 la 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 la 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 nombre> del proyecto.deploymentoptions 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