> ## 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 des fonctions utilisées pour générer des nombres aléatoires

# Fonctions de génération de nombres aléatoires

Toutes les fonctions de cette section n’acceptent aucun argument ou un seul. Le seul usage de l’argument (s’il est fourni) est d’empêcher l’[élimination des sous-expressions
communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination), afin que deux exécutions distinctes d’une même fonction aléatoire au sein d’une ligne
renvoient des valeurs aléatoires différentes.

Contenu associé

* Guide : [Génération de données aléatoires dans ClickHouse](/fr/guides/clickhouse/data-modelling/generating-test-data)
* Blog : [Génération de données aléatoires dans ClickHouse](https://clickhouse.com/blog/generating-random-test-distribution-data-for-clickhouse)

<Note>
  Les nombres aléatoires sont générés par des algorithmes non cryptographiques.
</Note>

<Note>
  La documentation ci-dessous est générée à partir de la table système `system.functions`.
</Note>

{/*AUTOGENERATED_START*/}

<div id="fuzzBits">
  ## fuzzBits
</div>

Introduite dans : v20.5.0

Inverse les bits de la chaîne d’entrée `s`, avec une probabilité `p` pour chaque bit.

**Syntaxe**

```sql theme={null}
fuzzBits(s, p)
```

**Arguments**

* `s` — `String` ou `FixedString` sur laquelle effectuer un fuzzing de bits [`String`](/fr/reference/data-types/string) ou [`FixedString`](/fr/reference/data-types/fixedstring)
* `p` — Probabilité d’inverser chaque bit, sous la forme d’un nombre compris entre `0.0` et `1.0` [`Float*`](/fr/reference/data-types/float)

**Valeur renvoyée**

Renvoie une chaîne fuzzée du même type que `s`. [`String`](/fr/reference/data-types/string) ou [`FixedString`](/fr/reference/data-types/fixedstring)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT fuzzBits(materialize('abacaba'), 0.1)
FROM numbers(3)
```

```response title=Response theme={null}
┌─fuzzBits(materialize('abacaba'), 0.1)─┐
│ abaaaja                               │
│ a*cjab+                               │
│ aeca2A                                │
└───────────────────────────────────────┘
```

<div id="rand">
  ## rand
</div>

Introduit dans : v1.1.0

Renvoie un nombre `UInt32` aléatoire suivant une distribution uniforme.

Cette fonction utilise un générateur congruentiel linéaire avec un état initial obtenu à partir du système, ce qui signifie que, bien qu'il paraisse aléatoire, il ne l'est pas réellement et peut être prévisible si l'état initial est connu.
Dans les cas où une véritable source d'aléa est indispensable, envisagez d'utiliser d'autres méthodes, comme des appels système ou l'intégration de bibliothèques externes.

**Syntaxe**

```sql theme={null}
rand([x])
```

**Alias** : `rand32`

**Arguments**

* `x` — Facultatif et ignoré. Le seul rôle de l'argument est d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsqu'un même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type `UInt32`. [`UInt32`](/fr/reference/data-types/int-uint)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT rand();
```

```response title=Response theme={null}
1569354847
```

<div id="rand64">
  ## rand64
</div>

Introduit dans : v1.1.0

Renvoie un nombre `UInt64` aléatoire suivant une distribution uniforme.

Utilise un générateur congruentiel linéaire avec un état initial obtenu à partir du système, ce qui signifie que, même s'il semble aléatoire, il ne l'est pas réellement et peut être prévisible si l'état initial est connu.
Lorsque le caractère véritablement aléatoire est crucial, envisagez d'utiliser d'autres méthodes, comme des appels système ou l'intégration de bibliothèques externes.

**Syntaxe**

```sql theme={null}
rand64([x])
```

**Arguments**

* `x` — Facultatif et ignoré. Le seul but de cet argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre UInt64 aléatoire suivant une distribution uniforme. [`UInt64`](/fr/reference/data-types/int-uint)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT rand64();
```

```response title=Response theme={null}
15030268859237645412
```

<div id="randBernoulli">
  ## randBernoulli
</div>

Introduit dans : v22.10.0

Renvoie un nombre aléatoire de type Float64 issu d’une [loi de Bernoulli](https://en.wikipedia.org/wiki/Bernoulli_distribution).

**Syntaxe**

```sql theme={null}
randBernoulli(probability[, x])
```

**Arguments**

* `probability` — La probabilité de succès, sous la forme d'une valeur comprise entre `0` et `1`. [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul objectif de cet argument est d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie une valeur `Float64` aléatoire générée selon la loi de Bernoulli spécifiée. [`UInt64`](/fr/reference/data-types/int-uint)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randBernoulli(.75) FROM numbers(5)
```

```response title=Response theme={null}
┌─randBernoulli(0.75)─┐
│                   1 │
│                   1 │
│                   0 │
│                   1 │
│                   1 │
└─────────────────────┘
```

<div id="randBinomial">
  ## randBinomial
</div>

Apparu dans : v22.10.0

Renvoie un nombre aléatoire de type Float64 tiré d'une [loi binomiale](https://en.wikipedia.org/wiki/Binomial_distribution).

**Syntaxe**

```sql theme={null}
randBinomial(experiments, probability[, x])
```

**Arguments**

* `experiments` — Le nombre d’épreuves [`UInt64`](/fr/reference/data-types/int-uint)
* `probability` — La probabilité de succès de chaque épreuve, sous la forme d’une valeur comprise entre `0` et `1` [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul but de cet argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type Float64 issu de la loi binomiale spécifiée. [`UInt64`](/fr/reference/data-types/int-uint)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT randBinomial(100, .75) FROM numbers(5)
```

```response title=Response theme={null}
┌─randBinomial(100, 0.75)─┐
│                      74 │
│                      78 │
│                      76 │
│                      77 │
│                      80 │
└─────────────────────────┘
```

<div id="randCanonical">
  ## randCanonical
</div>

Introduit dans : v22.11.0

Renvoie un nombre `Float64` aléatoire suivant une distribution uniforme entre `0` (inclus) et `1` (exclus).

**Syntaxe**

```sql theme={null}
randCanonical([x])
```

**Arguments**

* `x` — Facultatif et ignoré. Le seul but de l’argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type Float64. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT randCanonical();
```

```response title=Response theme={null}
0.345217890123456
```

<div id="randChiSquared">
  ## randChiSquared
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire tiré d’une [loi du chi carré](https://en.wikipedia.org/wiki/Chi-squared_distribution).

**Syntaxe**

```sql theme={null}
randChiSquared(degree_of_freedom[, x])
```

**Arguments**

* `degree_of_freedom` — Degrés de liberté. [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul but de cet argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire Float64 tiré de la distribution du chi carré spécifiée. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT randChiSquared(10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randChiSquared(10)─┐
│ 10.015463656521543 │
│  9.621799919882768 │
│   2.71785015634699 │
│ 11.128188665931908 │
│  4.902063104425469 │
└────────────────────┘
```

<div id="randConstant">
  ## randConstant
</div>

Introduit dans : v1.1.0

Génère une valeur aléatoire unique qui reste constante pour toutes les lignes lors de l’exécution de la requête en cours.

Cette fonction :

* Renvoie la même valeur aléatoire pour chaque ligne au sein d’une même requête
* Produit des valeurs différentes d’une exécution à l’autre

Elle est utile pour utiliser les mêmes seeds ou identifiants aléatoires sur toutes les lignes d’un jeu de données

**Syntaxe**

```sql theme={null}
randConstant([x])
```

**Arguments**

* `x` — Facultatif et ignoré. Le seul but de l’argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie une colonne de type `UInt32` contenant la même valeur aléatoire sur chaque ligne. [`UInt32`](/fr/reference/data-types/int-uint)

**Exemples**

**Utilisation de base**

```sql title=Query theme={null}
SELECT randConstant() AS random_value;
```

```response title=Response theme={null}
| random_value |
|--------------|
| 1234567890   |
```

**Utilisation avec un paramètre**

```sql title=Query theme={null}
SELECT randConstant(10) AS random_value;
```

```response title=Response theme={null}
| random_value |
|--------------|
| 9876543210   |
```

<div id="randExponential">
  ## randExponential
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire issu d’une [loi exponentielle](https://en.wikipedia.org/wiki/Exponential_distribution).

**Syntaxe**

```sql theme={null}
randExponential(lambda[, x])
```

**Arguments**

* `lambda` — Paramètre de taux, ou valeur lambda, de la distribution [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul but de l’argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type Float64 issu de la distribution exponentielle spécifiée. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT randExponential(1/10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randExponential(divide(1, 10))─┐
│              44.71628934340778 │
│              4.211013337903262 │
│             10.809402553207766 │
│              15.63959406553284 │
│             1.8148392319860158 │
└────────────────────────────────┘
```

<div id="randFisherF">
  ## randFisherF
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire tiré d’une [loi F](https://en.wikipedia.org/wiki/F-distribution).

**Syntaxe**

```sql theme={null}
randFisherF(d1, d2[, x])
```

**Arguments**

* `d1` — le degré de liberté d1 dans `X = (S1 / d1) / (S2 / d2)`. [`Float64`](/fr/reference/data-types/float)
* `d2` — le degré de liberté d2 dans `X = (S1 / d1) / (S2 / d2)`. [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul but de cet argument est d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) si le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type Float64 tiré de la loi F spécifiée [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randFisherF(10, 3) FROM numbers(5)
```

```response title=Response theme={null}
┌─randFisherF(10, 20)─┐
│  0.7204609609506184 │
│  0.9926258472572916 │
│  1.4010752726735863 │
│ 0.34928401507025556 │
│  1.8216216009473598 │
└─────────────────────┘
```

<div id="randLogNormal">
  ## randLogNormal
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire issu d'une [loi log-normale](https://en.wikipedia.org/wiki/Log-normal_distribution).

**Syntaxe**

```sql theme={null}
randLogNormal(mean, stddev[, x])
```

**Arguments**

* `mean` — La valeur moyenne de la distribution. [`Float64`](/fr/reference/data-types/float)
* `stddev` — L’écart type de la distribution. [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul objectif de cet argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire `Float64` tiré de la distribution log-normale spécifiée. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT randLogNormal(100, 5) FROM numbers(5)
```

```response title=Response theme={null}
┌─randLogNormal(100, 5)─┐
│  1.295699673937363e48 │
│  9.719869109186684e39 │
│  6.110868203189557e42 │
│  9.912675872925529e39 │
│ 2.3564708490552458e42 │
└───────────────────────┘
```

<div id="randNegativeBinomial">
  ## randNegativeBinomial
</div>

Introduit dans : v22.10.0

Renvoie un nombre aléatoire de type Float64 tiré d’une [loi binomiale négative](https://en.wikipedia.org/wiki/Negative_binomial_distribution).

**Syntaxe**

```sql theme={null}
randNegativeBinomial(experiments, probability[, x])
```

**Arguments**

* `experiments` — Le nombre d'expériences. [`UInt64`](/fr/reference/data-types/int-uint)
* `probability` — `La probabilité d'échec dans chaque expérience, sous forme d'une valeur comprise entre `0`et`1`. [`Float64\`]\(/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul but de cet argument est d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre Float64 aléatoire issu de la distribution binomiale négative spécifiée [`UInt64`](/fr/reference/data-types/int-uint)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randNegativeBinomial(100, .75) FROM numbers(5)
```

```response title=Response theme={null}
┌─randNegativeBinomial(100, 0.75)─┐
│                              33 │
│                              32 │
│                              39 │
│                              40 │
│                              50 │
└─────────────────────────────────┘
```

<div id="randNormal">
  ## randNormal
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire issu d'une [loi normale](https://en.wikipedia.org/wiki/Normal_distribution).

**Syntaxe**

```sql theme={null}
randNormal(mean, stddev[, x])
```

**Arguments**

* `mean` — La moyenne de la distribution [`Float64`](/fr/reference/data-types/float)
* `stddev` — L’écart type de la distribution [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul but de cet argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type Float64 issu de la distribution normale spécifiée. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT randNormal(10, 2) FROM numbers(5)
```

```response title=Response theme={null}
┌──randNormal(10, 2)─┐
│ 13.389228911709653 │
│  8.622949707401295 │
│ 10.801887062682981 │
│ 4.5220192605895315 │
│ 10.901239123982567 │
└────────────────────┘
```

<div id="randPoisson">
  ## randPoisson
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire tiré d’une [distribution de Poisson](https://en.wikipedia.org/wiki/Poisson_distribution).

**Syntaxe**

```sql theme={null}
randPoisson(n[, x])
```

**Arguments**

* `n` — Le nombre moyen d'occurrences. [`UInt64`](/fr/reference/data-types/int-uint)
* `x` — Facultatif et ignoré. Cet argument a pour seul but d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type Float64 issu de la loi de Poisson spécifiée. [`UInt64`](/fr/reference/data-types/int-uint)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randPoisson(10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randPoisson(10)─┐
│               8 │
│               8 │
│               7 │
│              10 │
│               6 │
└─────────────────┘
```

<div id="randStudentT">
  ## randStudentT
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire issu d’une [loi t de Student](https://en.wikipedia.org/wiki/Student%27s_t-distribution).

**Syntaxe**

```sql theme={null}
randStudentT(degree_of_freedom[, x])
```

**Arguments**

* `degree_of_freedom` — Degrés de liberté. [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul objectif de cet argument est d’empêcher l’[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) si le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire de type Float64 tiré de la loi t de Student spécifiée. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT randStudentT(10) FROM numbers(5)
```

```response title=Response theme={null}
┌─────randStudentT(10)─┐
│   1.2217309938538725 │
│   1.7941971681200541 │
│ -0.28192176076784664 │
│   0.2508897721303792 │
│  -2.7858432909761186 │
└──────────────────────┘
```

<div id="randUniform">
  ## randUniform
</div>

Introduit dans : v22.10.0

Renvoie un nombre Float64 aléatoire uniformément distribué sur l’intervalle $[\min, \max]$.

**Syntaxe**

```sql theme={null}
randUniform(min, max[, x])
```

**Arguments**

* `min` — Borne gauche de l'intervalle (incluse). [`Float64`](/fr/reference/data-types/float)
* `max` — Borne droite de l'intervalle (incluse). [`Float64`](/fr/reference/data-types/float)
* `x` — Facultatif et ignoré. Le seul but de cet argument est d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un nombre aléatoire tiré uniformément dans l'intervalle formé par `min` et `max`. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randUniform(5.5, 10) FROM numbers(5)
```

```response title=Response theme={null}
┌─randUniform(5.5, 10)─┐
│    8.094978491443102 │
│   7.3181248914450885 │
│    7.177741903868262 │
│    6.483347380953762 │
│    6.122286382885112 │
└──────────────────────┘
```

<div id="randomFixedString">
  ## randomFixedString
</div>

Introduit dans : v20.5.0

Génère une chaîne aléatoire de longueur fixe contenant le nombre de caractères spécifié.
Les caractères renvoyés ne sont pas nécessairement des caractères ASCII, c’est-à-dire qu’ils peuvent ne pas être imprimables.

**Syntaxe**

```sql theme={null}
randomFixedString(length)
```

**Arguments**

* `length` — Longueur de la chaîne en octets. [`UInt*`](/fr/reference/data-types/int-uint)

**Valeur renvoyée**

Une chaîne remplie d'octets aléatoires. [`FixedString`](/fr/reference/data-types/fixedstring)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randomFixedString(13) AS rnd, toTypeName(rnd)
```

```response title=Response theme={null}
┌─rnd──────┬─toTypeName(randomFixedString(13))─┐
│ j▒h㋖HɨZ'▒ │ FixedString(13)                 │
└──────────┴───────────────────────────────────┘
```

<div id="randomPrintableASCII">
  ## randomPrintableASCII
</div>

Introduit dans : v20.1.0

Génère une chaîne [ASCII](https://en.wikipedia.org/wiki/ASCII#Printable_characters) aléatoire contenant le nombre de caractères spécifié.

Si vous passez `length < 0`, le comportement de la fonction est indéfini.

**Syntaxe**

```sql theme={null}
randomPrintableASCII(length[, x])
```

**Arguments**

* `length` — Longueur de la chaîne en octets. [`(U)Int*`](/fr/reference/data-types/int-uint)
* `x` — Facultatif et ignoré. Le seul but de cet argument est d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsqu'un même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie une chaîne composée d'un ensemble aléatoire de caractères ASCII imprimables. [`String`](/fr/reference/data-types/string)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT number, randomPrintableASCII(30) AS str, length(str) FROM system.numbers LIMIT 3
```

```response title=Response theme={null}
┌─number─┬─str────────────────────────────┬─length(randomPrintableASCII(30))─┐
│      0 │ SuiCOSTvC0csfABSw=UcSzp2.`rv8x │                               30 │
│      1 │ 1Ag NlJ &RCN:*>HVPG;PE-nO"SUFD │                               30 │
│      2 │ /"+<"with:=LjJ Vm!c&hI*m#XTfzz │                               30 │
└────────┴────────────────────────────────┴──────────────────────────────────┘
```

<div id="randomString">
  ## randomString
</div>

Introduit dans : v20.5.0

Génère une chaîne aléatoire du nombre de caractères spécifié.
Les caractères renvoyés ne sont pas nécessairement des caractères ASCII, c’est-à-dire qu’ils peuvent ne pas être affichables.

**Syntaxe**

```sql theme={null}
randomString(length[, x])
```

**Arguments**

* `length` — Longueur de la chaîne en octets. [`(U)Int*`](/fr/reference/data-types/int-uint)
* `x` — Facultatif et ignoré. Cet argument a pour seule fonction d'empêcher l'[élimination des sous-expressions communes](/fr/reference/functions/regular-functions/overview#common-subexpression-elimination) lorsque le même appel de fonction est utilisé plusieurs fois dans une requête. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie une chaîne remplie d'octets aléatoires. [`String`](/fr/reference/data-types/string)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randomString(5) AS str FROM numbers(2)
```

```response title=Response theme={null}
���
�v6B�
```

<div id="randomStringUTF8">
  ## randomStringUTF8
</div>

Introduit dans : v20.5.0

Génère une chaîne [UTF-8](https://en.wikipedia.org/wiki/UTF-8) aléatoire contenant le nombre de points de code spécifié.
Aucun point de code issu de [plans](https://en.wikipedia.org/wiki/Plane_\(Unicode\)) non attribués (plans 4 à 13) n'est renvoyé.
Il est également possible que le client interagissant avec le serveur ClickHouse ne soit pas en mesure d'afficher correctement la chaîne UTF-8 générée.

**Syntaxe**

```sql theme={null}
randomStringUTF8(length)
```

**Arguments**

* `length` — Longueur de la chaîne en points de code. [`(U)Int*`](/fr/reference/data-types/int-uint)

**Valeur renvoyée**

Renvoie une chaîne composée de points de code UTF-8 aléatoires. [`String`](/fr/reference/data-types/string)

**Exemples**

**Exemple d'utilisation**

```sql title=Query theme={null}
SELECT randomStringUTF8(13)
```

```response title=Response theme={null}
┌─randomStringUTF8(13)─┐
│ 𘤗𙉝д兠庇󡅴󱱎󦐪􂕌𔊹𓰛       │
└──────────────────────┘
```