Moldeadora y calibradora

Los Shapers se llaman opcionalmente para los EAs de Función de Tabla. Los Sizers se llaman opcionalmente para los EAs de Función Escalar.

Estructuras de datos

estructura NZAESHP_HANDLE: El mango Shaper. Mango opaco que se utiliza con las funciones Shaper y Sizer AE.

Funciones

nzaeShpAddOutputColumn(NZAESHP_HANDLE handle, NzudsDataType dataType, const char *columnName): Añade columnas de salida no numéricas.
nzaeShpAddOutputColumnNumeric(NZAESHP_HANDLE handle, NzudsDataType data-Type, const char *columnName, int precision, int scale): Añade columnas de salida numéricas.
nzaeShpAddOutputColumnString(NZAESHP_HANDLE handle, NzudsDataType dataType, const char *columnName, int size): Añade columnas de salida de cadena.
void nzaeShpClose(NZAESHP_HANDLE handle): Cierra el asa al terminar.
NzaeShpRcCode nzaeShpGetEnv(NZAESHP_HANDLE handle, const char *name, const char **result): Obtiene una variable de entorno AE o de sistema. AE tiene prioridad.
void nzaeShpGetFirstEnvironmentEntry(NZAESHP_HANDLE handle, NzaeEnvironmentEntry *entry): Devuelve la primera entrada de entorno.
nzaeShpGetInputColumn(NZAESHP_HANDLE handle, int index, NzudsData **data): Obtiene los datos de la columna de entrada
AeUserCode nzaeShpGetLastErrorCode(NZAESHP_HANDLE mango): Obtiene el código del último error que se ha producido.
const char* nzaeShpGetLastErrorText(NZAESHP_HANDLE handle): Obtiene el texto del mensaje del último error ocurrido.
const char* nzaeShpGetLibraryFullPath(NZAESHP_HANDLE h, const char *libraryName, bool caseSensitive ): Obtiene la ruta de archivo de un nombre de biblioteca.
NzaeSharedLibraryInfo* nzaeShpGetLibraryInfo(NZAESHP_HANDLE h): Devuelve NzaeSharedLibraryInfo de la biblioteca compartida para esta solicitud.
NzaeSharedLibraryInfo* nzaeShpGetLibraryProcessInfo(NZAESHP_HANDLE h): Devuelve NzaeSharedLibraryInfo de la biblioteca compartida para el proceso. Devuelve NULL si el AE no es remoto.
NzaeShpRcCode nzaeShpGetMetadata(NZAESHP_HANDLE handle, NzaeShpMetadata *arg): Obtiene metadatos sobre el AE Shaper.
bool nzaeShpGetNextEnvironmentEntry(NZAESHP_HANDLE handle, NzaeEnvironmentEntry *entry): Devuelve la siguiente entrada de entorno.
int nzaeShpGetNumberOfParameters(NZAESHP_HANDLE h): Devuelve el número de parámetros.
int nzaeShpGetNumOutputColumns(NZAESHP_HANDLE handle): Devuelve el número de columnas de salida añadidas por el usuario.
nzaeShpGetOutputColumnInfo(NZAESHP_HANDLE handle, int index, NzaeSh-pOutputColumnInfo *info): Obtiene información sobre una columna de salida añadida por el usuario.
const char* nzaeShpGetParameter(NZAESHP_HANDLE h, int index): Devuelve un parámetro.
NzaeShpRcCode nzaeShpGetRuntime(NZAESHP_HANDLE handle, NzaeRuntime *arg): Obtiene información en tiempo de ejecución sobre el AE Shaper.
const char* nzaeShpGetSystemLogFileName(NZAESHP_HANDLE handle): Obtiene el nombre del archivo de registro del sistema AE.
NzaeShpRcCode nzaeShpGetUdfReturnType(NZAESHP_HANDLE handle, NzudsDataType *data-Type): Sólo para una UDF, obtiene el tipo de datos de retorno único predeterminado.
nzaeShpLog(NZAESHP_HANDLE handle, NzaeLogLevel level, const char *mes-sage): Registra el mensaje especificado.
nzaeShpPing(NZAESHP_HANDLE handle): Indica que el AE Shaper sigue activo y no está colgado.
NzaeShpRcCode nzaeShpSystemCatalogIsUpper(NZAESHP_HANDLE handle, bool *result): Devuelve TRUE si el valor predeterminado para los nombres de catálogo del sistema es mayúsculas.
NzaeShpRcCode nzaeShpUpdate(NZAESHP_HANDLE mango): Actualiza la información de forma y tamaño en el sistema Netezza.
NzaeShpRcCode nzaeShpUserError(NZAESHP_HANDLE handle, const char *_template,...): Indica que este AE ha encontrado una condición de error.

