> ## 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.

> Documentation de FUNCTION

# CREATE FUNCTION - fonction définie par l'utilisateur (UDF)

Crée une fonction définie par l'utilisateur (UDF) à partir d'une expression lambda. L'expression ne doit contenir que des paramètres de fonction, des constantes, des opérateurs ou d'autres appels de fonction.

**Syntaxe**

```sql theme={null}
CREATE [OR REPLACE] FUNCTION name [ON CLUSTER cluster] AS (parameter0, ...) -> expression
```

Une fonction peut avoir un nombre arbitraire de paramètres.

Il existe quelques restrictions :

* Le nom d'une fonction doit être unique parmi les fonctions utilisateur et les fonctions système.
* Les fonctions récursives ne sont pas autorisées.
* Toutes les variables utilisées par une fonction doivent être spécifiées dans sa liste de paramètres.

Si l'une de ces restrictions est enfreinte, une exception est levée.

**Exemple**

```sql title="Query" theme={null}
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
SELECT number, linear_equation(number, 2, 1) FROM numbers(3);
```

```text title="Response" theme={null}
┌─number─┬─plus(multiply(2, number), 1)─┐
│      0 │                            1 │
│      1 │                            3 │
│      2 │                            5 │
└────────┴──────────────────────────────┘
```

Une [fonction conditionnelle](/fr/reference/functions/regular-functions/conditional-functions) est appelée dans une fonction définie par l'utilisateur, dans la requête suivante :

```sql title="Query" theme={null}
CREATE FUNCTION parity_str AS (n) -> if(n % 2, 'odd', 'even');
SELECT number, parity_str(number) FROM numbers(3);
```

```text title="Response" theme={null}
┌─number─┬─if(modulo(number, 2), 'odd', 'even')─┐
│      0 │ even                                 │
│      1 │ odd                                  │
│      2 │ even                                 │
└────────┴──────────────────────────────────────┘
```

Remplacez une UDF existante :

```sql title="Query" theme={null}
CREATE FUNCTION exampleReplaceFunction AS frame -> frame;
SELECT create_query FROM system.functions WHERE name = 'exampleReplaceFunction';
CREATE OR REPLACE FUNCTION exampleReplaceFunction AS frame -> frame + 1;
SELECT create_query FROM system.functions WHERE name = 'exampleReplaceFunction';
```

```text title="Response" theme={null}
┌─create_query─────────────────────────────────────────────┐
│ CREATE FUNCTION exampleReplaceFunction AS frame -> frame │
└──────────────────────────────────────────────────────────┘

┌─create_query───────────────────────────────────────────────────┐
│ CREATE FUNCTION exampleReplaceFunction AS frame -> (frame + 1) │
└────────────────────────────────────────────────────────────────┘
```

<div id="related-content">
  ## Contenu connexe
</div>

<div id="executable-udfs">
  ### [UDF exécutables](/fr/reference/functions/regular-functions/udf).
</div>

<div id="user-defined-functions-in-clickhouse-cloud">
  ### [Fonctions définies par l’utilisateur dans ClickHouse Cloud](https://clickhouse.com/blog/user-defined-functions-clickhouse-udfs)
</div>