Problemen met Genie-ruimten oplossen

Op deze pagina wordt beschreven hoe u veelvoorkomende problemen kunt oplossen bij het maken en onderhouden van Genie-ruimten.

Verkeerd begrepen bedrijfs jargon

De meeste bedrijven of domeinen hebben een specifieke afkorting die ze gebruiken om te communiceren over bedrijfsspecifieke gebeurtenissen. Als u bijvoorbeeld naar een jaar verwijst, betekent dit misschien altijd het fiscale jaar en kan dit fiscale jaar beginnen in februari of maart in plaats van januari. Om Genie in staat te stellen deze vragen natuurlijk en nauwkeurig te beantwoorden, moet u instructies opnemen die uw bedrijfsjargon expliciet toewijzen aan woorden en concepten die Genie kan begrijpen. Zie Instructies geven.

Onjuist tabel- of kolomgebruik

Als Genie gegevens probeert op te halen uit een onjuiste tabel of een analyse uitvoert op onjuiste kolommen, kunt u de gegevens op een van de volgende manieren aanpassen:

• Geef duidelijke en nauwkeurige beschrijvingen op: Controleer uw tabellen en de bijbehorende metagegevens om te controleren of de terminologie die daar wordt gebruikt, overeenkomt met de terminologie van de gebruikers in ingediende vragen. Als dat niet het geval is, verfijnt u de beschrijving of voegt u een instructie toe waarmee de terminologie die in de tabel wordt gebruikt, wordt toegewezen aan de terminologie die in de vraag wordt gebruikt.
• Voorbeeldquery's toevoegen: Geef voorbeeldquery's op die Genie kan gebruiken om te leren hoe u op bepaalde vragen kunt reageren. Zie Instructies geven.
• Verwijder tabellen of kolommen uit de ruimte: sommige tabellen bevatten mogelijk overlappende kolommen of concepten die het moeilijk maken voor Genie om te weten welke gegevens in een antwoord moeten worden gebruikt. Verwijder indien mogelijk onnodige of overlappende tabellen of kolommen. Als u kolommen wilt verbergen in de gebruikersinterface van de Genie-ruimte zonder de onderliggende gegevensobjecten te wijzigen, raadpleegt u Relevante kolommen verbergen of weergeven.

Filterfouten

Gegenereerde query's bevatten vaak een WHERE component om resultaten te filteren op basis van een specifieke waarde. Als Genie geen inzicht heeft in de gegevenswaarden, kan de WHERE component worden ingesteld om te filteren op de verkeerde waarde. Het kan bijvoorbeeld proberen om de naam 'Californië' te vinden wanneer de tabel afkortingen zoals 'CA' gebruikt.

Voor dergelijke situaties controleert u of voor relevante kolommen voorbeeldwaarden en waardewoordenlijsten zijn ingeschakeld. Als er nieuwe gegevens zijn toegevoegd aan relevante tabellen, vernieuwt u de waarden. Zie Een kennisarchief bouwen voor betrouwbaardere Genie-ruimten.

Onjuiste koppelingen

Als foreign key verwijzingen niet zijn gedefinieerd in de Unity Catalog, weet uw omgeving mogelijk niet hoe verschillende tabellen samen moeten worden gevoegd.

Probeer een of meer van de volgende oplossingen te implementeren:

• Definieer waar mogelijk vreemde sleutelverwijzingen in uw Unity Catalog. Zie CONSTRAINT clausule.
• Als de refererende sleutelrelaties van uw tabellen niet zijn opgegeven in Unity Catalog, definieert u joinrelaties in het kennisarchief van uw Genie-ruimte. Deze strategie is handig voor complexere joinscenario's, zoals self-joins, of als u niet over voldoende machtigingen beschikt om de onderliggende tabellen te wijzigen. Zie Koppelingsrelaties definiëren.
• Geef voorbeeldquery's op waarbij u tabellen op standaard manieren samenvoegt.

Als geen van deze oplossingen het probleem oplost, voegt u de tabel vooraf aan een weergave toe en gebruikt u deze als invoer voor de ruimte.

Kolomopmerkingen worden niet gesynchroniseerd van vreemde tabellen

Azure Databricks beheert de metagegevens, gegevens of semantiek voor schrijfbewerkingen naar refererende tabellen niet. Afhankelijk van de brontabel zijn opmerkingen mogelijk niet toegankelijk vanuit Azure Databricks. Als u opmerkingen beschikbaar wilt maken, raadt Azure Databricks u aan een van de volgende handelingen uit te voeren:

