---
schema_version: "1"
id: 94c6f7e2026c07d8cfb5bc526b4c5e1564b7bf0e4e063843a49e2bfd96c04069
title: Funzioni pass-through (RAWSQL)
collection: tableau
version: current
locale: it-it
portal_url: https://docs.salesforce.com/tableau/current/it-it/public/desktop/functions_functions_passthrough.md
canonical_url: https://help.tableau.com/current/public/desktop/it-it/functions_functions_passthrough.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 3a29bf8da3233ba0b86c91070d1e475a942c1ba530b6f280836198b0d912f22d
description: Reference for RAWSQL pass-through functions that send SQL directly to the database.
---
[Passa al contenuto principale](#main-content)

# Funzioni pass-through (RAWSQL)

Queste funzioni pass-through RAWSQL inviano espressioni SQL direttamente al database, senza essere prima interpretate da Tableau. Se disponi di funzioni di database personalizzate di cui Tableau non è a conoscenza, utilizza le funzioni pass-through per chiamare queste funzioni personalizzate.

Poiché Tableau non interpreta l’espressione, se necessario devi definire l’aggregazione. Puoi utilizzare la versione `RAWSQLAGG` di una funzione quando devi passare un’espressione aggregata.

Le funzioni pass-through di RAWSQL potrebbero non funzionare con origini dati federate (combinate in database diversi) o pubblicate.

## Sintassi di RAWSQL

Le funzioni RAWSQL sono di due tipi: disaggregate e aggregate. Questo viene specificato nella prima parte del nome della funzione, ovvero _RAWSQL_ o _RAWSQLAGG_. La parte finale del nome della funzione è il tipo di output, ad esempio _BOOL_, _STR_ o _INT_. In tutte le funzioni RAWSQL, l’argomento è `"sql_expr", [arg1], ...[arg2]`. Quando scrivi la funzione, puoi utilizzare una sintassi di sostituzione `%n` per inserire il nome del campo o l’espressione corretta.

### Sintassi di sostituzione %n

Generalmente, il database non riconosce i nomi dei campi mostrati in Tableau. Poiché Tableau non interpreta le espressioni SQL nelle funzioni pass-through, l’utilizzo dei nomi dei campi di Tableau nella tua espressione può causare errori. Utilizza `%n` per inserire il nome del campo o l’espressione corretta per un calcolo Tableau in SQL pass-through.

Ad esempio, se avessi una funzione che calcola il valore mediano di un insieme di valori, potresti richiamare tale funzione nella colonna \[Vendite\] di Tableau in questo modo:

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

- `REALSQLAGG` perché desideri specificare l’aggregazione.
- `REAL` perché l’output è numerico e non necessariamente un intero.
- `MEDIAN` è l’aggregazione.
- `%1` è il segnaposto per `[Sales]`.

## Funzioni RAWSQL

L’espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell’espressione SQL come sintassi di sostituzione per i valori del database.

Le seguenti funzioni RAWSQL sono disponibili in Tableau:

### RAWSQL\_BOOL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>RAWSQL_BOOL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Booleano</td></tr><tr><td>Definizione</td><td>Restituisce un risultato booleano da una data espressione SQL.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQL_BOOL("%1 &gt; %2", [Sales], [Profit])</pre><p>Nell’esempio, %1 è uguale a [Sales] e %2 è uguale a [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>Sintassi</td><td><code>RAWSQLAGG_BOOL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Booleano</td></tr><tr><td>Definizione</td><td>Restituisce un risultato booleano da una data espressione SQL aggregata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQLAGG_BOOL("SUM( %1) &gt;SUM( %2)", [Sales], [Profit]) </pre><p>Nell’esempio, %1 è uguale a [Sales] e %2 è uguale a [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>Sintassi</td><td><code>RAWSQL_DATE("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Data</td></tr><tr><td>Definizione</td><td>Restituisce un risultato data da un’espressione SQL specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQL_DATE("%1", [Order Date])</pre><p>In questo esempio, %1 è uguale a [Order Date].</p></td></tr></tbody></table>

### RAWSQLAGG\_DATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>RAWSQLAGG_DATE("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Data</td></tr><tr><td>Definizione</td><td>Restituisce un risultato data da un’espressione SQL aggregata specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQLAGG_DATE("MAX(%1)", [Order Date])</pre><p>In questo esempio, %1 è uguale a [Order Date].</p></td></tr></tbody></table>

### RAWSQL\_DATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>RAWSQL_DATETIME("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Data e ora</td></tr><tr><td>Definizione</td><td>Restituisce un risultato data e ora da un’espressione SQL specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQL_DATETIME("%1", [Order Date])</pre><p>In questo esempio, %1 è uguale a [Order Date].</p></td></tr></tbody></table>

### RAWSQLAGG\_DATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>RAWSQLAGG_DATETIME("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Data e ora</td></tr><tr><td>Definizione</td><td>Restituisce un risultato data e ora da un’espressione SQL aggregata specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQLAGG_DATETIME("MIN(%1)", [Order Date])</pre><p>In questo esempio, %1 è uguale a [Order Date].</p></td></tr></tbody></table>

### RAWSQL\_INT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>RAWSQL_INT("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Intero</td></tr><tr><td>Definizione</td><td>Restituisce come risultato un numero intero da una data espressione SQL.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQL_INT("500 + %1", [Sales])</pre><p>In questo esempio, %1 è uguale a [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>Sintassi</td><td><code>RAWSQLAGG_INT("sql_expr", [arg1,] …[argN])</code></td></tr><tr><td>Output</td><td>Intero</td></tr><tr><td>Definizione</td><td>Restituisce come risultato un numero intero da una data espressione SQL aggregata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQLAGG_INT("500 + SUM(%1)", [Sales])</pre><p>In questo esempio, %1 è uguale a [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>Sintassi</td><td><code>RAWSQL_REAL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Numerico</td></tr><tr><td>Definizione</td><td>Restituisce un risultato numerico da un’espressione SQL specificata.</td></tr><tr><td>Esempio</td><td><pre>RAWSQL_REAL("-123.98 * %1", [Sales])</pre><p>In questo esempio, %1 è uguale a [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>Sintassi</td><td><code>RAWSQLAGG_REAL("sql_expr", [arg1,] …[argN])</code></td></tr><tr><td>Output</td><td>Numerico</td></tr><tr><td>Definizione</td><td>Restituisce un risultato numerico da un’espressione SQL aggregata specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQLAGG_REAL("SUM( %1)", [Sales])</pre><p>In questo esempio, %1 è uguale a [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>Sintassi</td><td><code>RAWSQL_SPATIAL("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Spaziale</td></tr><tr><td>Definizione</td><td>Restituisce un risultato spaziale da un’espressione SQL specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQL_SPATIAL("%1", [Geometry])</pre><p>In questo esempio, %1 è uguale a [Geometria].</p></td></tr><tr><td>Nota</td><td>Non esiste alcuna versione <code>RAWSQLAGG</code> di questa funzione.</td></tr></tbody></table>

### RAWSQL\_STR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>RAWSQL_STR("sql_expr", [arg1], …[argN])</code></td></tr><tr><td>Output</td><td>Stringa</td></tr><tr><td>Definizione</td><td>Restituisce una stringa da un’espressione SQL specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQL_STR("%1", [Customer Name])</pre><p>In questo esempio, %1 è uguale a [Nome cliente].</p></td></tr></tbody></table>

### RAWSQLAGG\_STR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>RAWSQLAGG_STR("sql_expr", [arg1,] …[argN])</code></td></tr><tr><td>Output</td><td>Stringa</td></tr><tr><td>Definizione</td><td>Restituisce una stringa da un’espressione SQL aggregata specificata.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">RAWSQLAGG_STR("AVG(%1)", [Discount])</pre><p>In questo esempio, %1 è uguale a [Sconto].</p></td></tr></tbody></table>