Carga de datos de partición federada

Desde un cubo de partición federada de Essbase, puede cargar datos en su tabla de hechos de Autonomous Data Warehouse. Antes de llevarlo a cabo, debe integrar Essbase con el almacenamiento de objetos de OCI y configurar las credenciales de DBMS_CLOUD mediante el script configure-dbms-writeback.

Integración de Essbase con OCI Object Storage

Para cargar datos desde un cubo de partición federada a su tabla de hechos de Autonomous Data Warehouse, Essbase utiliza el paquete DBMS_CLOUD, disponible con Autonomous Database.

Para acceder al paquete DBMS_CLOUD, debe haber seleccionado integrar Essbase con OCI Object Storage cuando desplegó la pila de Oracle Essbase desde Oracle Cloud Marketplace.

Para obtener más información, consulte Despliega Essbase desde Marketplace para las particiones federas.

Configuración de credenciales para la carga de datos

Para poder realizar cualquier operación de carga de datos a través de Essbase en Autonomous Data Warehouse, es necesario completar los pasos de un flujo de trabajo para activar las credenciales de la nube que se podrán utilizar con las particiones federadas.

Tipos de usuario en el flujo de trabajo de credenciales de carga de datos

Los usuarios con los siguientes tipos de acceso están o pueden estar involucrados en el flujo de trabajo necesario para configurar un cubo de partición federada para la carga de datos. En su organización, estos roles pueden ser independientes (de modo que la configuración sea un flujo de trabajo colaborativo) o se pueden combinar (una persona tiene todo el acceso necesario).

Tipo de usuario	Rol en el flujo de trabajo
Usuario de SSH	Puede utilizar la línea de comandos del sistema operativo para acceder, como usuario opc, a la instancia de Essbase desplegada en Oracle Cloud Infrastructure. (Puede ser la misma persona que ha desplegado Essbase como una pila en OCI).
Usuario de base de datos	Conoce el nombre y la contraseña de esquema de Autonomous Data Warehouse, el mismo esquema y la misma contraseña que se utilizan para crear la conexión de Essbase a Oracle Database (un requisito necesario para crear la partición federada).
Usuario de OCI	Puede acceder a la consola de OCI, incluido el cubo de almacenamiento de objetos para el catálogo de Essbase.
Administrador de base de datos	Conoce el nombre y la contraseña de esquema del administrador de Oracle Database.
Administrador de Essbase	Administrador del sistema de Essbase. Puede ser el administrador de Essbase inicial creado por el administrador del dominio de identidad (que también puede ser el usuario de OCI), o puede ser otro administrador del sistema de Essbase creado después de completar el despliegue de Essbase.
Gestor de aplicaciones de Essbase	Gestor/propietario de una aplicación de Essbase creado después de completar el despliegue de Essbase.

Flujo de trabajo de credenciales de carga de datos

Es necesario completar los siguientes pasos del flujo de trabajo para cada esquema de base de datos que utilice para la partición federada.

Usuario de OCI: siga las instrucciones de Despliega Essbase desde Marketplace para las particiones federas para desplegar Essbase en el arrendamiento de OCI con las selecciones adecuadas para particiones federadas.
Usuario de base de datos, administrador de Essbase o gestor de aplicaciones de Essbase: conéctese a la interfaz web de Essbase y cree una conexión a Autonomous Data Warehouse como se describe en Creación de una conexión para particiones federadas.
Usuario de base de datos, administrador de Essbase o gestor de aplicaciones de Essbase: cree la partición federada como se describe en Creación de una partición federada.
Usuario de OCI: en el perfil de usuario de la consola de OCI, genere y copie un token de autenticación. Proporcione este token, y su nombre de usuario, al usuario de SSH.

Consulte Obtención de un token de autenticación.
Usuario de SSH: ejecute el script de preparación de carga de datos, disponible en la instancia de Essbase en OCI. Solo tiene que ejecutar el script una vez por esquema de base de datos en Autonomous Data Warehouse.

Ejemplo:
1. Cambie al usuario oracle.
```
sudo su oracle
```
2. Vaya hasta la ubicación del script.
```
cd /u01/vmtools/config/adwwb_dbms
```
3. Ejecute el script.
```
./configure-dbms-writeback.sh
```
  Nota:
  Para ver las opciones del script, ejecute el script con el argumento -h o --help. Sintaxis: ./configure-dbms-writeback.sh [--help | -h]
  
  Nota:
  Si lo desea, ejecute el script con la opción de almacén. Esta opción define el script para que tome las credenciales del administrador de base de datos guardadas en el almacén, al que se accede mediante el OCID, en lugar de solicitarle la contraseña. Sintaxis: ./configure-dbms-writeback.sh [--vault | -V]
