Opzioni UDX

Queste costanti sono utilizzate dal metodo 'getOptions per modificare il comportamento dell'UDX nzLua.

Tabella 1.
Opzione Descrizione
OPT_AGGTYPE Valido solo per una UDA. Predefinito = qualsiasi. Questa opzione determina se una UDA può essere usata in combinazione con la clausola analitica OVER o con l'istruzione GROUP BY. I valori indicano:
  • qualsiasi --the UDA può essere utilizzata con OVER o GROUP BY
  • analitico--UDA può essere usato solo con la clausola OVER
  • raggruppato--UDA può essere utilizzato solo con l'istruzione GROUP BY
OPT_DETERMINISTICO Un UDX deterministico restituisce sempre lo stesso valore per un dato ingresso. Ciò consente al database Netezza di evitare di richiamare l'UDX più volte se gli argomenti sono gli stessi. Questa opzione può essere impostata su true o false.
OPT_FORCE_BIGNUM Questa opzione determina il modo in cui i valori interi e numerici vengono passati a un UDX nzLua. Normalmente un valore che può essere contenuto in un doppio viene sempre passato come doppio. I valori validi per OPT_FORCE_BIGNUM sono:
  • 0 - il valore predefinito... utilizzare il bignum solo quando necessario
  • 1 - usa bignum per tutti i valori bigint, numeric64 e numeric128
  • 2 - utilizzare bignum per tutti i valori bigint, numerici e double
  • 3 - utilizzare bignum per tutti i valori interi, numerici e in virgola mobile
OPT_MEMORIA Questa impostazione non influisce direttamente sulla memoria dell'UDX, ma viene utilizzata per indicare al database Netezza la quantità di memoria utilizzata dall'UDX (in megabyte). L'impostazione OPT_MEMORY consente valori compresi tra 1 e 128. Lo scheduler di Netezza utilizza questa impostazione per assicurarsi che il sistema non esaurisca la memoria durante l'esecuzione di una query.
OPT_NULL_INPUT Se impostata su false, una UDF restituirà NULL se uno qualsiasi degli argomenti è NULL (il metodo evaluate() non verrà richiamato). Il valore predefinito per OPT_NULL_INPUT è true, in modo che il metodo evaluate() venga richiamato quando uno qualsiasi degli argomenti dell'UDF è NULL.
OPT_PARALLEL Per una funzione tabella, impostando OPT_PARALLEL=false si obbliga la funzione tabella a essere eseguita sull'host come un singolo processo invece di essere eseguita in parallelo sulle SPU.
OPT_REPLICATE_BY_SQL Quando è vero, un UDX viene registrato con la clausola DDL REPLICATE BY SQL, che attiva la replica tramite SQL invece della replica per valore predefinita (clausola DDL REPLICATE BY VALUE). Questa opzione viene utilizzata solo per la replica. Per impostazione predefinita, questa opzione è falsa.
OPT_REQUIRE_FINAL Per una funzione tabella, forzare l'inclusione della sintassi "WITH FINAL" per utilizzare la funzione tabella. Per ulteriori informazioni, vedere Metodi API UDTF.
OPT_UDA_MERGE_NULL Il comportamento predefinito (false) di un'UDA nzLua è di non chiamare il metodo merge() quando tutte le variabili di stato sono nulle per uno degli stati. Se questo valore è impostato su true, il metodo merge() sarà sempre richiamato anche quando tutte le variabili di stato sono nulle.
OPT_VARARGS_AS_TABLE Normalmente un UDX VARARGS riceve gli argomenti usando la sintassi Lua varargs (...). Impostando questa opzione a true, gli argomenti VARARGS vengono passati a nzLua usando una tabella invece di un normale elenco di argomenti.