Încărcarea datelor de pe o partiţie federativă

Dintr-un cub de pe o partiţie federativă Essbase, puteţi încărca datele în tabelul de fapte din Autonomous Data Warehouse. Înainte să puteţi face acest lucru, trebuie să integraţi Essbase cu OCI Object Storage şi să configuraţi acreditările DBMS_CLOUD folosind scriptul configure-dbms-writeback.

Integrarea Essbase cu OCI Object Storage

Pentru a încărca datele dintr-un cub de pe o partiţie federativă în tabelul de fapte din Autonomous Data Warehouse, Essbase utilizează pachetul DBMS_CLOUD, disponibil cu Autonomous Database.

Pentru a accesa pachetul DBMS_CLOUD, trebuie să selectaţi integrarea Essbase cu OCI Object Storage când implementaţi stiva Oracle Essbase din Oracle Cloud Marketplace.

Pentru instrucţiuni mai detaliate, consultaţi Implementaţi Essbase din Marketplace pentru partiţii ca elemente ale unei federaţii.

Configuraţi acreditări pentru încărcarea datelor

Înainte să poată fi efectuată orice operaţiune de încărcare a datelor prin Essbase în Autonomous Data Warehouse, trebuie finalizat un flux de lucru cu etape, pentru a activa acreditările cloudului pentru a putea fi utilizate cu partiţii federative.

Tipuri de utilizatori în fluxul de lucru pentru acreditări pentru încărcarea datelor

Utilizatorii cu următoarele tipuri de acces sunt sau pot fi implicaţi în fluxul de lucru obligatoriu pentru configurarea unui cub cu partiţii federative pentru încărcarea datelor. În organizaţia dvs., aceste roluri pot fi separate (astfel încât configurarea să fie un flux de lucru colaborativ) sau rolurile pot fi combinate (o persoană are tot accesul obligatoriu).

Tip utilizator	Rol în cadrul fluxului de lucru
Utilizator SSH	Poate utiliza linia de comandă a sistemului de operare pentru a accesa ca utilizator opc instanţa Essbase implementată în Oracle Cloud Infrastructure. (Poate să fie aceeaşi persoană care a implementat Essbase ca stivă în OCI).
Utilizator de DB	Cunoaşte numele schemei şi parola Autonomous Data Warehouse -- aceleaşi schemă şi parolă care sunt utilizate pentru a crea conexiunea Essbase la Oracle Database (o cerinţă preliminară obligatorie pentru crearea partiţiei federative).
Utilizator OCI	Poate accesa consola OCI, inclusiv bucketul Object Storage pentru catalogul Essbase.
Administrator DB	Cunoaşte numele schemei şi parola administratorului Oracle Database.
Administrator Essbase	Administratorul sistemului Essbase. Poate fi administratorul Essbase iniţial, creat de administratorul domeniului de identităţi (care poate fi şi utilizatorul OCI) sau poate fi alt administrator al sistemului Essbase, creat după finalizarea implementării Essbase.
Manager de aplicaţii Essbase	Managerul/responsabilul unei aplicaţii Essbase, creat după finalizarea implementării Essbase.

Fluxul de lucru pentru acreditări pentru încărcarea datelor

Următoarele etape din fluxul de lucru trebuie finalizate pentru fiecare schemă a bazei de date pe care o utilizaţi pentru partiţia federativă.

Utilizator OCI: Urmaţi instrucţiunile din Implementaţi Essbase din Marketplace pentru partiţii ca elemente ale unei federaţii pentru a implementa Essbase în tenancy-ul OCI cu selecţiile adecvate pentru partiţiile federative.
Utilizator DB, Administrator Essbase, sau Manager de aplicaţii Essbase: Conectaţi-vă la interfaţa web Essbase şi creaţi o conexiune la Autonomous Data Warehouse, aşa cum se descrie în Creaţi o conexiune pentru partiţii ca elemente ale unei federaţii.
Utilizator DB, Administrator Essbase, sau Manager de aplicaţii Essbase: Creaţi partiţia federativă, aşa cum se descrie în Creaţi o partiţie ca element al unei federaţii.
Utilizator OCI: Din profilul de utilizator din consola OCI, generaţi şi copiaţi un token de autentificare. Furnizaţi-l pe acesta, precum şi numele de utilizator Utilizatorului SSH.

Consultaţi Preluarea unui token de autentificare.
Utilizator SSH: Rulaţi scriptul de pregătire a încărcării datelor, disponibil pentru instanţa Essbase din OCI. Trebuie să rulaţi scriptul doar o dată per schemă a bazei de date din Autonomous Data Warehouse.

