Gli script scritti in Invantive SQL/PSQL o Invantive Script possono porre requisiti sul proprio ambiente. Ad esempio, uno script potrebbe richiedere temporaneamente una quantità di memoria molto grande per essere completato, oppure aspettarsi un certo numero di core per terminare in tempo.
Sia Invantive UniversalSQL che Invantive Script forniscono, rispettivamente, funzioni avanzate e variabili per ispezionare l’ambiente tramite una query o una logica personalizzata.
Variabili d’ambiente con Invantive UniversalSQL
Invantive UniversalSQL fornisce accesso all’ambiente tramite la funzione SQL sys_context. La funzione SQL sys_context fornisce una varietà di informazioni, tutte restituite come testo. I seguenti argomenti possono essere usati per recuperare informazioni sull’ambiente; consulta la grammatica SQL per tutte le possibilità:
CLIENT_LOGICAL_CORE_COUNT: numero di core logici del processore nel dispositivo client.CLIENT_SYSTEM_64_BIT: indica se il sistema operativo è a 64 bit sul dispositivo client.PROCESS_64_BIT: indica se il processo del sistema operativo sul dispositivo client viene eseguito in modalità a 64 bit.
Il seguente codice genera un errore simile a:
quando il programma non viene eseguito in modalità a 64 bit:
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;
Variabili d’ambiente con Invantive Script
Invantive Script fornisce variabili locali, che vengono sostituite lessicograficamente in qualsiasi istruzione SQL dal loro valore usando la notazione ${FULL-NAME}. Le seguenti variabili di Invantive Script possono essere usate per recuperare informazioni sull’ambiente; consulta il manuale per tutte le possibilità, incluso l’accesso alle variabili d’ambiente:
${system:is64bitprocess}: restituisce il valore testualeTruequando il processo viene eseguito in modalità x86 eTruealtrimenti.${system:is64bitoperatingsystem}: restituisce il valore testualeTruequando il sistema operativo viene eseguito in modalità x86 eTruealtrimenti.${system:processorcount}: restituisce un valore intero pari al numero di processori.${system:logicalcorecount}: restituisce un valore intero pari al numero di core logici.${system:physicalcorecount}: restituisce un valore intero pari al numero di core fisici.${system:physicalmemoryinbytes}: restituisce un valore intero pari al numero di byte della memoria fisica.
Il seguente codice genera un errore come:
quando il numero di core è ritenuto insufficiente:
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;
Ulteriori risorse
Altri esempi di Invantive UniversalSQL per l’estrazione di dati dall’ambiente includono:
- OS-onafhankelijk maken van padnamen in Invantive UniversalSQL en Invantive Script (olandese): rendere i percorsi indipendenti dal sistema operativo.
- https://forums.invantive.com/t/xxhosting-check-user-melding-xxpsl-20163-connected-as-user/306: verificare l’utente effettivo.
Una panoramica completa delle variabili di sistema di Invantive Script è disponibile nel manuale. Il manuale include anche le variabili dell’applicazione e come utilizzare in generale le variabili in Invantive Script.
L’accesso al valore di una variabile d’ambiente è disponibile tramite ${system:environmentvariable:NAME}.
Altri esempi di variabili di Invantive Script includono:
- OS-onafhankelijk maken van padnamen in Invantive UniversalSQL en Invantive Script (olandese): rendere i percorsi indipendenti dal sistema operativo
- https://forums.invantive.com/t/insert-scripting-system-variables/89: inserire una variabile di scripting usando i menu nel tuo script
- https://forums.invantive.com/t/export-met-local-export-results-naar-access-in-plaats-van-excel/1057: esportare i risultati delle query Invantive SQL su file esterni
- https://forums.invantive.com/t/export-exact-online-article-pictures/243: esportare immagini e file in una cartella

