CREARE LA CONFIGURAZIONE DELLA CRONOLOGIA

Usare il comando CREATE HISTORY CONFIGURATION per creare una configurazione per la registrazione della cronologia su un sistema.

Per abilitare la raccolta dei dati storici, creare almeno una configurazione per la versione corrente dello schema. Se questa operazione viene eseguita per la prima volta per la versione corrente dello schema della cronologia o se la configurazione corrente della cronologia è di tipo NONE, l'operazione CREATE HISTORY CONFIGURATION non viene registrata nel database della cronologia.

Sintassi

Sintassi per la creazione della configurazione della cronologia:
CREATE HISTORY CONFIGURATION <config_name> <clause> [ <clause>… ]
Dove '<clause> rappresenta uno dei seguenti elementi :
HISTTYPE {QUERY | AUDIT | NONE} |
NPS [ LOCALHOST | <hostname> ]   |
DATABASE <dbname> |
USER <username> |
SCHEMA <schemaname> |
PASSWORD <password> |
COLLECT  <item>[,<item>…] |
LOADINTERVAL <number> |
LOADMINTHRESHOLD <number> |
LOADMAXTHRESHOLD <number> |
DISKFULLTHRESHOLD <number> |
STORAGELIMIT <number> |
LOADRETRY <number> |
ENABLEHIST <boolean> |
ENABLESYSTEM <boolean> |
VERSION <version> 
[ KEY key_store . key_alias ]
[ INCLUDING [ ALL | SUCCESS | FAILURE ] ]
Dove " <item> rappresenta uno dei seguenti elementi:
QUERY
PLAN
TABLE
COLUMN
SERVICE
STATE

Input

Il comando CREA CONFIGURAZIONE STORICO ha i seguenti ingressi:

Tabella 1. CREARE CONFIGURAZIONE STORICO ingressi
Immissione Descrizione
<config_name> Il nome della configurazione da creare. È possibile creare più di una configurazione, ma ogni nome deve essere unico. Questa opzione di input è un identificatore delimitato. Se non è delimitato, il sistema converte il nome nel caso predefinito.
TIPO DI STORIA Se raccogliere i dati storici e, in caso affermativo, il tipo di database storico:
QUERY
Raccogliere i dati storici in un database di query.
VERIFICA
Raccogliere i dati storici in un database di audit.
Nessuna
Disabilita la raccolta dei dati storici. Specificando questo parametro si impostano automaticamente i seguenti valori predefiniti:
  • CONFIG_LEVEL a HIST_LEVEL_NONE
  • CONFIG_TARGETTYPE a HIST_TARGET_LOCAL
  • CONFIG_COLLECTFILTER a COLLECT_ALL
Importante: se si specifica QUERY o AUDIT, questo valore deve corrispondere al tipo di database specificato nel comando 'nzhistcreatedb usato per creare il database; in caso contrario, il processo di caricamento fallisce.
NPS [LOCALHOST | <hostname> ] Memorizzare i dati della cronologia sul sistema Netezza Performance Server locale. Questo valore è quello predefinito e l'unico consentito.
DATABASE Il nome del database della cronologia in cui devono essere scritti i dati acquisiti. Il database deve esistere e deve essere stato creato con il comando 'nzhistcreatedb sul sistema Netezza Performance Server. Non esiste alcun valore predefinito. Questa opzione di input è un identificatore delimitato. Se non è delimitato, il sistema converte il nome nel caso dell'host.
SCHEMA Se si omette questo valore, i dati della cronologia vengono caricati nello schema predefinito del database della cronologia. È necessario specificare un valore di schema che corrisponda al proprietario del database. Questo è molto importante per i sistemi in cui l'impostazione enable_user_schema è TRUE.
UTENTE Il nome dell'utente di caricamento, cioè l'account utente utilizzato per caricare i dati storici nel database.
Importante: questo valore deve corrispondere all'utente di caricamento specificato nel comando 'nzhistcreatedb usato per creare il database; in caso contrario, il processo di caricamento fallisce.
Password La password dell'account utente del database. Non esiste alcun valore predefinito. Si tratta di una stringa con virgolette singole e la password viene memorizzata come stringa crittografata.

