Caricamento dati di partizione federata

È possibile caricare i dati di un cubo di partizione federata Essbase nella tabella fact in Autonomous Data Warehouse. Prima di poter eseguire questa operazione, è necessario integrare Essbase con lo storage degli oggetti OCI e configurare le credenziali DBMS_CLOUD mediante lo script configure-dbms-writeback.

Integrare Essbase con lo storage degli oggetti OCI

Per caricare i dati da un cubo di partizione federata nella tabella fact in Autonomous Data Warehouse, Essbase utilizza il package DBMS_CLOUD, disponibile con Autonomous Database.

Per poter accedere al package DBMS_CLOUD, è necessario aver scelto di eseguire l'integrazione di Essbase con lo storage degli oggetti OCI durante la distribuzione dello stack Oracle Essbase da Oracle Cloud Marketplace.

Per informazioni dettagliate complete, vedere Distribuire Essbase dal Marketplace per le partizioni federate.

Impostare le credenziali per il caricamento dati

Prima di poter eseguire qualsiasi operazione di caricamento dati da Essbase in Autonomous Data Warehouse, è necessario completare un workflow di passi per abilitare l'uso delle credenziali cloud con le partizioni federate.

Tipi di utente nel workflow delle credenziali del caricamento dati

Gli utenti con i tipi di accesso riportati di seguito sono o possono essere coinvolti nel workflow richiesto per l'impostazione di un cubo di partizione federata per il caricamento dati. Nell'organizzazione, questi ruoli possono essere distinti (in modo che l'impostazione sia un workflow collaborativo) oppure possono essere combinati (una persona dispone di tutti i tipi di accesso necessari).

Tipo di utente	Ruolo nel workflow
Utente SSH	Può utilizzare la riga di comando del sistema operativo per accedere, come utente opc, all'istanza Essbase distribuita nell'infrastruttura Oracle Cloud (può trattarsi della stessa persona che ha eseguito la distribuzione di Essbase come stack in OCI).
Utente DB	Conosce il nome e la password dello schema di Autonomous Data Warehouse, ovvero lo stesso schema e la stessa password utilizzati per creare la connessione di Essbase al database Oracle (necessario prerequisito prima di poter creare la partizione federata).
Utente OCI	Può accedere alla console OCI, incluso il bucket dello storage degli oggetti per il catalogo Essbase.
Amministratore DB	Conosce il nome e la password dello schema dell'amministratore del database Oracle.
Amministratore Essbase	L'amministratore di sistema Essbase. Può essere l'amministratore Essbase iniziale creato dall'amministratore del dominio di identità (che può anche essere l'utente OCI) oppure può essere un altro amministratore di sistema Essbase creato dopo il completamento della distribuzione di Essbase.
Responsabile applicazioni Essbase	Il responsabile o proprietario di un'applicazione Essbase, creata dopo il completamento della distribuzione Essbase.

Workflow delle credenziali del caricamento dati

È necessario completare i passi del workflow riportati di seguito per ogni schema di database utilizzato per la partizione federata.

Utente OCI: seguire le istruzioni in Distribuire Essbase dal Marketplace per le partizioni federate per distribuire Essbase nella tenancy OCI con le selezioni appropriate per le partizioni federate.
Utente DB, Amministratore Essbase o Responsabile applicazioni Essbase: eseguire il login all'interfaccia Web di Essbase e creare una connessione a Autonomous Data Warehouse, come descritto in Creare una connessione per le partizioni federate.
Utente DB, Amministratore Essbase o Responsabile applicazioni Essbase: creare la partizione federata, come descritto in Creare una partizione federata.
Utente OCI: dal proprio profilo utente nella console OCI, generare e copiare un token di autenticazione. Fornire questo token e il proprio nome utente all'Utente SSH.

Vedere Recuperare un token di autenticazione.
Utente SSH: eseguire lo script di preparazione del caricamento dati, disponibile nell'istanza Essbase in OCI. È necessario eseguire lo script una volta per ogni schema di database in Autonomous Data Warehouse.

