Come controllare il proprio ambiente usando Invantive UniversalSQL o Invantive Script?

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 testuale True quando il processo viene eseguito in modalità x86 e True altrimenti.
  • ${system:is64bitoperatingsystem}: restituisce il valore testuale True quando il sistema operativo viene eseguito in modalità x86 e True altrimenti.
  • ${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:

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: