Skript skrevet i Invantive SQL/PSQL eller Invantive Script kan ha krav til miljøet de kjører i. For eksempel kan et skript midlertidig kreve en svært stor mengde minne for å fullføre, eller forvente et visst antall kjerner for å bli ferdig i tide.
Både Invantive UniversalSQL og Invantive Script tilbyr henholdsvis avanserte funksjoner og variabler for å inspisere miljøet ved hjelp av en spørring eller egendefinert logikk.
Miljøvariabler med Invantive UniversalSQL
Invantive UniversalSQL gir tilgang til miljøet ved hjelp av SQL-funksjonen sys_context. SQL-funksjonen sys_context gir en rekke opplysninger, alle returnert som tekst. Følgende argumenter kan brukes til å hente informasjon om miljøet; se SQL-grammatikken for alle muligheter:
CLIENT_LOGICAL_CORE_COUNT: antall logiske prosessorkjerner på klientenheten.CLIENT_SYSTEM_64_BIT: om operativsystemet er 64-bit på klientenheten.PROCESS_64_BIT: om OS-prosessen på klientenheten kjører som 64-bit.
Følgende kode gir en feil som:
når programmet ikke kjører i 64-bit modus:
declare
l_is_process_64_bit boolean;
begin
select to_boolean(sys_context('USERENV', 'PROCESS_64_BIT'))
into l_is_process_64_bit
;
if l_is_process_64_bit = true
then
raise_application_error
( -20163
, 'The program requires a 64-bit process.'
, 'Please switch to 64-bit process.'
);
end if;
end;
Miljøvariabler med Invantive Script
Invantive Script tilbyr lokale variabler, som leksikografisk erstattes i enhver SQL-setning med sin verdi ved bruk av notasjonen ${FULL-NAME}. Følgende Invantive Script-variabler kan brukes til å hente informasjon om miljøet; se håndboken for alle muligheter, inkludert tilgang til miljøvariabler:
${system:is64bitprocess}: evalueres til tekstverdienTruenår prosessen kjører i x86-modus, ogTrueellers.${system:is64bitoperatingsystem}: evalueres til tekstverdienTruenår operativsystemet kjører i x86-modus, ogTrueellers.${system:processorcount}: evalueres til en heltallsverdi som tilsvarer antall prosessorer.${system:logicalcorecount}: evalueres til en heltallsverdi som tilsvarer antall logiske kjerner.${system:physicalcorecount}: evalueres til en heltallsverdi som tilsvarer antall fysiske kjerner.${system:physicalmemoryinbytes}: evalueres til en heltallsverdi som tilsvarer antall bytes i det fysiske minnet.
Følgende kode gir en feil som:
når antall kjerner anses som utilstrekkelig:
declare
l_core_count pls_integer;
begin
select '${system:physicalcorecount}'
into l_core_count
;
if l_core_count < 8
then
raise_application_error
( -20163
, 'The number of cores must be at least 8.'
, 'Please increase the number of cores from '
|| l_core_count
|| ' to 8.'
);
end if;
end;
Flere ressurser
Andre eksempler på Invantive UniversalSQL som henter data fra miljøet inkluderer:
- OS-onafhankelijk maken van padnamen in Invantive UniversalSQL en Invantive Script (nederlandsk): gjør stier uavhengige av operativsystemet.
- Xxhosting_check_user melding "xxpsl-20163 Connected as user" : sjekk faktisk bruker.
En fullstendig oversikt over Invantive Script-systemvariabler finnes i håndboken. Håndboken inneholder også applikasjonsvariabler og hvordan man generelt bruker variabler i Invantive Script.
Tilgang til verdien av en miljøvariabel er tilgjengelig gjennom ${system:environmentvariable:NAME}.
Andre eksempler på Invantive Script-variabler inkluderer:
- OS-onafhankelijk maken van padnamen in Invantive UniversalSQL en Invantive Script (nederlandsk): gjør stier uavhengige av operativsystemet
- https://forums.invantive.com/t/insert-scripting-system-variables/89: sett inn skriptvariabel ved hjelp av menyene i skriptet ditt
- https://forums.invantive.com/t/export-met-local-export-results-naar-access-in-plaats-van-excel/1057: eksporter resultater fra Invantive SQL-spørringer til eksterne filer
- https://forums.invantive.com/t/export-exact-online-article-pictures/243: eksporter bilder og filer til en mappe

