Contrôler la Caslib Active

Comment le paramètre activeOnAdd affecte-t-il l'activation immédiate d'une nouvelle caslib? - addCaslib

Le paramètre activeOnAdd, lorsqu'il est défini sur TRUE (valeur par défaut), indique que la nouvelle caslibEspace de stockage logique dans SAS Viya. Elle définit l’accès aux données (source physique) et leur chargement en mémoire (serveur CAS) pour permettre des analyses distribuées haute performance. créée par l'action table.addCaslib sera immédiatement définie comme la caslibEspace de stockage logique dans SAS Viya. Elle définit l’accès aux données (source physique) et leur chargement en mémoire (serveur CAS) pour permettre des analyses distribuées haute performance. active de la 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.. Cela signifie que les opérations de table subséquentes (comme le chargement de données) cibleront par défaut cette nouvelle caslibEspace de stockage logique dans SAS Viya. Elle définit l’accès aux données (source physique) et leur chargement en mémoire (serveur CAS) pour permettre des analyses distribuées haute performance., sans nécessiter d'activation manuelle. Si FALSE est spécifié, la caslibEspace de stockage logique dans SAS Viya. Elle définit l’accès aux données (source physique) et leur chargement en mémoire (serveur CAS) pour permettre des analyses distribuées haute performance. est créée mais n'est pas activée par défaut, nécessitant une activation explicite si elle doit être utilisée immédiatement.

Schéma : Comment le paramètre activeOnAdd affecte-t-il l'activation immédiate d'une nouvelle caslib?

Exemple de Code Additionnel

1	<pre>/* CASL Script : Comparaison du comportement activeOnAdd
2	(c) Nicolas Housset 2026 - Code SAS pour VIYA 4 - testé et validé en version 2024.09 */
3	PROC CAS;
4	/* 1. Création avec activation automatique (Défaut) */
5	TABLE.addCaslib /
6	name="CaslibActive",
7	datasource={srctype="path"},
8	path="/data/projects/sales/",
9	activeOnAdd=true; / La caslib active devient 'CaslibActive' */
10	/* Vérification du pointeur de session */
11	sessionprop.getSessOpt / name="caslib";
12	/* 2. Création sans activation */
13	TABLE.addCaslib /
14	name="CaslibPassive",
15	datasource={srctype="path"},
16	path="/data/projects/archive/",
17	activeOnAdd=false;
18	/* Le pointeur reste sur 'CaslibActive' malgré la création de 'CaslibPassive' */
19	sessionprop.getSessOpt / name="caslib";
20	QUIT;</pre>

Exemples pour l'action addCaslib

Ajouter une Caslib basée sur un chemin de fichiers système (PATH)

Cet exemple ajoute une caslib basique pointant vers un dossier local du serveur. Un grand classique indémodable !

Ajouter une Caslib vers une base de données Oracle

Cet exemple illustre l'ajout d'une caslib connectée à Oracle. Notez l'utilisation du bloc %%dataSource%% pour spécifier les informations de connexion, afin de lire directement depuis le SGBD.

Vous pourriez aussi aimer...

Conseil de l'Expert

Bien que l'activation automatique (activeOnAdd=true) soit très pratique pour l'exploration de données interactive (ad-hoc), elle peut devenir une source de bugs furtifs dans des programmes d'intégration en production.

En production, je recommande de forcer activeOnAdd=FALSE lors de l'exécution de scripts complexes manipulant plusieurs sources. Cela évite les effets de bord où une action table.loadTable chargerait accidentellement des données dans la mauvaise caslib simplement parce qu'elle a été la dernière créée.

Mécanismes Techniques et Comportements de Session

Priorité de Résolution : Lorsqu'il est à TRUE, le paramètre modifie instantanément la variable de session _CASLIB_. Toute action ultérieure ne spécifiant pas explicitement le paramètre caslib= utilisera cette nouvelle cible.
Portée de Session vs Globale : L'activation via activeOnAdd est strictement limitée à la session courante. Si la caslib est ajoutée avec une portée globale (promote=TRUE), elle ne devient pas automatiquement active pour les autres sessions existantes.
Chaînage d'Actions : Ce paramètre est essentiel pour le "pipelining" en CASL. Il permet de supprimer la redondance syntaxique dans les scripts de type Landing Zone vers Gold Zone.
Gestion des Erreurs : Si l'ajout de la caslib échoue (ex: droits d'accès insuffisants sur le path), le pointeur de la caslib active reste sur la valeur précédente, évitant ainsi un état de session instable.
Interaction avec CASLIB ALL : L'activation automatique n'influence pas l'affichage des listes globales, mais elle prévaut sur la hiérarchie de recherche lors de l'utilisation de noms de tables non qualifiés.