Hvordan sjekke miljøet ditt med Invantive UniversalSQL eller Invantive Script?

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 tekstverdien True når prosessen kjører i x86-modus, og True ellers.
  • ${system:is64bitoperatingsystem}: evalueres til tekstverdien True når operativsystemet kjører i x86-modus, og True ellers.
  • ${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:

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: