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à.
# Archivia e inoltra i dati delle campagne
**Importante**
L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta [AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise](fleetwise-regions.md).
Utilizza le partizioni di dati all'interno delle campagne per archiviare temporaneamente i dati di segnale su Edge per veicoli e flotte. Configurando le opzioni di caricamento e archiviazione per le partizioni di dati, puoi ottimizzare le condizioni ideali per l'inoltro dei dati verso le destinazioni di dati designate (come un bucket Amazon S3). Ad esempio, puoi configurare la partizione dati per archiviare i dati su un veicolo fino a quando non si connette al Wi-Fi. Quindi, una volta che il veicolo si connette, la campagna attiva l'invio dei dati in quella particolare partizione al cloud. In alternativa, puoi raccogliere dati utilizzando AWS IoT Jobs.
**Topics**
+ [Creare partizioni di dati](create-campaign-data-partitions.md)
+ [Carica i dati della campagna](update-campaign-cli-data-partitions.md)
+ [Carica i dati utilizzando AWS IoT Jobs](update-campaign-cli-data-partitions-jobs.md)
# Creare partizioni di dati
**Importante**
L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta [AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise](fleetwise-regions.md).
Una partizione dati in una campagna memorizza temporaneamente i dati del segnale. Puoi configurare quando e come inoltrare i dati al cloud.
Una partizione di dati funziona designando innanzitutto un particolare set di dati utilizzando il `dataPartitionId` per una campagna. Quindi, puoi definire ulteriormente le opzioni di archiviazione delle partizioni, come la dimensione massima, il tempo minimo per mantenere attiva la partizione dei dati (su disco) e dove archiviare i dati su Edge. È possibile determinare la posizione di archiviazione sul veicolo utilizzando. `storageLocation` La posizione di archiviazione determina il nome della cartella per la partizione di dati nella cartella di archiviazione della campagna. La cartella di archiviazione della campagna si trova in una cartella denominata con il nome del veicolo in un percorso di persistenza definito nel file di configurazione di Edge. Questo è il percorso assoluto della posizione di archiviazione:. `{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}`
La modalità di spooling impostata su `TO_DISK` specifica che i dati partizionati devono essere salvati su un disco del veicolo. L'archiviazione dei dati per le partizioni di dati funziona su base FIFO (first in, first out). Se elimini una campagna, elimini anche i dati nella partizione dati associata. Se non si specifica una partizione dati per i casi d' on/off uso della connettività, l' AWS IoT archivia FleetWise comunque i dati in un ring buffer sul veicolo in assenza di connettività. Quando la connettività riprende, l' AWS IoT FleetWise carica i dati sul cloud. Questo comportamento è configurabile nel FleetWise software Edge Agent for AWS IoT.
**Importante**
Se la partizione dei dati supera il limite massimo di archiviazione impostato, i dati più recenti sovrascrivono i dati più vecchi quando la partizione raggiunge la dimensione massima. I dati persi su Edge non sono recuperabili. La dimensione dello storage è determinata dal limite di archiviazione di Edge.
Quando i dati vengono caricati sul cloud, possono essere rimossi dopo che è trascorso il tempo minimo di validità. Imposta il periodo minimo di permanenza in modo appropriato per evitare eliminazioni involontarie.
Le opzioni di caricamento determinano le espressioni variabili e il linguaggio delle condizioni. Se vengono specificate le opzioni di caricamento, è necessario specificare anche le opzioni di archiviazione. Puoi anche richiedere che i segnali nelle partizioni di dati vengano caricati nel cloud. Per ulteriori informazioni, consulta [Carica i dati della campagna](update-campaign-cli-data-partitions.md).
Dopo aver definito le condizioni di partizione dei dati, `signalsToCollect` aiuta a specificare quali segnali tenere conto nella partizione dati. È possibile specificare le IDs partizioni di dati o impostarle `dataPartitionId` per `default` utilizzare una partizione dati predefinita stabilita. Un segnale senza un valore specificato `dataPartitionId` verrà associato al valore predefinito. `dataPartition`
**Per creare una partizione di dati**
Utilizzando l'esempio seguente, crea una campagna con una condizione di archiviazione della partizione dati. Questa campagna di esempio è configurata per archiviare i dati del veicolo in Amazon Timestream.
1. Sostituiscilo *campaign-name* con il nome della campagna che stai creando.
1. (Facoltativo) Fornisci una descrizione.
1. Sostituisci *role-arn* con Amazon Resource Name (ARN) del ruolo di esecuzione dell'attività che concede l'autorizzazione AWS FleetWise IoT a fornire dati alla tabella Timestream.
1. Sostituisci *table-arn* con l'ARN della tabella Timestream.
1. Sostituisci *signal-catalog-arn* con l'ARN del catalogo dei segnali.
1. Sostituisci *data-partition-id* sia l'`dataPartitions`ID che l'ID a cui `signalsToCollect` associarti. Innanzitutto, sostituisci l'ID della partizione dati da utilizzare nel segnale. Infatti`signalsToCollect`, l'ID deve corrispondere a uno dei IDs dati forniti in`dataPartitions`.
**Nota**
Stabilisci una partizione dati predefinita per una campagna utilizzandola `default` come ID.
1. Sostituisci *target-arn* con l'ARN di una flotta o di un veicolo che hai creato.
```
{
"name": "campaign-name",
"description": "Measurement of SOC, SOH, thermal, and power optimization for Fleet 2704",
"targetArn": "target-arn",
"collectionScheme": {
"conditionBasedCollectionScheme": {
"conditionLanguageVersion": 1,
"expression": "$variable.`Vehicle.BMS` > 50",
"minimumTriggerIntervalMs": 1000,
"triggerMode": "ALWAYS"
}
},
"compression": "SNAPPY",
"dataDestinationConfigs": [{
"timestreamConfig": {
"executionRoleArn": "role-arn",
"timestreamTableArn": "table-arn"
}
}],
"dataPartitions": [{
"id": "data-partition-id",
"storageOptions": {
"maximumSize": {
"unit": "GB",
"value": 1024
},
"minimumTimeToLive": {
"unit": "WEEKS",
"value": 6
},
"storageLocation": "string"
},
"uploadOptions": {
"conditionLanguageVersion": 1,
"expression": "$variable.`Vehicle.BMS.PowerOptimization` > 90"
}
}],
"signalCatalogArn": "signal-catalog-arn",
"signalsToCollect": [{
"dataPartitionId": "data-partition-id",
"maxSampleCount": 50000,
"minimumSamplingIntervalMs": 100,
"name": "Below-90-percent"
}],
"spoolingMode": "TO_DISK",
"tags": [{
"Key": "BMS",
"Value": "Under-90"
}]
}
```
Dopo aver soddisfatto tutte le condizioni specificate, i dati partizionati vengono inoltrati al cloud, abilitando la raccolta e l'archiviazione di nuovi segnali partizionati.
Successivamente, chiamerai l'`UpdateCampaign`API per distribuirla nel FleetWise software Edge Agent for AWS IoT. Per ulteriori informazioni, consulta [Carica i dati della campagna](update-campaign-cli-data-partitions.md).
# Carica i dati della campagna
**Importante**
L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta [AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise](fleetwise-regions.md).
Esistono due modi per caricare i dati delle campagne su Edge:
+ Le campagne che soddisfano le tue condizioni di caricamento caricheranno automaticamente i dati sul cloud dopo l'approvazione. Per approvare una campagna, utilizza l'operazione `updateCampaign` API.
+ Tramite AWS IoT Jobs, puoi forzare il caricamento dei dati anche quando non sono soddisfatte le condizioni specificate. Per ulteriori informazioni, consulta [Carica i dati utilizzando AWS IoT Jobs](update-campaign-cli-data-partitions-jobs.md).
**Per caricare i dati della campagna utilizzando l'operazione `UpdateCampaign` API**
Dopo aver creato la campagna, lo stato della campagna rimane invariato `WAITING_FOR_APPROVAL` fino a quando non modifichi il `action` file in`APPROVED`.
+ Utilizza l'esempio seguente per aggiornare la campagna `action` richiamando l'operazione [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html)API.
```
{
"action": "APPROVED",
"dataExtraDimensions": [ "string" ],
"description": "string",
"name": "string"
}
```
# Carica i dati utilizzando AWS IoT Jobs
**Importante**
L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta [AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise](fleetwise-regions.md).
Con AWS IoT Jobs, puoi configurare campagne per caricare i dati archiviati dei veicoli sul cloud ogni volta che ne hai bisogno.
**Per creare un documento di lavoro per la tua campagna**
+ Utilizza l'esempio seguente per creare un documento di lavoro per la campagna. Un documento di lavoro è un file.json che contiene informazioni sui veicoli o sulle flotte necessari per eseguire un lavoro. *Per ulteriori informazioni sulla creazione di un documento di lavoro, consulta [Creare e gestire i lavori utilizzando la Guida per AWS CLI gli](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)AWS IoT sviluppatori.*
Per richiedere che solo un veicolo carichi i dati, imposta l'obiettivo del lavoro sull' AWS IoT elemento associato al veicolo. Per richiedere che più veicoli (nella stessa campagna) carichino i dati, crea un gruppo di oggetti che corrispondono ai veicoli, quindi imposta l'obiettivo del lavoro sul gruppo di oggetti.
```
{
"version": "1.0",
"parameters": {
"campaignArn": ${aws:iot:parameter:campaignArn},
"endTime": ${aws:iot:parameter:endTime}
}
}
```
1. Sostituisci `CampaignArn` con l'Amazon Resource Name (ARN) di una campagna nella stessa regione e nello stesso account. L'ARN della campagna è obbligatorio.
1. (Facoltativo) Sostituiscilo `endTime` con il timestamp dei dati raccolti sul veicolo in formato ISO 8601 UTC (senza millisecondi). Ad esempio, `2024-03-05T23:00:00Z`. Il timestamp è esclusivo e determina l'ultimo datapoint da caricare. Se ometti`endTime`, il software Edge Agent continua a caricarsi fino a quando non vengono caricati tutti i dati archiviati di una campagna. Dopo aver caricato tutti i dati, aggiorna lo [stato di esecuzione del lavoro](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states) a`SUCCEEDED`. Lo [stato](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states) del processo viene aggiornato a`COMPLETED`.
**Per creare un lavoro utilizzando un modello di lavoro gestito**
1. Scegli **IoT-IO TFleet Wise- CollectCampaignData** dall'elenco dei modelli gestiti. *Per ulteriori informazioni, consulta [Creare un lavoro da modelli AWS gestiti](https://docs.aws.amazon.com/iot/latest/developerguide/job-template-manage-console-create.html) nella Guida per gli AWS IoT sviluppatori.*
1. Il modello gestito presenta i `endTime` parametri `CampaignArn` and.
1. Sostituisci `CampaignArn` con l'Amazon Resource Name (ARN) di una campagna nella stessa regione e nello stesso account. L'ARN della campagna è obbligatorio.
1. (Facoltativo) Sostituiscilo `endTime` con il timestamp dei dati raccolti sul veicolo in formato ISO 8601 UTC (senza millisecondi). Ad esempio, `2024-03-05T23:00:00Z`. Il timestamp è esclusivo e determina l'ultimo datapoint da caricare. Se ometti`endTime`, il software Edge Agent continua a caricarsi fino a quando non vengono caricati tutti i dati archiviati di una campagna. Dopo aver caricato tutti i dati, aggiorna lo [stato di esecuzione del lavoro](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states) a`SUCCEEDED`. Lo [stato](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states) del processo viene aggiornato a`COMPLETED`.
Per gli argomenti correlati alla risoluzione dei problemi, vedere[Archivia e inoltra i problemi](troubleshooting-campaign.md).
Per ulteriori informazioni sui AWS IoT lavori, consulta [Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html) nella *AWS IoT Developer Guide*.