Impatto sulla conservazione dei dati Configura per il livello caldo (console)Configura per warm tier (AWS CLI) (Configurazione per il livello freddo (console)Configura per cold tier (AWS CLI)

Configurare le impostazioni di archiviazione

È possibile configurare le impostazioni di archiviazione per attivare lo storage warm tier gestito dal servizio e anche per replicare i dati sul piano freddo. Per ulteriori informazioni sul periodo di conservazione per i livelli caldo e caldo, consultaImpatto sulla conservazione dei dati. Durante la configurazione delle impostazioni di archiviazione, procedi come segue:

Conservazione a livello elevato: imposta un periodo di conservazione per quanto tempo i dati vengono archiviati nel livello più elevato prima che vengano eliminati e spostati nello storage a livello caldo o a livello freddo gestito dal servizio in base alle impostazioni di archiviazione. AWS IoT SiteWise eliminerà tutti i dati del livello più elevato che esistevano prima della fine del periodo di conservazione. Se non imposti un periodo di conservazione, i tuoi dati vengono archiviati a tempo indeterminato nel livello più elevato.
Conservazione a livello caldo: imposta un periodo di conservazione per quanto tempo i dati vengono archiviati nel livello caldo prima che vengano eliminati dallo AWS IoT SiteWise storage e trasferiti nello storage cold tier gestito dal cliente. AWS IoT SiteWise elimina tutti i dati dal livello caldo che esisteva prima della fine del periodo di conservazione. Se non è impostato un periodo di conservazione, i dati vengono archiviati a tempo indeterminato nel livello caldo.

Nota

Per migliorare le prestazioni delle query, imposta un periodo di conservazione di livello elevato con lo storage di livello caldo.

Impatto della conservazione dei dati nello storage di livello caldo e caldo

Quando si riduce il periodo di conservazione dello storage hot tier, i dati vengono trasferiti in modo permanente dal livello caldo a quello caldo o freddo. Quando si riduce il periodo di conservazione del livello caldo, i dati vengono spostati sul livello freddo ed eliminati definitivamente dal livello caldo.
Quando si aumenta il periodo di conservazione dello storage di livello caldo o caldo, la modifica influisce sui dati inviati AWS IoT SiteWise da quel momento in poi. AWS IoT SiteWise non recupera i dati dallo storage a caldo o a freddo per inserirli nel livello più caldo. Ad esempio, se il periodo di conservazione dello storage hot tier è inizialmente impostato su 30 giorni e poi aumentato a 60 giorni, occorrono 30 giorni perché lo storage hot tier contenga 60 giorni di dati.

Argomenti

Configura le impostazioni di archiviazione per il livello caldo (console)
Configura le impostazioni di archiviazione per warm tier (AWS CLI)
Configura le impostazioni di archiviazione per il livello freddo (console)
Configura le impostazioni di archiviazione per il livello freddo (AWS CLI)

Configura le impostazioni di archiviazione per il livello caldo (console)

La procedura seguente mostra come configurare le impostazioni di archiviazione per replicare i dati sul livello warm della AWS IoT SiteWise console.

Per configurare le impostazioni di archiviazione nella console

Passare alla console AWS IoT SiteWise.
Nel pannello di navigazione, in Impostazioni, scegli Archiviazione.
Nell'angolo in alto a destra, scegliere Edit (Modifica).
Nella pagina Modifica archiviazione, procedi come segue:
Per le impostazioni Hot tier, procedi come segue:
- Se desideri impostare un periodo di conservazione per il periodo di archiviazione dei dati nel livello più elevato prima di essere eliminati e spostati nello storage di livello caldo gestito dal servizio, scegli Abilita periodo di conservazione.
- Per configurare un periodo di conservazione, inserisci un numero intero e scegli un'unità. Il periodo di conservazione deve essere maggiore o uguale a 30 giorni.
AWS IoT SiteWise elimina tutti i dati del livello più importante che sono più vecchi del periodo di conservazione. Se non imposti un periodo di conservazione, i dati vengono archiviati a tempo indeterminato.
(Consigliato) Per le impostazioni del livello Warm, procedi come segue:
- Per attivare l'archiviazione di livello caldo, seleziona Confermo e attiva l'opzione di archiviazione di livello caldo per attivare l'archiviazione di livello caldo.
- (Facoltativo) Per configurare un periodo di conservazione, inserisci un numero intero e scegli un'unità. Il periodo di conservazione deve essere maggiore o uguale a 365 giorni.
AWS IoT SiteWise elimina i dati del livello «warm» che esistevano prima del periodo di conservazione. Se non imposti un periodo di conservazione, i dati vengono archiviati a tempo indeterminato.
Nota
- Quando si opta per il livello caldo, la configurazione viene visualizzata una sola volta.
- Per impostare la conservazione a caldo, è necessario disporre di un livello di archiviazione a caldo o a freddo. Per l'efficienza in termini di costi e il recupero dei dati storici, AWS IoT SiteWise consiglia di archiviare i dati a lungo termine nel livello caldo.
- Per impostare la conservazione del livello caldo, è necessario disporre di un livello di conservazione a freddo.
Scegli Salva per salvare le impostazioni di archiviazione.

Nella sezione AWS IoT SiteWise Archiviazione, lo storage Warm tier si trova in uno di questi stati:

Abilitato: se i dati esistevano prima del periodo di conservazione del livello più elevato, li AWS IoT SiteWise sposta nel livello caldo».
Disabilitato: lo storage warm tier è disabilitato.

Configura le impostazioni di archiviazione per warm tier (AWS CLI)

È possibile configurare le impostazioni di archiviazione per spostare i dati al livello caldo utilizzando AWS CLI i comandi seguenti.

Per evitare di sovrascrivere la configurazione esistente, recupera le informazioni sulla configurazione di archiviazione corrente eseguendo il comando seguente:


aws iotsitewise describe-storage-configuration

Esempio risposta senza una configurazione di livello freddo esistente


{
          "storageType": "SITEWISE_DEFAULT_STORAGE",
          "disassociatedDataStorage": "ENABLED",
          "configurationStatus": {
              "state": "ACTIVE"
          },
          "lastUpdateDate": "2021-10-14T15:53:35-07:00",
          "warmTier": "DISABLED"
}

Esempio risposta con la configurazione Cold Tier esistente


{             
      "storageType": "MULTI_LAYER_STORAGE",
          "multiLayerStorage": {
            "customerManagedS3Storage": {
            "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/",
            "roleArn": "arn:aws:iam::aws-account-id:role/role-name"
            }
          },
      "disassociatedDataStorage": "ENABLED",
      "retentionPeriod": {
      "numberOfDays": retention-in-days
      },
       "configurationStatus": {
       "state": "ACTIVE"
      },
      "lastUpdateDate": "2023-10-25T15:59:46-07:00",
      "warmTier": "DISABLED"
}

Configura le impostazioni di archiviazione per il piano caldo con AWS CLI

Esegui il comando seguente per configurare le impostazioni di archiviazione. Sostituisci file-name con il nome del file che contiene la configurazione AWS IoT SiteWise di archiviazione.


aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json

Esempio AWS IoT SiteWise configurazione con livello caldo e caldo


{
             "storageType": "SITEWISE_DEFAULT_STORAGE",
             "disassociatedDataStorage": "ENABLED",
             "warmTier": "ENABLED",
             "retentionPeriod": {
                "numberOfDays": hot-tier-retention-in-days
              } 
              
}

hot-tier-retention-in-daysdeve essere un numero intero maggiore o uguale a 30 giorni.

Esempio response


{
             "storageType": "SITEWISE_DEFAULT_STORAGE",
             "configurationStatus": {
             "state": "UPDATE_IN_PROGRESS"
             }
}

Se hai abilitato lo storage a livello freddo, vediConfigura le impostazioni di archiviazione con AWS CLI un piano freddo esistente.

Configura le impostazioni di archiviazione con AWS CLI un piano freddo esistente

Configura le impostazioni di archiviazione utilizzando AWS CLI lo storage a livello freddo esistente

Esegui il comando seguente per configurare le impostazioni di archiviazione. Replace (Sostituisci) file-name con il nome del file che contiene la configurazione AWS IoT SiteWise di archiviazione.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
Esempio AWS IoT SiteWise configurazione di archiviazione
- Replace (Sostituisci) bucket-name con il nome del tuo bucket Amazon S3.
- Replace (Sostituisci) prefix con il tuo prefisso Amazon S3.
- Replace (Sostituisci) aws-account-id con l'ID del tuo AWS account.
- Replace (Sostituisci) role-name con il nome del ruolo di accesso di Amazon S3 che consente di inviare dati AWS IoT SiteWise ad Amazon S3.
- Replace (Sostituisci) hot-tier-retention-in-days con un numero intero maggiore o uguale a 30 giorni.
- Replace (Sostituisci) warm-tier-retention-in-days con un numero intero maggiore o uguale a 365 giorni.
Nota
AWS IoT SiteWise eliminerà tutti i dati del livello caldo più vecchi del periodo di conservazione del livello freddo. Se non imposti un periodo di conservazione, i dati vengono archiviati a tempo indeterminato.
```
{
      "storageType": "MULTI_LAYER_STORAGE",
        "multiLayerStorage": {
          "customerManagedS3Storage": {
              "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/",
              "roleArn": "arn:aws:iam::aws-account-id:role/role-name"
              }
          },
    "disassociatedDataStorage": "ENABLED",
    "retentionPeriod": {
      "numberOfDays": hot-tier-retention-in-days
    },
    "warmTier": "ENABLED",
    "warmTierRetentionPeriod": {
      "numberOfDays": warm-tier-retention-in-days
    }
}
```
Esempio response
```
{
      "storageType": "MULTI_LAYER_STORAGE",
      "configurationStatus": {
        "state": "UPDATE_IN_PROGRESS"
       }
}
```

Configura le impostazioni di archiviazione per il livello freddo (console)

La procedura seguente mostra come configurare le impostazioni di archiviazione per replicare i dati sul livello freddo della AWS IoT SiteWise console.

Per configurare le impostazioni di archiviazione nella console

Passare alla console AWS IoT SiteWise.
Nel pannello di navigazione, in Impostazioni, scegli Archiviazione.
Nell'angolo in alto a destra, scegliere Edit (Modifica).
Nella pagina Modifica archiviazione, procedi come segue:
1. Per le impostazioni di archiviazione, scegli Abilita archiviazione a freddo. La memorizzazione a livello freddo è disabilitata per impostazione predefinita.
2. Per la posizione del bucket S3, inserisci il nome di un bucket Amazon S3 esistente e un prefisso.
  Nota
  Amazon S3 utilizza il prefisso come nome di cartella nel bucket Amazon S3. Il prefisso deve contenere da 1 a 255 caratteri e terminare con una barra (/). AWS IoT SiteWise I dati vengono salvati in questa cartella.
  
  Se non disponi di un bucket Amazon S3, scegli Visualizza, quindi creane uno nella console Amazon S3. Per ulteriori informazioni, consulta Crea il tuo primo bucket S3 nella Amazon S3 User Guide.
3. Per il ruolo di accesso S3, esegui una delle seguenti operazioni:
  - Scegli Crea un ruolo da un modello AWS gestito, crea AWS automaticamente un IAM ruolo che consente di AWS IoT SiteWise inviare dati ad Amazon S3.
  - Scegli Usa un ruolo esistente, quindi scegli il ruolo che hai creato dall'elenco.
    Nota
    
    È necessario utilizzare lo stesso nome di bucket Amazon S3 per la posizione del bucket S3 utilizzato nel passaggio precedente e nella politica. IAM
    
    Assicurati che il tuo ruolo disponga delle autorizzazioni mostrate nell'esempio seguente.
    
    Esempio politica delle autorizzazioni:
    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject", "s3:GetBucketLocation", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::bucket-name", "arn:aws:s3:::bucket-name/*" ] } ] }
    Replace (Sostituisci) bucket-name con il nome del tuo bucket Amazon S3.
    
    Se il bucket S3 è crittografato utilizzando una KMS chiave gestita dal cliente, la KMS chiave deve avere una politica di accesso con un IAM ruolo e un'operazione. kms:Decrypt kms:GenerateDataKey
