Dataload für föderierte Partition

Von einem Essbase-Cube mit föderierter Partition können Sie Daten in Ihre Faktentabelle in Autonomous Data Warehouse laden. Zuvor müssen Sie Essbase mit OCI Object Storage integrieren und DBMS_CLOUD-Zugangsdaten mit dem Skript configure-dbms-writeback konfigurieren.

Essbase mit OCI Object Storage integrieren

Um Daten aus einem Cube mit föderierter Partition in Ihre Faktentabelle in Autonomous Data Warehouse zu laden, verwendet Essbase das DBMS_CLOUD-Package, das mit Autonomous Database verfügbar ist.

Für den Zugriff auf das DBMS_CLOUD-Package müssen Sie zunächst die Integration von Essbase mit OCI Object Storage auswählen, wenn Sie den Oracle Essbase-Stack aus Oracle Cloud Marketplace bereitstellen.

Die vollständigen Details dazu finden Sie unter Essbase aus Marketplace für föderierte Partitionen bereitstellen.

Zugangsdaten für Dataload einrichten

Bevor ein Dataload-Vorgang über Essbase zu Autonomous Data Warehouse ausgeführt werden kann, müssen Sie bestimmte Workflowschritte befolgen, um Cloud-Zugangsdaten für föderierte Partitionen zu aktivieren.

Benutzertypen beim Workflow für Dataload-Zugangsdaten

Benutzer mit den folgenden Zugriffstypen können am erforderlichen Workflow zum Einrichten eines Cubes mit föderierter Partition für Dataloads beteiligt sein. Diese Rollen können in Ihrer Organisation separat sein (sodass mehrere Personen am Workflow zusammenarbeiten müssen) oder kombiniert sein (eine Person verfügt über den gesamten erforderlichen Zugriff).

Benutzertyp	Rolle im Workflow
SSH-Benutzer	Kann über die Befehlszeile des Betriebssystems als Benutzer opc auf die in Oracle Cloud Infrastructure bereitgestellte Essbase-Instanz zugreifen. (Möglicherweise dieselbe Person, die Essbase als Stack auf OCI bereitgestellt hat.)
DB-Benutzer	Kennt den Schemanamen und das Kennwort von Autonomous Data Warehouse, dasselbe Schema und Kennwort wie zum Erstellen der Essbase-Verbindung zu Oracle Database (eine Voraussetzung vor dem Erstellen der föderierten Partition).
OCI-Benutzer	Kann auf die OCI-Konsole, einschließlich Objektspeicher-Bucket für den Essbase-Katalog, zugreifen.
DB-Admin	Kennt den Schemanamen und das Kennwort des Oracle Database-Administrators.
Essbase-Admin	Der Essbase-Systemadministrator. Kann der anfängliche Essbase-Administrator sein, der vom Identitätsdomainadministrator erstellt wurde (der auch der OCI-Benutzer sein kann) oder ein anderer Essbase-Systemadministrator, der nach Abschluss des Essbase-Deployments erstellt wurde.
Essbase-Anwendungsmanager	Der Manager/Eigentümer einer Essbase-Anwendung, der nach Abschluss des Essbase-Deployments erstellt wird.

Workflow für Dataload-Zugangsdaten

Die folgenden Workflowschritte müssen für jedes Datenbankschema ausgeführt werden, das Sie für föderierte Partitionen verwenden.

OCI-Benutzer: Befolgen Sie die Anweisungen unter Essbase aus Marketplace für föderierte Partitionen bereitstellen, umEssbase im OCI-Mandanten mit den jeweiligen Optionseinstellungen für föderierte Partitionen bereitzustellen.
DB-Benutzer, Essbase-Admin oder Essbase-Anwendungsmanager: Melden Sie sich bei der Essbase-Weboberfläche an, und erstellen Sie eine Verbindung zu Autonomous Data Warehouse, wie unter Verbindung für föderierte Partitionen erstellen beschrieben.
DB-Benutzer, Essbase-Admin oder Essbase-Anwendungsmanager: Erstellen Sie die föderierte Partition, wie unter Föderierte Partition erstellen beschrieben.
OCI-Benutzer: Generieren Sie aus Ihrem Benutzerprofil in der OCI-Konsole ein Authentifizierungstoken, und kopieren Sie es. Geben Sie dieses Token und Ihren Benutzernamen an den SSH-Benutzer weiter.

Siehe Authentifizierungstoken abrufen.
SSH-Benutzer: Führen Sie das Dataload-Vorbereitungsskript aus, das in der Essbase-Instanz auf OCI verfügbar ist. Sie müssen das Skript nur einmal pro Datenbankschema in Autonomous Data Warehouse ausführen.

