---
schema_version: "1"
id: 945e52e73d4dad61905e9b37fba81299e301f35554fa092e5ef6657c9f65b946
title: Fonctions de passage direct (RAWSQL)
collection: tableau
version: current
locale: fr-fr
portal_url: https://docs.salesforce.com/tableau/current/fr-fr/pro/desktop/functions_functions_passthrough.md
canonical_url: https://help.tableau.com/current/pro/desktop/fr-fr/functions_functions_passthrough.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 50fcaa5f51d0aec6d0f2b097e17203749a3387671203b8c5bc504cbd86db0763
description: Reference for RAWSQL pass-through functions that send SQL directly to the database.
---
[Passer au contenu principal](#main-content)

# Fonctions de passage direct (RAWSQL)

Ces fonctions directes RAWSQL permettent d’envoyer des expressions SQL directement vers la base de données, sans qu’elles soient préalablement interprétées par Tableau. Si vous disposez de fonctions de bases de données personnalisées dont Tableau ne connaît pas l’existence, vous pouvez utiliser ces fonctions directes pour appeler ces fonctions personnalisées.

Le cas échéant, étant donné que Tableau n’interprète pas l’expression, vous devrez définir l’agrégation. Vous pouvez utiliser la version `RAWSQLAGG` d’une fonction lorsque vous avez besoin de transmettre une expression agrégée.

Il peut arriver que les fonctions directes RAWSQL ne fonctionnent pas avec des sources de données fédérées (combinées à travers différentes bases de données) ou des sources de données publiées.

## Syntaxe RAWSQL

Les fonctions RAWSQL sont de deux types, désagrégé et agrégé. Ce type est spécifié dans la première partie du nom de la fonction, _RAWSQL_ ou _RAWSQLAGG_. La dernière partie du nom de la fonction est le type de sortie, tel que _BOOL,_ _STR_ ou _INT_. Dans toutes les fonctions RAWSQL, l’argument est `"sql_expr", [arg1], ...[arg2]`. Lors de l’écriture de la fonction, vous pouvez utiliser une syntaxe de substitution `%n` pour insérer le nom de champ correct ou l’expression correcte.

### Syntaxe de substitution %n

Votre base de données ne comprend généralement pas les noms de champs affichés dans Tableau. Dans la mesure où Tableau n’interprète pas les expressions SQL que vous incluez dans les fonctions directes, l’utilisation de noms de champs Tableau dans votre expression peut entraîner des erreurs. Utilisez `%n` pour insérer le nom de champ correct ou l’expression correcte pour un calcul Tableau dans une fonction directe SQL.

Par exemple, imaginez que vous disposez d’une fonction calculant la valeur médiane d’un ensemble de valeurs, vous pouvez l’appeler à partir de la colonne \[Sales\] de Tableau, comme suit :

RAWSQLAGG\_REAL("MEDIAN(%1)", \[Sales\])

- `REALSQLAGG` parce que vous souhaitez spécifier l’agrégation.
- `REAL` parce que la sortie est numérique et n’est pas nécessairement un entier.
- `MEDIAN` désigne l’agrégation.
- `%1` est l’espace réservé pour `[Sales]`.

## Fonctions RAWSQL

L’expression SQL est envoyée directement vers la base de données sous-jacente. Utilisez %n dans l’expression SQL comme syntaxe de substitution pour les valeurs de la base de données.

Les fonctions RAWSQL suivantes sont disponibles dans Tableau :

### RAWSQL\_BOOL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQL_BOOL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Booléen</td></tr><tr><td>Définition</td><td>Renvoie un résultat booléen à partir d’une expression SQL donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQL_BOOL("%1 &gt; %2", [Sales], [Profit])</pre><p>Dans cet exemple, %1 est égal à [Sales] et %2 est égal à [Profit].</p></td></tr></tbody></table>

### RAWSQLAGG\_BOOL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQLAGG_BOOL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Booléen</td></tr><tr><td>Définition</td><td>Renvoie un résultat booléen à partir d’une expression SQL d’agrégation.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQLAGG_BOOL("SUM( %1) &gt;SUM( %2)", [Sales], [Profit]) </pre><p>Dans cet exemple, %1 est égal à [Sales] et %2 est égal à [Profit].</p></td></tr></tbody></table>

### RAWSQL\_DATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQL_DATE("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Date</td></tr><tr><td>Définition</td><td>Renvoie un résultat de type Date à partir d’une expression SQL donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQL_DATE("%1", [Order Date])</pre><p>Dans cet exemple, %1 est égal à [Date Commande].</p></td></tr></tbody></table>

### RAWSQLAGG\_DATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQLAGG_DATE("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Date</td></tr><tr><td>Définition</td><td>Renvoie un résultat de type Date à partir d’une expression SQL d’agrégation donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQLAGG_DATE("MAX(%1)", [Order Date])</pre><p>Dans cet exemple, %1 est égal à [Date Commande].</p></td></tr></tbody></table>

### RAWSQL\_DATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQL_DATETIME("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Datetime</td></tr><tr><td>Définition</td><td>Renvoie un résultat de type Date et heure à partir d’une expression SQL donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQL_DATETIME("%1", [Order Date])</pre><p>Dans cet exemple, %1 est égal à [Date Commande].</p></td></tr></tbody></table>

### RAWSQLAGG\_DATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQLAGG_DATETIME("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Datetime</td></tr><tr><td>Définition</td><td>Renvoie un résultat de type Date et heure à partir d’une expression SQL d’agrégation donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQLAGG_DATETIME("MIN(%1)", [Order Date])</pre><p>Dans cet exemple, %1 est égal à [Date Commande].</p></td></tr></tbody></table>

### RAWSQL\_INT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQL_INT("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie un résultat entier à partir d’une expression SQL donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQL_INT("500 + %1", [Sales])</pre><p>Dans cet exemple, %1 est égal à [Sales].</p></td></tr></tbody></table>

### RAWSQLAGG\_INT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQLAGG_INT("sql_expr", [arg1,] …[argN])</code></td></tr><tr><td>Sortie</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie un résultat de nombre entier à partir d’une expression SQL d’agrégation.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQLAGG_INT("500 + SUM(%1)", [Sales])</pre><p>Dans cet exemple, %1 est égal à [Sales].</p></td></tr></tbody></table>

### RAWSQL\_REAL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQL_REAL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Nombre</td></tr><tr><td>Définition</td><td>Renvoie un résultat numérique à partir d’une expression SQL donnée.</td></tr><tr><td>Exemple</td><td><pre>RAWSQL_REAL("-123.98 * %1", [Sales])</pre><p>Dans cet exemple, %1 est égal à [Sales].</p></td></tr></tbody></table>

### RAWSQLAGG\_REAL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQLAGG_REAL("sql_expr", [arg1,] …[argN])</code></td></tr><tr><td>Sortie</td><td>Nombre</td></tr><tr><td>Définition</td><td>Renvoie un résultat numérique à partir d’une expression SQL d’agrégation donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQLAGG_REAL("SUM( %1)", [Sales])</pre><p>Dans cet exemple, %1 est égal à [Sales].</p></td></tr></tbody></table>

### RAWSQL\_SPATIAL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQL_SPATIAL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Graphiques spatiaux</td></tr><tr><td>Définition</td><td>Renvoie un résultat de données spatiales à partir d’une expression SQL donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQL_SPATIAL("%1", [Geometry])</pre><p>Dans cet exemple, %1 est égal à [Geometry].</p></td></tr><tr><td>Remarque</td><td>Il n’y a pas de version <code>RAWSQLAGG</code> de cette fonction.</td></tr></tbody></table>

### RAWSQL\_STR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQL_STR("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Sortie</td><td>Chaîne</td></tr><tr><td>Définition</td><td>Renvoie une chaîne à partir d’une expression SQL donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQL_STR("%1", [Customer Name])</pre><p>Dans cet exemple, %1 est égal à [Customer Name].</p></td></tr></tbody></table>

### RAWSQLAGG\_STR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>RAWSQLAGG_STR("sql_expr", [arg1,] …[argN])</code></td></tr><tr><td>Sortie</td><td>Chaîne</td></tr><tr><td>Définition</td><td>Renvoie une chaîne à partir d’une expression SQL d'agrégation donnée.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">RAWSQLAGG_STR("AVG(%1)", [Discount])</pre><p>Dans cet exemple, %1 est égal à [Discount].</p></td></tr></tbody></table>