Guide de dépannage du Query Service

SELECT * FROM customers LIMIT 0;

• Convertir la requête en requête CTAS et planifiez l’exécution. La planification d’une exécution peut être effectuée : via l’interface utilisateur ou le API.
• Exécutez la requête sur un bloc de données plus petit en appliquant des conditions de filtrage.
• Exécutez la commande EXPLAIN pour en savoir plus.
• Examinez les statistiques des données du jeu de données.
• Convertir la requête en formulaire simplifié et la relancer à l’aide de instructions préparées.

• Après vous être connecté à Experience Platform, sélectionnez Jeux de données dans le volet de navigation de gauche de l’interface utilisateur à laquelle accéder Jeux de données tableau de bord.
• Jeux de données Parcourir s’ouvre. Vous pouvez utiliser la barre de recherche pour affiner les options disponibles. Sélectionnez un jeu de données dans la liste affichée.

• Le Activité Jeux de données s’affiche. Sélectionner Prévisualisation d’un jeu de données pour ouvrir une boîte de dialogue du schéma XDM et une vue tabulaire des données aplaties du jeu de données sélectionné. Vous trouverez plus de détails dans la section prévisualisation de la documentation d’un jeu de données

• Sélectionnez un champ du schéma pour afficher son contenu dans une colonne aplatie. Le nom de la colonne s’affiche au-dessus de son contenu sur le côté droit de la page. Vous devez copier ce nom pour interroger ce jeu de données.

Consultez la documentation pour obtenir des conseils complets sur Comment travailler avec des structures de données imbriquées à l’aide de Query Editor ou d’un client tiers.

Il peut y avoir plusieurs raisons pour qu’une requête soit bloquée pendant le traitement. Pour déterminer la cause exacte, une analyse approfondie au cas par cas est nécessaire. Contacter l’assistance clientèle d’Adobe à ce processus.

Liste complète des numéros de téléphone de l’assistance clientèle d’Adobe est disponible sur la page d’aide d’Adobe. Vous pouvez également trouver de l’aide en ligne en procédant comme suit :

• Accédez à https://www.adobe.com/ dans votre navigateur web.
• Sur le côté droit de la barre de navigation supérieure, sélectionnez Se connecter.

• Utilisez votre Adobe ID et votre mot de passe enregistrés avec votre licence d’Adobe.
• Sélectionner Aide et assistance dans la barre de navigation supérieure.

Une bannière déroulante s’affiche avec une Aide et support . Sélectionner Contactez-nous pour ouvrir l’assistant virtuel de l’assistance clientèle Adobe ou sélectionnez Support aux entreprises pour obtenir une aide dédiée aux grandes entreprises.

Voir documentation bloquée anonyme pour plus d’informations.

1. Utilisez une combinaison de Fonctions définies par l’Adobe pour déterminer si les besoins du cas d’utilisation sont satisfaits.
2. Si la suggestion précédente ne répond pas à votre cas d’utilisation, vous devez utiliser une combinaison de fonctions de fenêtre. Les fonctions de fenêtre examinent tous les événements d’une séquence. Elles vous permettent également de consulter les données historiques et peuvent être utilisées dans n’importe quelle combinaison.

Utilisez la commande GET pour récupérer plusieurs requêtes. Vous trouverez des informations sur la manière d’effectuer un appel à l’API dans la section exemple de documentation sur les appels API.

À partir de la réponse, identifiez la requête sur laquelle vous souhaitez enquêter et effectuez une autre requête de GET à l’aide de id . Vous trouverez des instructions complètes dans la section récupération d’une requête par documentation d’identification.

Une réponse réussie renvoie un état HTTP 200 et contient le paramètre errors tableau. La réponse a été raccourcie pour plus de concision.

{
    "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",
}

Le Documentation de référence de l’API Query Service fournit plus d’informations sur tous les points de terminaison disponibles.

L’exemple suivant illustre l’utilisation d’une syntaxe CTAS et d’un type de données struct :

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 ;

Vous pouvez également confirmer que votre jeu de données contient des données à l’aide d’une petite requête telle que :

SELECT count(1) FROM myTableName

Vous devez également consulter la documentation pour obtenir des conseils sur la manière d’effectuer requêtes planifiées dans l’interface utilisateur et l’API.

Voici une liste des considérations à prendre en compte pour les requêtes planifiées lors de l’utilisation de la variable Query Editor. Elles ne s’appliquent pas au Query Service API :
Vous pouvez uniquement ajouter un planning à une requête qui a déjà été créée, enregistrée et exécutée.
You cannot ajoutez un planning à une requête paramétrée.
Requêtes planifiées cannot contiennent un bloc anonyme.
Vous pouvez uniquement planifier one modèle de requête à l’aide de l’interface utilisateur. Si vous souhaitez ajouter des plannings supplémentaires à un modèle de requête, vous devez utiliser l’API . Si une planification a déjà été ajoutée à l’aide de l’API, vous ne pourrez pas ajouter d’autres planifications à l’aide de l’interface utilisateur.

