Convention de nommage des data extensions SFMC : modèle et règles
Un modèle de convention de nommage pour vos data extensions SFMC : sept préfixes, des règles compatibles SQL, une arborescence de dossiers et un plan de déploiement.
Ouvrez Contact Builder dans un compte qui tourne depuis trois ans : vous y trouverez Newsletter_final, Newsletter_final_v2, test_copie_julie et une quarantaine de tables que personne n'ose supprimer. Chaque nouvelle audience commence alors par la même question : quelle data extension est la bonne ?
Une convention de nommage des data extensions SFMC règle le problème avec une seule règle : chaque nom indique ce que contient la table, d'où viennent les données et à qui elles servent, toujours dans le même ordre. Le modèle que nous recommandons tient en quatre blocs séparés par des underscores : un préfixe de type, un domaine métier, un descripteur et un périmètre, sans aucun espace.
Vous trouverez ici le modèle, des exemples concrets, les règles qui rendent un nom compatible avec le SQL, une arborescence de dossiers calée sur les préfixes et une liste d'étapes pour déployer la convention dans un compte existant, sans tout renommer d'un coup.
Pourquoi une convention de nommage des data extensions SFMC change tout
Ce qui se dégrade sans convention
Dans Marketing Cloud, le nom est le seul index dont vous disposez. Il n'existe pas de système de tags pour les data extensions, la recherche porte sur le nom, et une requête SQL désigne une table par son nom, pas par sa clé externe. Quand les noms sont incohérents, chaque création d'audience commence par une fouille dans les dossiers et quelques requêtes exploratoires, juste pour confirmer quelle table est à jour.
Le coût s'accumule. Les équipes dupliquent des tables faute de retrouver l'originale, personne ne pose de politique de rétention sur les copies, et le compte se remplit lentement de data extensions quasi identiques. Salesforce rappelle d'ailleurs dans son module d'optimisation de compte qu'il n'y a pas de plafond au nombre de data extensions, mais qu'un volume trop important ralentit l'interface et l'API.
Ce qu'un bon nom doit faire
Un bon nom répond à quatre questions avant même d'ouvrir la table : de quel type de données s'agit-il, quel domaine ou quelle marque en est responsable, que contient-elle, et quel est son périmètre. Il doit se trier correctement dans une liste, survivre à un copier-coller dans un éditeur SQL et rester lisible pour la personne qui rejoindra l'équipe l'an prochain. Il doit aussi rester lisible pour un assistant IA pour Salesforce Marketing Cloud qui s'appuie sur le nom des tables pour choisir la bonne source d'une requête.
Il ne doit pas tout encoder pour autant. Le nombre de lignes, la date du dernier rafraîchissement et le nom de l'auteur ont leur place dans le champ description ou dans votre documentation, pas dans le nom.
Le modèle de nommage, avec des exemples
Le schéma : TYPE_Domaine_Descripteur_Perimetre
Le modèle comporte quatre blocs reliés par des underscores. Le premier est un préfixe de type en majuscules qui indique le rôle de la table dans votre flux de données, et le deuxième nomme le domaine métier, la marque ou le programme.
Le troisième décrit le contenu. Le quatrième précise le périmètre : une région, une langue, une fréquence ou un canal.
L'audience fidélité de la newsletter française devient SND_Fidelite_MembresGold_FR. Le flux de commandes quotidien qui arrive de votre plateforme e-commerce devient IMP_Commandes_Ecommerce_Quotidien. Le référentiel client partagé entre toutes les business units devient MASTER_Clients_Global.
Évitez les accents dans les noms de tables et de champs : ils passent dans l'interface, mais ils compliquent les exports, les intégrations et la saisie au clavier pour les collègues qui n'ont pas de clavier français.
Les préfixes de type que nous recommandons
Gardez une liste assez courte pour être mémorisée. Sept préfixes couvrent presque toutes les tables d'un compte SFMC, et chacun correspond à une action de données habituelle dans Automation Studio.
| Préfixe | Contenu | Exemple | Action de données habituelle |
|---|---|---|---|
| MASTER | Référentiels, une ligne par client ou par produit | MASTER_Clients_Global | Update (Add and Update à l'import) |
| IMP | Imports bruts issus de fichiers ou d'intégrations | IMP_Commandes_Ecommerce_Quotidien | Overwrite ou Append |
| STG | Tables intermédiaires produites au milieu d'une automatisation | STG_Fidelite_Scores_Mensuel | Overwrite |
| SEG | Segments non envoyables utilisés comme briques | SEG_Fidelite_Gold_Actifs | Overwrite |
| SND | Audiences envoyables, utilisées par les envois et Journey Builder | SND_Fidelite_MembresGold_FR | Overwrite |
| SUP | Listes de suppression et d'exclusion | SUP_HardBounce_Global | Append ou Overwrite |
| LOG | Journaux d'envoi et tables d'audit qui grossissent dans le temps | LOG_SendLog_Global | Append |
Les tables temporaires et de test reçoivent un suffixe de cycle de vie plutôt qu'un préfixe dédié : SEG_Fidelite_Gold_Actifs_TST pendant la construction, puis _DELETEME quand elles peuvent disparaître. Salesforce recommande précisément ce type de suffixe dans ses conseils de nettoyage de compte, parce qu'il transforme l'audit en une simple recherche.
Les règles qui rendent un nom compatible avec le SQL
Ni espaces, ni caractères spéciaux
SFMC accepte les espaces dans les noms de data extensions et de champs, mais le SQL les tolère mal. Tout nom contenant un espace doit être entouré de crochets dans la requête, et la règle vaut aussi pour les champs. Une convention qui interdit les espaces et toute ponctuation autre que l'underscore supprime une famille entière d'erreurs de requête.
Le même raisonnement s'applique aux colonnes. Nommez un champ DateCommande plutôt que Date de commande, et OptInEmail plutôt que Opt-in email ?. Des noms sans crochets rendent aussi les jointures bien plus lisibles le jour où vous devez croiser deux tables.
Voici à quoi ressemble une requête quand chaque table suit la convention. Elle s'exécute dans une business unit enfant et lit le référentiel client partagé grâce au préfixe ENT..
SELECT
c.SubscriberKey,
c.EmailAddress,
c.Country
FROM ENT.MASTER_Customers_Global AS c
INNER JOIN SEG_Loyalty_Gold_Active AS s
ON s.SubscriberKey = c.SubscriberKey
WHERE c.EmailOptIn = 1
AND c.Country = 'FR'
AND NOT EXISTS (
SELECT 1
FROM ENT.SUP_HardBounce_Global AS b
WHERE b.SubscriberKey = c.SubscriberKey
)
- Le SELECT ne ramène que les champs dont l'audience envoyable a besoin : la clé, l'adresse et le pays utilisé pour le routage.
- ENT.MASTER_Customers_Global est le référentiel client partagé du compte parent ; le préfixe ENT est le moyen, depuis une business unit enfant, d'atteindre une data extension partagée en SQL.
- L'INNER JOIN sur SEG_Loyalty_Gold_Active ne conserve que les clients présents dans le segment Gold, construit par une requête précédente de la même automatisation.
- La clause WHERE applique le consentement et le pays, puis NOT EXISTS écarte toute personne présente dans la table de suppression des hard bounces.
- Data extension cible : SND_Loyalty_GoldMembers_FR, envoyable, clé primaire SubscriberKey, action Overwrite pour reconstruire l'audience à chaque exécution.
Lisez cette requête sans contexte : vous savez ce qu'est chaque table, où elle se trouve et pourquoi elle est là. C'est exactement ce que la convention doit permettre.
Une clé externe courte et stable
La clé externe (customer key) est ce qu'utilisent les API, l'activité d'import et beaucoup d'intégrations pour retrouver une data extension. La documentation développeur de Salesforce recommande de limiter cette clé à 36 caractères et prévient qu'une clé plus longue peut perturber d'autres traitements. Renseignez-la explicitement avec la même valeur que le nom, tronquée si nécessaire, plutôt que d'accepter le GUID généré.
Ne renommez jamais une table lue par une requête
Comme le SQL désigne les data extensions par leur nom, renommer une table casse en silence toutes les activités de requête qui la lisent. L'activité échoue à sa prochaine exécution, et la validation signale la table manquante dès que quelqu'un rouvre la requête. Pour adopter une convention dans un compte existant, créez la table au bon nom, repointez les requêtes, faites tourner les deux versions pendant un cycle, puis retirez l'ancienne avec le suffixe _DELETEME. Le guide sur la configuration d'une activité de requête dans Automation Studio détaille le paramétrage de la cible et de l'action de données.
Arborescence des dossiers et gouvernance du cycle de vie
Des dossiers qui reflètent les préfixes
Dossiers et préfixes doivent raconter la même histoire, pour qu'une table soit trouvable aussi bien en naviguant qu'en cherchant. Une arborescence qui fonctionne dans la plupart des comptes prévoit un dossier de premier niveau par préfixe de type, puis un sous-dossier par domaine métier.
Ainsi SND_Fidelite_MembresGold_FR se trouve dans Data Extensions, puis Envoyables, puis Fidélité. Le référentiel client partagé vit dans Shared Data Extensions, puis Master. Les imports atterrissent dans un dossier Imports, où la rétention est réglée de façon agressive puisque le fichier brut n'est pas la source de vérité.
C'est aussi là que l'outillage IA prend tout son sens : quand un outil lit les métadonnées de vos data extensions pour transformer les membres Gold du programme fidélité en France qui acceptent les emails en requête, ce sont des noms propres et une arborescence claire qui lui permettent de choisir la bonne table source plutôt qu'une copie obsolète.
Suffixes de cycle de vie et rétention
Une convention ne vaut que par le nettoyage qu'elle rend possible. Trois habitudes gardent un compte propre dans la durée.
- Définissez une politique de rétention dès la création sur chaque table IMP, STG et TMP, en supprimant les lignes ou la table entière après un délai fixe, pour que les données temporaires expirent sans qu'un humain ait à y penser.
- Marquez tout ce qui doit être retiré avec _DELETEME et lancez chaque trimestre une recherche sur ce suffixe, en supprimant ce qui dépasse le délai de grâce convenu.
- Indiquez un responsable dans le champ description de chaque table MASTER et SND, et confrontez chaque trimestre la liste des tables SND aux envois et aux journeys réellement actifs.
Si vous gérez plusieurs marques, l'article sur la gestion des audiences à l'échelle de plusieurs business units traite le volet data extensions partagées du même problème. Et pour choisir la bonne action de données sur chaque table, relisez Overwrite, Update ou Append dans une requête SFMC.
Déployer la convention dans un compte existant
Inutile de prévoir une migration massive. Appliquez la convention vers l'avant d'abord, puis nettoyez vers l'arrière là où cela en vaut la peine.
- Rédigez la convention sur une page : les quatre blocs, la liste des préfixes, les suffixes de cycle de vie et trois exemples. Rangez-la là où tous les utilisateurs SFMC la voient.
- Appliquez-la à chaque nouvelle data extension dès aujourd'hui, clé externe et dossier compris.
- Inventoriez les tables existantes et classez chacune en conserver, migrer ou supprimer. Commencez par les audiences envoyables et les listes de suppression, qui portent le plus de risque.
- Pour chaque table à migrer, créez le nouveau nom, repointez requêtes et imports, faites tourner les deux pendant un cycle, puis retirez l'ancienne.
- Ajoutez une rétention à chaque table d'import ou intermédiaire qui n'en a pas.
- Prévoyez une revue de nommage de 15 minutes dans la réunion ops mensuelle jusqu'à ce que la convention tienne toute seule.
Questions fréquentes
Peut-on renommer une data extension dans Marketing Cloud ?
Oui, le nom se modifie dans Contact Builder et dans Email Studio. Mais les activités de requête SQL désignent la table par son nom : chaque requête qui la lit doit être mise à jour, et toute source d'entrée Journey Builder ou tout envoi qui l'utilise mérite une vérification. Considérez un renommage comme une petite migration, pas comme un changement cosmétique.
Faut-il mettre une date dans le nom d'une data extension ?
Seulement quand la date fait partie de l'identité de la table, par exemple une audience de campagne ponctuelle qui ne sera jamais rafraîchie. Pour une table récurrente, une date dans le nom devient fausse dès la première réexécution et incite à créer des copies. Placez plutôt la fréquence dans le bloc périmètre, comme dans IMP_Commandes_Ecommerce_Quotidien.
Comment interroger une data extension partagée en SQL dans SFMC ?
Depuis une business unit enfant, ajoutez le préfixe ENT. devant le nom de la data extension partagée, par exemple FROM ENT.MASTER_Customers_Global. Le module Trailhead consacré au SQL documente ce préfixe, ainsi que la règle qui impose des crochets autour des noms contenant des espaces.
Existe-t-il une limite au nombre de data extensions par compte ?
Salesforce indique qu'il n'y a pas de limite fixe, tout en précisant qu'un très grand nombre de data extensions dégrade les performances de l'interface et de l'API. C'est la raison pratique de combiner convention de nommage, politiques de rétention et nettoyage régulier.
Des noms propres, et QAiry s'occupe du SQL
Une convention de nommage claire accélère chaque création d'audience, que la requête soit écrite par une personne ou par une IA. QAiry lit les data extensions de votre compte SFMC et transforme une demande en langage courant en SQL prêt pour la production, avec sa data extension cible ; des tables bien nommées rendent cette traduction d'autant plus précise.
Vous pouvez installer QAiry gratuitement dans votre propre compte SFMC, ou regarder les démos produit pour voir une demande devenir une audience de bout en bout.

