Exportar e importar el metadata#
El metadata de una conexión se puede exportar como un paquete (un fichero zip) e importar en otra conexión, de la misma instalación o de otra. Así se diseña y se prueba en un entorno de desarrollo y se lleva a producción, se copia el diseño a otra base de datos con la misma estructura o se guarda una copia del diseño fuera de ECenter.
Antes de empezar#
- Exportar e importar exige Administración del Metadata.
- La conexión de destino tiene que existir y tener su catálogo leído: importar no crea conexiones. Si va a diseñar en ella sin que la vean los usuarios, márquela como Solo para quien administra el metadata.
- Para automatizar la promoción entre entornos sin sesión, con una credencial de servicio, vea Integraciones.
Cómo funciona#
- En el entorno de origen, Exportar metadata… descarga el paquete.
- En el de destino, Importar metadata… abre un asistente que analiza el paquete: dice exactamente lo que haría la importación (lo nuevo, lo que cambia, lo que se elimina y el impacto en los documentos) sin cambiar nada.
- Si está conforme, importa: todo o nada. Si el destino ya tenía metadata, antes se guarda una copia (ver Copias del metadata).
Cada elemento del metadata lleva una clave de intercambio fija, que viaja en el paquete. La primera vez que se importa en un destino que ya tiene metadata, los elementos se reconocen por su nombre (una tabla por su esquema y su nombre físico, una dimensión o una métrica por su nombre en su tabla, una relación por sus tablas y sus columnas, una carpeta por su ruta) y adoptan la clave del paquete; desde entonces se reconocen por ella, aunque se renombren en cualquiera de los dos entornos. Lo reconocido conserva su número en el destino, así que los libros, las listas y los marcadores del destino siguen apuntando a lo mismo.
Qué lleva el paquete#
| Lleva | No lleva |
|---|---|
| Las tablas de hechos con sus campos, su clave, su alias y «Admite listas» | Las tablas definidas por los usuarios (datos externos) y lo que cuelga de ellas |
| Las dimensiones y las métricas, con su descripción de negocio, su formato, su función, su expresión y su fórmula | Las listas, los libros, las plantillas, los marcadores y las suscripciones |
| Las tablas auxiliares y el enlace de cada dimensión | Los usuarios, los roles y qué rol tiene cada privilegio |
| Las relaciones, con la preferida | La URL, el usuario, la contraseña, el nombre y el identificador de la conexión |
| El árbol de presentación: carpetas y colocaciones | Fechas, autores y números de la instalación |
| Los enlaces geográficos (el código de la capa) | Las capas geográficas: hay que subirlas en el destino con el mismo código |
| La referencia a los privilegios de acceso y de edición (los de usuario, por su ruta y su nombre) | |
| Si se pide: los universos, la disposición del diagrama y las agrupaciones |
Importante
Un paquete lleva SQL que se ejecutará contra la base de datos del cliente: expresiones, funciones, condiciones de universos y SQL de siguiente valor. Trátelo como código: importe solo paquetes de quien confíe y revise en el análisis lo que cambia.
Exportar#
- En Administración › Metadata, elija la conexión.
- Abra el menú Exportar e importar y elija Exportar metadata….
- Elija las opciones (abajo).
- Pulse Exportar. El navegador descarga
metadata-<conexión>-<AAAA-MM-DD>.zip.
El diálogo resume lo exportado: «Se ha exportado el metadata de «…»: 8 tablas de hechos y 15 auxiliares. Lleva 10 universos y 3 agrupaciones». Si tiene cambios sin guardar en el editor, avisa: el paquete lleva lo guardado.
| Opción | Qué hace |
|---|---|
| Incluir los universos (seguridad por filas) | Añade los universos de la conexión. Desmarcada por defecto, porque sus condiciones pueden llevar valores de sus datos. Sin ella, la importación no toca los universos del destino. |
| Incluir la disposición del diagrama | Añade la posición de las tablas en el diagrama de relaciones. Marcada por defecto. |
| Incluir las agrupaciones | Añade las agrupaciones con sus valores. Marcada por defecto. Las crean los usuarios y llevan valores de sus datos. |
Lo que nunca va en el paquete lo dice también el resumen: las fórmulas que usan métricas de datos externos y las métricas cuyas expresiones citan tablas de datos externos.
Dos exportaciones del mismo metadata dan el mismo fichero, y un metadata promocionado de desarrollo a producción se exporta igual en los dos: comparar dos entornos es comparar dos ficheros.
Importar#
- En Administración › Metadata, elija la conexión de destino.
- Abra Exportar e importar y elija Importar metadata… (en una conexión sin metadata, también Importar un paquete… en Estructura o en los Siguientes pasos de la conexión). Se abre el asistente Importar metadata a página completa.
- Siga sus pasos, que se ven a la izquierda. Siguiente y Anterior los recorren.
Paquete#
Elija el fichero en Paquete de metadata (.zip). Al elegirlo se analiza (el estado dice Analizando el paquete…), y Qué es dice el formato, la versión con que se escribió y el motor de origen («Formato 1 · escrito con Empowerment Center 8.0.0 · motor PostgreSQL»), las secciones que trae y la huella SHA-256 del fichero.
Esquemas y privilegios#
Este paso solo aparece si el paquete nombra algo que el destino no reconoce solo:
- Esquemas: el paquete no lleva el nombre físico de los esquemas sino un nombre lógico (el mismo, si no se ha dicho otro). Si no se resuelve solo (por un esquema de la conexión que se llame igual, o porque los dos tienen un único esquema), elija Esquema de «…» en esta conexión. Lo elegido se recuerda, y la conexión exporta después con el mismo nombre lógico: desarrollo (
DEV_COMERCIAL) y producción (COMERCIAL) dan el mismo paquete. - Privilegios: para cada privilegio del paquete que falta en esta instalación, elija Crear «…» (se crea en la misma carpeta; nadie lo tendrá hasta que lo asigne a un rol) o Usar un privilegio que ya existe.
Al cambiar algo se vuelve a analizar. La importación nunca cambia un privilegio que ya existe.
Diferencias#
Lo que haría la importación, sin cambiar nada todavía:
- Eliminar también lo que no está en el paquete: sin marcar (lo de por defecto), lo que solo está en esta conexión se conserva. Marcada, se elimina, con su impacto. Lo que crean los usuarios con los datos externos no se toca nunca.
- Los recuentos por clase («Métricas: 3 nuevas, 1 cambia, 27 iguales y 2 solo en esta conexión»).
- Un aviso si se eliminarían agrupaciones creadas por los usuarios de esta conexión.
- Avisos, filtrables por gravedad (Errores, Avisos, Información): por ejemplo, que el motor de origen es otro, que una función nombra un esquema de origen o que una tabla o columna no está en el catálogo del destino.
- Elementos que no quedan iguales, filtrables por Qué le pasa (Nuevos, Cambian, Solo aquí, Se eliminan) y por Clase, con lo que cambia de cada uno («Cambia la definición y el privilegio de acceso») y si se ha reconocido por su nombre.
- Descargar el informe (CSV).
Si el paquete ya es igual que el metadata de la conexión, lo dice: «Sin diferencias».
Impacto#
Lo que la importación haría a lo que usa el metadata de la conexión: documentos, listas, plantillas, suscripciones y alertas que se rompen o cambian de resultado, datos conservados que caducan, quién deja de ver o pasa a ver qué, y los universos. Es el mismo informe que el de cualquier guardado (ver Uso y validación). Si una regla lo impide, no se puede seguir.
Importar#
La importación entra entera o no entra: con un error no cambia nada. Pulse Importar metadata (o Importar igualmente si hay avisos o impacto que confirmar). Al terminar, el asistente lo resume y ofrece:
- Abrir el editor del metadata;
- Validar contenido;
- Asignar los privilegios creados en Usuarios y roles, si se creó alguno;
- Descargar el informe (CSV).
Mientras analiza o importa, Cancelar cancela el trabajo; una importación que ya se está confirmando no se detiene y entra entera. Salir del asistente con un paquete analizado sin importar pregunta antes: el servidor no guarda el paquete y habría que elegirlo otra vez.
Errores frecuentes#
| Mensaje | Qué hacer |
|---|---|
| «El paquete es de una versión más nueva de Empowerment Center: actualice este servidor para importarlo.» | Actualice el destino a la versión del origen, o exporte desde una versión igual. |
| «Hay otra importación o restauración en curso en esta conexión: la lanzó … Espere a que termine.» | Solo se importa una vez a la vez por conexión. |
| «El metadata ha cambiado desde el análisis: se ha vuelto a analizar. Revise las diferencias.» | Alguien guardó un cambio entre el análisis y la importación. Revise y vuelva a importar. |
| Un error que pide refrescar el catálogo | El destino no tiene catálogo leído. Refrésquelo en Ver catálogo. |
| Un paquete demasiado grande | Supera los topes de abajo. |
Topes#
| Propiedad | Por defecto | Qué es |
|---|---|---|
ecenter.metadata.exchange.max-package-size |
64MB |
El paquete descomprimido, entre todos sus ficheros. |
ecenter.metadata.exchange.max-entries |
5000 |
Ficheros dentro del zip. |
ecenter.metadata.exchange.max-entry-size |
16MB |
Cada fichero descomprimido. |