ALTER HISTORY CONFIGURATION

Utilice el comando ALTER HISTORY CONFIGURATION para modificar una configuración para recopilaciones de datos de historial. No se puede alterar la configuración actual.

Los cambios que se realicen en una configuración mediante la emisión de este comando se guardan inmediatamente. Sin embargo, solo son efectivos después de que se haga lo siguiente:

Emita el comando SET HISTORY CONFIGURATION para la configuración.
Detén y reinicia el sistema ' Netezza Performance Server ' emitiendo los comandos ' nzstop y ' nzstart '.

El comando ALTER se registra en el registro histórico actual. No es necesario que la base de datos de destino esté vacía.

Sintaxis

Sintaxis para modificar la configuración de historial:

ALTER HISTORY CONFIGURATION <config_name> <hist_clause> …
<hist-clause> ::=
| HISTTYPE {QUERY | NONE}
| NPS { LOCAL }
| DATABASE <dbname>
| SCHEMA <schema_name>
| USER <username>
| PASSWORD <writer-password>
| COLLECT  <history_item>[,<history_item>…]
| LOADINTERVAL {number }
| LOADMINTHRESHOLD {number}
| LOADMAXTHRESHOLD {number}
| DISKFULLTHRESHOLD {number}
| STORAGELIMIT {number}
| LOADRETRY {number}
| ENABLEHIST {boolean}
| ENABLESYSTEM {boolean}
| VERSION <version>

<history_item>
  QUERY
| PLAN
| TABLE
| COLUMN

Entradas

El comando ALTER HISTORY CONFIGURATION tiene las siguientes entradas:

Tabla 1. Entradas de ALTER HISTORY CONFIGURATION
Entrada	Descripción
<config_name>	Nombre de la configuración que se quiere a modificar. La configuración debe existir en el sistema. No puede modificar la configuración actual y no puede cambiar el nombre de la configuración. (Para cambiar un nombre de configuración, debe descartar la configuración y crear una nueva.) Esta opción de entrada es un identificador delimitado. Si no es delimitado, el sistema convierte el nombre al caso del host.
HISTTYPE	Tipo de base de datos que se quiere crear, que puede ser QUERY o NONE. Especifique NONE para inhabilitar la colección del historial. Si no especifica esta opción de entrada, el valor de configuración actual se retiene.
NPS® LOCAL	Almacena la información de registro del historial del sistema local Netezza Performance Server. Si no se especifica esta opción, se retiene el valor de la configuración actual.
DATABASE <dbname>	Base de datos de historiales en la que se escriben los datos capturados. La base de datos debe existir y debe crearse con el comando de script ' nzhistcreatedb ' en el sistema Netezza Performance Server. Si no especifica esta opción de entrada, el valor de configuración actual se retiene. Esta entrada es un identificador delimitado. Si no es delimitado, el sistema convierte el nombre al caso del host.
SCHEMA <schema_name>	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 donde el valor enable_user_schema es TRUE.
USER <username>	Nombre de usuario para acceder e insertar datos en la base de datos de historiales. (Este nombre es el nombre de usuario que se especifica en el comando nzhistcreatedb). Si no especifica esta opción de entrada, el valor de configuración actual se retiene. Esta opción de entrada es un identificador delimitado. Si no es delimitado, el sistema convierte el nombre al caso del host.
PASSWORD <writer password>	La contraseña para la cuenta de usuario de base de datos. Si no especifica esta opción de entrada, el valor de configuración actual se retiene. Esta opción de entrada 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. Si no especifica esta opción de entrada, el valor de configuración actual se retiene. 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 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. Si no especifica esta opción de entrada, el valor de configuración actual se retiene. 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 máximo es 102400 MB (100 GB). El valor STORAGELIMIT debe ser mayor que LOADMAXTHRESHOLD. Si no especifica esta opción de entrada, el valor de configuración actual se retiene. 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.
LOADRETRY	Número de veces que se reintenta la operación de carga. Los valores válidos son 0 (sin reintento), 1 ó 2. Si no especifica esta opción de entrada, el valor de configuración actual se retiene.
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. Si no especifica esta opción de entrada, el valor de configuración actual se retiene. 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. Si no especifica esta opción de entrada, el valor de configuración actual se retiene. 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 la versión 4.6 y posteriores, el número de versión es 1. A partir de la versión 7.0.3, el número de versión pasó a ser 2 para admitir varios esquemas en una base de datos. La versión debe coincidir con el número de versión especificado en el comando nzhistcreatedb; de lo contrario el proceso del cargador falla.

Resultados

El comando ALTER HISTORY CONFIGURATION tiene las siguientes salidas:

Tabla 2. Salidas de ALTER HISTORY CONFIGURATION
Resultado	Descripción
`ALTER HISTORY CONFIGURATION`	El comando se ha ejecutado correctamente.
`ERROR: permission denied`	No tiene los privilegios necesarios para emitir este comando.
`ERROR: <config-name> not found.`	No se puede encontrar el nombre de configuración especificado.
`ERROR: database <dbname> not found.`	La base de datos de historiales no se ha encontrado en el sistema.

Privilegios

Es necesario ser el usuario administrativo, o la cuenta debe tener los permisos Manage Security para modificar las configuraciones de historial.

Uso

El siguiente comando cambia el tipo de datos de historial que se capturan solo para Consultar datos (los demás valores permanecen sin cambios):

ALTER HISTORY CONFIGURATION all_hist COLLECT QUERY;