Criar o arquivo C++ para a UDF

Para começar, use qualquer editor de texto para criar seu arquivo C++. O nome do arquivo deve ter uma extensão .cpp. Você pode desejar criar um diretório como /home/nz/udx_files como sua área para arquivos de código UDX.

Seu arquivo C++ deve incluir o arquivo de cabeçalho ' udxinc.h, que contém as declarações necessárias para funções definidas pelo usuário e processamento nas SPUs.

#include "udxinc.h"

#include "udxinc.h"
#include <string.h>

#include "udxinc.h"
#include <string.h>
using namespace nz::udx_ver2;

#include "udxinc.h"
#include <string.h>

using namespace nz::udx_ver2;
class CCustomerName: public nz::udx_ver2::Udf
{
public:
};

Cada UDF deve implementar os dois métodos a seguir:

• O método instantiate() é chamado pelo mecanismo de tempo de execução para criar o objeto dinamicamente. A implementação estática deve ser fora da definição de classe. Na versão 2 do UDX, o método instantiate recebe um argumentoUdxInit *pInit), que permite o acesso à especificação de memória, à configuração de registro e ao ambiente UDX (consulte Ambiente UDX). O construtor deve ter um objeto UdxInit também e transmiti-lo para o construtor da classe base. O método instantiate cria um objeto do tipo de classe derivado usando o novo operador e retorna-o (Udf de tipo de classe base) para o mecanismo de tempo de execução. O mecanismo de tempo de execução exclui o objeto quando ele não for mais necessário. A seguir um exemplo do método instantiate versão 2 da API:

     #include "udxinc.h"
  #include <string.h>
  
  using namespace nz::udx_ver2;
  
  class CCustomerName: public nz::udx_ver2::Udf
  {
  public:
      CCustomerName(UdxInit *pInit) : Udf(pInit)
  {
  }
      static nz::udx_ver2::Udf* instantiate(UdxInit *pInit);
  };
  nz::udx_ver2::Udf* CCustomerName::instantiate(UdxInit *pInit)
  {
          return new CCustomerName(pInit);
  }

• O método evaluate() é chamado uma vez para cada linha de dados durante a execução.

     #include "udxinc.h"
  #include <string.h>
  
  using namespace nz::udx_ver2;
  
  class CCustomerName: public nz::udx_ver2::Udf
  {
  public:
      CCustomerName(UdxInit *pInit) : Udf(pInit)
  {
  }
      static nz::udx_ver2::Udf* instantiate(UdxInit *pInit);
      virtual nz::udx_ver2::ReturnValue evaluate()
      {
          // Code to be inserted here
      }
  };
  
  nz::udx_ver2::Udf* CCustomerName::instantiate(UdxInit *pInit)
  {
      return new CCustomerName(pInit);
  }
  

Você pode implementar os construtores e destruidores conforme necessário. Na API Versão 1, os construtores são opcionais. Na versão 2 da API, os construtores são necessários; você deve especificar um construtor mesmo se ele chamar o construtor da classe base, como no exemplo anterior. Algumas coisas comuns a serem incluídas nos construtores são rotinas de reserva de memória (visto que novo e excluir são relativamente caros) e configurar quaisquer estruturas que são necessárias para cálculo (por exemplo, configurando uma matriz para rotinas de criptografia).

virtual nz::udx_ver2::ReturnValue evaluate()
    {
        StringArg *str;
        str = stringArg(0);              // 4
        int lengths = str->length;                  // 5
        char *datas = str->data;                    // 6
        int32 retval = 0;
        if (lengths >= 10)
            if (memcmp("Customer A",datas,10) == 0)
                            retval = 1;
        NZ_UDX_RETURN_INT32(retval);                 // 11
    }

No programa de amostra, a linha 4 declara e usa uma estrutura StringArg para transmitir o argumento para a UDF. Argumentos para UDFs são recuperados usando funções como StringArg. Se essa UDF teve um segundo argumento de sequência, o segundo argumento deve ser referenciado por StringArg(1). Para obter uma lista completa dos tipos de argumentos suportados e suas funções auxiliares associadas, consulte Referência da API do auxiliar de tipo de dados. Extrair as linhas 5 e 6, o comprimento e ponteiro de caractere (char*) da estrutura StringArg.

A linha 11 usa uma macro UDX para retornar o valor calculado para o mecanismo do Netezza Performance Server. A macro NZ_UDX_RETURN_INT32 ajuda a confirmar que o valor de retorno é do tipo esperado. Para obter uma lista das macros de retorno disponíveis, consulte Macros de valor de retorno UDX.

Para usar a função, é necessário compilá-la e registrá-la como uma função disponível no sistema Netezza Performance Server.