# entry\_point

Полезно знать

Доступно начиная с dbt v1.11 или в [канале релизов v1 Latest](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md).

functions/\<filename>.yml

```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

```python
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

```yaml
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
```

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

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

* [Пользовательские функции](https://docs.getdbt.tech/docs/build/udfs.md)
* [Свойства функций](https://docs.getdbt.tech/reference/function-properties.md)
* [Конфигурации функций](https://docs.getdbt.tech/reference/function-configs.md)
* [type](https://docs.getdbt.tech/reference/resource-configs/type.md)
* [volatility](https://docs.getdbt.tech/reference/resource-configs/volatility.md)
* [runtime\_version](https://docs.getdbt.tech/reference/resource-configs/runtime-version.md)
* [packages](https://docs.getdbt.tech/reference/resource-configs/packages.md)
* [arguments](https://docs.getdbt.tech/reference/resource-properties/function-arguments.md)
* [returns](https://docs.getdbt.tech/reference/resource-properties/returns.md)
