table

attribute

Description

L'action `attribute` du jeu d'actions `table` est un outil puissant pour gérer les métadonnées étendues associées aux tables en mémoire dans CAS. Elle permet d'ajouter, de mettre à jour, de supprimer, d'exporter ou de convertir des attributs personnalisés pour une table entière ou pour des colonnes spécifiques. Ces attributs, stockés sous forme de paires clé-valeur, sont essentiels pour enrichir les données avec du contexte supplémentaire, comme des informations de version, des descriptions de variables, des règles de validation ou des métadonnées métier, sans altérer la structure des données elles-mêmes.

table.attribute <result=results> <status=rc> / attributes={{casattribute-1} <, {casattribute-2}, ...>}, caslib="string", name="string", set="string", table="string", task="ADD" | "CONVERT" | "DROP" | "EXPORT" | "UPDATE", xml="string", xmlPath="string";
Paramètres
ParamètreDescription
attributesSpécifie les attributs étendus à gérer. Vous devez spécifier le paramètre `set` si vous utilisez ce paramètre.
caslibSpécifie la caslib cible pour la table d'attributs étendus.
nameSpécifie le nom de la table en mémoire à laquelle les attributs sont associés.
setSpécifie le nom de l'ensemble d'attributs étendus.
tableSpécifie le nom d'une table d'attributs étendus existante à utiliser avec une tâche ADD, UPDATE ou CONVERT.
taskSpécifie la tâche à effectuer (ADD, CONVERT, DROP, EXPORT, UPDATE). La valeur par défaut est ADD.
xmlSpécifie les attributs étendus sous forme de document XML.
xmlPathSpécifie le chemin d'accès à un fichier contenant les attributs étendus sous forme de document XML.
Préparation des Données Voir la fiche de ce code dataprep
Création de la table de données

Ce code crée une table nommée `CARS_ATTRIBUTES` dans la caslib `casuser`. Cette table sera utilisée dans les exemples pour démontrer la gestion des attributs étendus.

Copié !
1 
2DATA casuser.cars_attributes;
3SET sashelp.cars;
4RUN;
5 

Exemples

Cet exemple montre comment ajouter un attribut de table simple, 'Version', avec la valeur '1.0', à la table `CARS_ATTRIBUTES`.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1PROC CAS;
2 TABLE.attribute /
3 name='CARS_ATTRIBUTES',
4 caslib='casuser',
5 task='ADD',
6 attributes={{key='Version', value='1.0'}};
7RUN;
8QUIT;
Résultat :
L'action ajoute l'attribut 'Version' à la table spécifiée. Aucune sortie visible n'est produite, mais les métadonnées de la table sont mises à jour.

Cet exemple détaillé illustre un cycle de vie complet de la gestion des attributs. Il commence par ajouter un attribut de table ('Source') et un attribut de colonne ('Description' pour la colonne 'MPG_City'). Ensuite, il met à jour la valeur de l'attribut de table, puis supprime l'attribut de colonne.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1PROC CAS;
2 /* Étape 1: Ajouter des attributs de table et de colonne */
3 TABLE.attribute /
4 name='CARS_ATTRIBUTES',
5 caslib='casuser',
6 task='ADD',
7 attributes=[
8 {key='Source', value='Internal Data Feed'},
9 {key='Description', value='Miles Per Gallon (City)', column='MPG_City'}
10 ];
11 
12 /* Étape 2: Mettre à jour un attribut de table */
13 TABLE.attribute /
14 name='CARS_ATTRIBUTES',
15 caslib='casuser',
16 task='UPDATE',
17 attributes={{key='Source', value='Validated Internal Data Feed'}};
18 
19 /* Étape 3: Supprimer un attribut de colonne */
20 TABLE.attribute /
21 name='CARS_ATTRIBUTES',
22 caslib='casuser',
23 task='DROP',
24 attributes={{key='Description', column='MPG_City'}};
25RUN;
26QUIT;
Résultat :
Les attributs de la table `CARS_ATTRIBUTES` sont modifiés séquentiellement. L'attribut 'Source' est d'abord ajouté puis sa valeur est mise à jour. L'attribut 'Description' de la colonne 'MPG_City' est ajouté puis supprimé. Ces opérations modifient les métadonnées sans affecter les données elles-mêmes.

Après avoir ajouté des attributs, cette action permet de les exporter et de les visualiser. L'exemple ajoute deux attributs puis utilise la tâche 'EXPORT' pour afficher les attributs existants pour la table `CARS_ATTRIBUTES`.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1PROC CAS;
2 TABLE.attribute /
3 name='CARS_ATTRIBUTES',
4 caslib='casuser',
5 task='ADD',
6 attributes=[
7 {key='Owner', value='Data Science Team'},
8 {key='Confidentiality', value='Internal'}
9 ];
10 
11 TABLE.attribute /
12 name='CARS_ATTRIBUTES',
13 caslib='casuser',
14 task='EXPORT';
15RUN;
16QUIT;
Résultat :
Le résultat de l'action 'EXPORT' est une table de résultats listant tous les attributs étendus associés à la table `CARS_ATTRIBUTES`, y compris leurs clés, valeurs et les colonnes auxquelles ils s'appliquent (si applicable).

FAQ

À quoi sert l'action 'attribute' dans le jeu d'actions 'table'?
Quels sont les paramètres disponibles pour l'action 'attribute'?
Quel est le paramètre requis pour l'action 'attribute'?
Comment spécifier les attributs étendus avec le paramètre 'attributes'?
Quelle est la condition pour utiliser le paramètre 'attributes'?
À quoi sert le paramètre 'caslib'?
Que spécifie le paramètre 'set'?
Dans quel contexte utilise-t-on le paramètre 'table' (ou 'attrTable')?
Quelles sont les valeurs possibles pour le paramètre 'task' et quelle est sa valeur par défaut?
Comment peut-on fournir des attributs étendus en utilisant XML?

Scénarios associés

Cas d'usage
Scénario Standard : Gouvernance et Lignage de Données Financières

Une institution financière doit se conformer aux réglementations en documentant la provenance, la confidentialité et la propriété de ses données clients. Ce scénario valide l'aj...

Cas d'usage
Scénario Cas Limite : Gestion des Erreurs et Cycle de Vie des Attributs

Un Data Steward souhaite automatiser la gestion des métadonnées. Ce test simule des erreurs courantes (oubli d'un paramètre requis) et valide un cycle complet de sauvegarde et r...

Cas d'usage
Scénario Performance : Audit d'un Traitement Batch sur Volumétrie

Une entreprise de e-commerce exécute un traitement batch nocturne sur des millions de transactions. Il est impératif de 'taguer' la table principale avec des métadonnées d'exécu...