CREATE HISTORY CONFIGURATION

Utilice el comando CREAR CONFIGURACIÓN DE HISTORIAL para crear una configuración para el registro de historial en un sistema.

Para habilitar la recopilación de datos de historial, cree al menos una configuración para la versión del esquema actual. Si esta operación se realiza por primera vez para la versión actual del esquema de historial, o si la configuración del historial actual es del tipo NONE, esta operación de CREATE HISTORY CONFIGURATION no se registra en la base de datos de historiales.

Sintaxis

Sintaxis para la creación de la configuración del historial:
CREATE HISTORY CONFIGURATION <config_name> <clause> [ <clause>… ]
donde <clause> representa una de las siguientes opciones:
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 ] ]
Donde <item> representa una de las opciones siguientes:
QUERY
PLAN
TABLE
COLUMN
SERVICE
STATE

Entradas

El comando CREATE HISTORY CONFIGURATION tiene las siguientes entradas:

Tabla 1. Entradas de CREATE HISTORY CONFIGURATION
Entrada Descripción
<config_name> Nombre de la configuración que se quiere crear. Se puede crear más de una configuración, pero ca nombre debe ser exclusivo. Esta opción de entrada es un identificador delimitado. Si no es delimitado, el sistema convierte el nombre a las mayúsculas o minúsculas predeterminadas.
HISTTYPE Especifica si se desea recopilar datos de historial y, si es así, el tipo de la base de datos de historiales:
CONSULTA
Recopile datos de historial en una base de datos de consultas.
AUDITORÍA
Recopile datos de historial en una base de datos de auditoría.
Ninguna
Inhabilite la recopilación de datos de historial. Si se especifica este parámetro, automáticamente se establecen los siguientes valores predeterminados:
  • CONFIG_LEVEL como HIST_LEVEL_NONE
  • CONFIG_TARGETTYPE como HIST_TARGET_LOCAL
  • CONFIG_COLLECTFILTER como COLLECT_ALL
Importante: Si se especifica QUERY o AUDIT, este valor debe coincidir con el tipo de base de datos especificado en el comando ' nzhistcreatedb ' utilizado para crear la base de datos; de lo contrario, el proceso de carga falla.
NPS [LOCALHOST | <hostname> ] Almacene los datos del historial en el sistema local Netezza Performance Server. Este valor es el predeterminado y el único permitido.
BASE DE DATOS Nombre de la base de datos de historiales en el que se deben escribir los datos capturados. La base de datos debe existir y debe haber sido creada con el comando ' nzhistcreatedb ' en el sistema Netezza Performance Server. No hay ningún valor predeterminado. Esta opción de entrada es un identificador delimitado. Si no es delimitado, el sistema convierte el nombre al caso del host.
SCHEMA Esquema de la base de datos de historiales en el que se desea cargar los datos de historial. Si se omite este valor, los datos de historial se cargan en el esquema predeterminado de la base de datos del historiales. Debe especificar un valor de esquema que coincida con el propietario de la base de datos. Esto es muy importante para sistemas en los que el valor enable_user_schema sea TRUE.
USUARIO Nombre del usuario de carga; es decir, la cuenta de usuario que se utiliza para cargar datos de historial en la base de datos.
Importante: Este valor debe coincidir con el usuario de carga especificado en el comando ' nzhistcreatedb ' utilizado para crear la base de datos; de lo contrario, el proceso de carga falla.
PASSWORD La contraseña para la cuenta de usuario de base de datos. No hay ningún valor predeterminado. Esta es una serie entre comillas simples y la contraseña se almacena como una serie codificada.

Si la contraseña de usuario cambia, también debe actualizar la configuración de historial con la nueva contraseña, o el proceso del cargado falla.
COLLECT Cuando la recopilación de datos de historial está habilitada, el sistema siempre recopila información sobre las anomalías de inicio de sesión, la creación de sesiones, la terminación de sesiones y el inicio del proceso de captura del registro (alcapp). Utilice este parámetro para especificar qué información adicional se quiere recopilar :
CONSULTA
Recopile datos de consulta.
PLAN
Recopile datos de consulta y datos de plan de las consultas.
TABLA
Recopile datos de consulta y datos de detalles de tabla de las consultas.
COLUMNA
Recopile datos de consulta, datos de detalles de tabla y datos de detalles de columna de las consultas.
SERVICIO
Recopile comandos de la CLI.
ESTADO
Recopile cambios de estado.

Puede especificar varios valores utilizando valores separados por comas. Para obtener más información, consulte la sección sobre recopilación de datos históricos en IBM® Netezza® System Administrator's Guide.
LOADINTERVAL Número de minutos que hay que esperar antes de que el sistema compruebe el área de transferencia para que los datos de historial se transfieran al área de carga. Los valores válidos son 0 (para inhabilitar el temporizador), o 1 - 60 minutos. No existe ningún valor predeterminado.

Este valor funciona con LOADMINTHRESHOLD y LOADMAXTHRESHOLD para configurar el proceso de carga. Para obtener más información sobre la configuración, consulte la sección sobre recopilación de datos del historial en IBM Netezza System Administrator's Guide.
LOADMINTHRESHOLD Cantidad mínima de datos de historial en MB que se quieren recopilar antes de transferir los archivos de proceso por lote por fases al área de carga. Un valor de 0 inhabilita la comprobación del umbral mínimo. El valor máximo es 102400 MB (100 GB).

