Перейти к основному содержимому

entry_point

💡Полезно знать
Доступно начиная с dbt v1.11 или в канале релизов v1 Latest.
functions/<filename>.yml
functions:
- name: <function name>
config:
entry_point: <string> # обязательно для Snowflake и BigQuery; необязательно и игнорируется в Databricks

Определение​

При создании Python UDF необходимо указать Python‑функцию, которая будет вызываться, с помощью параметра entry_point.

В настоящее время Python UDF поддерживаются в Snowflake, BigQuery и Databricks. В каждом хранилище данных используется своё имя для функции точки входа. В следующей таблице приведены эти имена:

ХранилищеКак используется entry_point
SnowflakeСтановится именем HANDLER в LANGUAGE PYTHON UDF
BigQueryСтановится значением entry_point в OPTIONS(...)
DatabricksПринимается для совместимости, но ни на что не влияет. Тело функции используется напрямую, поэтому dbt выводит предупреждение, если этот параметр задан. Доступен в dbt-databricks v1.12+.

Пример​

Например, если у вас есть Python UDF в файле functions/my_function.py со следующим кодом, где функция main используется в качестве точки входа:

functions/my_function.py
import re

def _digits_only(s: str) -> bool:
return bool(re.search(r'^[0-9]+$', s or ''))

def _to_flag(is_match: bool) -> int:
return 1 if is_match else 0

def main(a_string: str) -> int:
"""
This is used as the entry point for the UDF.
Returns 1 if a_string represents a positive integer (e.g., "10"),
else 0.
"""
return _to_flag(_digits_only(a_string))

После определения UDF вы можете указать main в качестве значения entry_point в YAML‑файле. Значение entry_point: main указывает на функцию main как на точку входа для UDF, тогда как _digits_only и _to_flag являются вспомогательными функциями.

functions/schema.yml
functions:
- name: is_positive_int
description: Returns 1 if a_string matches ^[0-9]+$, else 0
config:
runtime_version: "3.11" # required
entry_point: main # required: points to the function above
arguments:
- name: a_string
data_type: string
returns:
data_type: integer

Связанная документация​

Нашли ошибку?

0
Loading