Esempio:
1. Passare all'utente oracle.
```
sudo su oracle
```
2. Andare alla posizione dello script.
```
cd /u01/vmtools/config/adwwb_dbms
```
3. Eseguire lo script.
```
./configure-dbms-writeback.sh
```
  Nota:
  Per visualizzare le opzioni dello script, eseguire lo script con l'argomento -h o --help. Sintassi: ./configure-dbms-writeback.sh [--help | -h]
  
  Nota:
  Se necessario, eseguire lo script con l'opzione vault. Questa opzione consente di impostare lo script in modo che acquisisca le credenziali dell'amministratore DB memorizzate nel vault, a cui si accede utilizzando l'OCID, invece di richiedere la password. Sintassi: ./configure-dbms-writeback.sh [--vault | -V]
4. Quando richiesto, immettere le informazioni riportate di seguito.
  - Password dell'amministratore DB, se lo script non è stato eseguito con l'opzione vault. Poiché la password è un'informazione protetta, il testo non verrà visualizzato durante la digitazione al prompt dei comandi.
  - Nome utente e password dell'utente DB. Poiché la password è un'informazione protetta, il testo non verrà visualizzato durante la digitazione al prompt dei comandi.
  - Nome utente e token di autenticazione dell'utente OCI. Immettere la stringa di identificazione utente completa. Per trovare questa stringa, nella console OCI fare clic sull'icona del profilo nell'angolo in alto a destra per visualizzare una panoramica del profilo utente. Copiare la stringa completa visualizzata sotto Profilo e sopra Tenancy.
Lo script crea la credenziale cloud necessaria e la memorizza nello schema di database. Non è necessario eseguire di nuovo lo script quando si riavvia OCI Essbase o le applicazioni Essbase.

A questo punto è possibile caricare i dati da Essbase per aggiornare la tabella fact di Autonomous Data Warehouse.

Nota:

Per l'utente SSH: se il token di autenticazione dell'utente OCI utilizzato nello script di preparazione del caricamento dati non ha più accesso al bucket dello storage degli oggetti per il catalogo Essbase, sarà necessario trovare un altro utente OCI che soddisfi i requisiti elencati in Tipi di utente nel workflow di preparazione del caricamento dati e ripetere i passi del workflow.

Altre note sul caricamento dati di partizione federata

Posizione file dati origine

Prima di eseguire un caricamento dati da Essbase nella tabella fact, Oracle consiglia di caricare il file di dati nel server Essbase. Il caricamento dei dati lato client è supportato, ma richiede più tempo.

Strumenti di caricamento dati non di Essbase

Se non è necessario eseguire il caricamento dati da Essbase in Autonomous Data Warehouse, è possibile utilizzare Strumenti dati in Autonomous Database per caricare i dati nella tabella fact ed eseguire altri task di gestione. È tuttavia necessario accertarsi che il profilo del cubo e la tabella fact rimangano sincronizzati. Vedere Precauzioni sui metadati per i cubi di partizione federata.

File di dati formattati DBMS

Il caricamento di file di esportazione dati in formato Essbase in cubi di partizione federata può richiedere molto tempo. Per ottimizzare i caricamenti dei dati, utilizzare un file di origine in formato DBMS. È possibile crearne uno utilizzando il comando di calcolo DATAEXPORT con l'opzione DataExportCSVFormat. I file in formato CSV possono essere caricati più velocemente perché sono conformi alle opzioni del formato del package DBMS_CLOUD per i file di origine.

Dimensione pivot nella tabella fact e nell'origine di input del caricamento dati

La dimensione pivot utilizzata nei file di input per il caricamento dati deve essere uguale alla dimensione pivot della tabella fact.

Ad esempio, nella tabella fact riportata di seguito la dimensione pivot è la dimensione Measures (Sales, COGS, Margin e così via).

Tabella fact di dati e metadati denormalizzati visualizzata in SQL Developer, con le intestazioni di colonna "Year", "Product", "Market", "Scenario", "Sales", "COGS", "Margin", "Marketing", "Payroll", "Misc", "Total Expenses", "Profit", "Opening Inventory", "Additions" e "Ending Inventory."

Un file di input di caricamento dati accettabile per questa tabella fact avrà una forma simile, perché ha la stessa dimensione pivot. Esempio (troncato):

"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

Se la dimensione pivot del file di input è diversa dalla dimensione pivot della tabella fact, viene restituito un errore e il job di caricamento dei dati viene terminato.

Più file di importazione in MaxL non sono supportati

L'importazione di dati da più file in parallelo utilizzando un'istruzione MaxL import con caratteri jolly non è supportata per i cubi di partizione federata.