4. Per configurare l'hot tier, consulta la Fase 5 di. Configura le impostazioni di archiviazione per il livello caldo (console)
5. (Facoltativo) Per AWS IoT Analytics l'integrazione, procedi come segue.
  1. Se desideri utilizzarli AWS IoT Analytics per interrogare i tuoi dati, scegli Archivio AWS IoT Analytics dati abilitato.
  2. AWS IoT SiteWise genera un nome per il tuo data store oppure puoi inserire un nome diverso.
  AWS IoT SiteWise crea automaticamente un data store in AWS IoT Analytics cui salvare i dati. Per interrogare i dati, puoi usarli AWS IoT Analytics per creare set di dati. Per ulteriori informazioni, consulta Lavorare con AWS IoT SiteWise i dati nella Guida per l'AWS IoT Analytics utente.
6. Seleziona Salva.

Nella sezione AWS IoT SiteWise Archiviazione, lo storage Cold tier può avere uno dei seguenti valori:

Abilitato: AWS IoT SiteWise replica i dati nel bucket Amazon S3 specificato.
Abilitazione: AWS IoT SiteWise sta elaborando la richiesta per abilitare lo storage a freddo. Il completamento di questo processo può richiedere diversi minuti.
Enable_Failed: AWS IoT SiteWise impossibile elaborare la tua richiesta di abilitare lo storage a freddo. Se hai abilitato AWS IoT SiteWise l'invio di log ad Amazon CloudWatch Logs, puoi utilizzare questi log per risolvere i problemi. Per ulteriori informazioni, consulta Monitoraggio con Amazon CloudWatch Logs.
Disabilitato: lo storage a livello freddo è disabilitato.

