JavaScript UDF 소개¶

예¶

다음 예제의 코드는 입력 ARRAY를 받아 역순으로 정렬된 요소를 포함한 ARRAY를 반환하는 처리기 코드로 my_array_reverse 라는 UDF를 생성합니다. Snowflake는 SQL-JavaScript 데이터 타입 매핑 에 설명된 매핑에 따라 JavaScript 인자 및 반환 유형을 SQL로 변환하거나 그 반대로 변환합니다.

JavaScript 코드는 SQL 코드에서 이름이 대문자가 아닌 경우에도 입력 매개 변수 이름을 모두 대문자로 참조해야 합니다.

-- Create the UDF.
CREATE OR REPLACE FUNCTION my_array_reverse(a ARRAY)
  RETURNS ARRAY
  LANGUAGE JAVASCRIPT
AS
$$
  return A.reverse();
$$
;

정수 및 Double¶

JavaScript에는 정수 형식이 없습니다. 모든 숫자는 Double로 표시됩니다. JavaScript UDF는 형식 변환을 통한 경우를 제외하고는 정수 값을 허용하거나 반환하지 않습니다(즉, Double을 허용하는 JavaScript UDF에 정수를 전달할 수 있음).

Snowflake SQL과 JavaScript는 둘 다 Double 값을 지원합니다. 이 값은 있는 그대로 전송됩니다.

문자열¶

Snowflake SQL과 JavaScript는 둘 다 문자열 값을 지원합니다. 이 값은 있는 그대로 전송됩니다.

이진 값¶

모든 이진 값은 JavaScript Uint8Array 오브젝트로 변환됩니다. 이러한 형식화된 배열은 일반 JavaScript 배열과 동일한 방식으로 액세스할 수 있지만, 더 효율적이고 추가 메서드를 지원합니다.

JavaScript UDF가 Uint8Array 오브젝트를 반환하면 이는 Snowflake SQL 이진 값으로 변환됩니다.

날짜¶

모든 타임스탬프 및 날짜 형식은 JavaScript Date() 오브젝트로 변환됩니다. JavaScript 날짜 형식은 Snowflake SQL의 TIMESTAMP_LTZ(3)에 해당합니다.

날짜 또는 시간을 허용하는 JavaScript UDF에 대해 다음 참고 사항을 고려하십시오.

• 밀리초를 초과하는 모든 정밀도는 손실됩니다.

• SQL TIMESTAMP_NTZ에서 생성된 JavaScript Date 는 더 이상 “벽시계” 시간으로 작동하지 않으며, 일광 절약 시간제의 영향을 받습니다. 이는 TIMESTAMP_NTZ를 TIMESTAMP_LTZ로 변환할 때의 동작과 유사합니다.

• SQL TIMESTAMP_TZ에서 생성된 JavaScript Date 는 타임존 정보를 손실하지만, 입력과 동일한 시간을 나타냅니다(TIMESTAMP_TZ를 TIMESTAMP_LTZ로 변환할 때와 유사).

• SQL DATE는 현지 타임존의 현재 자정을 나타내는 JavaScript Date 로 변환됩니다.

또한, DATE 및 TIMESTAMP 형식을 반환하는 JavaScript UDF에 대해 다음 참고 사항을 고려하십시오.

• JavaScript Date 오브젝트는 TIMESTAMP_LTZ(3)에서 반환 데이터 타입으로의 캐스트와 동일한 변환 의미 체계를 준수하면서 UDF의 결과 데이터 타입으로 변환됩니다.

• VARIANT 오브젝트 내부에 중첩된 JavaScript Date 오브젝트는 항상 TIMESTAMP_LTZ(3) 형식입니다.

베리언트, 오브젝트, 배열¶

JavaScript UDF를 사용하면 베리언트 및 JSON 데이터를 쉽고 직관적으로 조작할 수 있습니다. UDF에 전달된 베리언트 오브젝트는 기본 JavaScript 형식 및 값으로 변환됩니다. 이전에 나열된 모든 값은 해당 JavaScript 형식으로 변환됩니다. 베리언트 오브젝트 및 배열은 JavaScript 오브젝트 및 배열로 변환됩니다. 마찬가지로, UDF에서 반환된 모든 값은 적절한 베리언트 값으로 변환됩니다. UDF가 반환하는 오브젝트와 배열에는 크기와 깊이 제한이 적용됩니다.