Beispiel:
1. Wechseln Sie zum Benutzer oracle.
```
sudo su oracle
```
2. Navigieren Sie zum Speicherort des Skripts.
```
cd /u01/vmtools/config/adwwb_dbms
```
3. Führen Sie das Skript aus.
```
./configure-dbms-writeback.sh
```
  Hinweis:
  Um Skriptoptionen anzuzeigen, führen Sie das Skript mit dem Argument -h oder --help aus. Syntax: ./configure-dbms-writeback.sh [--help | -h]
  
  Hinweis:
  Führen Sie das Skript optional mit der Option "vault" aus. Mit dieser Option verwendet das Skript im Vault gespeicherte DB-Admin-Zugangsdaten per Zugriff über die OCID, anstatt Sie zum Eingeben des Kennworts aufzufordern. Syntax: ./configure-dbms-writeback.sh [--vault | -V]
4. Wenn Sie dazu aufgefordert werden, geben Sie die erforderlichen Informationen ein:
  - Kennwort für DB-Admin, wenn Sie das Skript nicht mit der Option "vault" ausgeführt haben. Da das Kennwort geschützt ist, wird der Text beim Eingeben in der Eingabeaufforderung nicht angezeigt.
  - Benutzername und Kennwort für DB-Benutzer. Da das Kennwort geschützt ist, wird der Text beim Eingeben in der Eingabeaufforderung nicht angezeigt.
  - Benutzername und Authentifizierungstoken für OCI-Benutzer. Geben Sie die vollständige Zeichenfolge zur Benutzeridentifizierung an. Diese Zeichenfolge finden Sie, indem Sie in der OCI-Konsole oben rechts auf das Profilsymbol klicken, um einen Überblick über das Benutzerprofil anzuzeigen. Kopieren Sie die vollständige Zeichenfolge, die unter Profil und über Mandant angezeigt wird.
Das Skript erstellt die erforderlichen Cloud-Zugangsdaten und speichert diese im Datenbankschema. Sie müssen das Skript nicht erneut ausführen, wenn Sie OCI, Essbase oder Essbase-Anwendungen neu starten.

Jetzt können Sie Daten über Essbase laden, um die Faktentabelle in Autonomous Data Warehouse zu aktualisieren.

Hinweis:

SSH-Benutzer: Wenn das im Dataload-Vorbereitungsskript verwendete Authentifizierungstoken des OCI-Benutzers keinen Zugriff mehr auf den Objektspeicher-Bucket für den Essbase-Katalog hat, müssen Sie die Workflowschritte mit einem anderen OCI-Benutzer wiederholen, der die unter Benutzertypen beim Workflow für die Dataload-Vorbereitung genannten Anforderungen erfüllt.

Weitere Hinweise zum Dataload für föderierte Partitionen

Speicherort für die Quelldatendatei

Bevor Sie einen Dataload über Essbase in die Faktentabelle ausführen, empfiehlt Oracle, die Datendatei in den Essbase-Server hochzuladen. Clientseitige Dataloads werden unterstützt, dauern aber länger.

Tools für Dataload ohne Essbase

Wenn Sie keine Daten über Essbase in Autonomous Data Warehouse laden müssen, können Sie Datentools in Autonomous Database verwenden, um Daten in die Faktentabelle zu laden und andere Managementaufgaben auszuführen. Stellen Sie allerdings sicher, dass die Cube-Modellstruktur und die Faktentabelle synchron bleiben (siehe Vorsichtsmaßnahmen zu Metadaten für föderierte Partitions-Cubes).

Für DBMS formatierte Datendateien

Das Laden von Essbase-formatierten Datenexportdateien in Cubes mit föderierten Partitionen kann viel Zeit in Anspruch nehmen. Um Dataloads zu optimieren, verwenden Sie eine DBMS-formatierte Quelldatei. Diese können Sie mit dem Berechnungsbefehl DATAEXPORT in der DataExportCSVFormat-Option erstellen. Dateien im CSV-Format können schneller geladen werden, da sie den Formatoptionen des DBMS_CLOUD-Packages für Quelldateien entsprechen.

Pivot-Dimension in Faktentabelle und Dataload-Eingabequelle

Die in Dataload-Eingabedateien verwendete Pivot-Dimension muss mit der Pivot-Dimension der Faktentabelle identisch sein.

Beispiel: In der folgenden Faktentabelle ist die Pivot-Dimension die Measures-Dimension (Sales, COGS, Margin usw).

Faktentabelle mit denormalisierten Daten und Metadaten in SQL Developer mit den Spaltenheadern "Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions" und "Ending Inventory."

Eine zulässige Dataload-Eingabedatei für diese Faktentabelle hat eine ähnliche Form, da sie dieselbe Pivot-Dimension aufweist. Beispiel (abgekürzt):

"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

Wenn die Pivot-Dimension der Eingabedatei sich von der Pivot-Dimension der Faktentabelle unterscheidet, wird ein Fehler zurückgegeben, und der Dataload-Job wird beendet.

Mehrere Importdateien in MaxL nicht unterstützt

Der parallele Datenimport aus mehreren Dateien mit einer import-MaxL-Anweisung mit Platzhalterzeichen wird für Cubes mit föderierten Partitionen nicht unterstützt.