Configura le impostazioni di archiviazione per il livello freddo (AWS CLI)

La procedura seguente mostra come configurare le impostazioni di archiviazione per replicare i dati nel livello freddo utilizzando AWS CLI.

Per configurare le impostazioni di archiviazione utilizzando AWS CLI

Per esportare i dati in un bucket Amazon S3 nel tuo account, esegui il seguente comando per configurare le impostazioni di archiviazione. Replace (Sostituisci) file-name con il nome del file che contiene la configurazione dello AWS IoT SiteWise storage.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
Esempio AWS IoT SiteWise configurazione di archiviazione
- Replace (Sostituisci) bucket-name con il nome del tuo bucket Amazon S3.
- Replace (Sostituisci) prefix con il tuo prefisso Amazon S3.
- Replace (Sostituisci) aws-account-id con l'ID del tuo AWS account.
- Replace (Sostituisci) role-name con il nome del ruolo di accesso di Amazon S3 che consente di inviare dati AWS IoT SiteWise ad Amazon S3.
- Replace (Sostituisci) retention-in-days con un numero intero maggiore o uguale a 30 giorni.
```
{
      "storageType": "MULTI_LAYER_STORAGE",
      "multiLayerStorage": {
          "customerManagedS3Storage": {
              "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/",
              "roleArn": "arn:aws:iam::aws-account-id:role/role-name"
          }
      }, 
      "retentionPeriod": { 
          "numberOfDays": retention-in-days,
          "unlimited": false
      }
  }
```
Nota
- È necessario utilizzare lo stesso nome di bucket Amazon S3 nella configurazione e nella policy AWS IoT SiteWise di storage. IAM
- Assicurati che il tuo ruolo disponga delle autorizzazioni mostrate nell'esempio seguente.
  
  Esempio politica delle autorizzazioni:
  { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject", "s3:GetBucketLocation", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::bucket-name", "arn:aws:s3:::bucket-name/*" ] } ] }
  Replace (Sostituisci) bucket-name con il nome del tuo bucket Amazon S3.
- Se il bucket S3 è crittografato utilizzando una KMS chiave gestita dal cliente, la KMS chiave deve avere una politica di accesso con un IAM ruolo e un'operazione. kms:Decrypt kms:GenerateDataKey
Esempio response
```
{
    "storageType": "MULTI_LAYER_STORAGE",
    "retentionPeriod": {
        "numberOfDays": 100,
        "unlimited": false
    },
    "configurationStatus": {
        "state": "UPDATE_IN_PROGRESS"
    }
}
```
Nota
L'aggiornamento della configurazione di archiviazione può richiedere alcuni minuti. AWS IoT SiteWise

Per recuperare le informazioni sulla configurazione dello storage, esegui il comando seguente.


aws iotsitewise describe-storage-configuration

Esempio response


{
      "storageType": "MULTI_LAYER_STORAGE",
      "multiLayerStorage": {
          "customerManagedS3Storage": {
              "s3ResourceArn": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/torque/",
              "roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role"
          }
      },
      "retentionPeriod": { 
          "numberOfDays": 100,
          "unlimited": false
      },
      "configurationStatus": {
          "state": "ACTIVE"
      },
      "lastUpdateDate": "2021-03-30T15:54:14-07:00"
  }

Per interrompere l'esportazione dei dati nel bucket Amazon S3, esegui il seguente comando per configurare le impostazioni di archiviazione.
```
aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
```
Nota
Per impostazione predefinita, i tuoi dati vengono archiviati solo nel livello più elevato di. AWS IoT SiteWise
Esempio response
```
{
      "storageType": "SITEWISE_DEFAULT_STORAGE",
      "configurationStatus": {
          "state": "UPDATE_IN_PROGRESS"
      }
  }
```

Per recuperare le informazioni sulla configurazione dello storage, esegui il comando seguente.


aws iotsitewise describe-storage-configuration

Esempio response


{
      "storageType": "SITEWISE_DEFAULT_STORAGE",
      "configurationStatus": {
          "state": "ACTIVE"
      },
      "lastUpdateDate": "2021-03-30T15:57:14-07:00"
  }

(Facoltativo) Creare un archivio AWS IoT Analytics dati ()AWS CLI

Un AWS IoT Analytics data store è un repository scalabile e interrogabile che riceve e archivia dati. È possibile utilizzare la AWS IoT SiteWise console o AWS IoT Analytics APIs creare un archivio dati per salvare AWS IoT Analytics i dati. AWS IoT SiteWise Per interrogare i dati, si creano set di dati utilizzando AWS IoT Analytics. Per ulteriori informazioni, consulta Lavorare con AWS IoT SiteWise i dati nella Guida per l'AWS IoT Analytics utente.

I passaggi seguenti consentono AWS CLI di creare un archivio dati in AWS IoT Analytics.

Per creare un archivio dati, esegui il comando seguente. Replace (Sostituisci) file-name con il nome del file che contiene la configurazione del data store.


aws iotanalytics create-datastore --cli-input-json file://file-name.json

Nota

È necessario specificare il nome di un bucket Amazon S3 esistente. Se non disponi di un bucket Amazon S3, creane prima uno. Per ulteriori informazioni, consulta Crea il tuo primo bucket S3 nella Guida per l'utente di Amazon S3.
È necessario utilizzare lo stesso nome di bucket Amazon S3 nella configurazione AWS IoT SiteWise dello storage, nella IAM policy e nella configurazione del AWS IoT Analytics data store.

Esempio AWS IoT Analytics configurazione del data store

Replace (Sostituisci) data-store-name e s3-bucket-name con il nome del tuo AWS IoT Analytics data store e il nome del bucket Amazon S3.


{
      "datastoreName": "data-store-name",
      "datastoreStorage": {
          "iotSiteWiseMultiLayerStorage": {
              "customerManagedS3Storage": {
                  "bucket": "s3-bucket-name"
              }
          }
      },
      "retentionPeriod": {
          "numberOfDays": 90
      }
  }

Esempio response


{
      "datastoreName": "datastore_IoTSiteWise_demo",
      "datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
      "retentionPeriod": {
          "numberOfDays": 90,
          "unlimited": false
      }
  }

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Gestisci l'archiviazione dei dati

Risolvi i problemi relativi alle impostazioni di archiviazione

Configurare le impostazioni di archiviazione

Nota

Impatto della conservazione dei dati nello storage di livello caldo e caldo

Argomenti

Configura le impostazioni di archiviazione per il livello caldo (console)

Per configurare le impostazioni di archiviazione nella console

Nota

Configura le impostazioni di archiviazione per warm tier (AWS CLI)

Esempio risposta senza una configurazione di livello freddo esistente

Esempio risposta con la configurazione Cold Tier esistente

Configura le impostazioni di archiviazione per il piano caldo con AWS CLI

Esempio AWS IoT SiteWise configurazione con livello caldo e caldo

Esempio response

Configura le impostazioni di archiviazione con AWS CLI un piano freddo esistente

Configura le impostazioni di archiviazione utilizzando AWS CLI lo storage a livello freddo esistente

Esempio AWS IoT SiteWise configurazione di archiviazione

Nota

Esempio response

Configura le impostazioni di archiviazione per il livello freddo (console)

Per configurare le impostazioni di archiviazione nella console

Nota

Nota

Esempio politica delle autorizzazioni:

Configura le impostazioni di archiviazione per il livello freddo (AWS CLI)

Per configurare le impostazioni di archiviazione utilizzando AWS CLI

Esempio AWS IoT SiteWise configurazione di archiviazione

Nota

Esempio politica delle autorizzazioni:

Esempio response

Nota

Esempio response

Nota

Esempio response

Esempio response

(Facoltativo) Creare un archivio AWS IoT Analytics dati ()AWS CLI

Nota

Esempio AWS IoT Analytics configurazione del data store

Esempio response