• Bewerk kolommetagegevens in de gebruikersinterface van de Genie-ruimte. Bewerkte metagegevens zijn alleen van toepassing op de Genie-ruimte waar deze is geschreven. Zie Metagegevens van kolom bewerken.
• Maak een materiële weergave op basis van federatieve tabellen. U kunt opmerkingen toevoegen en bewerken in een gerealiseerde weergave zoals u dat zou doen in een beheerde tabel. U kunt deze weergave opnieuw gebruiken in meerdere Genie-ruimten. Zie Gegevens uit refererende tabellen laden met gerealiseerde weergaven voor meer informatie over het laden van gegevens uit refererende tabellen naar een gerealiseerde weergave. Zie Gerealiseerde weergaven voor meer informatie over het werken met gerealiseerde weergaven.

Problemen met metrische berekeningen

De manier waarop metrische gegevens worden berekend en samengevoegd, kan bijzonder complex zijn en veel zakelijke details omvatten die uw vakgebied niet begrijpt. Dit kan leiden tot onjuiste rapportage.

Probeer een of meer van de volgende oplossingen te implementeren:

• Definieer uw metrische gegevens als SQL-expressies in het kennisarchief. SQL-expressies bieden herbruikbare, nauwkeurige definities voor metingen, filters en dimensies die Genie consistent kan toepassen. Zie SQL-expressies definiëren.
• Als uw metrische gegevens worden samengevoegd vanuit basistabellen, geeft u voorbeelden van SQL-query's op die elke samengetelde waarde berekenen.
• Als uw metrische gegevens vooraf zijn berekend en zich in geaggregeerde tabellen bevinden, moet u dit uitleggen in tabelopmerkingen. Geef geldige aggregaties op voor elke metrische waarde als de metrische gegevens in die tabel verder kunnen worden samengeteld.
• Als de SQL die u probeert te genereren erg ingewikkeld is, probeer dan databaseweergaven te maken die al uw metrische gegevens voor uw omgeving hebben samengevoegd.

Onjuiste berekeningen op basis van tijd

Genie kan mogelijk niet altijd de tijdzone afleiden die wordt weergegeven in de gegevens of de tijdzone waarin uw analyse moet worden uitgevoerd, tenzij u expliciet aanvullende richtlijnen verstrekt.

Voeg meer expliciete instructies toe over de oorspronkelijke brontijdzone, de conversiefunctie en de doeltijdzone. In de volgende voorbeelden ziet u hoe u de algemene instructies voor betrouwbaardere tijdzoneconversies kunt wijzigen:

• Altijd tijden converteren naar een specifieke tijdzone: in dit voorbeeld wordt ervan uitgegaan dat de tijdstempel van de bron UTC is en dat u resultaten in de America/Los_Angeles tijdzone wilt opnemen. Voeg het volgende toe aan de instructies en vervang <timezone-column> door de juiste kolomnaam.
  • Tijdzones in de tabellen bevinden zich in UTC.
  • Converteer alle tijdzones met behulp van de volgende functie: convert_timezone('UTC', 'America/Los_Angeles', <timezone-column>).
• Converteer niet-UTC-datum/tijd-notaties naar UTC: Als de standaardtijdzone van de werkruimte is UTC maar gebruikers in Los Angeles vandaag moeten verwijzen naar een specifieke set records, voegt u het volgende toe aan de algemene instructies van de ruimte:
  • Als u vandaag wilt verwijzen, gebruikt u date(convert_timezone('UTC', 'America/Los_Angeles', current_timestamp())).

Zie convert_timezone functie voor meer informatie en syntaxis.

Instructies negeren

Zelfs als u uw tabellen en kolommen in commentaar hebt uitgelegd en algemene instructies hebt gegeven, wordt uw omgeving mogelijk nog steeds niet correct gebruikt.

Probeer een of meer van de volgende strategieën:

• Geef voorbeeldquery's op die uw tabellen correct gebruiken. Voorbeeldquery's zijn vooral effectief om uw omgeving te leren hoe u uw gegevens kunt gebruiken.
• Verberg irrelevante kolommen in de Genie-ruimte. Zie Relevante kolommen verbergen of weergeven.
• Maak weergaven van uw tabellen die een eenvoudigere weergave van uw gegevens bieden.
• Bekijk uw instructies en probeer de ruimte te concentreren door irrelevante tabellen of instructies te verwijderen.
• Probeer een nieuwe chat te starten. Eerdere interacties kunnen invloed hebben op de reacties van Genie in een bepaalde chat, maar het starten van een nieuwe chat geeft u een leeg startpunt voor het testen van nieuwe instructies.

