Dimensies opbouwen en gegevens laden met behulp van een regelbestand

Met behulp van een regel kunt u een dimensie opbouwen en gegevens laden vanuit een tekstbestand of een ander plat bestand.

Voordat u begint, hebt u de volgende resources nodig.

Toegang tot een Essbase instance
Als u geen plat bestand gebruikt als bron van gegevens, hebt u een verbinding en gegevensbron nodig die in Essbase zijn ingesteld op applicatieniveau.
Voorbeeldbestand met dimensiemetagegevens (dim-market.txt) gedownload naar uw computer.
Voorbeeld van gegevensbestand (data-basic.txt ) gedownload naar uw computer.

Met de genoemde resources kunt u nu met behulp van een regel de taken uitvoeren die samenhangen met het opbouwen van dimensies en het laden van gegevens.

Dimensies opbouwen met behulp van een regelbestand

U kunt dimensies bewerken en toewijzen aan een Essbase structuur met behulp van een regel in plaats van handmatig lege dimensies op te bouwen in de Essbase structuureditor. In deze sectie wordt beschreven en geïllustreerd hoe u dimensies opbouwt op basis van een plat bestand met behulp van een regel.

Wanneer u dimensies wilt opbouwen met behulp van een regel, definieert u de hiërarchische structuur van dimensies en metagegevens van onderdelen. U kunt een of meer dimensies maken met behulp van één regelbestand, of één regelbestand per dimensie gebruiken.

U kunt een dimensie opbouwen om dimensies toe te voegen of te wijzigen, maar u kunt de opgebouwde dimensie niet gebruiken om een bestaande dimensie te verwijderen.

Hier wordt geïllustreerd hoe u dimensies opbouwt op basis van een plat bestand met behulp van regels. Het proces voor het laden van gegevens met behulp van SQL of streaming wordt in andere onderwerpen beschreven.

Open het gedownloade bestand met metagegevens voor de dimensie, dim-market.txt, in een editor voor opgemaakte tekst. U ziet dat het bestand geen koptekstrij bevat en dat het bestandsscheidingsteken een komma is.
Meld u aan bij de webinterface van Essbase.
Vouw op de beginpagina de applicatie 'Voorbeeld' uit en selecteer de kubus 'Basis'.
Maak nu het regelbestand.
1. Start het inspectieprogramma vanuit het menu Acties, rechts van de kubus.
2. Klik op Scripts en vervolgens op Regels. De regeleditor wordt geopend met de huidige gedefinieerde regels.
3. Klik op Maken en selecteer Dimensie opbouwen (op index gebaseerd) om de regel voor het opbouwen van dimensies te definiëren. Een op een index gebaseerde regel voor het opbouwen van dimensies verwijdert de onderlinge afhankelijkheid van velden en maakt het mogelijk de velden in elke volgorde weer te geven.
4. Voer in het dialoogvenster 'Nieuwe regel' Dim_market1 in als de naam van het regelbestand.
5. Selecteer onder 'Gegevens bekijken' de optie Bestand voor invoer uit een plat bestand.
6. Klik op het pictogram 'Bladeren', blader naar het bestand dim-market.txt dat u hebt gedownload en klik op Openen om het te selecteren.
7. Zoals u eerder hebt gezien, bevat de eerste rij van het platte bestand geen koptekstwaarden. Als het selectievakje Koptekstrij is ingeschakeld, schakelt u het uit.
8. Stel Scheidingsteken in op 'Komma', overeenkomstig de bestandsindeling.
9. Klik op Doorgaan.
  U kunt nu een voorbeeld van de dimensiestructuur bekijken in de regeleditor, met de kolommen weergegeven op basis van het platte invoerbestand.
