table

fetch

Description

L'action 'fetch' récupère des lignes d'une table ou d'une vue chargée en mémoire sur le serveur CAS. Elle est principalement utilisée pour prévisualiser les données, effectuer des vérifications rapides ou extraire des sous-ensembles de données pour l'affichage côté client. Elle permet de sélectionner des variables spécifiques, de trier les résultats et de paginer la récupération (début/fin).

table.fetch <result=results> <status=rc> / fetchVars={{format="string", formattedLength=integer, label="string", name="variable-name", nfd=integer, nfl=integer}, {...}}, format=TRUE | FALSE, from=64-bit-integer, index=TRUE | FALSE, maxRows=integer, sasTypes=TRUE | FALSE, sortBy={{formatted="FORMATTED" | "RAW", name="variable-name", order="ASCENDING" | "DESCENDING"}, {...}}, sortLocale="string", sortMethodCutoff=double, table={caslib="string", computedOnDemand=TRUE | FALSE, computedVars={{...}}, computedVarsProgram="string", dataSourceOptions={...}, groupBy={{...}}, groupByMode="NOSORT" | "REDISTRIBUTE", importOptions={...}, name="table-name", orderBy={{...}}, singlePass=TRUE | FALSE, vars={{...}}, where="where-expression"}, to=64-bit-integer;
Paramètres
ParamètreDescription
tableSpécifie la table d'entrée (nom, caslib, options de filtrage). Ce paramètre est obligatoire.
fetchVarsSpécifie la liste des variables (colonnes) à inclure dans le résultat. Si omis, toutes les variables sont retournées.
fromIndique la position ordinale de la première ligne à retourner (pour la pagination).
toIndique la position ordinale de la dernière ligne à retourner (pour la pagination). La valeur par défaut est 20.
maxRowsDéfinit le nombre maximum de lignes à retourner par table de résultat. La valeur par défaut est 1000.
sortBySpécifie une ou plusieurs variables pour trier les résultats avant de les récupérer.
indexSi défini à TRUE (par défaut), ajoute une colonne '_Index_' aux résultats pour identifier le numéro de ligne.
formatSi défini à TRUE, applique les formats SAS associés aux variables dans les résultats.
Préparation des Données Voir la fiche de ce code dataprep
Chargement des données de test

Charge la table SASHELP.CLASS dans la bibliothèque CAS 'casuser' pour les exemples.

Copié !
1 
2PROC CAS;
3 
4SESSION casauto;
5upload path="%sysfunc(pathname(sashelp))/class.sas7bdat" casout={name="class", caslib="casuser", replace=true};
6 
7RUN;
8 

Exemples

Récupère les 20 premières lignes de la table CLASS (valeur par défaut du paramètre 'to').

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1 
2PROC CAS;
3TABLE.fetch RESULT=r / TABLE={name="class", caslib="casuser"};
4PRINT r;
5 
6RUN;
7 
Résultat :
Affiche les 20 premières lignes de la table avec toutes les colonnes.

Récupère les lignes 1 à 5, triées par âge décroissant, en ne sélectionnant que le Nom et l'Âge.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1 
2PROC CAS;
3TABLE.fetch RESULT=r / TABLE={name="class", caslib="casuser"} fetchVars={"Name", "Age"} sortBy={{name="Age", order="DESCENDING"}} from=1 to=5 index=true;
4PRINT r;
5 
6RUN;
7 
Résultat :
Affiche une table de 5 lignes contenant les colonnes Name, Age et _Index_, triée par les plus âgés.

FAQ

Quelle est la fonction principale de l'action fetch ?
Comment sélectionner uniquement certaines colonnes à afficher ?
Comment limiter le nombre de lignes retournées par l'action ?
Est-il possible de trier les résultats de l'action fetch ?
Comment démarrer la récupération des lignes à partir d'une position spécifique ?
À quoi sert le paramètre "index" ?
Comment appliquer les formats aux variables récupérées ?