Fråga service och data Distiller frågor och svar

Om du vill kringgå gränsen för utdataraden använder du "LIMIT 0" i frågan. Exempel:

SELECT * FROM customers LIMIT 0;

En eller flera av följande lösningar rekommenderas vid timeout i frågor.

• Konvertera frågan till en CTAS-fråga och schemalägg körningen. Du kan schemalägga en körning antingen via gränssnitteteller API.
• Kör frågan i ett mindre datasegment genom att tillämpa ytterligare filtervillkor.
• Kör EXPLAIN-kommandot om du vill samla in mer information.
• Granska statistiken för data i datauppsättningen.
• Konvertera frågan till ett förenklat formulär och kör den igen med förberedda satser.

Följande steg beskriver hur du visar en tabellvy av en datauppsättning via användargränssnittet, inklusive alla kapslade fält och kolumner i ett förenklat formulär.

• När du har loggat in på Experience Platform väljer du Datasets i den vänstra navigeringen i användargränssnittet för att navigera till Datasets-instrumentpanelen.
• Fliken för datauppsättningar Browse öppnas. Du kan använda sökfältet för att förfina de tillgängliga alternativen. Välj en datauppsättning i den lista som visas.

• Skärmen Datasets activity visas. Välj Preview dataset om du vill öppna en dialogruta med XDM-schemat och en tabellvy med separerade data från den valda datauppsättningen. Mer information finns i förhandsgranskningen av en datauppsättningsdokumentation

• Markera ett fält i schemat om du vill visa innehållet i en förenklad kolumn. Kolumnens namn visas ovanför innehållet till höger på sidan. Du bör kopiera det här namnet om du vill använda det för att fråga om den här datauppsättningen.

I dokumentationen finns fullständig vägledning om hur du arbetar med kapslade datastrukturer med frågeredigeraren eller en tredjepartsklient.

Om frågan har tagit lång tid på en mycket liten datauppsättning kontaktar du kundsupporten.

Det kan finnas många orsaker till att en fråga har fastnat under bearbetningen. För att fastställa den exakta orsaken krävs en djupgående analys från fall till fall. Kontakta Adobe kundsupport om du vill vara den här processen.

En fullständig lista över telefonnummer till kundsupport för Adobe finns på hjälpsidan för Adobe. Du kan även hitta hjälp online genom att utföra följande steg:

• Navigera till https://www.adobe.com/ i webbläsaren.
• Välj Sign In till höger om det övre navigeringsfältet.

• Använd ditt Adobe ID och lösenord som är registrerat med din licens för Adobe.
• Välj Help & Support i det övre navigeringsfältet.

En rullgardinsmeny med avsnittet Help and support visas. Välj Contact us om du vill öppna den virtuella kundtjänstassistenten på Adobe eller välj Enterprise support om du vill ha dedikerad hjälp för stora organisationer.

Med den anonyma blockfunktionen kan du kedja en eller flera SQL-satser som körs i sekvens. De gör det även möjligt att hantera undantag.

Mer information finns i dokumentationen för anonyma block.

Det finns två sätt att implementera anpassad attribuering:

1. Använd en kombination av de befintliga Adobe-definierade funktionerna för att identifiera om användningsbehoven uppfylls.
2. Om föregående förslag inte uppfyller ditt användningssätt bör du använda en kombination av fönsterfunktioner. Fönsterfunktioner tittar på alla händelser i en sekvens. De gör det även möjligt att granska historiska data och kan användas i valfri kombination.

Om du vill hämta felloggar för en viss fråga måste du först använda API:t för frågetjänsten för att hämta information om frågeloggen. HTTP-svaret innehåller de fråge-ID:n som krävs för att undersöka ett frågefel.

Använd kommandot GET för att hämta flera frågor. Information om hur du anropar API finns i exempeldokumentationen för API-anrop.