De werkbalk rechtsboven in de regeleditor toont de algemene opties voor een regel. U kunt hier de eigenschappen of gegevensbron wijzigen en de resultaten bekijken. De werkbalk aan de linkerkant van de regeleditor toont de veldopties voor de regel.
Nu kunt u de regel instellen en bewerken op de pagina 'Regeleditor'.
1. Klik op de voorbeeldpagina voor de nieuwe regel in het eerste veld (de eerste kolom) op Dimensie en selecteer de dimensie Market. De dimensie Market wordt toegewezen aan alle velden.
2. Klik onder 'Market' in het eerste veld op Type en selecteer het dimensietype Bovenliggend.
  Het bronbestand voor deze regel heeft een indeling met boven- en onderliggende niveaus. Als u een bronbestand op basis van generaties had, zou u het eerste veld kunnen instellen op Generatie. In dat geval wordt het generatienummer op 2 gezet, omdat Generatie 1 standaard de dimensie zelf is.
3. Stel de overige velden in:
  Stel het type van veld 2 in op Onderliggend.
  
  Stel het type van veld 3 in op Eigenschap, en het vak 'Bovenliggend-onderliggend' op de derde rij op Onderliggend.
  
  Stel het type van veld 4 en 5 in op UDA, en het vak 'Bovenliggend-onderliggend' op de derde rij op Onderliggend.
  
  Stel het type van veld 6-9 respectievelijk in op Alias, de vakken 'Alias' op de derde rij op ChineseNames, JapaneseNames, RussianNames en GermanNames, en de vakken op de vierde rij op Onderliggend.
  
  Stel het type van veld 10 in op Kenmerkonderdeel, het vak op de derde rij op Populatie, en het vak op de vierde rij op Onderliggend.
  
  Het veld 'Dimensie' is meestal ingesteld op 'Generatie', 'Bovenliggend' of 'Onderliggend'. Als de gewenste dimensienaam niet voorkomt in het menu, klikt u op Dimensies (op de algemene werkbalk), voegt u de dimensienaam toe en klikt u op Toevoegen en OK.
4. Controleer nu de veldeigenschappen voor een veld. Selecteer de laatste veldkolom, Populatie. Open via de werkbalk 'Veldopties' het tabblad Eigenschappen en controleer of de optie 'Hoofdlettergebruik' is ingesteld op Geen bewerking > Dat betekent dat tekst in hoofdletters en kleine letters hier niet anders wordt behandeld dan in het brontekstbestand.
5. Klik in de algemene werkbalk op het tabblad Bron als u het gegevensbronbestand wilt wijzigen. Controleer op het tabblad 'Bestandseigenschappen' of het scheidingsteken is ingesteld op Komma.
6. Wanneer u klaar bent met het definiëren van de regel, klikt u op Verifiëren op de algemene werkbalk om de regelsyntaxis te valideren.
7. Klik op Opslaan en sluiten.
8. Klik op Vernieuwen. U ziet dat de gemaakte regel nu wordt vermeld in het deelvenster 'Regels' van het tabblad 'Scripts'. U kunt uw regel bewerken door op de regelnaam te klikken en vervolgens op Doorgaan te klikken.
  Vanuit het menu Acties voor een vermelde regel kunt u de build desgewenst kopiëren, hernoemen of exporteren naar een JSON-bestand voor probleemoplossingsdoeleinden. Klik op Sluiten om terug te gaan naar de beginpagina.
Vervolgens maakt u een taak om de dimensie op te bouwen met behulp van de regel en voert deze taak uit.
1. Selecteer op de beginpagina Taken en vervolgens Nieuwe taak.
2. Selecteer Dimensie opbouwen.
3. Selecteer in het dialoogvenster Dimensie opbouwen in de lijst Applicatie de applicatie Sample.
4. Selecteer in de lijst Database de kubus Basic. Het laden kan enige tijd duren.
5. Selecteer in de lijst Script de regel voor het opbouwen van dimensies die u hebt gemaakt, Dim_market1.rul.
6. Selecteer voor Laadtype de optie Bestand.
7. Selecteer het platte dimensiegegevensbestand Dim_Market in de lijst Gegevensbestand. Dit bestand bevindt zich in de map Sample, Basic.
8. Selecteer in de lijst Opties voor herstructureren de optie Invoergegevens behouden voor de gegevens u wilt behouden.
  
  Als u de verbinding wilt verbreken voor andere gebruikers die met de kubus Sample, Basic zijn verbonden om de dimensie direct te kunnen opbouwen, selecteert u Opbouwen van dimensie afdwingen.
  
  Voor gegevens op eindnodeniveau worden alleen waarden op niveau 0 behouden. Gebruik deze optie als alle gegevens die zijn vereist voor de berekening zich in onderdelen op niveau 0 bevinden. Voor invoergegevens worden alleen blokken behouden die gegevens bevatten die worden geladen. Geen van beide opties is van toepassing op databases voor geaggregeerde opslag.