4. Cuando se le solicite, introduzca la información necesaria:
  - La contraseña del administrador de base de datos, si no ha ejecutado el script con la opción de almacén. Debido a que la contraseña es información protegida, no se mostrará el texto a medida que escribe en el símbolo del sistema.
  - El nombre de usuario y la contraseña del usuario de base de datos. Debido a que la contraseña es información protegida, no se mostrará el texto a medida que escribe en el símbolo del sistema.
  - El nombre de usuario y el token de autenticación del usuario de OCI. Introduzca la cadena de identificación de usuario completa. Para buscar esta cadena en la consola de OCI, haga clic en el icono de perfil en la esquina superior derecha para mostrar una visión general del perfil de usuario. Copie la cadena completa que aparece debajo de Perfil y encima de Arrendamiento.
El script crea la credencial de nube necesaria y la almacena en el esquema de base de datos. No es necesario volver a ejecutar el script al reiniciar OCI, Essbase o las aplicaciones de Essbase.

A continuación, puede cargar los datos mediante Essbase para actualizar la tabla de hechos de Autonomous Data Warehouse.

Nota:

Para el usuario de SSH: si el token de autenticación del usuario de OCI utilizado en el script de preparación de la carga de datos ya no tiene acceso al cubo de almacenamiento de objetos para el catálogo de Essbase, deberá buscar otro usuario de OCI que cumpla los requisitos que se indican en Tipos de usuario en el flujo de trabajo de preparación de carga de datos y repetir los pasos del flujo de trabajo.

Otras notas sobre la carga de datos de partición federada

Ubicación del archivo de datos de origen

Antes de realizar una carga de datos mediante Essbase en la tabla de hechos, Oracle recomienda cargar el archivo de datos en el servidor de Essbase. La carga de datos del cliente está soportada, pero tarda más tiempo.

Herramientas de carga de datos no de Essbase

Si no tiene que cargar datos mediante Essbase a Autonomous Data Warehouse, puede utilizar la Herramientas de datos de Autonomous Database para cargar datos a la tabla de hechos y realizar otras tareas de gestión. Sin embargo, asegúrese de que el esquema de cubo y la tabla de hechos no queden desincronizadas. Consulte Precauciones con los metadatos para los cubos de partición federada.

Archivos de datos con formato DBMS

La carga de archivos de exportación de datos con formato Essbase en cubos de partición federada puede tardar bastante tiempo. Para optimizar las cargas de datos, utilice un archivo de origen con formato DBMS. Puede crear uno mediante el comando de cálculo DATAEXPORT con la opción DataExportCSVFormat. Los archivos con formato CSV se pueden cargar con más rapidez porque se ajustan a las opciones de formato del paquete DBMS_CLOUD para los archivos de origen.

Dimensión de tabla dinámica en tabla de hechos y origen de entrada de carga de datos

La dimensión de tabla dinámica utilizada en los archivos de entrada de carga de datos debe ser la misma que la dimensión de tabla dinámica de la tabla de hechos.

Por ejemplo, en la siguiente tabla de hechos, la dimensión de tabla dinámica es la dimensión Measures (Sales, COGS, Margin, etc).

Tabla de hecho de datos y metadatos desnormalizados mostrados en SQL Developer con las cabeceras de columna "Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions" y "Ending Inventory."

Un archivo de entrada de carga de datos aceptable para esta tabla de hechos tiene una forma similar, ya que tiene la misma dimensión de tabla dinámica. Ejemplo (truncado):

"Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions","Ending Inventory"
"Jan","100-10","New York","Actual",678,271,407,94,51,0,145,262,2101,644,2067
"Feb","100-10","New York","Actual",645,258,387,90,51,1,142,245,2067,619,2041
"Mar","100-10","New York","Actual",675,270,405,94,51,1,146,259,2041,742,2108

Si la dimensión de tabla dinámica del archivo de entrada difiere de la dimensión de tabla dinámica de la tabla de hechos, se devuelve un error y se termina el trabajo de carga de datos.

La importación desde varios archivos en MaxL no está soportada

La importación de datos desde varios archivos en paralelo mediante una sentencia import de MaxL con comodines no está soportada para los cubos de partición federada.