Procedimento armazenado VIRTUALIZEFILE

Cria um Db2 apelido e uma visualização com a definição apropriada para um arquivo simples acessado por meio de um nó remoto.

Parâmetros de entrada

NODEID
O tipo desse parâmetro necessário é VARCHAR(2000). Especifica o ID do nó onde o arquivo está hospedado. Os formatos compatíveis são CSV e e XLS.
CAMINHO DO ARQUIVO
O tipo desse parâmetro necessário é VARCHAR(32672). Especifica o caminho completo do arquivo no sistema de arquivos do agente remoto.
OPÇÕESCSV
O tipo desse parâmetro necessário é VARCHAR(32672). Especifica a lista separada por vírgulas de strings para opções adicionais. As seguintes opções são suportadas:
  • MAXCHARS=<N>, onde <N> é o número máximo de caracteres em uma célula de string. Os valores de célula mais longos na fonte são truncados para esse comprimento. O padrão é 32672.
  • SCANROWS=<N>, onde <N> é o número de linhas a serem pré-escaneadas para inferir os tipos de coluna. O padrão é 200. Se o número fornecido for 0, nenhuma linha será verificada. Se o número fornecido for negativo, todas as linhas serão verificadas.
  • COLSNAMES=<True or False>, determina se a primeira linha será interpretada como nomes de colunas. O padrão é true.
  • XLS,XLS=<Sheetname>,XLS=(<Sheetname> <TopLeftCell>, <BottomRightCell or RightColumn>), nome da folha opcional e coordenadas das células da tabela. Todos os exemplos a seguir são válidos: “XLS”, “” XLS=Sheet3, “XLS=( Sheet3,B6,R8 )” e “XLS=( Sheet3,B6,R )”.
  • Observação: para nomes de planilhas que incluem vírgulas, o nome deve ser colocado entre aspas simples ou duplas. As aspas aninhadas devem ser escapadas duplicando-as.
VIRTSCHEMA
O tipo desse parâmetro necessário é VARCHAR(128). Especifica o esquema local da tabela virtualizada.
VIRTNAME
O tipo desse parâmetro necessário é VARCHAR(128). Especifica o nome local da tabela virtualizada.
VIRTDEF
O tipo desse parâmetro necessário é VARCHAR(32672). Especifica uma definição da tabela virtualizada.
SUBSTITUIR
O tipo deste parâmetro obrigatório é CHAR(1). Os valores válidos são:
  • Y: Substitui o apelido, se existir.
  • NNão substitui o apelido existente.
ignoreCase
O tipo deste parâmetro obrigatório é CHAR(1). Especifica a sensibilidade a maiúsculas e minúsculas dos nomes do esquema virtual, da tabela e da coluna. Os valores válidos são:
  • Y: Torna os nomes do esquema virtual, da tabela e da coluna insensíveis a maiúsculas e minúsculas.
  • N: Preserva o caso dos nomes do esquema virtual, da tabela e da coluna.

Parâmetros de saída

DIAGS
O tipo desse parâmetro é VARCHAR(32672). Representa as mensagens de diagnóstico.

Sintaxe

Use a seguinte sintaxe e substitua os parâmetros para este procedimento armazenado:

CALL DVSYS.VIRTUALIZEFILE('<NODEID>', '<FILEPATH>', '<OPTIONSCSV>', 'DRV', 'TEST2', 'LAST VARCHAR(255), FIRST VARCHAR(255), ADDR VARCHAR(255), PLACE VARCHAR(255), STATE VARCHAR(255), ZIP INT', 'Y', 'Y', ?)

Exemplo

call DVSYS.virtualizefile('qpendpoint_1:6415', '/opt/ibm/address.xls', 'XLS=(Sheet1,A1,F9),COLNAMES=false', 'DRV', 'TEST2', 'LAST VARCHAR(255), FIRST VARCHAR(255), ADDR VARCHAR(255), PLACE VARCHAR(255), STATE VARCHAR(255), ZIP INT', 'Y', 'Y', ?)