Opciones comunes

Las siguientes son opciones comunes de la utilidad ' register_ae '.

--sig <función(<arg>)>

Especifica el nombre de la función SQL y la firma del argumento de entrada. La firma debe ir entre comillas dobles para evitar que el shell interprete los paréntesis literalmente. Por ejemplo:

--sig "applyResult(varchar(16), double)"

Es posible definir una función que tome un número variable de argumentos utilizando la palabra clave "varargs". Por ejemplo:

--sig "applyOperation(varargs)"

Para obtener una lista completa de los tipos de datos admitidos, consulte la Guía del usuario deNetezza Database. Para obtener más información sobre las firmas, consulte la Guía del desarrollador de funciones definidas por el usuarioNetezza.

--return <tipo_valor>

Establece el valor de retorno o la tabla de retorno de la función. Por ejemplo, para una función escalar o agregada:

--return double

Para una función de tabla:

--return "table(total double, label varchar(128))"

Para una función de tabla, el tipo de retorno debe estar entre comillas dobles para evitar que el shell interprete los paréntesis literalmente. Es posible definir una función que devuelva una tabla definida en tiempo de ejecución con la API shaper utilizando la palabra clave "any". Por ejemplo:

--return "table(any)"

--language {system | cpp | java | fortran | perl | python64 | python3x| r}

Establece el lenguaje de programación que se utiliza para escribir el AE. Las opciones aceptadas son system (para la API C base), cpp (para C++), java, fortran, perl, python64, python3x (para la versión 3.x de Python ) y "r". Por ejemplo:

--language java

Nota: Para obtener información sobre cómo instalar R, consulte la comunidad IBM developerWorks Netezza Developer Network (NDN). Primero debe registrarse en developerWorks https://www.ibm.com/developerWorks. Busque "NDN" para localizar la comunidad Netezza Developer Network. Sigue las instrucciones de la página general para acceder a la parte privada de la comunidad.

--template <tipo_registro>

Define el tipo de registro. Consulte el directorio de plantillas del idioma para obtener una lista completa. Los valores opcionales más comunes son:

udtf que es una función de tabla
udf que es una función escalar
uda que es una función agregada
udtf64 que es la versión de 64 bits de udtf
udf64 que es una versión de 64 bits de udf
uda64 que es una versión de 64 bits de uda
Nota: No todos los idiomas admiten el funcionamiento en 64 bits.

Por ejemplo:

--template udtf

<versión> --version

Establece la versión AE en uso. Este valor está vinculado a la versión actual de IBM Netezza analytics y se utiliza para realizar un seguimiento de la incompatibilidad. Puede mostrar el contenido de ' /nz/export/ae/adapters/system_ae/ ' para listar las versiones. Por ejemplo:

--version 3

--db <sistema_db>

Selecciona la base de datos de destino del sistema Netezza (la base de datos donde se produce el registro) y la ubicación predeterminada de los archivos de salida. Por defecto (si no se especifica -db), la base de datos de destino es la base de datos establecida en la variable de entorno Linux NZ_DATABASE. Por ejemplo:

--db dev

--user <usuario_db>

Establece el nombre de usuario de la base de datos. Esta opción también ayuda a determinar la ubicación predeterminada de los archivos de entrada de registro. Por defecto (si no se especifica ' --user ') ' register_ae ' utiliza la variable de entorno Linux NZ_USER. Para más información, véase Definición de usuario. Por ejemplo:

--user Joe_User

--pw <contraseña>

Establece la contraseña de la base de datos. Por defecto (si no se especifica ' --pw ') ' register_ae ' utiliza la variable de entorno Linux NZ_PASSWORD. Por ejemplo:

--pw MyPassword

La utilidad " register_ae " también admite el almacenamiento en caché de " nzpassword ". nzpassword es una utilidad de línea de comandos del sistema NPS.

--level {0 | 1 | 2 | 3}

Controla la salida del archivo de registro. A continuación se describen los niveles de registro. Cada nivel incluye la salida de los niveles inferiores. Los números más altos proporcionan más información que puede ser útil para la asistencia técnica.

Tabla 1. Niveles de registro
Nivel	Descripción
Nivel 0	No hay información y desactiva el registro.
Nivel 1	Información básica a nivel de usuario sobre la ejecución. La cantidad de datos de salida es fija.
Nivel 2	El lado hijo (AE) de la comunicación entre procesos. La cantidad de datos de salida es variable y puede ser grande.
Nivel 3	El lado padre (NPS) de la comunicación entre procesos. La cantidad de datos de salida es variable y puede ser grande.

Por ejemplo:

--level 1

--exe <nombre de fichero>

Especifica el nombre de un objeto ejecutable, un nombre de archivo de script Python o un archivo JAR Java. Con Java, dado que exe sólo es necesario cuando se utilizan archivos JAR, y Java puede utilizar archivos de clase directamente, el uso de --exe para especificar un archivo JAR es opcional. Por ejemplo:

--exe <executable>

--exe apply.jar

--exe applyop.py

--define

Un interruptor opcional que se puede utilizar para establecer variables de plantilla específicas, controlando el modo de salida. Por ejemplo:

--define templatevar=value

--define java_class=<nombre_de_clase>

Especifica la clase Java a ejecutar. La opción --exe se utiliza para especificar un archivo JAR. Debe especificar al menos una de las opciones, y pueden especificarse ambas. Por ejemplo:

--define java_class=org.netezza.sample.ApplyDriver

Nota: Este es un ejemplo específico de una opción más general que se utiliza dentro del kit de herramientas de plantillas utilizado para implementar ' compile_ae y ' register_ae. La forma general es ' --define <template_variable>=<value>.

--path <nombre de la ruta>

Establece la ruta del directorio a la ubicación de los archivos de entrada. Por ejemplo:

--path /nz/export/ae/applications/special

Nota: La ubicación de salida de los archivos ' compile_ae ' y la ubicación de entrada de los archivos ' register_ae ' para una aplicación específica deben coincidir. La utilidad ' register_ae ' busca archivos en la ubicación donde ' compile_ae ' despliega archivos. Esto puede configurarse utilizando los ajustes por defecto de la base de datos, especificando las mismas opciones de base de datos para ' compile_ae y ' register_ae, o utilizando la opción ' --path.

--warn

Proporciona una advertencia en lugar de un error, permitiendo que el proceso continúe, si la ubicación de salida no comienza con <ae_export_dir>/ae/applications/<ae_db>. La advertencia se aplica sólo si está utilizando una ubicación de salida no estándar con la opción --path. Por ejemplo:

--warn