Exemplu:
1. Comutaţi la utilizatorul oracle.
```
sudo su oracle
```
2. Navigaţi la locaţia scriptului.
```
cd /u01/vmtools/config/adwwb_dbms
```
3. Rulaţi scriptul.
```
./configure-dbms-writeback.sh
```
  Notă:
  Pentru a vedea opţiunile scriptului, rulaţi-l cu argumentul -h sau --help. Sintaxă: ./configure-dbms-writeback.sh [--help | -h]
  
  Notă:
  Opţional puteţi rula scriptul cu opţiunea de vault. Această opţiune setează scriptul să preia acreditările administratorului DB stocate în vault, care accesate utilizând OCID-ul, în loc să vă solicite parola. Sintaxă: ./configure-dbms-writeback.sh [--vault | -V]
4. Când vi se solicită, introduceţi informaţiile obligatorii:
  - Parola Administratorului DB, dacă nu aţi rulat scriptul cu opţiunea de vault. Deoarece parola reprezintă o informaţie protejată, nu veţi vedea textul când tastaţi promptul de comandă.
  - Numele de utilizator şi parola Utilizatorului DB. Deoarece parola reprezintă o informaţie protejată, nu veţi vedea textul când tastaţi promptul de comandă.
  - Numele de utilizator şi tokenul de autentificare ale Utilizatorului OCI. Introduceţi şirul integral de identificare a utilizatorului. Pentru a găsi acest şir, în consola OCI, faceţi clic pe pictograma profilului din colţul din dreapta sus pentru a afişa o prezentare a profilului de utilizator. Copiaţi şirul integral afişat sub Profil şi deasupra Tenancy-ului.
Scriptul creează acreditările necesare pentru cloud şi le stochează în schema bazei de date. Nu este necesar să rulaţi din nou scriptul la repornirea aplicaţiilor OCI, Essbase sau Essbase.

Acum puteţi să încărcaţi datele prin Essbase pentru a actualiza tabelul de fapte Autonomous Data Warehouse.

Notă:

Pentru Utilizatorul SSH– Dacă tokenul de autentificare al utilizatorului OCI utilizat în scriptul de pregătire a încărcării datelor nu mai are acces la bucketul Object Storage pentru catalogul Essbase, va trebui să găsiţi alt utilizator OCI care îndeplineşte cerinţele din Tipuri de utilizatori în fluxul de lucru de pregătire a încărcării datelor şi să repetaţi etapele din fluxul de lucru.

Alte note despre încărcarea datelor de pe o partiţie federativă

Locaţie fişier de date sursă

Înainte de efectua o încărcare de date prin Essbase în tabelul de fapte, Oracle vă recomandă să încărcaţi fişierul de date pe serverul Essbase. Este acceptată şi încărcarea de date de pe partea clientului, dar durează mai mult.

Instrumente non-Essbase pentru încărcarea datelor

Dacă nu trebuie să încărcaţi datele prin Essbase în Autonomous Data Warehouse, puteţi utiliza instrumentele de date din Baza de date Autonomous Database pentru a încărca datele în tabelul de fapte şi pentru a efectua alte sarcini administrative. Totuşi, verificaţi dacă proiectul cubului şi tabelul de fapte sunt sincronizate - consultaţi Precauţii privind metadatele pentru cuburi cu partiţii ca elemente ale unei federaţii.

Fişiere de date în format DBMS

Încărcarea fişierelor de export de date formatate în Essbase în cuburi cu partiţii federative, poate dura mult timp. Pentru a optimiza încărcările de date, folosiţi un fişier sursă cu format DBMS. Puteţi crea unul cu ajutorul comenzii de calcul DATAEXPORT cu opţiunea DataExportCSVFormat. Fişierele formatate CSV pot fi încărcate mai repede, deoarece corespund opţiunilor de format pentru pachetul DBMS_CLOUD pentru fişierele sursă.

Dimensiunea Pivot din tabelul de fapte şi sursa de intrare pentru încărcarea datelor

Dimensiunea Pivot utilizată în fişierele de intrare pentru încărcarea datelor trebuie să coincidă cu dimensiunea Pivot a tabelului de fapte.

De exemplu, în următorul tabel de fapte, dimensiunea Pivot este dimensiunea Subindicatori (Vânzări, COGS, Marjă etc.).

Tabelul de fapte al datelor denormalizate şi al metadatelor afişate în SQL Developer, cu anteturile de coloană "Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions" şi "Ending Inventory."

Un fişier de intrare acceptabil pentru încărcarea datelor pentru acest tabel de fapte are o configuraţie similară, deoarece are aceeaşi dimensiune Pivot. Exemplu (trunchiat):

"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

Dacă dimensiunea Pivot a fişierului de intrare diferă de dimensiunea Pivot a tabelului de fapte, este returnată o eroare, iar jobul de încărcare a datelor este întrerupt.

Importul mai multor fişiere în MaxL nu este acceptat

Importul de date din mai multe fişiere în paralel, prin instrucţiunea de import MaxL cu caractere de înlocuire nu este acceptată pentru cuburile cu partiţii federative.