Barrières de sécurité pour Query Service

Les barrières de sécurité sont des seuils qui guident l’utilisation des données et du système, l’optimisation des performances et la prévention des erreurs ou des résultats inattendus dans Adobe Experience Platform.
Ce document fournit des limites d’utilisation par défaut pour les données de Query Service afin de vous aider à optimiser les performances du système lors de l’interrogation de données par rapport à vos droits de licence.

IMPORTANT
Vérifiez vos droits de licence dans votre commande de ventes et la description du produit correspondante sur les limites d’utilisation réelles en plus de cette page de garde-fous.

Conditions préalables

Avant de poursuivre ce document, vous devez bien comprendre les principales définitions et fonctionnalités de Query Service. Ils sont décrits ci-dessous :

  • Requêtes ad hoc : pour exécuter des requêtes SELECT afin d’explorer, d’expérimenter et de valider des données où les résultats des requêtes ne sont pas stockés sur le lac de données.

  • Requêtes par lots : pour exécuter des requêtes INSERT TABLE AS SELECT et CREATE TABLE AS SELECT afin de nettoyer, de former, de manipuler et d’enrichir les données. Les résultats de ces requêtes sont stockés sur le lac de données. La mesure permettant de mesurer la consommation de cette fonctionnalité est les heures de calcul.

  • Utilisateurs de Query Service : les utilisateurs de Query Service fournis dans votre licence actuelle pour Customer Journey Analytics, Adobe Real-Time Customer Data Platform et/ou Adobe Journey Optimizer peuvent également être utilisés avec Data Distiller. Les utilisateurs de Query Service sont partagés entre les fonctionnalités.

  • Utilisateurs ad hoc : les utilisateurs ad hoc sont ceux qui exécutent des requêtes ad hoc.

  • Utilisateurs par lots : les utilisateurs par lots sont ceux qui exécutent les requêtes par lots.

  • API de création de rapports : API permettant d’effectuer des appels de récupération de données (en interne ou en externe). Les modèles de données de rapport étendus sont dérivés des modèles de données de rapport natifs dans Adobe Experience Platform, tels que le modèle de données des tableaux de bord Real-Time CDP.

L’illustration ci-dessous résume la manière dont les fonctionnalités de Query Service sont actuellement mises en package et sous licence :

Types de protection

Ce document comprend deux types de limites par défaut :

Type de protection
Description
Barrière de sécurité des performances (limite de soft)
Les barrières de performance sont des limites d’utilisation liées à la portée de vos cas d’utilisation. Lorsque vous dépassez les barrières de performance, vous pouvez rencontrer une dégradation des performances et une latence. Adobe n’est pas responsable d’une telle dégradation des performances. Les clients qui dépassent systématiquement une barrière de performance peuvent choisir d’acquérir une capacité supplémentaire afin d’éviter une dégradation des performances.
Barrières de sécurité système (limite stricte)
Les barrières de sécurité appliquées par le système sont appliquées par l’interface utilisateur ou l’API de Real-Time CDP. Il s’agit de limites que vous ne pouvez pas dépasser, car l’interface utilisateur et l’API vous empêcheront de le faire ou renverront une erreur.
NOTE
Les limites par défaut décrites dans ce document sont constamment améliorées. Consultez régulièrement les mises à jour.

Barrières de sécurité des performances de l’entité de Principal

Les tableaux ci-dessous contiennent les descriptions et limites recommandées pour l’exécution des requêtes lors de l’utilisation d’un modèle de requête particulier.

Requêtes ad hoc

Mécanisme de sécurisation
Limite
Type de limite
Description
Durée maximale d’exécution
10 minutes
Barrière de sécurité mise en place par le système
Cela définit le temps de sortie maximal pour une requête SQL ad hoc. Le dépassement de la limite de temps pour renvoyer un résultat renvoie le code d’erreur 53400.
Utilisateurs de Query Service simultanés
  • Comme spécifié dans la description du produit de l’application.
  • +5 (avec chaque module complémentaire d’utilisateurs de requêtes ad hoc supplémentaire acheté)
Barrière de sécurité mise en place par le système
Cela définit le nombre d’utilisateurs qui peuvent créer des sessions simultanément pour une organisation particulière. Si la limite de simultanéité est dépassée, l’utilisateur reçoit une erreur Session Limit Reached.
Concurrence des requêtes
  • Comme spécifié dans la description du produit de l’application.
  • +1 (avec chaque module complémentaire SKU d’utilisateur de requête ad hoc supplémentaire acheté)
Barrière de sécurité mise en place par le système
Cela définit le nombre de requêtes pouvant être exécutées simultanément pour une organisation particulière. Si la limite de simultanéité est dépassée, les requêtes sont mises en file d'attente.
Connecteur client et limite de sortie de résultat