Se la password dell'utente cambia, è necessario aggiornare anche la configurazione della cronologia con la nuova password, altrimenti il processo di caricamento fallisce.
Raccogli Quando la raccolta dei dati della cronologia è abilitata, il sistema registra sempre le informazioni relative al fallimento del login, alla creazione e alla chiusura della sessione e all'avvio del processo di acquisizione dei log (alcapp). Utilizzare questo parametro per specificare che devono essere raccolte informazioni aggiuntive:
QUERY
Raccogliere i dati della query.
PLAN
Raccogliere i dati delle query e pianificare i dati delle query.
TABELLA
Raccogliere i dati delle query e i dati dei dettagli delle tabelle dalle query.
COLONNA
Raccogliere i dati delle query, i dati di dettaglio delle tabelle e i dati di dettaglio delle colonne.
SERVIZIO
Raccogliere i comandi CLI.
STATO_ATTUALE
Raccogliere le modifiche di stato.

È possibile specificare più valori utilizzando valori separati da virgole. Per ulteriori informazioni, consultare la sezione relativa alla raccolta dei dati storici nella Guida dell'amministratore di sistemaIBM® Netezza®.
VALORE DI CARICO Il numero di minuti da attendere prima che il sistema controlli l'area di stadiazione per i dati storici da trasferire all'area di caricamento. I valori validi sono 0 (per disattivare il timer) o 1 - 60 minuti. Non esiste un valore predefinito.

Questo valore funziona con LOADMINTHRESHOLD e LOADMAXTHRESHOLD per configurare il processo di caricamento. Per ulteriori informazioni sulle impostazioni, consultare la sezione relativa alla raccolta dei dati storici nella Guida dell'amministratore del sistemaIBM Netezza.
SOGLIA DI CARICO La quantità minima di dati di cronologia in MB da raccogliere prima di trasferire i file batch in fase all'area di caricamento. Il valore 0 disabilita il controllo della soglia minima. Il valore massimo è 102400 MB (100 GB).

Questo valore funziona con gli ingressi LOADINTERVAL e LOADMAXTHRESHOLD per configurare i timer del processo di caricamento. Per ulteriori informazioni sulle impostazioni, consultare la sezione relativa alla raccolta dei dati storici nella Guida dell'amministratore del sistemaIBM Netezza.
SOGLIA DI CARICO La quantità di dati storici in MB da raccogliere prima di trasferire automaticamente i file batch in fase all'area di caricamento. Un valore pari a 0 disabilita il controllo della soglia massima. Il valore massimo è 102400 MB (100 GB).

Questo valore funziona con gli ingressi LOADMINTHRESHOLD e LOADINTERVAL per configurare i timer del processo di caricamento. Per ulteriori informazioni sulle impostazioni, consultare la sezione relativa alla raccolta dei dati storici nella Guida dell'amministratore del sistemaIBM Netezza.
SOGLIA DISCO PIENA Questa opzione è riservata per un uso futuro. Qualsiasi valore specificato viene ignorato. Il valore predefinito è 0.
LIMITE DI STOCCAGGIO La dimensione massima dell'area di staging dei dati storici in MB. Se le dimensioni dell'area di staging raggiungono o superano questa soglia, la raccolta dei dati storici si interrompe finché non si libera spazio su disco. Il valore STORAGELIMIT deve essere maggiore di LOADMAXTHRESHOLD.