Este valor funciona con las entradas LOADINTERVAL y LOADMAXTHRESHOLD para configurar los temporizadores del proceso de carga. Para obtener más información sobre la configuración, consulte la sección sobre recopilación de datos del historial en IBM Netezza System Administrator's Guide.
LOADMAXTHRESHOLD Cantidad mínima de datos de historial en MB que se han de recopilar antes de transferir automáticamente los archivos de proceso por lotes en fases al área de carga. Un valor de 0 inhabilita la comprobación del umbral máximo. El valor máximo es 102400 MB (100 GB).

Este valor funciona con las entradas LOADMINTHRESHOLD y LOADINTERVAL para configurar los temporizadores del proceso de carga. Para obtener más información sobre la configuración, consulte la sección sobre recopilación de datos del historial en IBM Netezza System Administrator's Guide.
DISKFULLTHRESHOLD Esta opción se reserva para un uso futuro. Se ignora cualquier valor que especifique. El valor por omisión es 0.
STORAGELIMIT Tamaño máximo del área de transferencia de datos de historial en MB. Si el tamaño del área de transferencia alcanza o supera este umbral, la recopilación de datos de historial se detiene hasta que se pueda liberar espacio de disco. El valor STORAGELIMIT debe ser mayor que LOADMAXTHRESHOLD.

No hay ningún valor predeterminado. Los valores válidos van de 0 a cualquier entero positivo. Si se especifica 0, la comprobación del límite de almacenamiento se inhabilita. El valor máximo es 102400 MB (100 GB).
LOADRETRY Número de veces que se reintenta la operación de carga. Los valores válidos son 0 (sin reintento), 1 ó 2. No hay ningún valor predeterminado.
ENABLEHIST Especifica si se registra información sobre consultas en la base de datos de historial de consulta. Un valor de TRUE habilita la recopilación de historial para estas consultas y FALSE la inhabilita. No hay ningún valor predeterminado. Si especifica FALSE, se capturan las consultas en la base de datos de historial que tienen errores de sintaxis.
ENABLESYSTEM Especifica si se registra información acerca de consultas del sistema. Una consulta de sistema accede al menos a una tabla de sistema pero no a tablas de usuario. Un valor de TRUE habilita la recopilación de historial para estas consultas y FALSE la inhabilita. No hay ningún valor predeterminado. Si especifica FALSE, se capturan las consultas en las tablas del sistema que tienen errores de sintaxis.
VERSION <version> Versión del esquema de historial de la configuración. De forma predeterminada, es la versión del esquema de historial de la imagen actual. Para el release 4.6, el número de versión es 1.
Importante: El número de versión especificado debe coincidir con el número de versión especificado en el comando ' nzhistcreatedb ' utilizado para crear la base de datos; de lo contrario, el proceso de carga falla.
KEY NONE Sólo se aplica a HISTTYPE AUDIT. Si se especifica NONE, no se asocia ninguna clave criptográfica con la configuración y no se realiza ninguna firma digital. Para obtener más información sobre claves criptográficas, consulte la Guía del administrador deIBM Netezza Advanced Security.
KEY <crypto-key-name> La clave criptográfica especificada debe ser un par de claves pública-privada existente. La clave criptográfica se utiliza para firmar digitalmente los datos de historial de auditoría.
INCLUDING [ALL | SUCCESS | FAILURE ] Especifica que el registro de historial debe capturar las operaciones siguientes para las tablas query_prolog, query_epilog, plan_prolog y plan_epilog:
  • ALL: capturar operaciones satisfactorias y anómalas
  • SUCCESS: capturar sólo las consultas satisfactorias
  • FAILURE: capturar sólo las operaciones anómalas
Este valor no se aplica a los datos capturados en session_prolog, session_epilog y autenticación anómala.

Resultados

El comando CREATE HISTORY CONFIGURATION tiene las siguientes salidas:

Tabla 2. Salidas de CREATE HISTORY CONFIGURATION
Resultado Descripción
CREATE HISTORY CONFIGURATION El comando se ha ejecutado correctamente.
ERROR: permission denied No tiene el permiso necesario para emitir este comando.
ERROR: database <dbname> not found. La base de datos de historiales no se ha encontrado en el sistema.

Privilegios

Para configurar la recopilación de datos de historial, es necesario ser el usuario administrativo o la cuenta debe tener el privilegio Manage Security.

Uso

Algunos usos de ejemplo del comando CREATE HISTORY CONFIGURATION son los siguientes.

El comando crea una configuración de historial denominada all_hist que habilita la captura de toda la información del historial:
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;
El siguiente comando crea una configuración de historial denominada hist_mincollect que recopila el nivel básico de los datos de historial (fallo de inicio de sesión, la creación de sesión, la finalización de sesión y el inicio del proceso 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;
El siguiente comando crea una configuración de historial denominada hist_queryonly que recopila detalles del plan y la consulta y el nivel básico de información:
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;
El siguiente comando crea una configuración de historial denominada hist_disabled que inhabilita la recopilación del historial:
MYDB.SCH1(USER)=> CREATE HISTORY CONFIGURATION hist_disabled HISTTYPE 
NONE;