9. Klik op OK. De taak voor het opbouwen van de dimensie wordt uitgevoerd.
10. Klik op de pagina Taken op Vernieuwen om de taak te volgen.
11. Wanneer de taak voltooid is, klikt u op het menu Acties voor de uitgevoerde taak en selecteert u Taakdetails om de status van de opbouwtaak te controleren.
12. Open op de beginpagina van Applicaties rechts van de kubus Basic in de applicatie Sample Acties en vervolgens Structuur om de dimensiehiërarchie te verifiëren. In Acties, Database, Inspecteren kunt u ook de gemaakte generatienamen onder het dimensietabblad zien. Sluit de weergave af wanneer u klaar bent.
U hebt nu een dimensie opgebouwd met behulp van een regel.

Gegevens laden met behulp van een regelbestand

Met regels kunt u gegevenswaarden extraheren, transformeren en in een Essbase kubus laden. De brongegevenswaarden kunnen het volgende bevatten:

Gegevenswaarden
Onderdeelnamen, aliassen en formules
Generatie- en niveaunamen
Gegevensopslageigenschappen
Kenmerken en door de gebruiker gedefinieerde kenmerken

Wanneer u een Essbase kubus opbouwt, worden gegevensbestanden en regelbestanden voor het laden van gegevens gemaakt in de kubusdirectory. U kunt ook gegevens en regels van een ondersteunde lokale versie van Essbase gebruiken.

Zowel de opmaak voor draaigegevens als voor bestanden zonder opmaak in rijensets wordt ondersteund.

Wanneer u gegevens laadt, worden SUM-, MIN-, MAX-, AVG- en COUNT-bewerkingen ondersteund in gegevenskolommen in alle rijen. Hiermee worden big-datacases ondersteund waarin Essbase kubussen worden gemaakt met onderdelen op het hoogste niveau. U kunt vanuit Essbase een drill-through uitvoeren om de gegevens op een gedetailleerder niveau te bekijken.

Hier wordt geïllustreerd hoe u gegevens laadt uit een plat bestand met behulp van regels. Het proces voor het laden van gegevens met behulp van SQL of streaming wordt in andere onderwerpen beschreven.

Open het gedownloade gegevensbestand, data-basic.txt, in een editor voor opgemaakte tekst. U ziet dat er geen koprij is en dat het bestandsscheidingsteken een komma is.
Meld u aan bij de webinterface van Essbase.
Vouw op de beginpagina de applicatie 'Voorbeeld' uit en selecteer de kubus 'Basis'.
Maak nu de laadregel.
1. Start het inspectieprogramma vanuit het menu Acties, rechts van de kubus 'Basic'.
2. Selecteer het tabblad Scripts en vervolgens Regels. De regeleditor wordt geopend met de huidige gedefinieerde regels.
3. Klik op Maken en selecteer Gegevens laden om de regel voor het laden van gegevens te definiëren.
4. Voer in het dialoogvenster Nieuwe regel Data_basic1 in als de naam van de regel.
5. Voer Eenheden in als de gegevensdimensie.
6. Selecteer onder 'Gegevens bekijken' de optie Bestand voor invoer uit een plat bestand.
7. Klik op het pictogram 'Bladeren'. Blader naar het bestand data-basic.txt dat u hebt gedownload en klik op Openen om het te selecteren.
8. Zoals u eerder hebt gezien, bevat de eerste rij van het platte bestand geen koptekstwaarden. Als het selectievakje Koptekstrij is ingeschakeld, schakelt u het uit. Wanneer de koptekstrij aanwezig is, worden de kolommen automatisch toegewezen.
9. Selecteer Komma als de waarde voor het Scheidingsteken, overeenkomstig de bestandsindeling.
10. Klik op Doorgaan.
  U kunt nu het voorbeeld van de gegevens zien in de regeleditor, op basis van het ingevoerde platte bestand.