Identifiera den fråga du vill undersöka från svaret och gör en annan GET-förfrågan med hjälp av dess id-värde. Fullständiga instruktioner finns i Hämta en fråga efter ID-dokumentation.

Ett lyckat svar returnerar HTTP-status 200 och innehåller arrayen errors. Svaret har förkortats av kortfattad anledning.

{
    "isInsertInto": false,
    "request": {
                "dbName": "prod:all",
                "sql": "SELECT *\nFROM\n  accounts\nLIMIT 10\n"
            },
    "clientId": "8c2455819a624534bb665c43c3759877",
    "state": "SUCCESS",
    "rowCount": 0,
    "errors": [{
      'code': '58000',
      'message': 'Batch query execution gets : [failed reason ErrorCode: 58000 Batch query execution gets : [Analysis error encountered. Reason: [sessionId: f055dc73-1fbd-4c9c-8645-efa609da0a7b Function [varchar] not defined.]]]',
      'errorType': 'USER_ERROR'
      }],
    "isCTAS": false,
    "version": 1,
    "id": "343388b0-e0dd-4227-a75b-7fc945ef408a",
}

Referensdokumentationen för API:t för frågetjänsten innehåller mer information om alla tillgängliga slutpunkter.

Meddelandet "Fel vid validering av schema" betyder att systemet inte kan hitta ett fält i schemat. Du bör läsa dokumentet med bästa praxis för att organisera dataresurser i frågetjänsten följt av Skapa tabell som markeringsdokumentation.

I följande exempel visas hur en CTAS-syntax och en strukturell datatyp används:

CREATE TABLE table_name WITH (SCHEMA='schema_name')

AS SELECT '1' as _id,

 STRUCT

  ('2021-02-17T15:39:29.0Z' AS taskActualCompletionDate,

    '2020-09-09T21:21:16.0Z' AS taskActualStartDate,

    'Consulting' AS taskdescription,

    '5f6527c10011e09b89666c52d9a8c564' AS taskguide,

    'Stakeholder Consulting Engagement' AS taskname,

    '2020-09-09T15:00:00.0Z' AS taskPlannedStartDate,

    '2021-02-15T11:00:00.0Z' AS taskPlannedCompletionDate

  ) AS _workfront ;

Siffrorna som visas på profilkontrollpanelen är korrekta vid den senaste ögonblicksbilden. De tal som genereras i exporttabellen är helt beroende av exportfrågan. Därför är det en vanlig orsak att fråga hur många profiler som är kvalificerade för en viss målgrupp.

Den mest troliga orsaken är att frågan är för smal i omfånget. Du bör systematiskt ta bort ett avsnitt i WHERE-satsen tills du börjar se data.

Du kan också bekräfta att datauppsättningen innehåller data genom att använda en liten fråga som:

SELECT count(1) FROM myTableName

Kontrollera först loggarna för att få reda på mer om felet. Avsnittet med vanliga frågor om att hitta fel i loggar innehåller mer information om hur du gör detta.

Du bör även läsa dokumentationen om hur du utför schemalagda frågor i användargränssnittet och via API.

När du använder Query Editor kan du bara lägga till ett schema i en fråga som redan har skapats och sparats. Detta gäller inte API:t Query Service.

Du kan köra en fråga som returnerar noll rader för att bara få metadata som svar. Den här exempelfrågan returnerar bara metadata för den angivna tabellen.

SELECT * FROM <table> WHERE 1=0

Du kan skapa tillfälliga tabeller för att snabbt iterera och experimentera med en fråga innan den materialiseras för användning. Du kan också använda temporära tabeller för att validera om en fråga fungerar.

Du kan till exempel skapa en tillfällig tabell:

CREATE temp TABLE temp_dataset AS
SELECT *
FROM actual_dataset
WHERE 1 = 0;

Sedan kan du använda den temporära tabellen enligt följande:

INSERT INTO temp_dataset
SELECT a._company AS _company,
a._id AS _id,
a.timestamp AS timestamp
FROM actual_dataset a
WHERE timestamp >= TO_TIMESTAMP('2021-01-21 12:00:00')
AND timestamp < TO_TIMESTAMP('2021-01-21 13:00:00')
LIMIT 100;

Adobe Experience Platform innehåller data i UTC-format (Coordinated Universal Time) för tidsstämpling. Ett exempel på UTC-formatet är 2021-12-22T19:52:05Z

Frågetjänsten stöder inbyggda SQL-funktioner för konvertering av en viss tidsstämpel till och från UTC-format. Metoderna to_utc_timestamp() och from_utc_timestamp() har två parametrar: timestamp och timezone.

Konvertera till UTC-tidsstämpeln

Metoden to_utc_timestamp() tolkar de angivna parametrarna och konverterar den till tidsstämpeln för den lokala tidszonen i UTC-format. Exempelvis är tidszonen i Seoul i Sydkorea UTC/GMT +9 timmar. Genom att ange en tidsstämpel som bara är ett datum, använder metoden standardvärdet midnatt på morgonen. Tidsstämpeln och tidszonen konverteras till UTC-format från tidpunkten i den regionen till en UTC-tidsstämpel för den lokala regionen.

SELECT to_utc_timestamp('2021-08-31', 'Asia/Seoul');

Frågan returnerar en tidsstämpel i användarens lokala tid. I det här fallet är klockan 16.00 föregående dag som Seoul nio timmar framåt.

2021-08-30 15:00:00

Om den angivna tidsstämpeln var 2021-07-14 12:40:00.0 för tidszonen Asia/Seoul skulle den returnerade UTC-tidsstämpeln vara 2021-07-14 03:40:00.0

Konsolutdata i gränssnittet för frågetjänsten är ett mer läsbart format:

8/30/2021, 3:00 PM

Konvertera från UTC-tidsstämpeln

Metoden from_utc_timestamp() tolkar de angivna parametrarna från tidsstämpeln för den lokala tidszonen och tillhandahåller motsvarande tidsstämpel för det önskade området i UTC-format. I exemplet nedan är timmen 2:40 PM i användarens lokala tidszon. Seoul-tidszonen som skickas som en variabel ligger nio timmar före den lokala tidszonen.

SELECT from_utc_timestamp('2021-08-31 14:40:00.0', 'Asia/Seoul');

Frågan returnerar en tidsstämpel i UTC-format för den tidszon som skickas som en parameter. Resultatet är nio timmar före den tidszon som körde frågan.

8/31/2021, 11:40 PM

Hur ska jag filtrera mina tidsseriedata?

SELECT a._company  AS _company,
       a._id       AS _id,
       a.timestamp AS timestamp
FROM   dataset a
WHERE  timestamp >= To_timestamp('2021-01-21 12:00:00')
       AND timestamp < To_timestamp('2021-01-21 13:00:00')

När du använder operatorn CAST för att konvertera en tidsstämpel måste du inkludera både datumet och tid.

Om du t.ex. saknar tidskomponenten, som visas nedan, uppstår ett fel:

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021' AS timestamp)

Korrekt användning av operatorn CAST visas nedan:

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021 00:00:00' AS timestamp)

Operatorn NOT IN används ofta för att hämta rader som inte finns i en annan tabell eller SQL-sats. Operatorn kan göra prestandan långsammare och kan returnera oväntade resultat om kolumnerna som jämförs accepterar NOT NULL, eller om du har ett stort antal poster.

I stället för att använda NOT IN kan du använda antingen NOT EXISTS eller LEFT OUTER JOIN.

Om du till exempel har skapat följande tabeller:

CREATE TABLE T1 (ID INT)
CREATE TABLE T2 (ID INT)
INSERT INTO T1 VALUES (1)
INSERT INTO T1 VALUES (2)
INSERT INTO T1 VALUES (3)
INSERT INTO T2 VALUES (1)
INSERT INTO T2 VALUES (2)

