UDF 호출하기¶

UDF 호출하기¶

일반적으로 다른 함수를 호출하는 것과 동일한 방식으로 UDF를 호출합니다.

UDF에 인자가 있는 경우 해당 인자를 이름 또는 위치로 지정할 수 있습니다.

예를 들어 다음 UDF는 3개의 인자를 허용합니다.

CREATE OR REPLACE FUNCTION udf_concatenate_strings(
    first VARCHAR,
    second VARCHAR,
    third VARCHAR)
  RETURNS VARCHAR
  LANGUAGE SQL
  AS
  $$
    RETURN first || second || third;
  $$;

UDF를 호출할 때 인자를 이름으로 지정할 수 있습니다.

SELECT udf_concatenate_strings(
  first => 'one',
  second => 'two',
  third => 'three');

인자를 이름으로 지정하면 인자를 특정 순서로 지정할 필요가 없습니다.

SELECT udf_concatenate_strings(
  third => 'three',
  first => 'one',
  second => 'two');

인자를 위치로 지정할 수도 있습니다.

SELECT udf_concatenate_strings(
  'one',
  'two',
  'three');

다음 사항을 참고하십시오.

• 이름 또는 위치로 모든 인자를 지정해야 합니다. 일부 인자는 이름으로, 다른 인자는 위치로 지정할 수는 없습니다.

  이름으로 인자를 지정할 때 인자 이름 주위에 큰따옴표를 사용할 수 없습니다.

• 두 함수 또는 두 프로시저가 이름은 같지만 인자 유형이 다른 경우 인자 이름이 다르면 인자 이름을 사용하여 실행할 함수 또는 프로시저를 지정할 수 있습니다. 프로시저 및 함수 오버로딩하기 섹션을 참조하십시오.

선택적 인자가 있는 UDF 호출하기¶

UDF에 선택적 인자 가 있는 경우 호출에서 선택적 인자를 생략할 수 있습니다. 각 선택적 인자에는 인자가 생략될 때 사용되는 기본값이 있습니다.

예를 들어 다음 UDF는 필수 인자 1개와 선택적 인자 2개가 있습니다. 각 선택적 인자에는 기본값이 있습니다.

CREATE OR REPLACE FUNCTION build_string_udf(
    word VARCHAR,
    prefix VARCHAR DEFAULT 'pre-',
    suffix VARCHAR DEFAULT '-post'
  )
  RETURNS VARCHAR
  AS
  $$
    SELECT prefix || word || suffix
  $$
  ;

호출에서 선택적 인자를 생략할 수 있습니다. 인자를 생략하면 인자의 기본값이 사용됩니다.

SELECT build_string_udf('hello');

+---------------------------+
| BUILD_STRING_UDF('HELLO') |
|---------------------------|
| pre-hello-post            |
+---------------------------+

SELECT build_string_udf('hello', 'before-');

+--------------------------------------+
| BUILD_STRING_UDF('HELLO', 'BEFORE-') |
|--------------------------------------|
| before-hello-post                    |
+--------------------------------------+

선택적 인자를 생략하고 서명에서 생략된 인자 뒤에 나타나는 다른 선택적 인자를 지정해야 하는 경우 위치 인자 대신 명명된 인자를 사용하십시오.

예를 들어 prefix 인자를 생략하고 suffix 인자를 지정한다고 가정해 보겠습니다. suffix 인자는 서명에서 prefix 뒤에 나타나므로 인자를 이름으로 지정해야 합니다.

SELECT build_string_udf(word => 'hello', suffix => '-after');

+-------------------------------------------------------+
| BUILD_STRING_UDF(WORD => 'HELLO', SUFFIX => '-AFTER') |
|-------------------------------------------------------|
| pre-hello-after                                       |
+-------------------------------------------------------+

UDTF 호출하기¶

테이블 함수를 호출하는 방식으로 UDTF를 호출할 수 있습니다. 기본 제공 테이블 함수 를 호출할 때와 마찬가지로, 쿼리의 FROM 절에서 UDTF를 호출할 때 TABLE 키워드 다음에 오는 괄호 안에 UDTF의 이름과 인자를 지정합니다.

즉, UDTF를 호출할 때 TABLE 키워드에 대해 다음과 같은 양식을 사용합니다.

SELECT ...
  FROM TABLE ( udtf_name (udtf_arguments) )

다음 예제의 코드는 '2021-01-16'::DATE 인자에 DATE 리터럴을 지정하여 my_java_udtf 테이블 함수를 호출합니다.

SELECT ...
  FROM TABLE(my_java_udtf('2021-01-16'::DATE));

테이블 함수에 대한 인자는 리터럴이 아니라 식일 수 있습니다. 예를 들어, 테이블의 열을 사용하여 테이블 함수를 호출할 수 있습니다. 예 섹션 을 포함하여 몇 가지 예가 아래에 나와 있습니다.

UDF 호출 의 경우와 마찬가지로, 이름 또는 위치로 인자를 지정할 수 있습니다.

일반적인 테이블 함수에 대한 자세한 내용은 테이블 함수 를 참조하십시오.

create table file_names (file_name varchar);
insert into file_names (file_name) values ('sample.txt'),
                                          ('sample_2.txt');

select f.file_name, w.word
   from file_names as f, table(split_file_into_words(f.file_name)) as w;

+-------------------+------------+
| FILE_NAME         | WORD       |
+-------------------+------------+
| sample_data.txt   | some       |
| sample_data.txt   | words      |
| sample_data_2.txt | additional |
| sample_data_2.txt | words      |
+-------------------+------------+

create function split_file_into_words(inputFileName string)
    ...
    imports = ('@inline_jars/sample.txt', '@inline_jars/sample_2.txt')
    ...

SELECT *
    FROM stocks_table AS st,
         TABLE(my_udtf(st.symbol, st.transaction_date, st.price) OVER (PARTITION BY st.symbol))

SELECT *
    FROM stocks_table AS st,
         TABLE(my_udtf(st.symbol, st.transaction_date, st.price) OVER (PARTITION BY 1))

SELECT *
     FROM stocks_table AS st,
          TABLE(my_udtf(st.symbol, st.transaction_date, st.price) OVER (PARTITION BY st.symbol ORDER BY st.transaction_date))

SELECT *
    FROM stocks_table AS st,
         TABLE(my_udtf(st.symbol, st.transaction_date, st.price) OVER (PARTITION BY st.symbol ORDER BY st.transaction_date))
    ORDER BY st.symbol, st.transaction_date, st.transaction_time;

SELECT * FROM udtf_table, TABLE(my_func(col1) OVER (PARTITION BY udtf_table.col2 * 2));   -- NO!