Non esiste alcun valore predefinito. I valori validi vanno da 0 a qualsiasi numero intero positivo. Se si specifica 0, il controllo dei limiti di archiviazione è disabilitato. Il valore massimo è 102400 MB (100 GB).
CARICAMENTO Il numero di volte in cui l'operazione di caricamento viene ritentata. I valori validi sono 0 (nessun tentativo), 1 o 2. Non esiste alcun valore predefinito.
ABILITAZIONE Se registrare le informazioni sulle query nel database della cronologia. Un valore di TRUE abilita la raccolta della cronologia per queste query, mentre FALSE la disabilita. Non esiste alcun valore predefinito. Se si specifica FALSE, tutte le query sul database della cronologia che presentano errori di sintassi vengono catturate.
SISTEMA ABILITANTE Se registrare le informazioni sulle query del sistema. Una query di sistema accede ad almeno una tabella di sistema ma non a tabelle utente. Un valore di TRUE abilita la raccolta della cronologia per queste query, mentre FALSE la disabilita. Non esiste alcun valore predefinito. Se si specifica FALSE, vengono catturate tutte le query sulle tabelle di sistema che presentano errori di sintassi.
Versione<version> La versione dello schema della storia della configurazione. Per impostazione predefinita, si tratta della versione dello schema della cronologia dell'immagine corrente. Per la versione 4.6, il numero di versione è 1.
Importante: il numero di versione specificato deve corrispondere al numero di versione specificato nel comando 'nzhistcreatedb usato per creare il database; in caso contrario, il processo di caricamento non riesce.
CHIAVE NESSUNA Si applica solo a HISTTYPE AUDIT. Se si specifica NONE, non viene associata alcuna chiave crittografica alla configurazione e non viene eseguita la firma digitale. Per ulteriori informazioni sulle chiavi crittografiche, consultare la IBM Netezza Advanced Security Administrator's Guide.
KEY <crypto-key-name> La chiave crittografica specificata deve essere una coppia di chiavi pubbliche e private esistente. La chiave crittografica viene utilizzata per firmare digitalmente i dati della cronologia di audit.
INCLUSO [TUTTI | SUCCESSO | FALLIMENTO ] Specifica che la registrazione della cronologia deve catturare le seguenti operazioni per le tabelle query_prolog, query_epilog, plan_prolog e plan_epilog:
  • TUTTI: cattura le operazioni riuscite e non riuscite
  • SUCCESSIONE: cattura solo le query che hanno avuto successo
  • FALLIMENTO: cattura solo le operazioni fallite
Questa impostazione non si applica ai dati acquisiti nei campi session_prolog, session_epilog e failed authentication.

Output

Il comando CREA CONFIGURAZIONE STORICO ha le seguenti uscite:

Tabella 2. CREARE STORICO CONFIGURAZIONE uscite
Emissione Descrizione
CREATE HISTORY CONFIGURATION Il comando è stato eseguito correttamente.
ERROR: permission denied Non si dispone dell'autorizzazione necessaria per eseguire questo comando.
ERROR: database <dbname> not found. Il database della cronologia non è stato trovato nel sistema.

Privilegi

Per configurare la raccolta dei dati della cronologia è necessario essere l'utente amministratore o il proprio account deve avere il privilegio Gestione sicurezza.

Utilizzo

Seguono alcuni esempi di utilizzo del comando CREA STORIA CONFIGURAZIONE.

Il comando seguente crea una configurazione della cronologia denominata all_hist che consente di acquisire tutte le informazioni sulla cronologia:
MYDB.SCH1(USER)=> CREATE HISTORY CONFIGURATION all_hist HISTTYPE QUERY 
DATABASE histdb USER histusr PASSWORD histusrpw COLLECT PLAN,COLUMN 
LOADINTERVAL 5 LOADMINTHRESHOLD 4 LOADMAXTHRESHOLD 20 VERSION 1;
Il comando seguente crea una configurazione della cronologia denominata hist_mincollect che raccoglie il livello base dei dati della cronologia (fallimento del login, creazione e terminazione della sessione e avvio del processo alcapp):
MYDB.SCH1(USER)=> CREATE HISTORY CONFIGURATION hist_mincollect HISTTYPE 
QUERY DATABASE histdb USER histusr PASSWORD histusrpw COLLECT 
LOADINTERVAL 5 LOADMINTHRESHOLD 4 LOADMAXTHRESHOLD 20 VERSION 1;
Il comando seguente crea una configurazione della cronologia denominata hist_queryonly che raccoglie i dettagli delle query e dei piani e il livello base delle informazioni:
MYDB.SCH1(USER)=> CREATE HISTORY CONFIGURATION hist_mincollect HISTTYPE 
QUERY DATABASE "query db" USER histusr PASSWORD histusrpw COLLECT 
QUERY,PLAN LOADINTERVAL 5 LOADMINTHRESHOLD 4 LOADMAXTHRESHOLD 20 
VERSION 1;
Il comando seguente crea una configurazione della cronologia denominata hist_disabled che disabilita la raccolta della cronologia:
MYDB.SCH1(USER)=> CREATE HISTORY CONFIGURATION hist_disabled HISTTYPE 
NONE;