Querylogbestanden bevatten krachtige diagnostische informatie waarmee beheerders problemen met betrekking tot de prestaties van de query's, foutscenario's en foutieve resultaten kunnen analyseren en oplossen. Wanneer u querylogbestanden in Oracle Analytics activeert, wordt er informatie over ontleden, optimalisatie, uitvoeringsplannen, fysieke query's, overzichtsstatistieken en meer in het querylogbestand geschreven.
Querylogbestanden openen
Opmerking:
Werkmapauteurs kunnen tevens querygegevens openen zoals querytijd, servertijd en streamingtijd voor visualisatiecomponenten in hun werkmappen. Zie Querylogbestanden voor een werkmap openen aan het einde van dit onderwerp.Niveaus querylogbestand
Het logbestandsniveau stelt de details van gegenereerde logbestanden vast en de hoeveelheid.
U kunt het globale logbestandsniveau voor uw semantische model (RPD) definiëren met behulp van de eigenschap Logbestandsniveau systeem (onder Hulpprogramma's, Optie, Repository) of onder de sessievariabele.
U kunt het logbestandsniveau voor een rapport omzeilen door de variabele LOGLEVEL
toe te voegen aan de eigenschap Voorvoegsel, beschikbaar in het tabblad Geavanceerd van het rapport.
Om te garanderen dat u volledige logbestanden krijgt door cachetreffers te voorkomen, kunt u de variabele DISABLE_CACHE_HIT=1
met LOGLEVEL
opnemen.
LOGLEVEL
) liggen tussen 0 en 7.
LOGLEVEL=0
betekent dat het loggen is gedeactiveerd.LOGLEVEL=7
is het hoogste logbestandsniveau dat met name door het ontwikkelingsteam van Oracle wordt gebruikt.LOGLEVEL=2
is geschikt voor het optimaliseren van prestaties en basiskennis.LOGLEVEL=3
is vereist voor het oplossen van problemen met databeveiligingsfilters op rijniveau.Afhankelijk van het logbestandsniveau bevatten querylogbestanden informatie over de query, waaronder de logische aanvraag, het navigatie- en uitvoeringsplan, de gegenereerde fysieke query, de uitvoeringstijd, rijen en bytes die met verschillende uitvoeringsnoden zijn opgehaald en cachegerelateerde informatie.
Beheerders kunnen querylogbestanden extraheren via de pagina SQL-instructie geven in de console, door de query uit te voeren met de passende instellingen voor het LOGLEVEL
en de variabelen.
Een querylogbestand lezen
Op de pagina Sessies en querylogbestanden staan alle query's en sessies die momenteel actief zijn. Beheerders kunnen deze pagina vanuit de console openen.
Elke invoer op de pagina geeft toegang tot het querylogbestand voor een bepaalde query op het ingestelde niveau (dat wil zeggen, op het semantisch, sessie- of rapportniveau).
Elke aanvraag heeft een unieke requestid
in Oracle Analytics.
Logische SQL-query
Dit een voorbeeld van een logische SQL-query in Oracle Analytics.
Dit zijn enkele veelgebruikte variabelen die u mogelijk in een logische SQL-aanvraag tegenkomt.
QUERY_SRC_CD
: de oorsprong van de query, zoals de prompt, de visualisatie van gegevens, het rapport, de SQL-instructie enzovoort.SAW_SRC_PATH
: als de query wordt opgeslagen, is dit het pad naar de query in de catalogus.SAW_DASHBOARD
: als de query in een dashboard is opgenomen, is dit het pad naar het dashboard in de catalogus.SAW_DASHBOARD_PG
: de naam van de dashboardpagina.Logische aanvraag
De logische aanvraag is de vertaling van een query van de presentatielaag naar het bedrijfsmodel en de toewijzingslaag, nadat er mogelijk beveiligingsfilters zijn toegevoegd.
Oracle Analytics besluit op basis van de logische aanvraag of de query een bestaande cache treft of uit de database moet worden opgehaald.
Uitvoeringsplan
Het uitvoeringsplan is de transformatie van de werkelijke logische aanvraag in een geoptimaliseerd plan voor de uitvoering. Hieronder valt een verzendingsplan voor elke bewerking en of het in de database of in Oracle Analytics wordt uitgevoerd. Wanneer een bewerking in Oracle Analytics wordt uitgevoerd, geeft het querylogbestand [for database 0:0,0]
aan.
Tijdens de uitvoering doorloopt Oracle Analytics exact deze boomstructuur. In gedetailleerde logbestanden is informatie over de verwerkte rijen op elke node van de uitvoeringsboomstructuur beschikbaar.
Fysieke of database-aanvragen
Op basis van het uitvoeringsplan genereert Oracle Analytics een fysieke SQL die op de opgegeven database wordt uitgevoerd. Er kunnen een of meer aanvragen naar een of meer databases worden verzonden.
Voor elke fysieke aanvraag die naar de database wordt verzonden, is er een logbestand voor het aantal opgehaalde rijen en bytes.
Wanneer er meerdere query's zijn, kunt u de query-ID (in dit voorbeeld 1914627
) gebruiken om de exacte query te gebruiken die is gelogd in de sectie Sending query to the database
. Zo kunt u de query toewijzen met opgehaalde rijen wanneer er meerdere database-aanvragen zijn.
Eén rapport kan meerdere query's naar een of meer databases verzenden, afhankelijk van de definitie van de rapportstructuur en het semantische model. In dit querylogbestand werden er bijvoorbeeld 3 fysieke query's naar de database verzonden.
Het logbestand geeft soortgelijke verwerkte informatie over rijen voor alle nodes in het uitvoeringsplan. Tot slot: de rijen die naar de client worden verzonden, worden gelogd.
Het logbestand bevat ook een uiteindelijk overzicht van statistieken, waaronder de totale uitvoeringstijd. U kunt deze tijd correleren om prestatieproblemen te analyseren en onderzoeken.
Overzichtsstatistieken
Overwegingen voor querylogbestanden
Activiteit met één thread Bij ongunstige omstandigheden kunt u prestatieproblemen ervaren bij logbestandsniveaus van hoger dan 2.
De weergegeven en berekende tijden gelden voor wanneer invoer naar het logbestand wordt geschreven en dit is meestal het moment waarop ze plaatsvinden (oftewel de activiteit waarmee de logbestandinvoer is gestart). Tenzij er andere knelpunten zijn die invloed hebben op het loggen.
Querylogbestanden zijn bedoeld voor het stellen van een diagnose en niet voor het verzamelen van gebruiksgegevens. Als u meer wilt weten over het bijhouden van gebruik, raadpleegt u Gebruik controleren.
Querylogbestanden voor een werkmap openen
Alleen beheerders kunnen logbestanden vanuit de pagina Sessies en querylogbestanden in de console openen. Inhoudauteurs kunnen echter via het menu Ontwikkelaar logbestandinformatie openen voor visualisatiequery's in hun werkmappen. Dit is een nuttig hulpprogramma voor auteurs die problemen met hun queryprestaties willen oplossen. Gebruikers die het prestatiehulpprogramma voor werkmappen willen openen (de menu-optie Ontwikkelaar), moeten Ontwikkelaarsopties activeren in het menu Geavanceerdonder Mijn profiel inschakelen.
Na de activering wordt de menu-optie Ontwikkelaar in het werkmapmenu weergegeven.
Met de optie Ontwikkelaar kunnen gebruikers direct verschillende logbestanden weergeven en analyseren voor visualisatie op een canvas. Onder het canvas verschijnt een nieuw venster met verschillende tabbladen voor elk type informatie. Logbestanden worden niet standaard ingevuld of vernieuwd bij het uitvoeren van de visualisatie.
Selecteer de visualisatie die u wilt analyseren en klik op Vernieuwen om de logbestanden te genereren. Na het vernieuwen worden er verschillende typen informatie over de visualisatiedisplays weergegeven en kunt u de logbestandsinformatie voor de specifieke visualisatie analyseren. Als u meerdere visualisaties wilt analyseren, moet u ze afzonderlijk vernieuwen en beurtelings analyseren.
Opmerking:
Het menu Ontwikkelaar is alleen beschikbaar voor werkmappen. Voor klassieke analyses en dashboards kunt u querylogbestanden via de pagina Sessies en querylogbestanden openen.