Big-Data-HPC-Platform/docs/PT_BR/ECLStandardLibraryReference/SLR-Mods/SprayVariable.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<sect1 id="SprayVariable">
  <title>SprayDelimited / SprayVariable</title>

  <para><emphasis role="bold">STD.File.SprayDelimited<indexterm>
      <primary>STD.File.SprayVariable</primary>
    </indexterm><indexterm>
      <primary>File.SprayVariable</primary>
    </indexterm><indexterm>
      <primary>SprayVariable</primary>
    </indexterm><indexterm>
      <primary>SprayDelimited</primary>
    </indexterm>(</emphasis> <emphasis> sourceIP </emphasis> <emphasis
  role="bold">, </emphasis> <emphasis>sourcePath , </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis> sourceMaxRecordSize </emphasis>
  <emphasis role="bold">] </emphasis> <emphasis>, </emphasis> <emphasis
  role="bold"> [</emphasis> <emphasis> sourceCsvSeparate </emphasis> <emphasis
  role="bold">] </emphasis> <emphasis>, </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis> sourceCsvTerminate </emphasis> <emphasis
  role="bold">] </emphasis> <emphasis>, </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis> sourceCsvQuote </emphasis> <emphasis
  role="bold">] </emphasis> <emphasis>, </emphasis> <emphasis role="bold">
  </emphasis> <emphasis>destinationGroup, destinationLogicalName </emphasis>,
  <emphasis role="bold">[</emphasis> <emphasis>timeout</emphasis> <emphasis
  role="bold">]</emphasis> ,<emphasis role="bold"> [</emphasis>
  <emphasis>espServerIpPort</emphasis> <emphasis role="bold">]</emphasis>
  ,<emphasis> </emphasis> <emphasis role="bold">[</emphasis>
  <emphasis>maxConnections</emphasis> <emphasis role="bold">]</emphasis>
  ,<emphasis role="bold"> [</emphasis> <emphasis>allowOverwrite</emphasis>
  <emphasis role="bold">] , [</emphasis> <emphasis>replicate</emphasis>
  <emphasis role="bold">] , [</emphasis> <emphasis>compress
  </emphasis><emphasis role="bold">]</emphasis> , <emphasis role="bold">
  [</emphasis> <emphasis> sourceCsvEscape </emphasis> <emphasis
  role="bold">]</emphasis>, <emphasis role="bold"> [</emphasis> <emphasis>
  failIfNoSourceFile </emphasis> <emphasis role="bold">]</emphasis>, <emphasis
  role="bold"> [</emphasis> <emphasis> recordStructurePresent </emphasis>
  <emphasis role="bold">]</emphasis>, <emphasis role="bold"> [</emphasis>
  <emphasis> quotedTerminator </emphasis> <emphasis role="bold">]</emphasis>,
  <emphasis role="bold"> [</emphasis> <emphasis> encoding </emphasis>
  <emphasis role="bold">]</emphasis><emphasis role="bold"> , [</emphasis>
  <emphasis>expireDays</emphasis> <emphasis role="bold">] ,
  </emphasis><emphasis role="bold">[</emphasis>
  <emphasis>dfuServerQueue</emphasis><emphasis
  role="bold">])</emphasis></para>

  <para><emphasis>dfuwuid</emphasis> <emphasis role="bold"> :=
  STD.File.fSprayDelimited<indexterm>
      <primary>STD.File.fSprayVariable</primary>
    </indexterm><indexterm>
      <primary>File.fSprayVariable</primary>
    </indexterm><indexterm>
      <primary>fSprayVariable</primary>
    </indexterm><indexterm>
      <primary>fSprayDelimited</primary>
    </indexterm>(</emphasis> <emphasis> sourceIP </emphasis> <emphasis
  role="bold">, </emphasis> <emphasis>sourcePath , </emphasis> <emphasis
  role="bold"> [</emphasis> <emphasis> sourceMaxRecordSize </emphasis>
  <emphasis role="bold">] </emphasis> <emphasis>, </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis> sourceCsvSeparate </emphasis> <emphasis
  role="bold">] </emphasis> <emphasis>, </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis> sourceCsvTerminate </emphasis> <emphasis
  role="bold">] </emphasis> <emphasis>, </emphasis> <emphasis role="bold">
  [</emphasis> <emphasis> sourceCsvQuote </emphasis> <emphasis role="bold">]
  </emphasis> <emphasis>, destinationGroup, destinationLogicalName </emphasis>
  <emphasis role="bold">, [</emphasis> <emphasis>timeout</emphasis> <emphasis
  role="bold">] , [</emphasis> <emphasis>espServerIpPort</emphasis> <emphasis
  role="bold">]</emphasis> ,<emphasis> </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis>maxConnections</emphasis> <emphasis
  role="bold">]</emphasis> ,<emphasis role="bold"> [</emphasis>
  <emphasis>allowOverwrite</emphasis> <emphasis role="bold">] , [</emphasis>
  <emphasis>replicate</emphasis> <emphasis role="bold">] , [</emphasis>
  <emphasis>compress </emphasis> <emphasis role="bold">]</emphasis> ,
  <emphasis role="bold"> [</emphasis> <emphasis> sourceCsvEscape </emphasis>
  <emphasis role="bold">]</emphasis>, <emphasis role="bold"> [</emphasis>
  <emphasis> failIfNoSourceFile </emphasis> <emphasis
  role="bold">]</emphasis>, <emphasis role="bold"> [</emphasis> <emphasis>
  recordStructurePresent </emphasis> <emphasis role="bold">]</emphasis>,
  <emphasis role="bold"> [</emphasis> <emphasis> quotedTerminator </emphasis>
  <emphasis role="bold">]</emphasis> , <emphasis role="bold"> [</emphasis>
  <emphasis> encoding </emphasis> <emphasis role="bold">]</emphasis> ,
  <emphasis role="bold">[</emphasis> <emphasis>expireDays</emphasis> <emphasis
  role="bold">] , </emphasis><emphasis role="bold">[</emphasis>
  <emphasis>dfuServerQueue</emphasis><emphasis
  role="bold">])</emphasis></para>

  <informaltable colsep="1" frame="all" rowsep="1">
    <tgroup cols="2">
      <colspec colwidth="80.50pt"/>

      <colspec/>

      <tbody>
        <row>
          <entry><emphasis>sourceIP</emphasis></entry>

          <entry>Uma string terminada por nulo que contém o endereço IP da
          arquivo.</entry>
        </row>

        <row>
          <entry><emphasis>sourcePath</emphasis></entry>

          <entry>Uma string terminada por nulo que contém o caminho e o nome
          do arquivo.</entry>
        </row>

        <row>
          <entry><emphasis>maxrecordsize</emphasis></entry>

          <entry>Opcional. Um inteiro que contém o tamanho máximo dos
          registros no arquivo. Se omitido, o padrão é 4096.</entry>
        </row>

        <row>
          <entry><emphasis>srcCSVseparator</emphasis></entry>

          <entry>Opcional. Uma string terminada por nulo que contém o
          separador de campos do CSV. Se omitida, o padrão é "\\,"</entry>
        </row>

        <row>
          <entry><emphasis>srcCSVterminator</emphasis></entry>

          <entry>Opcional. Uma string terminada por nulo que contém o
          separador de registros do CSV. Se omitida, o padrão é
          "\\n,\\r\\n"</entry>
        </row>

        <row>
          <entry><emphasis>srcCSVquote</emphasis></entry>

          <entry>Opcional. Uma string terminada por nulo que contém o
          delimitador de campos entre aspas do CSV. Se omitida, o padrão é
          '\"'</entry>
        </row>

        <row>
          <entry><emphasis>destinationgroup</emphasis></entry>

          <entry>Uma string terminada em nulo contendo o nome do
          supercomputador específico dentro do cluster de destino.</entry>
        </row>

        <row>
          <entry><emphasis>destinationlogicalname</emphasis></entry>

          <entry>Uma string terminada em nulo contendo o nome lógico do
          arquivo.</entry>
        </row>

        <row>
          <entry><emphasis>timeout</emphasis></entry>

          <entry>Opcional. Um valor inteiro que indica a configuração de tempo
          limite. Se omitido, o padrão é -1. Se definido como (0), o controle
          da execução retorna imediatamente à workunit ECL sem esperar a
          conclusão da workunit DFU.</entry>
        </row>

        <row>
          <entry><emphasis>espserverIPport</emphasis></entry>

          <entry>Opcional. Uma string terminada por nulo que contém o
          protocolo, o IP, a porta e o diretório ou DNS equivalente do
          programa do servidor' ESP. Normalmente são os mesmos IP e porta do
          ECL Watch, com "/FileSpray" anexado. Se omitida, o padrão é o valor
          no atributo lib_system.ws_fs_server.</entry>
        </row>

        <row>
          <entry><emphasis>maxConnections</emphasis></entry>

          <entry>Opcional. Um inteiro que especifica o número máximo de
          conexões. Se omitido, o padrão é um (1).</entry>
        </row>

        <row>
          <entry><emphasis>allowoverwrite</emphasis></entry>

          <entry>Opcional. Um indicador booleano TRUE ou FALSE que indica se o
          novo arquivo pode sobrescrever um arquivo existente do mesmo nome.
          Se omitido, o padrão é FALSE.</entry>
        </row>

        <row>
          <entry><emphasis>replicate</emphasis></entry>

          <entry>Opcional. Um indicador booleano TRUE ou FALSE que indica se o
          novo arquivo deve ser replicado. Se omitido, o padrão é
          FALSE.</entry>
        </row>

        <row>
          <entry><emphasis>compress</emphasis></entry>

          <entry>Opcional. Um indicador booleano TRUE ou FALSE que indica se o
          novo arquivo deve ser compactado. Se omitido, o padrão é
          FALSE.</entry>
        </row>

        <row>
          <entry><emphasis>sourceCsvEscape</emphasis></entry>

          <entry>Opcional. Uma string terminada por nulo que contém os
          caracteres de escape do CSV. Se omitida, o padrão é nenhum.</entry>
        </row>

        <row>
          <entry><emphasis>failIfNoSourceFile</emphasis></entry>

          <entry>Opcional. Um indicador booleano TRUE ou FALSE que indica se o
          spray deve falhar caso nenhum arquivo de origem seja encontrado. Se
          omitido, o padrão é FALSE.</entry>
        </row>

        <row>
          <entry><emphasis>recordStructurePresent</emphasis></entry>

          <entry>Opcional. Um indicador booleano TRUE ou FALSE que indica se a
          estrutura do registro deve ser derivada do cabeçalho do arquivo. Se
          omitido, o padrão é FALSE.</entry>
        </row>

        <row>
          <entry><emphasis>quotedTerminator</emphasis></entry>

          <entry>Opcional. Um indicador booleano TRUE ou FALSE que indica se o
          caractere terminador pode ser incluído em um campo entre aspas. O
          Padrão e TRUE para todos. Se FALSE, permite um particionamento mais
          rápido do arquivo (evitando uma varredura completa do
          arquivo).</entry>
        </row>

        <row>
          <entry><emphasis>expireDays</emphasis></entry>

          <entry>Opcional. Um valor inteiro indicando o número de dias
          restantes para o arquivo ser removido automaticamente. Se omitido, o
          padrão é -1 (sem data de validade).</entry>
        </row>

        <row>
          <entry><emphasis>encoding</emphasis></entry>

          <entry>Uma string terminada por nulo que contém a codificação. Pode
          ser definida como: ascii, utf8, utf8n, utf16, utf16le, utf16be,
          utf32, utf32le e utf32be. Se omitida, o padrão é ascii.</entry>
        </row>

        <row>
          <entry><emphasis>dfuServerQueue</emphasis></entry>

          <entry>Nome do Servidor DFU de destino. O padrão é '' (empty) para o
          primeiro na fila de DFU no ambiente.</entry>
        </row>

        <row>
          <entry><emphasis>dfuwuid</emphasis></entry>

          <entry>O nome da definição que receberá a string terminada por nulo
          que contém o ID da workunit DFU (DFUWUID) gerado para a
          workunit.</entry>
        </row>

        <row>
          <entry>Return:<emphasis> </emphasis></entry>

          <entry>fSprayDelimited retorna uma string terminada por nulo que
          contém o ID da workunit DFU (DFUWUID).</entry>
        </row>
      </tbody>
    </tgroup>
  </informaltable>

  <para>A função <emphasis role="bold">SprayDelimited </emphasis> recebe um
  arquivo de comprimento variável da zona de entrada de arquivos e o distribui
  entre os nós do supercomputador de destino.</para>

  <para>A função <emphasis role="bold">SprayVariable</emphasis> agora é
  chamada <emphasis role="bold">SprayDelimited</emphasis> e a função <emphasis
  role="bold">fSprayVariable</emphasis> é agora chamada <emphasis
  role="bold">fSprayDelimited</emphasis>. Os nomes antigos ainda estão
  disponíveis para compatibilidade com versões anteriores.</para>

  <para>Exemplo:</para>

  <programlisting format="linespecific">STD.File.SprayDelimited('10.150.50.14',
       'c:\\InputData\\MyFile.txt',
       ,,,,
       '400way',
       'IN::MyFile',
       -1,
       'http://10.150.50.12:8010/FileSpray');</programlisting>
</sect1>