Limitações de UDFs de JavaScript¶

Tamanho máximo do código-fonte de JavaScript¶

O Snowflake limita o tamanho máximo do código-fonte JavaScript no corpo de uma UDF de JavaScript. O Snowflake recomenda limitar o tamanho a 100 KB. (O código é armazenado de forma compactada, e o limite exato depende da capacidade de compactação do código).

Consumir muita memória causará a falha da UDF¶

UDFs de JavaScript falharão se consumirem muita memória. O limite específico está sujeito a alterações. Usar muita memória resultará em um erro sendo retornado.

Demorar muito para concluir fará com que uma UDF seja inativada e retorne um erro¶

UDFs de JavaScript que demoram muito para serem concluídas serão eliminadas e um erro será retornado ao usuário. Além disso, as UDFs de JavaScript que entram em loops infinitos resultarão em erros.

O excesso de profundidade da pilha resultará em um erro¶

Um excesso de profundidade da pilha devido a recursão resultará em um erro.

Estado global¶

O Snowflake geralmente preserva o estado global do JavaScript entre as iterações de uma UDF. Entretanto, você não deve confiar que modificações anteriores ao estado global estejam disponíveis entre chamadas à função. Além disso, você não deve supor que todas as linhas serão executadas dentro do mesmo ambiente de JavaScript.

Na prática, o estado global é relevante com:

• Lógica de inicialização complexa/cara. Por padrão, o código fornecido da UDF é avaliado para cada linha processada. Se esse código contiver uma lógica complexa, isso pode ser ineficiente.

• Funções que contêm código que não é idempotente. Um padrão típico seria:

  Date.prototype._originalToString = Date.prototype.toString;
  Date.prototype.toString = function() {
    /* ... SOME CUSTOM CODE ... */
    this._originalToString()
    }
  

  Copy

  A primeira vez que este código é executado, ele muda o estado de toString e _originalToString. Essas mudanças são preservadas no estado global, e na segunda vez que o código é executado, os valores são novamente alterados de forma a criar recursividade. A segunda vez que toString é chamado, o código é recursivo infinitamente (até esgotar o espaço da pilha).

Para estas situações, um padrão recomendado é garantir que o código relevante seja avaliado apenas uma vez, usando a semântica global da variável de JavaScript. Por exemplo:

var setup = function() {
/* SETUP LOGIC */
};

if (typeof(setup_done) === "undefined") {
  setup();
  setup_done = true;  // setting global variable to true
}

Copy

Observe que esse mecanismo é seguro apenas para armazenar em cache os efeitos da avaliação do código. Não é garantido que, após uma inicialização, o contexto global seja preservado para todas as linhas e nenhuma lógica de negócios deve depender disso.

Bibliotecas JavaScript¶

As UDFs de JavaScript oferecem suporte ao acesso à biblioteca padrão JavaScript. Observe que isto exclui muitos objetos e métodos normalmente fornecidos por navegadores. Não há nenhum mecanismo para importar, incluir ou chamar bibliotecas adicionais. Todos os códigos necessários devem ser incorporados dentro da UDF.

Além disso, a função interna eval() do JavaScript está desativada.

Tamanho e profundidade da variante retornada¶

Objetos da variante retornada estão sujeitos a limitações de tamanho e profundidade de aninhamento:

Tamanho:

Atualmente limitado a vários megabytes, mas sujeito a mudanças.

Profundidade:

Atualmente limitado a uma profundidade de aninhamento de 1.000, mas sujeito a mudanças.

Se qualquer objeto for grande ou profundo demais, um erro será retornado quando a UDF for chamada.

As restrições de tipo de argumento e retorno às vezes são ignoradas¶

Certas características de tipo declaradas para um valor de retorno ou argumento serão ignoradas quando a UDF é chamada. Nesses casos, o valor recebido pode ser usado como recebido, esteja ou não em conformidade com as restrições especificadas na declaração.

Os seguintes são ignorados para UDFs cuja lógica está escrita em JavaScript:

• Comprimento para argumentos do tipo VARCHAR

CREATE OR REPLACE FUNCTION tf (arg1 VARCHAR(1))
RETURNS VARCHAR(1)
LANGUAGE JAVASCRIPT AS 'return A.substr(3, 3);';