Om du använder operatorn NOT EXISTS kan du replikera med operatorn NOT IN genom att använda följande fråga:

SELECT ID FROM T1
WHERE NOT EXISTS
(SELECT ID FROM T2 WHERE T1.ID = T2.ID)

Om du använder operatorn LEFT OUTER JOIN kan du också replikera med operatorn NOT IN genom att använda följande fråga:

SELECT T1.ID FROM T1
LEFT OUTER JOIN T2 ON T1.ID = T2.ID
WHERE T2.ID IS NULL

Systemet har inga index eftersom det inte är en databas, men det har andra optimeringar som är kopplade till datalagret. Följande alternativ är tillgängliga för att justera dina frågor:

• Ett tidsbaserat filter som bygger på tidsseriedata.
• Optimerad nedtryckning för strukturdatatypen.
• Optimerad kostnad och minneshantering för matriser och kartdatatyper.
• Inkrementell bearbetning med ögonblicksbilder.
• Ett beständigt dataformat.

Det finns tre sätt att begränsa åtkomsten. De är följande:

• Använd bara SELECT-programsatser och ge datauppsättningar skrivskyddad åtkomst. Tilldela även behörigheten Hantera fråga.
• Använd SELECT/INSERT/CREATE-programsatser och ge datauppsättningar skrivbehörighet. Tilldela även behörigheten för frågehantering.
• Använd ett integrationskonto med föregående förslag ovan och tilldela frågeintegrationsbehörigheten.

Ja. Data kan extraheras från frågetjänsten och det finns även ett alternativ för att lagra resultaten i CSV-format via ett SQL-kommando.

Det finns två sätt att spara resultatet av en fråga när du använder en PSQL-klient. Du kan använda kommandot COPY TO eller skapa en sats med följande format:

SELECT column1, column2
FROM <table_name>
\g <table_name>.out

Vägledning om hur COPY TO command används finns i referensdokumentationen för SQL-syntaxen.

En vanlig orsak till det här problemet är att fråga efter tidsseriedata utan tidsfilter. Exempel:

SELECT * FROM prod_table LIMIT 1;

Ska skrivas som:

SELECT * FROM prod_table
WHERE
timestamp >= to_timestamp('2022-07-22')
and timestamp < to_timestamp('2022-07-23');

När systemet är anslutet till frågetjänsten är det anslutet till en interaktiv motor eller batchbearbetningsmotor. Detta kan leda till längre inläsningstider för att återspegla de bearbetade data.

Om du vill förbättra svarstiderna för dina instrumentpaneler bör du implementera en Business Intelligence-server (BI) som ett cachelagringslager mellan Query Service och BI-verktyg. I allmänhet har de flesta BI-verktyg ett extra erbjudande för en server.

Syftet med att lägga till cacheserverlagret är att cachelagra data från frågetjänsten och använda samma för kontrollpaneler för att snabba upp svaret. Detta är möjligt eftersom resultaten för frågor som körs cachelagras i BI-servern varje dag. Cachelagringsservern skickar sedan dessa resultat till alla användare med samma fråga för att minska fördröjningen. Se dokumentationen för verktyget eller tredjepartsverktyget som du använder för att få mer information om den här konfigurationen.

Metoden history_meta() används för att komma åt en ögonblicksbild från en datauppsättning. Tidigare, om du skulle köra en fråga på en tom datauppsättning i Azure Data Lake Storage (ADLS), skulle du få en felkod på 58000 som anger att datauppsättningen inte finns. Ett exempel på det gamla systemfelet visas nedan.

ErrorCode: 58000 Internal System Error [Invalid table your_table_name. historyMeta can be used on datalake tables only.]

Det här felet uppstod eftersom det inte fanns något returvärde för frågan. Det här beteendet har nu åtgärdats för att returnera följande meddelande:

Query complete in {timeframe}. 0 rows returned.