> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Tabela do sistema que contém o status de carregamento e os metadados de configuração de Funções Definidas pelo Usuário (UDFs).

# system.user_defined_functions

<div id="description">
  ## Descrição
</div>

Contém o status de carregamento, informações sobre erros e metadados de configuração para [Funções Definidas pelo Usuário (UDFs)](/pt-BR/reference/functions/regular-functions/udf).

<div id="columns">
  ## Colunas
</div>

* `name` ([String](/pt-BR/reference/data-types/index)) — Nome da UDF.
* `load_status` ([Enum8('Success' = 0, 'Failed' = 1)](/pt-BR/reference/data-types/index)) — Status de carregamento. Valores possíveis:
  * **Success** — UDF carregada e pronta para uso
  * **Failed** — Falha ao carregar a UDF (consulte o campo 'loading\_error\_message' para mais detalhes).
* `loading_error_message` ([String](/pt-BR/reference/data-types/index)) — Mensagem de erro detalhada quando o carregamento falha. Vazia se tiver sido carregada com sucesso.
* `last_successful_update_time` ([Nullable(DateTime)](/pt-BR/reference/data-types/index)) — Timestamp da última atualização bem-sucedida. NULL se nunca tiver sido bem-sucedida.
* `loading_duration_ms` ([UInt64](/pt-BR/reference/data-types/index)) — Tempo gasto no carregamento da UDF, em milissegundos.
* `type` ([Enum8('executable' = 0, 'executable\_pool' = 1)](/pt-BR/reference/data-types/index)) — Tipo da UDF: 'executable' (processo único) ou 'executable\_pool' (pool de processos).
* `command` ([String](/pt-BR/reference/data-types/index)) — Script ou comando a ser executado para esta UDF.
* `format` ([String](/pt-BR/reference/data-types/index)) — Formato de dados para E/S (por exemplo, 'TabSeparated', 'JSONEachRow').
* `return_type` ([String](/pt-BR/reference/data-types/index)) — Tipo de retorno da função (por exemplo, 'String', 'UInt64').
* `return_name` ([String](/pt-BR/reference/data-types/index)) — Identificador opcional do valor de retorno. Vazio se não estiver configurado.
* `argument_types` ([Array(String)](/pt-BR/reference/data-types/index)) — Array de tipos de argumentos (por exemplo, \['String', 'UInt64']).
* `argument_names` ([Array(String)](/pt-BR/reference/data-types/index)) — Array de nomes de argumentos. Strings vazias para argumentos sem nome.
* `max_command_execution_time` ([UInt64](/pt-BR/reference/data-types/index)) — Número máximo de segundos para processar um bloco de dados. Apenas para o tipo 'executable\_pool'.
* `command_termination_timeout` ([UInt64](/pt-BR/reference/data-types/index)) — Segundos antes de enviar SIGTERM ao processo do comando.
* `command_read_timeout` ([UInt64](/pt-BR/reference/data-types/index)) — Milissegundos para leitura do stdout do comando.
* `command_write_timeout` ([UInt64](/pt-BR/reference/data-types/index)) — Milissegundos para gravação no stdin do comando.
* `pool_size` ([UInt64](/pt-BR/reference/data-types/index)) — Número de instâncias do processo do comando. Apenas para o tipo 'executable\_pool'.
* `send_chunk_header` ([UInt8](/pt-BR/reference/data-types/index)) — Indica se a contagem de linhas deve ser enviada antes de cada fragmento de dados (booleano).
* `execute_direct` ([UInt8](/pt-BR/reference/data-types/index)) — Indica se o comando deve ser executado diretamente (1) ou via /bin/bash (0).
* `lifetime` ([UInt64](/pt-BR/reference/data-types/index)) — Intervalo de recarga em segundos. 0 significa que a recarga está desativada.
* `deterministic` ([UInt8](/pt-BR/reference/data-types/index)) — Indica se a função retorna o mesmo resultado para os mesmos argumentos (booleano).

<div id="example">
  ## Exemplo
</div>

Veja todas as UDFs e o status de carregamento delas:

```sql theme={null}
SELECT
    name,
    load_status,
    type,
    command,
    return_type,
    argument_types
FROM system.user_defined_functions
FORMAT Vertical;
```

```response theme={null}
Row 1:
──────
name:           my_sum_udf
load_status:    Success
type:           executable
command:        /var/lib/clickhouse/user_scripts/sum.py
return_type:    UInt64
argument_types: ['UInt64','UInt64']
```

Encontre UDFs que falharam:

```sql theme={null}
SELECT
    name,
    loading_error_message
FROM system.user_defined_functions
WHERE load_status = 'Failed';
```

<div id="see-also">
  ## Veja também
</div>

* [Funções Definidas pelo Usuário](/pt-BR/reference/functions/regular-functions/udf) — Como criar e configurar UDFs.