Enumeraciones

enum NzaeShpRcCode{ NZAESHP_RC_ERROR= -1, NZAESHP_RC_NORMAL= 0 }: Códigos de retorno de las funciones nzaeShp Shaper.

Descripción detallada

Los Shapers se llaman opcionalmente para los EAs de Función de Tabla. Los Sizers se llaman opcionalmente para los EAs de Función Escalar.

Documentación de funciones

nzaeShpAddOutputColumn(NZAESHP_HANDLE handle, NzudsDataType dataType, const char *columnName)

Añade columnas de salida no numéricas.

Parámetros:

handle
El mango Shaper
NzudsDataType dataType
Tipo de datos.
columnName
Nombre de columna.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

nzaeShpAddOutputColumnNumeric(NZAESHP_HANDLE handle, NzudsDataType data-Type, const char *columnName, int precision, int scale)

Añade columnas de salida numéricas.

Parámetros:

handle
El mango Shaper
NzudsDataType dataType
Tipo de datos.
columnName
Nombre de columna.
precision
La precisión de la columna.
scale
La escala de las columnas.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

nzaeShpAddOutputColumnString(NZAESHP_HANDLE handle, NzudsDataType dataType, const char *columnName, int size)

Añade columnas de salida de cadena.

Parámetros:

handle
El mango Shaper
NzudsDataType dataType
Tipo de datos.
columnName
Nombre de columna.
size
El tamaño de la columna.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

void nzaeShpClose(NZAESHP_HANDLE handle)

Cierra el asa al terminar.

Parámetros:

handle
El mango Shaper.

NzaeShpRcCode nzaeShpGetEnv(NZAESHP_HANDLE handle, const char *name, const char **result)

Obtiene una variable de entorno AE o de sistema. AE tiene prioridad.

Parámetros:

handle
El mango Shaper
name
El nombre de la variable.
result
El valor de la variable o NULL si no se encuentra.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

void nzaeShpGetFirstEnvironmentEntry(NZAESHP_HANDLE handle, NzaeEnvironmentEntry *entry)

Devuelve la primera entrada de entorno.

Parámetros:

handle
El mango Shaper.
NzaeEnvironmentEntry entry
La primera entrada.

Esta llamada a la función va seguida de repetidas llamadas a nzaeGetNextEnvironmentEntry. El sistema AE es el propietario de la memoria de esta llamada.

nzaeShpGetInputColumn(NZAESHP_HANDLE handle, int index, NzudsData **data)

Obtiene los datos de la columna de entrada

Parámetros:

handle
El mango Shaper
index
El índice de entrada.
NzudsData data
Los datos de entrada.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

Si isConstant es FALSE, el valor es siempre NULL.

AeUserCode nzaeShpGetLastErrorCode(NZAESHP_HANDLE mango)

Obtiene el código del último error que se ha producido.

Parámetros:

handle
El mango Shaper

Devuelve

AeUserCode

El código de error del último error que se ha producido.

const char* nzaeShpGetLastErrorText(NZAESHP_HANDLE handle)

Obtiene el texto del mensaje del último error ocurrido.

Parámetros:

handle
El mango Shaper

Devuelve

El texto del mensaje del último error que se ha producido.

const char* nzaeShpGetLibraryFullPath(NZAESHP_HANDLE h, const char *libraryName, bool caseSensitive )

Obtiene la ruta de archivo de un nombre de biblioteca.

Parámetros:

h
El mango Shaper
libraryName
Nombre de biblioteca.
caseSensitive
Si es TRUE, la búsqueda distingue entre mayúsculas y minúsculas.

Devuelve

La ruta del archivo si se encuentra; NULL en caso contrario.

Devuelve NULL si no se encuentra la biblioteca. El sistema AE es el propietario de la memoria de esta llamada.

NzaeSharedLibraryInfo* nzaeShpGetLibraryInfo(NZAESHP_HANDLE h)

Devuelve NzaeSharedLibraryInfo de la biblioteca compartida para esta solicitud.

Parámetros:

h
El mango Shaper

Devuelve
NzaeSharedLibraryInfo
La información de la Biblioteca Compartida.

El sistema AE es el propietario de la memoria de esta llamada.

NzaeSharedLibraryInfo* nzaeShpGetLibraryProcessInfo(NZAESHP_HANDLE h)

Devuelve NzaeSharedLibraryInfo de la biblioteca compartida para el proceso. Devuelve NULL si el AE no es remoto.

Parámetros:

h
El mango Shaper

Devuelve
NzaeSharedLibraryInfo
La información de la Biblioteca Compartida.

El sistema AE es el propietario de la memoria de esta llamada.