-- flatten all arrays and values of objects into a single array
-- order of objects may be lost
CREATE OR REPLACE FUNCTION flatten_complete(v variant)
  RETURNS variant
  LANGUAGE JAVASCRIPT
  AS '
  // Define a function flatten(), which always returns an array.
  function flatten(input) {
    var returnArray = [];
    if (Array.isArray(input)) {
      var arrayLength = input.length;
      for (var i = 0; i < arrayLength; i++) {
        returnArray.push.apply(returnArray, flatten(input[i]));
      }
    } else if (typeof input === "object") {
      for (var key in input) {
        if (input.hasOwnProperty(key)) {
          returnArray.push.apply(returnArray, flatten(input[key]));
        }
      }
    } else {
      returnArray.push(input);
    }
    return returnArray;
  }

  // Now call the function flatten() that we defined earlier.
  return flatten(V);
  ';

select value from table(flatten(flatten_complete(parse_json(
'[
  {"key1" : [1, 2], "key2" : ["string1", "string2"]},
  {"key3" : [{"inner key 1" : 10, "inner key 2" : 11}, 12]}
  ]'))));

-----------+
   VALUE   |
-----------+
 1         |
 2         |
 "string1" |
 "string2" |
 10        |
 11        |
 12        |
-----------+

NULL 및 정의되지 않은 값¶

JavaScript UDF를 사용할 때는 NULL 값을 포함할 수 있는 행 및 변수에 세심한 주의를 기울이십시오. 특히 Snowflake에는 두 개의 고유한 NULL 값(SQL NULL 및 베리언트의 JSON null)이 포함되어 있는 반면, JavaScript에는 null 외에 undefined 값이 포함되어 있습니다.

JavaScript UDF에 대한 SQL NULL 인자는 JavaScript undefined 값으로 변환됩니다. 마찬가지로, 반환된 JavaScript undefined 값은 SQL NULL 로 다시 변환됩니다. 이는 베리언트를 포함한 모든 데이터 타입에 해당됩니다. 베리언트 이외 형식의 경우, 반환된 JavaScript null 도 SQL NULL 값이 됩니다.

베리언트 형식의 인자 및 반환된 값은 JavaScript의 undefined 값과 null 값을 구분합니다 SQL NULL 은 JavaScript undefined 로 계속 변환됩니다(JavaScript undefined 는 SQL NULL 로 변환). 베리언트 JSON null 은 JavaScript null 로 변환됩니다(JavaScript null 은 Variant JSON null 로 다시 변환). JavaScript 오브젝트에 값으로 포함되거나 배열에 포함된 undefined 값으로 인해 요소가 생략됩니다.

다음과 같이 하나의 문자열과 하나의 NULL 값이 있는 테이블을 만드십시오.

create or replace table strings (s string);
insert into strings values (null), ('non-null string');

Copy

다음과 같이 문자열을 NULL 로 변환하고 NULL 을 문자열로 변환하는 함수를 만드십시오.

CREATE OR REPLACE FUNCTION string_reverse_nulls(s string)
    RETURNS string
    LANGUAGE JAVASCRIPT
    AS '
    if (S === undefined) {
        return "string was null";
    } else
    {
        return undefined;
    }
    ';

Copy

다음과 같이 함수를 호출하십시오.

select string_reverse_nulls(s) 
    from strings
    order by 1;
+-------------------------+
| STRING_REVERSE_NULLS(S) |
|-------------------------|
| string was null         |
| NULL                    |
+-------------------------+

Copy

SQL NULL 을 전달하는 것과 베리언트 JSON null 을 전달하는 것 사이의 차이를 보여주는 함수를 다음과 같이 만드십시오.

CREATE OR REPLACE FUNCTION variant_nulls(V VARIANT)
      RETURNS VARCHAR
      LANGUAGE JAVASCRIPT
      AS '
      if (V === undefined) {
        return "input was SQL null";
      } else if (V === null) {
        return "input was variant null";
      } else {
        return V;
      }
      ';

Copy

select null, 
       variant_nulls(cast(null as variant)),
       variant_nulls(PARSE_JSON('null'))
       ;
+------+--------------------------------------+-----------------------------------+
| NULL | VARIANT_NULLS(CAST(NULL AS VARIANT)) | VARIANT_NULLS(PARSE_JSON('NULL')) |
|------+--------------------------------------+-----------------------------------|
| NULL | input was SQL null                   | input was variant null            |
+------+--------------------------------------+-----------------------------------+

Copy

undefined 반환, null 반환, 그리고 undefined 및 null 을 포함하는 베리언트 반환 간의 차이를 보여주는 함수를 다음과 같이 만드십시오(undefined 값은 반환된 베리언트에서 제거됨).

CREATE OR REPLACE FUNCTION variant_nulls(V VARIANT)
      RETURNS variant
      LANGUAGE JAVASCRIPT
      AS $$
      if (V == 'return undefined') {
        return undefined;
      } else if (V == 'return null') {
        return null;
      } else if (V == 3) {
        return {
            key1 : undefined,
            key2 : null
            };
      } else {
        return V;
      }
      $$;

Copy

select variant_nulls('return undefined'::VARIANT) AS "RETURNED UNDEFINED",
       variant_nulls('return null'::VARIANT) AS "RETURNED NULL",
       variant_nulls(3) AS "RETURNED VARIANT WITH UNDEFINED AND NULL; NOTE THAT UNDEFINED WAS REMOVED";
+--------------------+---------------+---------------------------------------------------------------------------+
| RETURNED UNDEFINED | RETURNED NULL | RETURNED VARIANT WITH UNDEFINED AND NULL; NOTE THAT UNDEFINED WAS REMOVED |
|--------------------+---------------+---------------------------------------------------------------------------|
| NULL               | null          | {                                                                         |
|                    |               |   "key2": null                                                            |
|                    |               | }                                                                         |
+--------------------+---------------+---------------------------------------------------------------------------+

Copy

JavaScript 내 형식 변환¶

JavaScript는 다양한 형식 간에 값을 암시적으로 변환합니다. 값이 반환되는 경우, 값은 SQL 값으로 변환되기 전에 요청된 반환 형식으로 먼저 변환됩니다. 예를 들어, 숫자가 반환되었지만, UDF가 문자열을 반환하는 것으로 선언된 경우, 이 숫자는 JavaScript 내에서 문자열로 변환됩니다. 잘못된 형식을 반환하는 것과 같은 JavaScript 프로그래밍 오류는 이 동작으로 인해 숨겨질 수 있습니다. 또한, 값의 형식을 변환하는 동안 오류가 나타나면 오류가 발생합니다.

JavaScript 숫자 범위¶

정밀도가 그대로 유지되는 숫자의 범위는 다음과 같습니다.

-(2^53 -1)

~

(2^53 -1)

Snowflake NUMBER(p, s) 및 DOUBLE 데이터 타입의 유효한 값 범위가 더 큽니다. Snowflake에서 값을 검색하여 JavaScript 숫자 변수에 저장하면 정밀도가 손실될 수 있습니다. 예:

CREATE OR REPLACE FUNCTION num_test(a double)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  return A;
$$
;

Copy

select hash(1) AS a, 
       num_test(hash(1)) AS b, 
       a - b;
+----------------------+----------------------+------------+
|                    A | B                    |      A - B |
|----------------------+----------------------+------------|
| -4730168494964875235 | -4730168494964875000 | -235.00000 |
+----------------------+----------------------+------------+

Copy

처음 두 열은 일치해야 하고 세 번째 열은 0.0을 포함해야 합니다.

이 문제는 JavaScript 사용자 정의 함수(UDF) 및 저장 프로시저에 적용됩니다.

getColumnValue() 를 사용할 때 저장 프로시저에서 문제가 발생하는 경우, 예를 들어 다음을 통해 값을 문자열로 검색하여 문제를 피할 수 있습니다.

getColumnValueAsString()

그런 다음 저장 프로시저에서 문자열을 반환하고 문자열을 SQL의 숫자 데이터 타입으로 캐스팅할 수 있습니다.