Mandato nzudxrunharness

Ejecuta un agregado o función definidos por el usuario dentro de un entorno de prueba de simulación. El arnés muestra información sobre el uso de los objetos y puede detectar sobrescrituras en el almacenamiento intermedio cuando se llama a los UDF/UDA. El mandato muestra mensajes para salidas estándar y, opcionalmente, para archivos de registro estándar. Debe iniciar sesión como usuario nz para ejecutar este mandato.

El mandato tiene la sintaxis siguiente:

nzudxrunharness [OPTION]...

La tabla siguiente describe las opciones que puede utilizar para cualquier instancia del mandato.

Tabla 1. Opciones generales de nzudxrunharness
Opción	Descripción
--dir `dir_datos`	Especifica la ubicación del directorio de datos, que generalmente es /nz/data.
--base `base`	Especifica el directorio base o de inicio para el software Netezza Performance Server. El valor predeterminado es /nz/kit.
--usuario `usuario`	Especifica el usuario de la base de datos Netezza Performance Server para ejecutar este comando. El usuario debe ser el administrador o el usuario propietario de la base de datos de destino que tiene el UDX. El valor predeterminado es el valor de NZ_USER.
--pw `contraseña`	Especifica la contraseña del usuario Netezza Performance Server. El valor predeterminado es el valor de NZ_PASSWORD.
--db `base_datos`	Especifica la base de datos en la que se va a ejecutar el UDX. El valor predeterminado es el valor de variable de entorno de NZ_DATABASE.
--schema `esquema`	Especifica el esquema en el que se va a ejecutar el UDX. El valor predeterminado es el valor de variable de entorno de NZ_SCHEMA.
-h	Muestra el uso del mandato.

La tabla siguiente describe las opciones que puede para especificar el archivo de entrada para el mandato.

Tabla 2. Opciones del archivo de entrada nzudxrunharness
Opción	Descripción
--file `archivo_prueba`	Especifica el nombre de la vía de acceso de un archivo de datos de prueba. Las columnas deben estar en el orden esperado para los argumentos y deben estar separados por comas (,).
--grp `col`	Especifica el número de columna del archivo de datos de prueba que se utiliza para agrupar (por agregados). El archivo de datos de prueba ya debe estar agrupado.
--sep `separador`	Especifica el carácter que se utiliza como separados en el archivo de prueba. El valor predeterminado es coma (,).
--escape `escapar`	Especifica el carácter de escape a utilizar en el archivo de prueba. El valor predeterminado es ninguno.
--citando	Utiliza las comillas dobles para el archivo de prueba.
--entrada hexadecimal	Especifica que los datos del archivo está en entrada hexadecimal.
--generar	Genera un archivo de control, pero no ejecuta el arnés. Para obtener más información, consulte Archivo de control del arnés de pruebas.

La tabla siguiente describe las demás opciones de entrada aleatorias para el mandato.

Tabla 3. Opciones de entrada aleatoria de nzudxrunharness
Opción	Descripción
--rows `filas`	Especifica el número de filas a simular. El valor predeterminado es 100.
--groups `grupos`	Especifica el número de grupos a simular. El valor predeterminado es 5.
--nulls `nulos`	Especifica los argumentos null. El valor se especifica como una serie de números de campo separada por dos puntos, por ejemplo 1:2:3:5 El valor predeterminado es no nulls.

La tabla siguiente describe las opciones de salida del mandato.

Tabla 4. Opciones de salida de nzudxrunharness
Opción	Descripción
--imprimir	Imprime valores de retorno.
--hex	Imprime valores de retorno, con series en formato hexadecimal.
--novalidato	Omite los pasos de validación del desbordamiento del almacenamiento intermedio. (El arnés se ejecuta más rápido cuando lo ejecuta sin validación.)
--dbg	Inicia el depurador.

La tabla siguiente describe las opciones que especifica el UDX a probar.

Tabla 5. Opciones de UDX de nzudxrunharness
Opción	Descripción
--name `nombre`	Especifica el nombre de agregado o función. Puede especificar el nombre de agregado o de función tal como es, si el nombre es exclusivo, o si utiliza una firma completa como `func`(`retorno`).
--func	Opera en una función (valor predeterminado).
--agg	Opera en un agregado.

La tabla siguiente describe las opciones que puede utilizar para sustituir los valores UDX definidos.

Tabla 6. Opciones de sustitución de UDX de nzudxrunharness
Opción	Descripción
--máscara NONE, DEBUG, TRACE	Especifica la sustitución de la máscara de registro. Los valores válidos son NONE, DEBUG o TRACE. También puede especificar una combinación de DEBUG, TRACE separada por coma para registrar ambos tipos de mensajes.
--over `sustitución`	Especifica las sustituciones de tamaño de columna de la serie. El valor se especifica como 1-40:2-400 donde el primer número es la columna (basado en 1). El segundo número es el tamaño del carácter (no un tamaño en bytes).
--varargs `columnas`	Especifica la información de argumento para VARARGS UDX. Especifique el valor como una serie de tipo separada por dos puntos. Por ejemplo: `VARCHAR(100):NUMERIC(10,3):INT4`
--vallado	Ejecuta el arnés en modalidad protegida. Este valor sustituye la protección definida para el UDX en la base de datos.
--sin vallar	Ejecuta el arnés en modalidad no protegida. Este valor sustituye la protección definida para el UDX en la base de datos.
--object `archivo`	Especifica el archivo de objeto que se va a utilizar en lugar del archivo de objeto especificado para el UDX de la base de datos. También puede utilizar la opción --data con la opción --object porque puede ser necesaria para las ubicaciones de archivo del objeto de biblioteca.
--nodlclose	Especifica que el arnés de pruebas no invoque la función de biblioteca C ' dlclose() para cerrar referencias a bibliotecas compartidas UNIX que se pusieron a disposición con ' dlopen(). El arnés de prueba invoca dlclose() de forma predeterminada. Si va a ejecutar el arnés de prueba dentro de la herramienta de depuración como valgrind o callgrind, especifique esta opción para que el arnés no invoque dlclose() automáticamente. Esto le permite acceder a los nombres de símbolo y a otros valores que pueden ser útiles para la depuración, pero puede que no estén disponibles después de llamar a dlclose(). (Para obtener más información sobre el entorno de depuración valgrind, consulte http://valgrind.org.)
--final	En las funciones de tabla definidas por el usuario, invoca la función de tabla utilizando el comportamiento TABLE WITH FINAL.

El arnés de prueba ejecuta el UDX especificado utilizando un archivo de datos proporcionado o creando datos aleatorios en base a los distintivos --rows,--groups y --nulls. Con el distintivo --nulls, las columnas especificadas son null en 50% de las veces. Además, cuando utiliza datos aleatorios, las series se llenan a su capacidad máxima, que se basa en la firma del argumento o las sustituciones especificadas por --over. El uso de un archivo de datos proporcionado es la mejor forma de probar la exactitud del algoritmo.

El uso de los distintivos --mask muestra los resultados de las llamadas logMsg. Los distintivos --print y --hex muestran los resultados de evaluate o performFinalResult. El arnés también imprime rutinas externas que se encuentran en el archivo de objeto. El distintivo --dbg invoca al depurador para que se pueda depurar el objeto real. Si utiliza el depurador, asegúrese de que el archivo de objeto de host para el UDX se ha compilado con símbolos de depuración. (Normalmente, debe compilar utilizando la modalidad optimizada.)

En el archivo de datos, los tipos como intervalo y timetz con más de un dato deben tener los campos separados por dos puntos (:). Los nulos pueden especificarse mediante <NULL>.