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

# Richieste endpoint per dati tabulari
<a name="clarify-processing-job-data-format-tabular-request"></a>

Per ottenere previsioni basate sui modelli per l'analisi delle distorsioni post-allenamento e l'analisi dell'importanza delle funzionalità, i processi di elaborazione di SageMaker Clarify serializzano i dati tabulari in byte e li inviano a un endpoint di inferenza come payload di richieste. Questi dati tabulari provengono dal set di dati di input o vengono generati. Se si tratta di dati sintetici, vengono generati dall'esplicatore per l'analisi SHAP o PDP.

Il formato dei dati di payload della richiesta deve essere specificato dal parametro `content_type` di configurazione dell'analisi. Se il parametro non viene fornito, il processo di elaborazione SageMaker Clarify utilizzerà il valore del parametro come tipo di contenuto. `dataset_type` Per ulteriori informazioni su `content_type` o `dataset_type`, consulta [File di configurazione dell’analisi](clarify-processing-job-configure-analysis.md).

Le successive sezioni mostrano esempi di richieste endpoint nei formati CSV e JSON Lines.

## Richiesta dell'endpoint in formato CSV
<a name="clarify-processing-job-data-format-tabular-request-csv"></a>

Il processo di elaborazione SageMaker Clarify può serializzare i dati in formato CSV (tipo MIME:). `text/csv` La seguente tabella mostra esempi dei payload di richiesta serializzati.


| Payload di richiesta dell'endpoint (rappresentazione di stringhe) | Commenti | 
| --- | --- | 
|  '1,2,3,4'  |  Record singolo (quattro funzionalità numeriche).  | 
|  '1,2,3,4\$1n5,6,7,8'  |  Due record, separati da un'interruzione di riga \$1n.  | 
|  '"Questo è un buon prodotto",5'  |  Record singolo (una funzionalità testuale e una numerica).  | 
|  '"Questo è un buon prodotto",5\$1n"Pessima esperienza di acquisto",1'  |  Due record.  | 

## La richiesta dell'endpoint è in formato JSON Lines
<a name="clarify-processing-job-data-format-tabular-request-jsonlines"></a>

Il processo di elaborazione SageMaker Clarify può serializzare i dati nel formato denso SageMaker AI JSON Lines (tipo MIME:). `application/jsonlines` Per ulteriori informazioni su righe JSON, consultare [Formato della richiesta JSONLINES](cdf-inference.md#cm-jsonlines).

Per trasformare i dati tabulari in dati JSON, fornisci una stringa modello al parametro `content_template` di configurazione dell'analisi. Per ulteriori informazioni su `content_template`, consulta [File di configurazione dell’analisi](clarify-processing-job-configure-analysis.md). La seguente tabella mostra esempi dei payload di richiesta serializzati.


| Payload di richiesta dell'endpoint (rappresentazione di stringhe) | Commenti | 
| --- | --- | 
|  '\$1"data":\$1"features":[1,2,3,4]\$1\$1'  |  Record singolo. In questo caso, la stringa di esempio assomiglia a`'{"data":{"features":$features}}' ` e `$features` viene sostituito dall'elenco delle funzionalità `[1,2,3,4]`.  | 
|  '\$1"data":\$1"features":[1,2,3,4]\$1\$1\$1n\$1"data":\$1"features":[5,6,7,8]\$1\$1'  |  Due record.  | 
|  '\$1"features":["Questo è un buon prodotto",5]\$1'  |  Record singolo. In questo caso, la stringa di esempio assomiglia a `'{"features":$features}'` e \$1features viene sostituito dall'elenco delle funzionalità `["This is a good product",5]`.  | 
|  '\$1"features":["Questo è un buon prodotto",5]\$1\$1n\$1"features":["Pessima esperienza di acquisto",1]\$1'  |  Due record.  | 

## La richiesta dell'endpoint è in formato JSON
<a name="clarify-processing-job-data-format-tabular-request-json"></a>

Un processo di elaborazione SageMaker Clarify può serializzare i dati in strutture JSON arbitrarie (tipo MIME:). `application/json` A tale scopo, è necessario fornire una stringa di esempio al parametro `content_template` di configurazione dell'analisi. Viene utilizzato dal processo di elaborazione SageMaker Clarify per costruire la struttura JSON esterna. È inoltre necessario fornire una stringa di esempio per `record_template`, che viene utilizzata per costruire la struttura JSON di ogni record. Per ulteriori informazioni su `content_template` e `record_template`, consulta [File di configurazione dell’analisi](clarify-processing-job-configure-analysis.md). 

**Nota**  
Poiché `content_template` e `record_template` sono parametri di stringa, tutti i caratteri con virgolette doppie (`"`) che fanno parte della struttura serializzata JSON devono essere annotati come caratteri di escape nella configurazione. Ad esempio, se vuoi evitare una virgoletta doppia in Python, puoi inserire quanto segue per `content_template`.  

```
"{\"data\":{\"features\":$record}}}"
```

La tabella seguente mostra esempi di payload di richieste JSON serializzate e i corrispondenti parametri `content_template` e `record_template` necessari per costruirli.


| Payload di richiesta dell'endpoint (rappresentazione di stringhe) | Commenti | content\$1template | record\$1template | 
| --- | --- | --- | --- | 
|  '\$1"data":\$1"features":[1,2,3,4]\$1\$1'  |  Un singolo record alla volta.  |  '\$1"data":\$1"features":\$1record\$1\$1\$1'  |  "\$1features"  | 
|  '\$1"instances":[[0, 1], [3, 4]], "feature-names": ["A", "B"]\$1'  |  Record multipli con nomi di funzionalità.  |  ‘\$1"instances":\$1records, "feature-names":\$1feature\$1names\$1'  |  "\$1features"  | 
|  '[\$1"A": 0, "B": 1\$1, \$1"A": 3, "B": 4\$1]'  |  Coppie multi-record e chiave-valore.  |  "\$1records"  |  "\$1features\$1kvp"  | 
|  '\$1"A": 0, "B": 1\$1'  |  Un record alla volta e coppie chiave-valore.  |  "\$1record"  |  "\$1features\$1kvp"  | 
|  '\$1"A": 0, "nested": \$1"B": 1\$1\$1'  |  In alternativa, usa il record\$1template completo per strutture arbitrarie.  |  "\$1record"  |  '\$1"A": "\$1\$1A\$1", "nested": \$1"B": "\$1\$1B\$1"\$1\$1'  |