Met de werkbalk 'Algemene opties' rechtsboven in de regeleditor kunt u bestandseigenschappen of de gegevensbron wijzigen en de resultaten bekijken in de regeleditor. Met de werkbalk 'Veldopties' aan de linkerkant van de regeleditor kunt u velden in de regel toewijzen.

Omdat het invoerbestand geen koppen bevatte, moet u alle kolommen toewijzen aan de juiste dimensies en onderdelen.
Nu kunt u in de regeleditor de regelvelden instellen.
1. Klik op het dropdownmenu Maken en begin met het instellen van de veldnamen.
  Stel veld (kolom) 1 in op Product.
  
  Stel veld 2 in op Market.
  
  Stel veld 3 in op Year.
  
  Stel veld 4 in op Scenario.
  
  Stel veld 5 in op Sales.
  
  Stel veld 6 in op COGS.
  
  Stel veld 7 in op Marketing.
  
  Stel veld 8 in op Payroll.
  
  Stel veld 9 in op Misc.
  
  Stel veld 10 in op Opening Inventory.
  
  Stel veld 11 in op Additions.
  
  Alle dimensies moeten zijn vertegenwoordigd in de gegevenslaadregel voordat er gegevens kunnen worden geladen.
2. Wanneer u klaar bent met het definiëren van de regel met algemene opties en veldopties, klikt u op Verifiëren op de algemene werkbalk om de syntaxis te valideren. Klik vervolgens op Sluiten.
3. Nadat de syntaxis is gevalideerd, klikt u op Opslaan en sluiten.
4. Klik op Vernieuwen. U ziet dat de gemaakte regel nu wordt vermeld in het deelvenster 'Regels' van het tabblad 'Scripts'. Nu kunt u uw regel bewerken door op de regelnaam te klikken en vervolgens op Doorgaan te klikken.
5. Klik op Sluiten om terug te gaan naar de beginpagina 'Applicaties'.
Maak vervolgens een taak om de gegevens te laden met behulp van de regel.
Selecteer op de beginpagina Taken en vervolgens Nieuwe taak.
1. Selecteer Gegevens laden.
2. Selecteer in het dialoogvenster Gegevens laden in het menu Applicatie de applicatie Sample.
3. Selecteer in de lijst Database de kubus Basic.
4. Selecteer in de lijst Script de regel voor het laden van gegevens die u hebt gemaakt, Data_market1.rul.
5. Selecteer voor Laadtype de optie Bestand.
6. Selecteer het bestand Data_Basic1 in de lijst Gegevensbestand Dit bestand bevindt zich in de map Sample \Basic.
7. Optioneel: schakel het selectievakje Afbreken bij fout in als u wilt dat het laden stopt wanneer een fout optreedt.
8. Klik op OK. De taak voor het laden van gegevens wordt uitgevoerd.
9. Klik op de pagina 'Taken' op Vernieuwen om de taakstatus te controleren.
Controleer als de taak is voltooid of de invoerrecords zijn verwerkt en geladen.
1. Klik op de beginpagina 'Applicaties' op Acties, rechts van de kubus 'Basic' in de applicatie 'Sample'.
2. Selecteer Taakdetails om de details van de taak voor het laden van gegevens te controleren.
3. Als u klaar bent, klikt u op Sluiten.
4. Ga weer naar de beginpagina 'Applicaties' en open via Acties het inspectieprogramma voor de kubus 'Sample'.
5. Selecteer Statistieken om de resulterende statistieken voor de kubus 'Basic' te zien.
U hebt nu gegevens geladen met behulp van een regel.