Prestatieproblemen

Wanneer Genie uitzonderlijk lange query's of tekstreacties moet genereren, kan het lang duren om te reageren of zelfs een time-out tijdens de denkfase.

Probeer een of meer van de volgende acties om de prestaties te verbeteren:

• Controleer de querygeschiedenis om langzame queries te identificeren. Veel prestatieproblemen kunnen worden opgelost door de gegenereerde SQL-query's te optimaliseren in plaats van de genie-ruimteconfiguratie te wijzigen. Bekijk de uitvoeringstijden van de query en queryplannen in de querygeschiedenis van uw SQL Warehouse om knelpunten en mogelijkheden voor optimalisatie te identificeren.
• Gebruik betrouwbare middelen of weergaven om complexe query's te encapsuleren. Zie Gebruik van vertrouwde assets in AI/BI Genie-ruimten.
• Verminder waar mogelijk de lengte van uw voorbeeldquery's voor SQL.
• Start een nieuwe chat als Genie trage of mislukte reacties begint te genereren.

Onbetrouwbare reacties op bedrijfskritieke vragen

Gebruik vertrouwde assets om geverifieerde antwoorden te geven op specifieke vragen die gebruikers verwachten te stellen. Zie Gebruik van vertrouwde assets in AI/BI Genie-ruimten.

Waarschuwing voor tokenlimiet

Tokens zijn de basiseenheden van tekst die Genie gebruikt om taal te verwerken en te begrijpen. Tekstinstructies en metagegevens in een Genie-ruimte worden geconverteerd naar tokens. Als uw ruimte de tokenlimiet nadert, wordt er een waarschuwing weergegeven. Genie gebruikt contextfilters om prioriteit te geven aan de tokens die het meest relevant zijn voor een vraag. Hoewel reacties nog steeds moeten worden gegenereerd wanneer er een waarschuwing wordt weergegeven, kan de kwaliteit worden verminderd als belangrijke context wordt gefilterd. Wanneer de tokenlimiet wordt overschreden, kunt u geen berichten meer verzenden of ontvangen in de ruimte Genie.

Houd rekening met de volgende procedures om het aantal tokens te verminderen:

• Overbodige kolommen verwijderen: onnodige kolommen in uw tabellen kunnen aanzienlijk bijdragen aan tokengebruik. Maak indien mogelijk weergaven om redundante of niet-essentiële velden uit te sluiten van uw onbewerkte tabellen. U kunt overbodige kolommen ook verbergen in een Genie-ruimte. Zie Relevante kolommen verbergen of weergeven.
• Stroomlijn kolombeschrijvingen: hoewel kolombeschrijvingen belangrijk zijn, vermijdt u het dupliceren van informatie die al door kolomnamen wordt overgebracht. Als een kolom bijvoorbeeld een naam account_nameheeft, kan een beschrijving zoals 'de naam van uw account' overbodig zijn en kunnen worden weggelaten.
• Bewerk kolommetagegevens in de Genie-ruimte: Zie Kolommetagegevens bewerken voor meer informatie over het bewerken van beschrijvingen en het opgeven van synoniemen in kolommetagegevens.
• Voorbeeld SQL-query's opschonen: Neem een breed scala aan voorbeelden van SQL-query's op om verschillende soorten vragen te behandelen, maar verwijder overlappende of redundante voorbeelden.
• Vereenvoudig de instructies: controleer of uw instructies duidelijk en beknopt zijn. Vermijd onnodige woorden.

Uw account is niet ingeschakeld voor cross-geo-verwerking

Genie is een Designated Service die wordt beheerd door Azure Databricks. Aangewezen Diensten gebruiken Databricks Geos voor het beheren van gegevensresidentie. Gegevens kunnen niet worden verwerkt in dezelfde geografische locatie als de werkruimte voor sommige regio's. Als uw werkruimte zich in een van deze regio's bevindt, moet cross-geo-verwerking worden ingeschakeld door uw accountbeheerder.

Doorvoerlimieten bereiken

Wanneer u Genie-ruimten opent via de Gebruikersinterface van Azure Databricks, is de doorvoer beperkt tot 20 vragen per minuut per werkruimte, in alle Genie-ruimten.

Wanneer u Genie-ruimten benadert via de gratis versie van de Conversation API (Public Preview), is de doorvoer beperkt tot een maximale inspanning van vijf vragen per minuut per werkruimte, over alle Genie-ruimten. Zie De Genie-API gebruiken om Genie te integreren in uw toepassingen.