sessionProp

getSessOpt

##set_sessionprop

Description

L'action getSessOpt est votre détective privé personnel au sein de SAS Cloud Analytic ServicesMoteur analytique distribué et en mémoire (in-memory) au cœur de SAS Viya. Il assure le traitement des données et l'exécution des modèles avec une très haute performance. . Elle permet d'extraire la valeur actuelle d'une option de sessionInstance de connexion active entre un client et le serveur CAS (Cloud Analytic Services), isolant les ressources, les bibliothèques et les traitements d'un utilisateur au sein de SAS Viya. spécifique. Que vous soyez curieux de connaître votre fuseau horaire actuel (TIMEZONEOption de configuration ou constante système définissant le décalage horaire régional pour normaliser l'affichage, le stockage et le calcul des dates et heures au sein de l'architecture SAS Viya.) ou que vous vouliez vérifier si votre DATA StepBloc de programmation SAS itératif utilisé pour lire, transformer et manipuler des données ligne par ligne afin de créer des tables de sortie personnalisées et calculer de nouvelles variables. va hurler à la moindre erreur de format (DATASTEPFMTERROption système contrôlant le comportement de l'étape DATA lorsqu'un format est introuvable. Activée, elle génère une erreur et arrête l'exécution ; désactivée, elle émet un simple avertissement.), cette action vous donne la réponse brute. C'est un peu comme demander à votre voiture quelle est sa consommation réelle plutôt que de croire la brochure publicitaire.

Syntaxe Officielle
sessionProp.getSessOpt /
name="nom-de-l-option";

Paramètres Clés

Nom du paramètre Description
name Spécifie le nom technique de l'option de session à afficher. Les valeurs acceptées incluent des options de performance (METRICS, MAXTABLEMEM), de localisation (LOCALE, TIMEZONE), ou de comportement du moteur (CASLIB, DATASTEPVARLENCHK). La liste complète est disponible dans la documentation officielle .

Préparation des données

Préparation de l'environnement de test

Pour tester la récupération d'options, nous allons d'abord définir une option de session (le tag de l'application) afin de vérifier que getSessOpt la retrouve correctement.

1PROC CAS;
2 sessionProp.setSessOpt / apptag="Expert_Viya_Demo";
3RUN;

Exemples d'utilisation

Vérifier la Caslib active

Un grand classique : savoir sur quelle bibliothèque de données (caslib) votre session pointe par défaut.

1PROC CAS;
2 sessionProp.getSessOpt / name="CASLIB";
3RUN;
Résultat Attendu :
Le journal affichera le nom de la caslib par défaut (souvent CASUSER).
Vérifier le Timezone

Idéal pour savoir si votre serveur vit encore à l'heure du siège social en Caroline du Nord ou s'il est synchronisé avec vous.

1PROC CAS;
2 sessionProp.getSessOpt / name="TIMEZONE";
3RUN;
Résultat Attendu :
Affiche le fuseau horaire utilisé pour les fonctions de date et heure de la session.
Audit de la configuration du DATA Step CAS

Dans cet exemple, nous vérifions comment le DATA Step va se comporter en cas de fusion sans clause BY ou de formats manquants.

1PROC CAS;
2 PRINT "--- Vérification FMTERR ---";
3 sessionProp.getSessOpt / name="DATASTEPFMTERR";
4 PRINT "--- Vérification MERGENOBY ---";
5 sessionProp.getSessOpt / name="DATASTEPMERGENOBY";
6 PRINT "--- Vérification VARLENCHK ---";
7 sessionProp.getSessOpt / name="DATASTEPVARLENCHK";
8RUN;
Résultat Attendu :
Une série de rapports dans le journal indiquant les comportements (ERROR, WARNING ou IGNORE) pour chaque situation de DATA Step.
Inspection des limites de mémoire et performance

Vérifions les ressources allouées à la session pour éviter de faire exploser le serveur (et s'attirer les foudres de l'admin).

1PROC CAS;
2 /* Vérifie la mémoire maximale pour une table */
3 sessionProp.getSessOpt / name="MAXTABLEMEM";
4 /* Vérifie si les métriques d'exécution sont activées */
5 sessionProp.getSessOpt / name="METRICS";
6 /* Vérifie le nombre de workers actifs */
7 sessionProp.getSessOpt / name="NWORKERS";
8RUN;
Résultat Attendu :
Affichage des seuils de mémoire en octets, du statut des métriques (True/False) et du nombre de nœuds de calcul.
Récupération dynamique dans une variable CASL

Utilisation de getSessOpt pour stocker la valeur dans une variable et l'utiliser plus tard dans un script complexe.

1PROC CAS;
2 sessionProp.getSessOpt / name="LOCALE" RESULT=r;
3 maLocale = r.LOCALE;
4 PRINT "Votre session parle actuellement le : " maLocale;
5RUN;
Résultat Attendu :
Le journal affichera une phrase personnalisée avec la locale (ex: fr_FR).