Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo dei parametri del set di dati in Amazon Quick
In Amazon Quick, gli autori possono utilizzare i parametri dei set di dati in Direct Quick per personalizzare dinamicamente i propri set di dati e applicare una logica riutilizzabile ai propri set di dati. Un *parametro del set di dati* è un parametro creato a livello di set di dati. Viene utilizzato da un parametro di analisi tramite controlli, campi calcolati, filtri, azioni URLs, titoli e descrizioni. Per ulteriori informazioni sui parametri di analisi, consulta [Parametri in Amazon Quick](parameters-in-quicksight.md). L'elenco seguente descrive tre azioni che possono essere eseguite con i parametri dei set di dati:
+ **SQL personalizzato in query diretta**: i proprietari del set di dati possono inserire i parametri del set di dati nell'SQL personalizzato di un set di dati della query diretta. Quando questi parametri vengono applicati a un controllo di filtro in un'analisi rapida, gli utenti possono filtrare i dati personalizzati in modo più rapido ed efficiente.
+ **Variabili ripetibili**: i valori statici che appaiono in più posizioni nella pagina del set di dati possono essere modificati con un'unica azione utilizzando parametri personalizzati del set di dati.
+ **Sposta i campi calcolati nei set** di dati: gli autori di Quick possono copiare i campi calcolati con parametri in un'analisi e migrarli a livello di set di dati. Ciò protegge i campi calcolati a livello di analisi da modifiche accidentali e i campi calcolati possono essere condivisi tra più analisi.
In alcune situazioni, i parametri del set di dati migliorano le prestazioni di controllo dei filtri per i set di dati di query dirette che richiedono un SQL personalizzato complesso e semplificano la logica aziendale a livello di set di dati.
**Topics**
+ [Limitazioni dei parametri del set di dati](#dataset-parameters-limitations)
+ [Creazione di parametri del set di dati in Amazon Quick](dataset-parameters-SQL.md)
+ [Inserimento dei parametri del set di dati nell'SQL personalizzato](dataset-parameters-insert-parameter.md)
+ [Aggiunta di parametri del set di dati ai campi calcolati](dataset-parameters-calculated-fields.md)
+ [Aggiunta di parametri del set di dati ai filtri](dataset-parameters-dataset-filters.md)
+ [Utilizzo dei parametri del set di dati nelle analisi rapide](dataset-parameters-analysis.md)
+ [Casi d'uso avanzati dei parametri del set di dati](dataset-parameters-advanced-options.md)
## Limitazioni dei parametri del set di dati
Questa sezione descrive le limitazioni note che potresti incontrare quando lavori con i parametri dei set di dati in Amazon Quick.
+ Quando i lettori del pannello di controllo pianificano i report inviati tramite e-mail, i controlli selezionati non si propagano ai parametri del set di dati inclusi nel report allegato all'e-mail. Vengono invece utilizzati i valori predefiniti dei parametri.
+ I parametri del set di dati non possono essere inseriti nell'SQL personalizzato dei set di dati archiviati in SPICE.
+ I valori predefiniti dinamici possono essere configurati solo nella pagina di analisi dell'analisi che utilizza il set di dati. Non è possibile configurare un valore predefinito dinamico a livello di set di dati.
+ L'opzione **Seleziona tutto** non è supportata sui controlli multi-valore dei parametri di analisi mappati ai parametri del set di dati.
+ I controlli a cascata non sono supportati per i parametri del set di dati.
+ I parametri del set di dati possono essere utilizzati dai filtri del set di dati solo quando il set di dati utilizza una query diretta.
+ In una query SQL personalizzata, è possibile utilizzare solo 128 parametri del set di dati.
# Creazione di parametri del set di dati in Amazon Quick
Utilizza le seguenti procedure per iniziare a utilizzare i parametri del set di dati.
**Creazione di un nuovo parametro del set di dati**
1. **Dalla pagina di avvio rapido, scegli **Dati** a sinistra, scegli i puntini di sospensione (tre punti) accanto al set di dati che desideri modificare, quindi scegli Modifica.**
1. Nella pagina **Set di dati** visualizzata, scegli **Parametri** sulla sinistra, quindi fai clic sull'icona (\$1) per creare un nuovo parametro del set di dati.
1. Nella finestra a comparsa **Crea nuovo parametro** che appare, inserisci un nome per il parametro nella casella **Nome**.
1. Nel menu a discesa **Tipo di dati**, scegli il tipo di dati desiderato per il parametro. I tipi di dati supportati sono `String`, `Integer`, `Number` e `Datetime`. Questa opzione non potrà essere modificata dopo la creazione del parametro.
1. Per **Valore predefinito**, immetti il valore predefinito che desideri assegnare al parametro.
**Nota**
Quando associ un parametro del set di dati a un parametro di analisi, è possibile scegliere un valore predefinito diverso. In questo caso, il valore predefinito configurato qui sarà sovrascritto dal nuovo valore predefinito.
1. Per **Valori**, scegli il tipo di valore che desideri assegnare al parametro. I parametri a **valore singolo** supportano menu a discesa a selezione singola, campi di testo e controlli elenco. I parametri a **valori multipli** supportano i controlli di menu a discesa a selezione multipla. Questa opzione non potrà essere modificata dopo la creazione del parametro.
1. Al termine della configurazione del nuovo parametro, scegli **Crea** per crearlo.
# Inserimento dei parametri del set di dati nell'SQL personalizzato
È possibile inserire i parametri del set di dati nell'SQL personalizzato di un set di dati in modalità di query diretta facendo riferimento ad esso con `<<$parameter_name>>` nell'istruzione SQL. Durante il runtime, gli utenti del pannello di controllo possono inserire i valori di controllo del filtro associati a un parametro del set di dati. Quindi, possono visualizzare i risultati negli elementi visivi del pannello di controllo dopo che i valori sono stati propagati alla query SQL. È possibile utilizzare i parametri per creare filtri di base in base all'input del cliente nelle clausole `where`. In alternativa, è possibile aggiungere le clausole `case when` o `if else` per modificare dinamicamente la logica della query SQL in base all'input di un parametro.
Ad esempio, supponiamo di voler aggiungere una clausola `WHERE` al codice SQL personalizzato che filtra i dati in base al nome della Regione di un utente finale. In questo caso, crei un parametro a valore singolo chiamato `RegionName`:
```
SELECT *
FROM transactions
WHERE region = <<$RegionName>>
```
Puoi anche consentire agli utenti di fornire più valori al parametro:
```
SELECT *
FROM transactions
WHERE region in (<<$RegionNames>>)
```
Nel seguente esempio più complesso, l'autore di un set di dati fa riferimento due volte a due parametri del set di dati in base al nome e al cognome di un utente che possono essere selezionati in un controllo di filtro del pannello di controllo:
```
SELECT Region, Country, OrderDate, Sales
FROM transactions
WHERE region=
(Case
WHEN <<$UserFIRSTNAME>> In
(select firstname from user where region='region1')
and <<$UserLASTNAME>> In
(select lastname from user where region='region1')
THEN 'region1'
WHEN <<$UserFIRSTNAME>> In
(select firstname from user where region='region2')
and <<$UserLASTNAME>> In
(select lastname from user where region='region2')
THEN 'region2'
ELSE 'region3'
END)
```
I parametri possono essere utilizzati nelle clausole `SELECT` anche per creare nuove colonne in un set di dati dall'input dell'utente:
```
SELECT Region, Country, date,
(case
WHEN <<$RegionName>>='EU'
THEN sum(sales) * 0.93 --convert US dollar to euro
WHEN <<$RegionName>>='CAN'
THEN sum(sales) * 0.78 --convert US dollar to Canadian Dollar
ELSE sum(sales) -- US dollar
END
) as "Sales"
FROM transactions
WHERE region = <<$RegionName>>
```
Per creare una query SQL personalizzata o modificare una query esistente prima di aggiungere un parametro del set di dati, consulta [Utilizzo di SQL per personalizzare i dati](adding-a-SQL-query.md).
Quando si applica un codice SQL personalizzato con un parametro del set di dati, `<<$parameter_name>>` viene utilizzato come valore segnaposto. Quando un utente sceglie uno dei valori dei parametri da un controllo, Quick sostituisce il segnaposto con i valori che l'utente seleziona nella dashboard.
Nell'esempio seguente, l'utente immette una nuova query SQL personalizzata che filtra i dati in base allo stato:
```
select * from all_flights
where origin_state_abr = <<$State>>
```
Il valore predefinito del parametro viene applicato alla query SQL e i risultati vengono visualizzati nel **riquadro di anteprima**.
# Aggiunta di parametri del set di dati ai campi calcolati
Puoi aggiungere i parametri del set di dati anche alle espressioni dei campi calcolati utilizzando il formato `${parameter_name}`.
Quando si crea un calcolo, è possibile scegliere i parametri esistenti dall'elenco di parametri disponibili in **Parametri**. Non è possibile creare un campo calcolato che contenga un parametro multi-valore.
Per ulteriori informazioni sull'aggiunta di campi calcolati, consulta [Utilizzo di campi calcolati con parametri in Amazon Quick](parameters-calculated-fields.md).
# Aggiunta di parametri del set di dati ai filtri
Per i set di dati in modalità di query diretta, gli autori dei set di dati possono utilizzare i parametri del set di dati nei filtri senza SQL personalizzato. I parametri del set di dati non possono essere aggiunti ai filtri se il set di dati è archiviato in SPICE.
**Aggiunta di un parametro del set di dati a un filtro**
1. Apri la pagina del set di dati per il quale desideri creare un filtro. Scegli **Filtri** sulla sinistra, quindi scegli **Aggiungi filtro**.
1. Inserisci il nome che desideri assegnare al filtro, quindi scegli il campo che desideri filtrare dal menu a discesa.
1. Dopo aver creato il nuovo filtro, vai al filtro nel riquadro **Filtri**, scegli i puntini di sospensione (tre punti) accanto al filtro, quindi seleziona **Modifica**.
1. Per **Tipo di filtro**, scegli **Filtro personalizzato**.
1. Per **Condizione del filtro**, scegli la condizione desiderata.
1. Seleziona la casella **Usa parametro** e scegli il parametro del set di dati che desideri venga utilizzato dal filtro.
1. Una volta terminato con le modifiche, scegli **Aggiorna**.
# Utilizzo dei parametri del set di dati nelle analisi rapide
Dopo aver creato un parametro del set di dati e dopo averlo aggiunto a un'analisi, associa il parametro del set di dati a un parametro di analisi nuovo o esistente. Dopo aver associato un parametro del set di dati a un parametro di analisi, sarà possibile utilizzarli con filtri, controlli e qualsiasi altra funzionalità dei parametri di analisi.
È possibile gestire i parametri del set di dati nel riquadro **Parametri** dell'analisi che utilizza il set di dati a cui appartengono i parametri. Nella sezione **Parametri del set di dati** del riquadro **Parametri**, è possibile scegliere di visualizzare solo i parametri del set di dati non mappati (impostazione predefinita). In alternativa, è possibile decidere di visualizzare tutti i parametri del set di dati mappati e non mappati scegliendo **TUTTI** dal menu a discesa **Visualizzazione**.
## Mappatura dei parametri del set di dati nelle nuove analisi rapide
Quando crei una nuova analisi da un set di dati che contiene parametri, devi mappare i parametri del set di dati all'analisi prima di poterli utilizzare. Questo vale anche quando si aggiunge un set di dati con parametri a un'analisi. È possibile visualizzare tutti i parametri non mappati in un'analisi nel riquadro **Parametri** dell'analisi. In alternativa, scegli **VISUALIZZA** nel messaggio di notifica che appare in alto a destra della pagina quando crei l'analisi o aggiungi il set di dati.
**Mappatura di un parametro del set di dati a un parametro dell'analisi**
1. Apri la console [Quick](https://quicksight.aws.amazon.com/).
1. Scegli l'analisi che desideri modificare.
1. Scegli l'icona **Parametri** per aprire il riquadro **Parametri**.
1. Scegliete i puntini di sospensione (tre punti) accanto al parametro del set di dati che desideri mappare, scegli **Mappa parametro**, quindi scegli il parametro dell'analisi a cui desideri mappare il parametro del set di dati.
Se l'analisi non ha parametri di analisi, puoi scegliere **Mappa parametro** e **Crea nuovo** per creare un parametro dell'analisi che viene mappato automaticamente al parametro del set di dati al momento della creazione.
1. (Facoltativo) Nella finestra a comparsa **Crea nuovo parametro** che viene visualizzata, inserisci un nome per il nuovo parametro dell'analisi nella casella **Nome**.
1. (Facoltativo) Per **Valore predefinito**, immetti il valore predefinito che desideri assegnare al parametro.
1. (Facoltativo) Scegli **Imposta un valore predefinito dinamico** per impostare un valore predefinito dinamico per il nuovo parametro.
1. Nella tabella **Parametri del set di dati mappati**, vedrai il parametro del set di dati che stai mappando al nuovo parametro di analisi. È possibile aggiungere altri parametri del set di dati a questo parametro di analisi scegliendo il menu a discesa **AGGIUNGI PARAMETRO DEL SET DI DATI** e quindi scegliendo il parametro che si desidera mappare. È possibile annullare la mappatura di un parametro del set di dati scegliendo il pulsante **Rimuovi** accanto al parametro del set di dati da rimuovere.
Per ulteriori informazioni sulla creazione di parametri di analisi, consulta [Configurazione dei parametri in Amazon Quick](parameters-set-up.md).
Quando mappi un parametro del set di dati a un parametro di analisi, il parametro di analisi rappresenta il parametro del set di dati ovunque venga utilizzato nell'analisi.
È inoltre possibile mappare e annullare la mappatura dei parametri del set di dati ai parametri di analisi nella finestra **Modifica parametro**. Per aprire la finestra **Modifica parametro**, passa al riquadro **Parametri**, scegliete i puntini di sospensione (tre punti) accanto al parametro di analisi da modificare, quindi scegli **Modifica parametro**. È possibile aggiungere altri parametri del set di dati a questo parametro di analisi scegliendo il menu a discesa **AGGIUNGI PARAMETRO DEL SET DI DATI** e quindi scegliendo il parametro che si desidera mappare. È possibile annullare la mappatura di un parametro del set di dati scegliendo il pulsante **Rimuovi** accanto al parametro del set di dati da rimuovere. Puoi anche rimuovere tutti i parametri del set di dati mappati scegliendo **RIMUOVI TUTTO**. Una volta completate le modifiche, scegli **Aggiorna**.
Quando si elimina un parametro di analisi, la mappatura di tutti i parametri del set di dati viene annullata nell'analisi e vengono visualizzati nella sezione **NON MAPPATI** del riquadro **Parametri**. È possibile mappare un parametro del set di dati solo a un parametro di analisi alla volta. Per mappare un parametro del set di dati a un parametro di analisi diverso, annulla la mappatura del parametro del set di dati e mappalo di nuovo al nuovo parametro di analisi.
## Aggiunta di controlli di filtro ai parametri di analisi mappati
Dopo aver mappato un parametro del set di dati a un parametro di analisi in Quick, puoi creare controlli di filtro per filtri, azioni, campi calcolati, titoli, descrizioni e. URLs
**Aggiunta di un controllo a un parametro mappato**
1. Nel riquadro **Parametri** della pagina di analisi, scegli i puntini di sospensione (tre punti) accanto al parametro di analisi mappato desiderato, quindi scegli **Aggiungi controllo**.
1. Nella finestra **Aggiungi controllo** che appare, inserisci il **nome** desiderato e scegli lo **stile** che desideri assegnare al controllo. Per i controlli a valore singolo, scegli tra `Dropdown`, `List` e `Text field`. Per i controlli multivalore, scegli `Dropdown`.
1. Per creare il controllo, scegli **Aggiungi**.
# Casi d'uso avanzati dei parametri del set di dati
In questa sezione sono riportati opzioni e casi d'uso più avanzati relativi ai parametri del set di dati e ai controlli a discesa. Utilizza le seguenti procedure dettagliate per creare valori a discesa dinamici con parametri del set di dati.
## Utilizzo di controlli multivalore con parametri del set di dati
Quando si utilizzano i parametri del set di dati che vengono inseriti nell'SQL personalizzato di un set di dati, i parametri del set di dati generalmente filtrano i dati in base ai valori di una colonna specifica. Se si crea un controllo a discesa e si assegna il parametro come valore, l'elenco a discesa mostrerà solo il valore filtrato dal parametro. La procedura seguente mostra come creare un controllo mappato a un parametro del set di dati e mostra tutti i valori non filtrati.
**Compilazione di tutti i valori assegnati in un controllo a discesa**
1. Crea un nuovo set di dati a colonna singola in SPICE o una query diretta che includa tutti i valori univoci del set di dati originale. Ad esempio, supponiamo che il set di dati originale utilizzi il seguente SQL personalizzato:
```
select * from all_flights
where origin_state_abr = <<$State>>
```
Per creare una tabella a colonna singola con tutti gli stati di origine univoci, applica il seguente codice SQL personalizzato al nuovo set di dati:
```
SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc
```
L'espressione SQL restituisce tutti gli stati univoci in ordine alfabetico. Il nuovo set di dati non dispone di parametri del set di dati.
1. Immetti un **nome** per il nuovo set di dati, quindi salva e pubblica il set di dati. Nel nostro esempio, il nuovo set di dati si chiama `State Codes`.
1. Apri l'analisi che contiene il set di dati originale e aggiungi il nuovo set di dati. Per informazioni sull'aggiunta di set di dati a un'analisi esistente, consulta [Aggiunta di un set di dati a un'analisi](adding-a-data-set-to-an-analysis.md).
1. Passa al riquadro **Controlli** e individua il controllo a discesa che desideri modificare. Scegli i puntini di sospensione (tre punti) accanto al controllo, quindi scegli **Modifica**.
1. Nella finestra **Formatta controllo** che viene visualizzata sulla sinistra, scegli **Collega a un campo del set di dati** nella sezione **Valori**.
1. Per il menu a discesa **Set di dati** che appare, scegli il nuovo set di dati che hai creato. Nel nostro esempio, viene scelto il set di dati `State Codes`.
1. Per il menu a discesa **Campo** che appare, scegli il campo appropriato. Nel nostro esempio, viene scelto il campo `origin_state_abr`.
Dopo aver completato il collegamento del controllo al nuovo set di dati, tutti i valori univoci vengono visualizzati nel menu a discesa del controllo. Questi includono i valori che vengono filtrati dal parametro del set di dati.
## Utilizzo dei controlli con le opzioni Seleziona tutto
Per impostazione predefinita, quando uno o più parametri del set di dati vengono mappati a un parametro di analisi e sono aggiunti a un controllo, l'opzione `Select all` non è disponibile. La procedura seguente mostra una soluzione alternativa che utilizza lo stesso scenario di esempio della sezione precedente.
**Nota**
Questa procedura dettagliata riguarda set di dati sufficientemente piccoli da poter essere caricati nella query diretta. Se si dispone di un set di dati di grandi dimensioni e si desidera utilizzare l'opzione `Select All`, si consiglia di caricare il set di dati in SPICE. Tuttavia, se si desidera utilizzare l'opzione `Select All` con i parametri del set di dati, questa procedura dettagliata descrive un modo per farlo.
Per iniziare, supponiamo di avere un set di dati di query diretta con SQL personalizzato che contiene un parametro multivalore chiamato `States`:
```
select * from all_flights
where origin_state_abr in (<<$States>>)
```
**Utilizzo dell'opzione Seleziona tutto in un controllo che utilizza i parametri del set di dati**
1. Nel riquadro **Parametri** dell'analisi, individua il parametro del set di dati che desideri utilizzare e scegli **Modifica** dai puntini di sospensione (tre punti) accanto al parametro.
1. Nella finestra **Modifica parametro** che appare, inserisci un nuovo valore predefinito nella sezione **Molteplici valori predefiniti statici**. Nel nostro esempio, il valore predefinito è` All States`. Tieni presente che nell'esempio viene utilizzato uno spazio iniziale in modo che il valore predefinito venga visualizzato come primo elemento del controllo.
1. Scegli **Aggiorna** per aggiornare il parametro.
1. Passa al set di dati che contiene il parametro del set di dati che stai utilizzando in. analysis-by-analysis Modifica l'SQL personalizzato del set di dati per includere un caso d'uso predefinito per i nuovi valori predefiniti multipli statici. Utilizzando l'esempio ` All States`, l'espressione SQL viene visualizzata come segue:
```
select * from public.all_flights
where
' All States' in (<<$States>>) or
origin_state_abr in (<<$States>>)
```
Se l'utente sceglie ` All States` nel controllo, la nuova espressione SQL restituisce tutti i record univoci. Se l'utente sceglie un valore diverso dal controllo, la query restituisce i valori che sono stati filtrati dal parametro del set di dati.
### Utilizzo dei controlli con le opzioni Seleziona tutto e multivalore
È possibile combinare la procedura `Select all` precedente con il metodo di controllo multivalore discusso in precedenza per creare controlli a discesa che contengano un valore `Select all` oltre a più valori selezionabili dall'utente. Questa procedura dettagliata presuppone che l'utente abbia seguito le procedure precedenti, che sappia come mappare i parametri del set di dati ai parametri di analisi e che sia possibile creare controlli in un'analisi. Per ulteriori informazioni sui parametri di analisi, consulta [Mappatura dei parametri del set di dati nelle nuove analisi rapide](dataset-parameters-analysis.md#dataset-parameters-map-to-analysis). Per ulteriori informazioni sulla creazione di controlli in un'analisi che utilizza parametri del set di dati, consulta [Aggiunta di controlli di filtro ai parametri di analisi mappati](dataset-parameters-analysis.md#dataset-parameters-analysis-filter-control).
**Aggiunta di più valori a un controllo con l'opzione Seleziona tutto e un parametro del set di dati mappato**
1. Apri l'analisi contenente il set di dati originale con un'espressione SQL `Select all` personalizzata e un secondo set di dati che include tutti i possibili valori della colonna filtrata esistente nel set di dati originale.
1. Passa al set di dati secondario creato in precedenza per restituire tutti i valori di una colonna filtrata. Aggiungi un'espressione SQL personalizzata che aggiunga l'opzione `Select all` precedentemente configurata alla query. L'esempio seguente aggiunge il record ` All States` all'inizio dell'elenco dei valori restituiti dal set di dati:
```
(Select ' All States' as origin_state_abr)
Union All
(SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc)
```
1. Torna all'analisi a cui appartengono i set di dati e mappa il parametro del set di dati che stai utilizzando al parametro di analisi creato nella fase 3 della procedura precedente. Il parametro di analisi e il parametro del set di dati possono avere lo stesso nome. Nel nostro esempio, il parametro di analisi è chiamato `States`.
1. Crea un nuovo controllo di filtro o modifica un controllo di filtro esistente, quindi scegli **Nascondi Seleziona tutto** per nascondere l'opzione **Seleziona tutto** disabilitata che appare nei controlli multivalore.
Una volta creato il controllo, gli utenti potranno utilizzare lo stesso controllo per selezionare tutti o più valori di una colonna filtrata in un set di dati.