SELECT * FROM <table> WHERE 1=0

Vous pouvez par exemple créer un tableau temporaire :

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

Vous pouvez ensuite utiliser le tableau temporaire comme suit :

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;

Query Service prend en charge les fonctions SQL intégrées pour convertir un horodatage donné au format UTC et à partir de ce format. Les deux to_utc_timestamp() et le from_utc_timestamp() Les méthodes prennent deux paramètres : horodatage et fuseau horaire.

Convertir en horodatage UTC

Le to_utc_timestamp() interprète les paramètres donnés et les convertit à l’horodatage de votre fuseau horaire local. au format UTC. Par exemple, le fuseau horaire à Séoul, en Corée du Sud, est UTC/GMT +9 heures. En fournissant un horodatage date seule, la méthode utilise une valeur par défaut de minuit le matin. L’horodatage et le fuseau horaire sont convertis au format UTC de l’heure de cette région en horodatage UTC de votre région locale.

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

La requête renvoie un horodatage à l’heure locale de l’utilisateur. Dans ce cas, la veille à 15h00 comme à Séoul, il y a neuf heures d'avance.

2021-08-30 15:00:00

Autre exemple : si l’horodatage donné a été 2021-07-14 12:40:00.0 pour le Asia/Seoul fuseau horaire, l’horodatage UTC renvoyé serait 2021-07-14 03:40:00.0

La sortie de console fournie dans l’interface utilisateur de Query Service est plus lisible :

8/30/2021, 3:00 PM

Convertir à partir de l’horodatage UTC

Le from_utc_timestamp() interprète les paramètres donnés. à partir de l’horodatage de votre fuseau horaire local et fournit l’horodatage équivalent de la région souhaitée au format UTC. Dans l’exemple ci-dessous, l’heure est 14 h 40 dans le fuseau horaire local de l’utilisateur. Le fuseau horaire de Séoul passé en tant que variable est neuf heures avant le fuseau horaire local.

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

La requête renvoie un horodatage au format UTC pour le fuseau horaire transmis en tant que paramètre. Le résultat est neuf heures avant le fuseau horaire qui a exécuté la requête.

8/31/2021, 11:40 PM

Comment dois-je filtrer mes données de série temporelle ?

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')

Par exemple, l’absence du composant temporel, comme illustré ci-dessous, entraînera une erreur :

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

L’utilisation correcte de la variable CAST est illustré ci-dessous :

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

Au lieu d’utiliser NOT IN, vous pouvez utiliser NOT EXISTS ou LEFT OUTER JOIN.

Par exemple, si les tables suivantes sont créées :

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)

Si vous utilisez la variable NOT EXISTS , vous pouvez répliquer à l’aide de l’opérateur NOT IN en utilisant la requête suivante :

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

Si vous utilisez la méthode LEFT OUTER JOIN , vous pouvez répliquer à l’aide de l’opérateur NOT IN en utilisant la requête suivante :

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

Il existe deux manières d’enregistrer les résultats d’une requête lors de l’utilisation d’un client PSQL. Vous pouvez utiliser la variable COPY TO ou créez une instruction au format suivant :

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

Conseils sur l’utilisation de la variable COPY TO command se trouve dans la documentation de référence sur la syntaxe SQL.

SELECT * FROM prod_table LIMIT 1;

Doit être écrit comme suit :

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

Consultez la documentation pour plus d’informations sur la manière de connexion à des clients externes avec des informations d’identification.

Si vous souhaitez améliorer les temps de réponse de vos tableaux de bord, vous devez mettre en oeuvre un serveur Business Intelligence (BI) en tant que couche de mise en cache entre Query Service et les outils de BI. En règle générale, la plupart des outils de BI disposent d’une offre supplémentaire pour un serveur.

L’ajout de la couche de serveur de cache a pour but de mettre en cache les données de Query Service et d’en utiliser de même pour les tableaux de bord afin d’accélérer la réponse. Cela est possible, car les résultats des requêtes exécutées seraient mis en cache dans le serveur BI chaque jour. Le serveur de mise en cache diffuse ensuite ces résultats à tout utilisateur disposant de la même requête afin de réduire la latence. Reportez-vous à la documentation de l’utilitaire ou de l’outil tiers que vous utilisez pour clarifier cette configuration.

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

Cette erreur s’est produite car il n’y avait aucune valeur renvoyée pour la requête. Ce comportement a maintenant été corrigé afin de renvoyer le message suivant :

Query complete in {timeframe}. 0 rows returned.