NzaeShpRcCode nzaeShpGetMetadata(NZAESHP_HANDLE handle, NzaeShpMetadata *arg)

Obtiene metadatos sobre el AE Shaper.

Parámetros:

handle
El mango Shaper
NzaeShpMetadata arg
Los metadatos que hay que rellenar. Creado por la persona que llama.

Devuelve
NzaeShpRcCode
El código de devolución de Shaper.

bool nzaeShpGetNextEnvironmentEntry(NZAESHP_HANDLE handle, NzaeEnvironmentEntry *entry)

Devuelve la siguiente entrada de entorno.

Parámetros:

handle
El mango Shaper
NzaeEnvironmentEntry entry
La siguiente entrada.

Devuelve
FALSE al final.
La primera nzaeGetNextEnvironmentEntry debe seguir a una llamada a nzaeGetFirstEnvironmentEntry. Devuelve FALSE al final. Los nombres clave pueden repetirse, pero la versión actual de un nombre clave se indica en último lugar. El sistema AE es el propietario de la memoria de esta llamada.

int nzaeShpGetNumberOfParameters(NZAESHP_HANDLE h)

Devuelve el número de parámetros.

Parámetros:

h
El mango Shaper.

Devuelve
El número de parámetros.

int nzaeShpGetNumOutputColumns(NZAESHP_HANDLE handle)

Devuelve el número de columnas de salida añadidas por el usuario.

Parámetros:

h
El mango Shaper.

Devuelve
El número de columnas de salida.

nzaeShpGetOutputColumnInfo(NZAESHP_HANDLE handle, int index, NzaeSh-pOutputColumnInfo *info)

Obtiene información sobre una columna de salida añadida por el usuario.

Parámetros:

h
El mango Shaper.
index
El índice de la columna de salida.
NzaeShpOutputColumnInfo info
La información de salida.

Devuelve
NzaeShpRcCode
El código de devolución de Shaper.

const char* nzaeShpGetParameter(NZAESHP_HANDLE h, int index)

Devuelve un parámetro.

Parámetros:

h
El mango Shaper.
index
El índice del parámetro.

Devuelve

Valor del parámetro.

El índice tiene base cero.

NzaeShpRcCode nzaeShpGetRuntime(NZAESHP_HANDLE handle, NzaeRuntime *arg)

Obtiene información en tiempo de ejecución sobre el AE Shaper.

Parámetros:

h
El mango Shaper.
NzaeRuntime arg
El tiempo de ejecución que hay que rellenar. Creado por la persona que llama.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

const char* nzaeShpGetSystemLogFileName(NZAESHP_HANDLE handle)

Obtiene el nombre del archivo de registro del sistema AE.

Parámetros:

handle
El mango Shaper.

Devuelve

El nombre del archivo de registro.

NzaeShpRcCode nzaeShpGetUdfReturnType(NZAESHP_HANDLE handle, NzudsDataType *data-Type)

Sólo para una UDF, obtiene el tipo de datos de retorno único predeterminado.

Parámetros:

handle
El mango Shaper.
NzudsDataType dataType
El tipo de devolución.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

nzaeShpLog(NZAESHP_HANDLE handle, NzaeLogLevel level, const char *mes-sage)

Registra el mensaje especificado.

Parámetros:

handle
El mango Shaper.
NzaeLogLevel level
El nivel de registro.
message
El mensaje de registro.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

nzaeShpPing(NZAESHP_HANDLE handle)

Indica que el AE Shaper sigue activo y no está colgado.

Parámetros:

handle
El mango Shaper.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

NzaeShpRcCode nzaeShpSystemCatalogIsUpper(NZAESHP_HANDLE handle, bool *result)

Devuelve TRUE si el valor predeterminado para los nombres de catálogo del sistema es mayúsculas.

Parámetros:

handle
El mango Shaper.
result
TRUE si el catálogo está en mayúsculas.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

NzaeShpRcCode nzaeShpUpdate(NZAESHP_HANDLE mango)

Actualiza la información de forma y tamaño en el sistema Netezza.

Parámetros:

handle
El mango Shaper.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

NzaeShpRcCode nzaeShpUserError(NZAESHP_HANDLE handle, const char *_template,...)

Indica que este AE ha encontrado una condición de error.

Parámetros:

handle
El mango Shaper.
_template
La plantilla printf-stlye.

Devuelve

NzaeShpRcCode

El código de devolución de Shaper.

El AE está completo y debería salir después de esta llamada. Message se construye como printf.

Documentación sobre tipos de enumeración

enum NzaeShpRcCode

Códigos de retorno de las funciones nzaeShp Shaper.

NZAESHP_RC_ERROR

NZAESHP_RC_NORMAL