Gestion des données Experience Platform à l’aide de Python et de SQLAlchemy

Dernière mise à jour : 4 avril 2025

Créé pour :

  • Utilisateur ou utilisatrice
  • Développeur

Découvrez comment utiliser SQLAlchemy pour une plus grande flexibilité dans la gestion de vos données Adobe Experience Platform. Pour ceux qui ne sont pas aussi familiers avec SQL, SQLAlchemy peut grandement améliorer le temps de développement en travaillant avec des bases de données relationnelles. Ce document fournit des instructions et des exemples pour connecter SQLAlchemy à Query Service et commencer à utiliser Python pour interagir avec vos bases de données.

SQLAlchemy est un mappeur relationnel d'objets (ORM) et une bibliothèque de code Python qui peut transférer des données stockées dans une base de données SQL vers des objets Python. Vous pouvez ensuite effectuer des opérations CRUD sur les données contenues dans le lac de données d’Experience Platform à l’aide du code Python. Cela supprime la nécessité de gérer les données à l’aide de PSQL uniquement.

Commencer

Pour acquérir les informations d’identification nécessaires à la connexion de SQLAlchemy à Experience Platform, vous devez avoir accès à l’espace de travail Requêtes dans l’interface utilisateur d’Experience Platform. Contactez l’administrateur ou administratrice de votre organisation si vous n’avez pas actuellement accès à l’espace de travail Requêtes.

Query Service des informations d’identification

Pour trouver vos informations d’identification, connectez-vous à l’interface utilisateur d’Experience Platform et sélectionnez Requêtes dans le volet de navigation de gauche, suivi de Informations d’identification. Pour obtenir des instructions complètes sur la façon de trouver vos informations d’identification, veuillez lire le guide des informations d’identification.

Onglet Informations d’identification avec les informations d’identification arrivant à expiration pour Query Service mis en surbrillance.

Bien que le port 80 soit le port recommandé pour une connexion à Query Service, vous pouvez également utiliser le port 5432.

IMPORTANT
Si vous utilisez des informations d’identification arrivant à expiration (comme illustré dans l’image ci-dessus) pour vous connecter à Query Service, la durée de vie de session de votre connexion expirera après la période définie définie dans les paramètres de votre organisation. Par défaut, cette période est de 24 heures. Consultez la documentation pour savoir comment connecter un client avec des informations d’identification non expirantes ou modifier la durée de vie de session de vos informations d’identification arrivant à expiration.

Une fois que vous avez accès à vos informations d’identification QS, ouvrez l’éditeur de Python de votre choix.

Stocker les informations d’identification dans Python

Dans l’éditeur de Python, importez la bibliothèque urllib.parse.quote et enregistrez chaque variable d’identification en tant que paramètre. Le module urllib.parse fournit une interface standard pour diviser les chaînes URL en composants. La fonction quote remplace les caractères spéciaux dans la chaîne URL afin de rendre les données plus sûres pour une utilisation en tant que composants URL. Vous trouverez ci-dessous un exemple du code requis :

CONSEIL
Utilisez les guillemets Python pour saisir votre chaîne de mot de passe à plusieurs lignes.
from urllib.parse import quote

host = "<YOUR_HOST>"

port = "<YOUR_PORT>"

dbname = "<YOUR_DATABASE>"

user = "<YOUR_USERNAME>"

password = quote('''
<YOUR_PASSWORD>
''')
REMARQUE
Le mot de passe que vous fournissez pour se connecter SQLAlchemy à Experience Platform expirera si vous utilisez des informations d’identification arrivant à expiration. Voir la section Informations d’identification pour plus d’informations.