sessionProp

addFmtLib

L'essentiel
Auf einen Blick
Die korrekte Interpretation analytischer Ergebnisse hängt oft von der Bereitstellung passender Formatvorlagen ab, wofür die addFmtLib-Funktion innerhalb der SAS Viya-Architektur zuständig ist. Mit diesem Befehl integrieren Administratoren und Analysten benutzerdefinierte Formatbibliotheken in die laufende CAS-Sitzung, sodass numerische Codes oder Abkürzungen während der Verarbeitung automatisch in aussagekräftige Textwerte übersetzt werden können. Unser untenstehender FAQ-Bereich behandelt technische Details zur Übernahme bestehender Formatkataloge und zur Lösung typischer Konfigurationsprobleme, um eine konsistente Datenansicht zu gewährleisten.

Beschreibung

Fügt eine benutzerdefinierte Formatbibliothek zur aktuellen CAS-Sitzung hinzu. Formatbibliotheken ermöglichen es, Rohdatenwerte in benutzerfreundliche und verständliche Beschriftungen umzuwandeln, was für die Berichterstellung und Datenanalyse unerlässlich ist. Diese Aktion kann Formate aus einer CAS-Tabelle (SASHDAT-Datei) oder direkt aus einem Dateisystempfad laden, der für den CAS-Controller zugänglich ist.

sessionProp.addFmtLib <result=results> <status=rc> / caslib="string", fmtLibName="string", fmtSearch="APPEND" | "INSERT" | "NONE" | "REPLACE", name="table-name", path="string", promote=TRUE | FALSE, replace=TRUE | FALSE;
Einstellungen
ParameterBeschreibung
caslib Gibt die Caslib an, in der sich die Formatbibliothek befindet.
fmtLibName Gibt den Namen der Formatbibliothek an.
fmtSearch Gibt die Suchreihenfolge der Formatbibliothek an. Standard ist APPEND.
name Gibt den Namen der Formatbibliothekstabelle in der Caslib an.
path Gibt den Pfad zu einer Formatbibliothek an. Der Pfad muss vom Controller-Knoten des Servers lesbar sein.
promote Wenn auf True gesetzt, wird die Formatbibliothek in den globalen Geltungsbereich befördert. Erfordert möglicherweise Administratorrechte.
replace Wenn auf True gesetzt, wird eine vorhandene Formatbibliothek mit demselben Namen ersetzt.
Erstellung von Beispieldaten

Erstellt eine einfache CAS-Tabelle 'cars_data' mit Automodellen und deren Herkunftsland-Codes, um die Verwendung von Formaten zu demonstrieren.

Kopiert!
1PROC CAS;
2 DATA casuser.cars_data;
3 INFILE DATALINES delimiter=',';
4 INPUT Model $20. Origin 1.;
5 DATALINES;
6 Chevrolet Chevelle,1
7 Buick Skylark,1
8 Renault 12,2
9 Datsun 510,3
10 ;
11 RUN;
12QUIT;

Beispiele

Dieses Beispiel geht davon aus, dass eine SASHDAT-Datei mit dem Namen 'myformats.sashdat' bereits in der Caslib 'casuser' vorhanden ist. Die Aktion `addFmtLib` wird verwendet, um diese Formate unter dem Namen 'myformats' zur Sitzung hinzuzufügen.

SAS® / CAS-Code Code wartet auf Validierung durch die Community
Kopiert!
1PROC CAS;
2 sessionprop.addFmtLib /
3 caslib="casuser"
4 name="myformats.sashdat"
5 fmtLibName="myformats";
6QUIT;
Ergebnis :
Die Formatbibliothek 'myformats' wird erfolgreich zur Sitzung hinzugefügt. Nachfolgende Aktionen können die in dieser Bibliothek definierten Formate verwenden.

Dieses Beispiel zeigt den gesamten Prozess: 1. Erstellen eines benutzerdefinierten Formats `$country.` mit `PROC FORMAT`. 2. Speichern der Formate in einer Kontrolltabelle mit `fmtLibCntlOut`. 3. Hochladen dieser Tabelle in eine CAS-Tabelle. 4. Hinzufügen der Formatbibliothek zur Sitzung mit `addFmtLib`. 5. Anwenden des Formats auf unsere Beispieldaten mit der Aktion `simple.freq` zur Überprüfung.

SAS® / CAS-Code Code wartet auf Validierung durch die Community
Kopiert!
1PROC FORMAT;
2 value country 1='USA' 2='Europe' 3='Asia';
3RUN;
4 
5PROC CASUTIL;
6 save casdata='work.formats' outcaslib='casuser' casout='myformats' replace;
7QUIT;
8 
9PROC CAS;
10 sessionprop.addFmtLib /
11 caslib="casuser"
12 name="myformats"
13 fmtLibName="myformats"
14 replace=true;
15 
16 SIMPLE.freq /
17 TABLE={caslib="casuser", name="cars_data"}
18 inputs={{name="Origin", FORMAT="country."}};
19QUIT;
Ergebnis :
Die Frequenztabelle zeigt die formatierte Spalte 'Origin' mit den Ländernamen ('USA', 'Europe', 'Asia') anstelle der numerischen Codes, was bestätigt, dass die Formatbibliothek erfolgreich erstellt, hinzugefügt und angewendet wurde.

FAQ

Was ist der Zweck der `addFmtLib`-Aktion?
Wie wird der `caslib`-Parameter in der `addFmtLib`-Aktion verwendet?
Welche Funktion hat der `fmtLibName`-Parameter?
Wie beeinflusst der `fmtSearch`-Parameter die Suchreihenfolge?
Was gibt der `name`-Parameter an?
Welche Anforderungen gelten für den `path`-Parameter?
Was bewirkt die Aktivierung des `promote`-Parameters?
Was passiert, wenn der `replace`-Parameter auf True gesetzt wird?

Zugehörige Szenarien

Anwendungsfall
Standard-Segmentierung von Kundendaten für eine Marketingkampagne

Eine Marketingabteilung möchte Kundendaten für eine bevorstehende Kampagne analysieren. Die Kundensegmente (z. B. 1=Hoher Wert, 2=Mittlerer Wert) und Regionen (z. B. 10=DACH, 20...

Anwendungsfall
Laden und Promoten einer großen, globalen Formatbibliothek für die Produktanalyse

Ein großes Einzelhandelsunternehmen verwaltet Tausende von Produktkategorien mit numerischen Codes. Für eine unternehmensweite Umsatzanalyse muss eine sehr große Formatbibliothe...

Anwendungsfall
Testen von Konflikten, Fehlern und Suchreihenfolgen mit mehreren Formatbibliotheken

Ein Data-Governance-Team muss die Regeln für die Formatverwaltung definieren. Es muss verstehen, wie das System auf Konflikte reagiert, wenn mehrere Formatbibliotheken mit überl...