Connecteur client

  • Interface utilisateur de requête (100 lignes)
  • Client tiers (50 000)
  • PostgresSQL client (50 000)
Barrière de sécurité mise en place par le système

Le résultat d'une requête peut être reçu par les moyens suivants :

  • Interface utilisateur de Query Service
  • Client tiers
  • PostgresSQL client

Remarque : L’ajout d’une limitation au nombre de sorties peut renvoyer des résultats plus rapidement. Par exemple, LIMIT 5, LIMIT 10, etc.

Résultats renvoyés via
Interface utilisateur du client
S/O
Cela définit la manière dont les résultats sont mis à la disposition des utilisateurs.

Requêtes par lots

Guardrail
Limit
Type de limite
Description
Durée maximale d’exécution
24 heures
Barrière de sécurité mise en place par le système
Cette option définit le temps d’exécution maximal d’une requête SQL par lot.
Le temps de traitement d’une requête dépend du volume de données à traiter et de la complexité des requêtes.
Utilisateurs simultanés de Query Service pour un lot non planifié
  • Comme spécifié dans la description du produit de l’application.
  • +5 (avec chaque module complémentaire d’utilisateurs de requêtes ad hoc supplémentaire acheté)
Barrière de sécurité mise en place par le système
Pour les requêtes par lots non planifiées (par exemple, les requêtes CTAS/ITAS en mode interactif), cela définit le nombre d’utilisateurs qui peuvent créer des sessions simultanément pour une organisation particulière. Si la limite de simultanéité est dépassée, l’utilisateur reçoit une erreur Session Limit Reached.
Utilisateurs simultanés de Query Service pour un lot planifié
Aucune limitation d’utilisateur
S/O
Les requêtes par lots planifiées sont des tâches asynchrones, il n’y a donc aucune limitation de l’utilisateur.
Heures de calcul pour le traitement des données par lots
Comme spécifié dans la commande de ventes SKU personnalisé de la requête de renseignement Adobe Experience Platform du client
Protecteur des performances
Cela définit la durée de calcul définie par chaque année pendant laquelle un client est autorisé à exécuter des requêtes par lots afin d’analyser, de traiter et d’écrire des données dans le lac de données.
Concurrence des requêtes
Pris en charge
S/O
Les requêtes par lots planifiées sont des tâches asynchrones. Par conséquent, les requêtes simultanées sont prises en charge.
Connecteur client et limite de sortie des résultats

Connecteur client

  • Interface utilisateur de requête (pas de limite supérieure pour les lignes)
  • Client tiers (pas de limite supérieure aux lignes)
  • PostgresSQL client (aucune limite supérieure pour les lignes)
  • API REST (pas de limite supérieure pour les lignes)
Barrière de sécurité mise en place par le système

Le résultat d'une requête peut être rendu disponible à l'aide des méthodes suivantes :

  • Peut être stocké en tant que jeux de données dérivés
  • Peuvent être insérés dans les jeux de données dérivés existants

Remarque : Il n’existe pas de limite supérieure au nombre d’enregistrements à partir du résultat de la requête.

Résultats renvoyés via
Jeu de données
S/O
Cela définit la manière dont les résultats sont mis à la disposition des utilisateurs.

Magasin accéléré de requêtes query-accelerated-store

Le tableau ci-dessous fournit la description et les limites recommandées de la barrière de sécurité pour le magasin accéléré de requêtes.

Mécanisme de sécurisation
Limite
Type de limite
Description
Concurrence des requêtes
4
Barrière de sécurité mise en place par le système
Pour garantir que les requêtes sur les données agrégées via l’API de création de rapports (y compris les requêtes qui améliorent les modèles de données tels que les modèles de données Real-Time CDP) disposent des ressources pour s’exécuter efficacement, l’API de création de rapports effectue le suivi de l’utilisation des ressources en attribuant des emplacements simultanés à chaque requête. Le système place les requêtes dans une file d’attente et attend que les emplacements simultanés soient disponibles ou qu’ils puissent être diffusés à partir du cache. Quatre emplacements de requête simultanés au maximum sont disponibles à tout moment.
Si vous accédez à l’API de création de rapports par le biais d’un outil de BI et que vous avez besoin de davantage de simultanéité, un serveur de BI est requis.

Étapes suivantes

Après avoir lu ce document, vous devez mieux comprendre les limites par défaut pour l’exécution des requêtes avec les modèles de requête disponibles.

Pour plus d’informations sur Query Service, consultez la documentation suivante :

Pour plus d’informations sur les barrières de sécurité des autres services Experience Platform, sur les informations de latence de bout en bout et les informations de licence des documents Description du produit Real-Time CDP, consultez la documentation suivante :

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb