As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerencie o armazenamento de dados em AWS IoT SiteWise
Você pode configurar AWS IoT SiteWise para salvar seus dados nos seguintes níveis de armazenamento:
**Dados acessados com frequência (camada quente)**
O nível de armazenamento quente é um armazenamento AWS IoT SiteWise gerenciado de séries temporais. O hot tier é mais eficaz para dados acessados com frequência, com baixa write-to-read latência. Os dados armazenados no nível quente são usados por aplicações industriais que precisam de acesso rápido aos valores mais recentes das medições nos equipamentos. Isso inclui aplicações que visualizam métricas em tempo real com um painel interativo ou aplicações que monitoram operações e acionam alarmes para identificar problemas de desempenho.
Por padrão, os dados ingeridos AWS IoT SiteWise são armazenados na camada ativa. Você pode definir um período de retenção para o nível quente, após o qual AWS IoT SiteWise move os dados no nível quente para o armazenamento no nível quente ou frio, com base na sua configuração. Para maximizar o desempenho e o custo-benefício, defina o período de retenção do nível quente de modo que seja maior do que o tempo necessário para recuperar dados com frequência. Isso é usado para métricas, alarmes e cenários de monitoramento em tempo real. Se um período de retenção não estiver definido, os dados serão armazenados indefinidamente no nível quente.
**Nível morno**
O nível de armazenamento aquecido é um nível AWS IoT SiteWise gerenciado que é eficaz para o armazenamento econômico de dados históricos. É melhor usá-lo para recuperar grandes volumes de dados com características de write-to-read latência média. Use o nível morno para armazenar dados históricos necessários para grandes workloads. Por exemplo, ele é usado para recuperação de dados para analytics, aplicações de business intelligence (BI), ferramentas de relatórios e treinamento de modelos de machine learning (ML). Se habilitar o nível de armazenamento frio, você poderá definir um período de retenção do nível morno. Após o término do período de retenção, AWS IoT SiteWise exclui os dados do nível quente.
**Dados acessados raramente (camada fria)**
O nível de armazenamento frio usa um bucket do Amazon S3 para armazenar dados que raramente são usados. Com o nível frio habilitado, o AWS IoT SiteWise replica a série temporal, inclusive medições, métricas, transformações, agregados e definições de modelos de ativo a cada 6 horas. O nível frio é usado para armazenar dados que toleram alta latência de leitura para relatórios e backups históricos.
**Topics**
+ [
# Defina as configurações de armazenamento em AWS IoT SiteWise
](configure-storage.md)
+ [
# Solucionar problemas de configurações de armazenamento para AWS IoT SiteWise
](troubleshoot-storage-configuration.md)
+ [
# Caminhos de arquivo e esquemas de dados salvos na camada fria
](file-path-and-schema.md)
# Defina as configurações de armazenamento em AWS IoT SiteWise
Você pode definir configurações de armazenamento para aceitar o armazenamento do nível morno gerenciado pelo serviço, além de replicar os dados para o nível frio. Para saber mais sobre o período de retenção para os níveis morno e quente, consulte [Impacto da retenção de dados](#retention-period). Ao definir as configurações de armazenamento, faça o seguinte:
+ **Retenção de nível** ativo — defina um período de retenção de quanto tempo seus dados são armazenados no nível ativo antes de serem excluídos e movidos para o armazenamento gerenciado em nível quente ou armazenamento em nível frio com base em suas configurações de armazenamento. AWS IoT SiteWise excluirá todos os dados do hot tier que existiam antes do término do período de retenção. Se você não definir um período de retenção, os dados serão armazenados indefinidamente no nível quente.
+ **Retenção de nível quente** — defina um período de retenção de quanto tempo seus dados são armazenados no nível quente antes de serem excluídos do AWS IoT SiteWise armazenamento e movidos para o armazenamento de nível frio gerenciado pelo cliente. AWS IoT SiteWise exclui todos os dados do nível de aquecimento que existiam antes do término do período de retenção. Se um período de retenção não estiver definido, os dados serão armazenados indefinidamente no nível morno.
**nota**
Para melhorar o desempenho de consulta, defina um período de retenção do nível quente com armazenamento de nível morno.
## Impacto da retenção de dados no armazenamento dos níveis quente e morno
+ Quando você diminui o período de retenção do armazenamento do nível quente, os dados são movidos permanentemente do nível quente para o nível morno ou frio. Quando você diminui o período de retenção do nível morno, os dados são movidos para o nível frio e excluídos permanentemente do nível morno.
+ Quando você aumenta o período de retenção do armazenamento de nível quente ou quente, a alteração afeta os dados enviados a AWS IoT SiteWise partir de então. AWS IoT SiteWise não recupera dados do armazenamento quente ou frio para preencher o nível quente. Por exemplo, se o período de retenção do armazenamento de nível quente for inicialmente definido para 30 dias, depois for aumentado para 60 dias, serão necessários 30 dias para que o armazenamento de nível quente contenha dados equivalentes a 60 dias.
**Topics**
+ [
## Impacto da retenção de dados no armazenamento dos níveis quente e morno
](#retention-period)
+ [
## Definir configurações de armazenamento para nível morno (console)
](#configure-storage-console-warm)
+ [
## Definir configurações de armazenamento para nível morno (AWS CLI)
](#configure-storage-cli-warm)
+ [
## Definir configurações de armazenamento para nível frio (console)
](#configure-storage-console)
+ [
## Definir configurações de armazenamento para nível frio (AWS CLI)
](#configure-storage-cli)
## Definir configurações de armazenamento para nível morno (console)
O procedimento a seguir mostra como definir as configurações de armazenamento para replicar dados para a camada quente no AWS IoT SiteWise console.
**Para definir configurações de ingestão de dados no console:**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. No painel de navegação, em **Configurações**, selecione **Armazenamento**.
1. No canto superior direito, escolha **Editar**.
1. Na página **Editar permissões**, faça o seguinte:
1. Para **Configurações do nível quente**, faça o seguinte:
+ Se quiser definir um período de retenção para armazenamento dos dados no nível quente antes que eles sejam excluídos e movidos para o armazenamento do nível morno gerenciado pelo serviço, escolha **Habilitar período de retenção**.
+ Para configurar um período de retenção, insira um número e escolha uma unidade. O período de retenção deve ser igual ou maior que 30 dias.
AWS IoT SiteWise exclui todos os dados no hot tier que sejam mais antigos do que o período de retenção. Caso não defina um período de retenção, seus dados serão armazenados indefinidamente.
1. (Recomendado) Para **Configurações do nível morno**, faça o seguinte:
+ Para aceitar o armazenamento de nível morno, selecione **Confirmo a opção de armazenamento de nível morno** para aceitar o armazenamento de nível morno.
+ (Opcional) Para configurar um período de retenção, insira um número inteiro e escolha uma unidade. O período de retenção deve ser maior ou igual a 365 dias.
AWS IoT SiteWise exclui dados no nível de aquecimento que existiam antes do período de retenção. Caso não defina um período de retenção, seus dados serão armazenados indefinidamente.
**nota**
Quando você aceita o nível morno, a configuração só é exibida uma vez.
Para definir a retenção do nível quente, você deve ter um armazenamento de nível morno ou frio. Para eficiência de custos e recuperação de dados históricos, AWS IoT SiteWise recomenda que você armazene dados de longo prazo no nível quente.
Para definir a retenção do nível morno, você deve ter um armazenamento de nível frio.
1. Escolha **Salvar** para salvar as configurações de armazenamento.
Na seção **Armazenamento do AWS IoT SiteWise **, o **Armazenamento de nível morno** está em um destes estados:
+ **Habilitado**: se os dados existiam antes do período de retenção do nível quente, o AWS IoT SiteWise move os dados para o nível morno.
+ **Desabilitado**: o armazenamento de nível morno está desabilitado.
## Definir configurações de armazenamento para nível morno (AWS CLI)
Você pode definir as configurações de armazenamento para mover dados para a camada quente usando os comandos AWS CLI e os seguintes.
Para evitar a substituição da configuração existente, recupere as informações da configuração de armazenamento atual executando o seguinte comando:
```
aws iotsitewise describe-storage-configuration
```
**Example resposta sem a configuração de nível frio existente**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-10-14T15:53:35-07:00",
"warmTier": "DISABLED"
}
```
**Example resposta com a configuração de nível frio existente**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/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"
}
```
### Defina as configurações de armazenamento para o nível quente com AWS CLI
Execute o comando a seguir para definir as configurações de armazenamento. `file-name`Substitua pelo nome do arquivo que contém a configuração AWS IoT SiteWise de armazenamento.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuração com nível quente e quente**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"warmTier": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
}
}
```
O trecho `hot-tier-retention-in-days` deve ser um número inteiro maior ou igual a 30 dias.
**Example resposta**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
Se o armazenamento de nível frio estiver habilitado, consulte [Defina as configurações de armazenamento com AWS CLI uma camada fria existente](#configure-storage-cli-existing-cold).
### Defina as configurações de armazenamento com AWS CLI uma camada fria existente
**Defina as configurações de armazenamento usando AWS CLI o armazenamento de camada fria existente**
+ Execute o comando a seguir para definir as configurações de armazenamento. Substitua *file-name* pelo nome do arquivo que contém a configuração de armazenamento do AWS IoT SiteWise .
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuração de armazenamento**
+ Substitua *amzn-s3-demo-bucket* pelo nome do bucket do Amazon S3.
+ *prefix*Substitua pelo prefixo do Amazon S3.
+ *aws-account-id*Substitua pelo ID AWS da sua conta.
+ *role-name*Substitua pelo nome da função de acesso do Amazon S3 que permite enviar dados AWS IoT SiteWise para o Amazon S3.
+ *hot-tier-retention-in-days*Substitua por um número inteiro maior ou igual a 30 dias.
+ *warm-tier-retention-in-days*Substitua por um número inteiro maior ou igual a 365 dias.
**nota**
AWS IoT SiteWise excluirá todos os dados na camada quente que sejam mais antigos do que o período de retenção da camada fria. Caso não defina um período de retenção, seus dados serão armazenados indefinidamente.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/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
}
}
```
**Example resposta**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
## Definir configurações de armazenamento para nível frio (console)
O procedimento a seguir mostra como definir as configurações de armazenamento para replicar dados para a camada fria no AWS IoT SiteWise console.
**Para definir configurações de ingestão de dados no console:**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. No painel de navegação, em **Configurações**, selecione **Armazenamento**.
1. No canto superior direito, escolha **Editar**.
1. Na página **Editar permissões**, faça o seguinte:
1. Em **Configurações de armazenamento**, escolha **Ativar armazenamento em camada fria**. O armazenamento de camada fria estará desabilitado por padrão.
1. Em **Localização do bucket do S3**, insira o nome de um bucket existente do Amazon S3 e um prefixo.
**nota**
O Amazon S3 usa o prefixo como nome de pasta para organizar os dados no bucket Amazon S3. O prefixo deve ter entre 1 e 255 caracteres e terminar com uma barra (/). Seus dados AWS IoT SiteWise serão salvos nessa pasta.
Se não tiver um bucket do Amazon S3, escolha **Exibir** e crie um no console do Amazon S3. Para obter mais informações, consulte [Criar seu primeiro bucket do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) no *Guia do Usuário do Amazon S3*.
1. Para **Função de acesso S3**, siga um destes procedimentos:
+ Escolha **Criar uma função a partir de um modelo AWS gerenciado**, cria AWS automaticamente uma função do IAM que permite AWS IoT SiteWise enviar dados para o Amazon S3.
+ Escolha **Usar uma função existente** e, em seguida, a função criada a partir da lista.
**nota**
Você deve usar o mesmo nome do bucket do Amazon S3 na **Localização do bucket do S3** da etapa anterior e política do IAM.
Certifique-se de que sua função tem as permissões do exemplo a seguir:
**Example política de permissões:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Substitua amzn-s3-demo-bucket pelo nome do bucket do Amazon S3.
Se o bucket do Amazon S3 for criptografado usando uma chave KMS gerenciada pelo cliente, a chave KMS deverá ter uma política de acesso com uma função do IAM para operações. `kms:Decrypt` `kms:GenerateDataKey`
1. Para configurar o nível quente, consulte a etapa 5 em [Definir configurações de armazenamento para nível morno (console)](#configure-storage-console-warm).
1. (Opcional) Para ** Integração AWS IoT Analytics **, faça o seguinte:
**nota**
Aviso de fim do suporte: em 15 de dezembro de 2025, AWS encerrará o suporte para AWS IoT Analytics. Depois de 15 de dezembro de 2025, você não poderá mais acessar o AWS IoT Analytics console ou AWS IoT Analytics os recursos. Para obter mais informações, consulte [AWS IoT Analytics Fim do suporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
1. Se você quiser usar AWS IoT Analytics para consultar seus dados, escolha **Armazenamento de AWS IoT Analytics dados ativado**.
1. AWS IoT SiteWise gera um nome para seu armazenamento de dados ou você pode inserir um nome diferente.
AWS IoT SiteWise cria automaticamente um armazenamento de dados AWS IoT Analytics para salvar seus dados. Para consultar os dados, você pode usar AWS IoT Analytics para criar conjuntos de dados. Para obter mais informações, consulte Como [trabalhar com AWS IoT SiteWise dados](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) no *Guia AWS IoT Analytics do usuário*.
1. Escolha **Salvar**.
Na seção **Armazenamento do AWS IoT SiteWise **, o **Armazenamento em camada fria** pode ser um dos seguintes valores:
+ **Ativado** — AWS IoT SiteWise replica seus dados para o bucket do Amazon S3 especificado.
+ **Habilitar** — AWS IoT SiteWise está processando sua solicitação para habilitar o armazenamento em camada fria. O processo pode demorar vários minutos para ser concluído.
+ **Enable\$1Failed** — AWS IoT SiteWise não foi possível processar sua solicitação para ativar o armazenamento em camada fria. Se você habilitou AWS IoT SiteWise o envio de registros para o Amazon CloudWatch Logs, você pode usar esses registros para solucionar problemas. Para obter mais informações, consulte [Monitore com Amazon CloudWatch Logs](monitor-cloudwatch-logs.md).
+ **Desabilitado** — O armazenamento em camada fria está desabilitado.
## Definir configurações de armazenamento para nível frio (AWS CLI)
O procedimento a seguir mostra como definir as configurações de armazenamento para replicar os dados na camada fria usando o AWS CLI.
**Para definir as configurações de armazenamento usando AWS CLI**
1. Para exportar dados para um bucket do Amazon S3 em sua conta, execute o comando a seguir para definir as configurações de armazenamento: *file-name*Substitua pelo nome do arquivo que contém a configuração AWS IoT SiteWise de armazenamento.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuração de armazenamento**
+ Substitua *amzn-s3-demo-bucket* pelo nome do bucket do Amazon S3.
+ *prefix*Substitua pelo prefixo do Amazon S3.
+ *aws-account-id*Substitua pelo ID AWS da sua conta.
+ *role-name*Substitua pelo nome da função de acesso do Amazon S3 que permite enviar dados AWS IoT SiteWise para o Amazon S3.
+ *retention-in-days*Substitua por um número inteiro maior ou igual a 30 dias.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"retentionPeriod": {
"numberOfDays": retention-in-days,
"unlimited": false
}
}
```
**nota**
Você deve usar o mesmo nome de bucket do Amazon S3 na configuração de AWS IoT SiteWise armazenamento e na política do IAM.
Certifique-se de que sua função tem as permissões do exemplo a seguir:
**Example política de permissões:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Substitua amzn-s3-demo-bucket pelo nome do bucket do Amazon S3.
Se o bucket do Amazon S3 for criptografado usando uma chave KMS gerenciada pelo cliente, a chave KMS deverá ter uma política de acesso com uma função do IAM para operações. `kms:Decrypt` `kms:GenerateDataKey`
**Example resposta**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
**nota**
A atualização da configuração de armazenamento pode levar alguns minutos. AWS IoT SiteWise
1. Para obter as informações de configuração do repositório, use o seguinte comando:
```
aws iotsitewise describe-storage-configuration
```
**Example resposta**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-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"
}
```
1. Para interromper a exportação de dados para o bucket do Amazon S3, execute o comando a seguir para definir configurações de armazenamento:
```
aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
```
**nota**
Por padrão, seus dados são armazenados apenas na camada ativa do AWS IoT SiteWise.
**Example Retorno**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
1. Para obter as informações de configuração do repositório, use o seguinte comando:
```
aws iotsitewise describe-storage-configuration
```
**Example resposta**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:57:14-07:00"
}
```
### (Opcional) Crie um armazenamento AWS IoT Analytics de dados (AWS CLI)
**nota**
Aviso de fim do suporte: em 15 de dezembro de 2025, AWS encerrará o suporte para AWS IoT Analytics. Depois de 15 de dezembro de 2025, você não poderá mais acessar o AWS IoT Analytics console ou AWS IoT Analytics os recursos. Para obter mais informações, consulte [AWS IoT Analytics Fim do suporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
Um armazenamento AWS IoT Analytics de dados é um repositório escalável e consultável que recebe e armazena dados. Você pode usar o AWS IoT SiteWise console ou AWS IoT Analytics APIs criar um armazenamento AWS IoT Analytics de dados para salvar seus AWS IoT SiteWise dados. Para consultar os dados, você cria conjuntos de dados usando o. AWS IoT Analytics Para obter mais informações, consulte [Trabalhando com dados AWS IoT SiteWise](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) no *Guia do Usuário do AWS IoT Analytics *.
As etapas a seguir são usadas AWS CLI para criar um armazenamento de dados em AWS IoT Analytics.
Para criar um armazenamento de dados, execute o comando a seguir: *file-name*Substitua pelo nome do arquivo que contém a configuração do armazenamento de dados.
```
aws iotanalytics create-datastore --cli-input-json file://file-name.json
```
**nota**
Você deve especificar o nome de um bucket existente do Amazon S3. Se você não tiver um bucket do Amazon S3, crie um primeiro. Para obter mais informações, consulte [Criar seu primeiro bucket do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) no *Guia do Usuário do Amazon S3*.
Você deve usar o mesmo nome de bucket do Amazon S3 na configuração de AWS IoT SiteWise armazenamento, na política do IAM e na configuração do armazenamento de AWS IoT Analytics dados.
**Example AWS IoT Analytics configuração do armazenamento de dados**
Substitua *data-store-name* e *amzn-s3-demo-bucket* pelo nome do seu armazenamento de AWS IoT Analytics dados e pelo nome do bucket do Amazon S3.
```
{
"datastoreName": "data-store-name",
"datastoreStorage": {
"iotSiteWiseMultiLayerStorage": {
"customerManagedS3Storage": {
"bucket": "amzn-s3-demo-bucket"
}
}
},
"retentionPeriod": {
"numberOfDays": 90
}
}
```
**Example resposta**
```
{
"datastoreName": "datastore_IoTSiteWise_demo",
"datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
"retentionPeriod": {
"numberOfDays": 90,
"unlimited": false
}
}
```
# Solucionar problemas de configurações de armazenamento para AWS IoT SiteWise
Use as informações a seguir para solucionar problemas com a configuração de armazenamento.
**Topics**
+ [
## Erro: Bucket não existe
](#no-s3-bucket)
+ [
## Erro: acesso negado ao caminho do Amazon S3
](#iam-permissions)
+ [
## Erro: O ARN da função não pode ser presumido
](#iam-trust-relationship)
+ [
## Erro: falha ao acessar o bucket do Amazon S3 entre regiões
](#cross-region-s3-bucket)
## Erro: Bucket não existe
**Solução:** AWS IoT SiteWise não foi possível encontrar seu bucket do Amazon S3. Certifique-se de ter inserido o nome de um bucket existente do Amazon S3 na região atual.
## Erro: acesso negado ao caminho do Amazon S3
**Solução:** AWS IoT SiteWise não foi possível acessar seu bucket do Amazon S3. Faça o seguinte:
+ Certifique-se de usar o mesmo bucket do Amazon S3 especificado na política do IAM.
+ Certifique-se de que sua função tem as permissões do exemplo a seguir:
**Example política de permissões**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
Substitua amzn-s3-demo-bucket pelo nome do bucket do Amazon S3.
## Erro: O ARN da função não pode ser presumido
**Solução:** AWS IoT SiteWise não foi possível assumir a função do IAM em seu nome. Certifique-se de que seu perfil confia no seguinte serviço: `iotsitewise.amazonaws.com`. Para obter mais informações, consulte [Não consigo presumir uma função](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_cant-assume-role) em *Guia do Usuário do IAM*.
## Erro: falha ao acessar o bucket do Amazon S3 entre regiões
**Solução:** O bucket do Amazon S3 que você especificou está em uma região diferente AWS . Certifique-se de que seu bucket e AWS IoT SiteWise ativos do Amazon S3 estejam na mesma região.
# Caminhos de arquivo e esquemas de dados salvos na camada fria
AWS IoT SiteWise armazena seus dados na camada fria replicando séries temporais, incluindo medições, métricas, transformações e agregados, além de definições de ativos e modelos de ativos. A seguir, descrevemos os caminhos de arquivo e os esquemas de dados enviados para a camada fria.
**Topics**
+ [
## Dados do equipamento (medições)
](#measurements-file-path-and-schema)
+ [
## Métricas, transformações e agregados
](#metrics-file-path-and-schema)
+ [
## Metadados de ativos
](#asset-metadata)
+ [
## Metadados de hierarquia de ativos
](#asset-hierarchy-metadata)
+ [
## Arquivos de índice de dados de armazenamento
](#storage-data-index)
## Dados do equipamento (medições)
AWS IoT SiteWise exporta dados do equipamento (medições) para a camada fria uma vez a cada seis horas. Os dados brutos são salvos na camada fria no formato [Apache AVRO](https://avro.apache.org) (`.avro`).
### Caminho do arquivo
AWS IoT SiteWise armazena dados do equipamento (medições) na camada fria usando o modelo a seguir.
```
{keyPrefix}/raw/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/raw_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Cada caminho de arquivo para dados brutos no Amazon S3 contém os seguintes componentes:
#### Caminho do arquivo
| Componente do caminho | Description |
| --- | --- |
| `keyPrefix` | O prefixo do Amazon S3 que você especificou na configuração de armazenamento. AWS IoT SiteWise O Amazon S3 usa o prefixo como nome de pasta no bucket. |
| `raw` | A pasta que armazena dados de séries temporais do equipamento (medições). A pasta `raw` é salva na pasta de prefixos. |
| `seriesBucket` | Um número hexadecimal entre 00 e ff. Esse número é derivado de `timeSeriesId`. Essa partição é usada para aumentar a taxa de transferência ao AWS IoT SiteWise gravar na camada fria. Ao usar o Amazon Athena para executar consultas, você pode usar a partição para particionamento refinado, a fim de melhorar o desempenho da consulta. `seriesBucket` e `timeSeriesBucket` nos metadados do ativo são o mesmo número. |
| `startYear` | O ano do horário de início exclusivo associado aos dados de séries temporais. |
| `startMonth` | O mês do horário de início exclusivo associado aos dados de séries temporais. |
| `startDay` | O dia do mês do horário de início exclusivo associado aos dados de séries temporais. |
| `fileName` | O nome do arquivo usa o caractere sublinhado (\$1) como delimitador para separar: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/file-path-and-schema.html) O arquivo é salvo no formato `.avro` usando a compressão [Rápida](https://github.com/google/snappy). |
**Example caminho do arquivo para dados brutos na camada fria**
`keyPrefix/raw/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/raw_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### Campos
O esquema de dados brutos exportados para a camada fria contém os seguintes campos:
AWS IoT SiteWise aconselha os clientes a implementarem o suporte para a evolução do esquema em sistemas que leem dados brutos do nível frio, pois podem ser introduzidos campos adicionais no futuro.
Os dados nulos são representados como todos os campos de valor sendo nulos. No entanto, os clientes ainda receberão o tipo de dados correto ao fazer consultas com AWS IoT SiteWise APIs.
#### Campos
| Nome do campo | Tipos suportados | Tipo padrão | Description |
| --- | --- | --- | --- |
| `seriesId` | `string` | N/A | A ID que identifica os dados de série temporais do equipamento (medições). Você pode usar esse campo para unir dados brutos e metadados de ativos em consultas. |
| `timeInSeconds` | `long` | N/D | O carimbo de data e hora, em segundos, no formato de época do Unix. Os dados fracionários de nanossegundos são fornecidos por `offsetInNanos`. |
| `offsetInNanos` | `long` | N/D | O deslocamento em nanossegundos de `timeInSeconds`. |
| `quality` | `string` | N/D | A qualidade do valor de série temporal. |
| `doubleValue` | `double` ou `null` | `null` | Dados de séries temporais tipo duplo (número de ponto flutuante). |
| `stringValue` | `string` ou `null` | `null` | Dados de séries temporais tipo string (sequência de caracteres). |
| `integerValue` | `int` ou `null` | `null` | Dados de séries temporais tipo inteiro (número inteiro). |
| `booleanValue` | `boolean` ou `null` | `null` | Dados de séries temporais tipo Booleanos (verdadeiro ou falso). |
| `jsonValue` | `string` ou `null` | `null` | Dados de séries temporais do tipo JSON (tipos de dados complexos armazenados como string). |
| `recordVersion` | `long` ou `null` | `null` | O número da versão para o registro. Você pode usar o número da versão para selecionar o registro mais recente. Os registros mais recentes têm números de versão maiores. |
**Example dados brutos na camada fria**
```
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675887,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.75},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675889,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.69},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675890,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.66},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675891,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.92},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675892,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.73},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
```
## Métricas, transformações e agregados
AWS IoT SiteWise exporta métricas, transforma e agrega para o nível frio uma vez a cada seis horas. Métricas, transformações e agregados são salvos na camada fria, no formato [Apache AVRO](https://avro.apache.org) (`.avro`).
### Caminho do arquivo
AWS IoT SiteWise armazena métricas, transformações e agregados na camada fria usando o modelo a seguir.
```
{keyPrefix}/agg/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/agg_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Cada caminho de arquivo para métricas, transformações e agregados no Amazon S3 contém os seguintes componentes:
#### Caminho do arquivo
| Componente do caminho | Description |
| --- | --- |
| `keyPrefix` | O prefixo do Amazon S3 que você especificou na configuração de armazenamento. AWS IoT SiteWise O Amazon S3 usa o prefixo como nome de pasta no bucket. |
| `agg` | A pasta que armazena dados de séries temporais das métricas. A pasta `agg` é salva na pasta de prefixos. |
| `seriesBucket` | Um número hexadecimal entre 00 e ff. Esse número é derivado de `timeSeriesId`. Essa partição é usada para aumentar a taxa de transferência ao AWS IoT SiteWise gravar na camada fria. Ao usar o Amazon Athena para executar consultas, você pode usar a partição para particionamento refinado, a fim de melhorar o desempenho da consulta. `seriesBucket` e `timeSeriesBucket` nos metadados do ativo são o mesmo número. |
| `startYear` | O ano do horário de início exclusivo associado aos dados de séries temporais. |
| `startMonth` | O mês do horário de início exclusivo associado aos dados de séries temporais. |
| `startDay` | O dia do mês do horário de início exclusivo associado aos dados de séries temporais. |
| `fileName` | O nome do arquivo usa o caractere sublinhado (\$1) como delimitador para separar: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/file-path-and-schema.html) O arquivo é salvo no formato `.avro` usando a compressão [Rápida](https://github.com/google/snappy). |
**Example caminho do arquivo para métricas na camada fria**
`keyPrefix/agg/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/agg_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### Campos
O esquema de métricas, transformações e agregados que são exportados para a camada fria contém os seguintes campos:
#### Campos
| Nome do campo | Tipos suportados | Tipo padrão | Description |
| --- | --- | --- | --- |
| `seriesId` | `string` | N/D | A ID que identifica dados de séries temporais de equipamentos, métricas ou transformações. Você pode usar esse campo para unir dados brutos e metadados de ativos em consultas. |
| `timeInSeconds` | `long` | N/D | O carimbo de data e hora, em segundos, no formato de época do Unix. Os dados fracionários de nanossegundos são fornecidos por `offsetInNanos`. |
| `offsetInNanos` | `long` | N/D | O deslocamento em nanossegundos de `timeInSeconds`. |
| `quality` | `string` | N/D | A qualidade pela qual filtram-se os dados de ativos. |
| `resolution` | `string` | N/D | O intervalo de tempo no qual agregam-se os dados. |
| `count` | `double` ou `null` | `null` | O número total de pontos de dados das variáveis fornecidas ao longo do intervalo de tempo atual. |
| `average` | `double` ou `null` | `null` | A média dos valores das variáveis fornecidas ao longo do intervalo de tempo atual. |
| `min` | `double` ou `null` | `null` | O valor mínimo dos valores das variáveis fornecidas ao longo do intervalo de tempo atual. |
| `max` | `boolean` ou `null` | `null` | O valor máximo das variáveis fornecidas ao longo do intervalo de tempo atual. |
| `sum` | `string` ou `null` | `null` | A soma dos valores das variáveis fornecidas ao longo do intervalo de tempo atual. |
| `recordVersion` | `long` ou `null` | `null` | O número da versão para o registro. Você pode usar o número da versão para selecionar o registro mais recente. Os registros mais recentes têm números de versão maiores. |
**Example Dados métricos na camada fria**
```
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334060,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334120,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":29.0,"average":{"double":46.0},"min":{"double":32.0},"max":{"double":60.0},"sum":{"double":1334.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334540,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334600,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":29.0,"average":{"double":46.0},"min":{"double":32.0},"max":{"double":60.0},"sum":{"double":1334.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637335020,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
```
## Metadados de ativos
Quando você ativa AWS IoT SiteWise a exportação de dados para a camada fria pela primeira vez, os metadados do ativo são exportados para a camada fria. Após a configuração inicial, AWS IoT SiteWise exporta metadados do ativo para a camada somente quando você altera as definições do modelo do ativo ou as definições do ativo. Os metadados de ativo são salvos no nível frio no formato JSON delimitado por nova linha (`.ndjson`).
### Caminho do arquivo
AWS IoT SiteWise armazena metadados de ativos na camada fria usando o modelo a seguir.
```
{keyPrefix}/asset_metadata/asset_{assetId}.ndjson
```
Cada caminho de arquivo para metadados de ativos na camada fria contém os seguintes componentes:
#### Caminho do arquivo
| Componente do caminho | Description |
| --- | --- |
| `keyPrefix` | O prefixo do Amazon S3 que você especificou na configuração de armazenamento AWS IoT SiteWise s. O Amazon S3 usa o prefixo como nome de pasta no bucket. |
| `asset_metadata` | A pasta que armazena os metadados do ativo. A pasta `asset_metadata` é salva na pasta de prefixos. |
| `fileName` | O nome do arquivo usa o caractere sublinhado (\$1) como delimitador para separar: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/file-path-and-schema.html) O arquivo é salvo no formato `.ndjson`. |
**Example caminho de arquivo para metadados de ativos na camada mais fria**
`keyPrefix/asset_metadata/asset_35901915-d476-4dca-8637-d9ed4df939ed.ndjson`
### Campos
O esquema dos metadados do ativo exportado para a camada fria contém os seguintes campos:
#### Campos
| Nome do campo | Description |
| --- | --- |
| `assetId` | ID do ativo. |
| `assetName` | O nome do ativo. |
| `assetExternalId` | O ID externo do ativo. |
| `assetModelId` | ID do modelo de ativo usada para criá-lo. |
| `assetModelName` | O nome do modelo do ativo. |
| `assetModelExternalId` | O ID externo do modelo de ativo. |
| `assetPropertyId` | A ID da propriedade do ativo. |
| `assetPropertyName` | O nome da propriedade do ativo. |
| `assetPropertyExternalId` | O ID externo da propriedade de ativo. |
| `assetPropertyDataType` | O tipo de dados da propriedade do ativo. |
| `assetPropertyUnit` | A unidade da propriedade do ativo (por exemplo, `Newtons` e `RPM`). |
| `assetPropertyAlias` | O alias que identifica a propriedade de ativo, como um caminho de fluxo de dados do servidor OPC UA (por exemplo, `/company/windfarm/3/turbine/7/temperature`). |
| `timeSeriesId` | A ID que identifica dados de séries temporais de equipamentos, métricas ou transformações. Você pode usar esse campo para unir dados brutos e metadados de ativos em consultas. |
| `timeSeriesBucket` | Um número hexadecimal entre 00 e ff. Esse número é derivado de `timeSeriesId`. Essa partição é usada para aumentar a taxa de transferência ao AWS IoT SiteWise gravar na camada fria. Ao usar o Amazon Athena para executar consultas, você pode usar a partição para particionamento refinado, a fim de melhorar o desempenho da consulta. `timeSeriesBucket` e `seriesBucket` no caminho do arquivo para os dados brutos são o mesmo número. |
| `assetCompositeModelId` | O ID do modelo composto. |
| `assetCompositeModelExternalId` | O ID externo do modelo composto. |
| `assetCompositeModelDescription` | A descrição do modelo composto. |
| `assetCompositeModelName` | O nome do modelo composto. |
| `assetCompositeModelType` | O tipo do modelo composto. Para modelos compostos de alarme, este tipo é `AWS/ALARM`. |
| `assetCreationDate` | A data na qual o ativo foi criado, no horário de época do Unix. |
| `assetLastUpdateDate` | A data na qual o ativo foi atualizado pela última vez, no horário de época do Unix. |
| `assetStatusErrorCode` | O código do erro. |
| `assetStatusErrorMessage` | A mensagem de erro. |
| `assetStatusState` | O status atual do ativo. |
**Example metadados de ativos na camada fria**
```
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"95e63da7-d34e-43e1-bc6f-1b490154b07a","assetPropertyExternalId":null,"assetPropertyName":"Temperature","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"Celsius","assetPropertyAlias":"USA/Washington/Seattle/WT2/temp","timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeSeriesBucket":"f6","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"c706d54d-4c11-42dc-9a01-63662fc697b4","assetPropertyExternalId":null,"assetPropertyName":"Pressure","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"KiloPascal","assetPropertyAlias":"USA/Washington/Seattle/WT2/pressure","timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_c706d54d-4c11-42dc-9a01-63662fc697b4","timeSeriesBucket":"1e","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"8cf1162f-dead-4fbe-b468-c8e24cde9f50","assetPropertyExternalId":null,"assetPropertyName":"Max Temperature","assetPropertyDataType":"DOUBLE","assetPropertyUnit":null,"assetPropertyAlias":null,"timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_8cf1162f-dead-4fbe-b468-c8e24cde9f50","timeSeriesBucket":"d7","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"3a5f2a22-3b37-4332-9c1c-404ea1d73fab","assetExternalId":null,"assetName":"BatchAssetDouble1","assetModelId":"814bdfd8-24db-4a33-8d9b-ebc75e75e827","assetModelExternalId":null,"assetModelName":"FlashTestAssetModelDouble","assetPropertyId":"6b7e1532-175b-4c02-b410-ab401a9176ed","assetPropertyExternalId":null,"assetPropertyName":"measurementProperty","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"u","assetPropertyAlias":null,"timeSeriesId":"ab19f4fa-7e7b-4247-ae89-ff316f5ff8aa","timeSeriesBucket":"af","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1646960106,"assetLastUpdateDate":1646960106,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
```
## Metadados de hierarquia de ativos
Quando você ativa AWS IoT SiteWise para salvar dados na camada fria pela primeira vez, os metadados da hierarquia de ativos são exportados para a camada fria. Após a configuração inicial, AWS IoT SiteWise exporta os metadados da hierarquia de ativos para a camada fria somente quando você faz alterações no modelo do ativo ou nas definições do ativo. Os metadados da hierarquia de ativos são salvos no nível frio no formato JSON delimitado por nova linha (`.ndjson`).
Um identificador externo para a hierarquia, o ativo de destino ou o ativo de origem é recuperado chamando a [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)API.
### Caminho do arquivo
AWS IoT SiteWise armazena metadados da hierarquia de ativos na camada fria usando o modelo a seguir.
```
{keyPrefix}/asset_hierarchy_metadata/{parentAssetId}_{hierarchyId}.ndjson
```
Cada caminho de arquivo para metadados da hierarquia do ativo na camada fria contém os seguintes componentes:
#### Caminho do arquivo
| Componente do caminho | Description |
| --- | --- |
| `keyPrefix` | O prefixo do Amazon S3 que você especificou na configuração de armazenamento. AWS IoT SiteWise O Amazon S3 usa o prefixo como nome de pasta no bucket. |
| `asset_hierarchy_metadata` | A pasta que armazena os metadados da hierarquia do ativo. A pasta `asset_hierarchy_metadata` é salva na pasta de prefixos. |
| `fileName` | O nome do arquivo usa o caractere sublinhado (\$1) como delimitador para separar: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/file-path-and-schema.html) O arquivo é salvo no formato `.ndjson`. |
**Example caminho do arquivo para metadados da hierarquia do ativo na camada fria**
`keyPrefix/asset_hierarchy_metadata/35901915-d476-4dca-8637-d9ed4df939ed_c5b3ced8-589a-48c7-9998-cdccfc9747a0.ndjson`
### Campos
O esquema dos metadados da hierarquia do ativo exportados para a camada fria contém os seguintes campos:
#### Campos
| Nome do campo | Description |
| --- | --- |
| `sourceAssetId` | ID do ativo de origem nessa relação de ativos. |
| `targetAssetId` | ID do ativo de destino nessa relação de ativos. |
| `hierarchyId` | ID da hierarquia. |
| `associationType` | O tipo de associação dessa relação de ativos. O valor deve ser `CHILD`. O ativo de destino é um ativo filho do ativo de origem. |
**Example metadados da hierarquia do ativo na camada fria**
```
{"sourceAssetId":"80388e72-2284-44fb-9c89-bfbaf0dfedd2","targetAssetId":"2b866c25-0c74-4750-bdf5-b73683c8a2a2","hierarchyId":"bbed9f59-0412-4585-a61d-6044db526aee","associationType":"CHILD"}
{"sourceAssetId":"80388e72-2284-44fb-9c89-bfbaf0dfedd2","targetAssetId":"6b51246e-984d-460d-bc0b-470ea47d1e31","hierarchyId":"bbed9f59-0412-4585-a61d-6044db526aee","associationType":"CHILD"}
```
**Para visualizar seus dados na camada fria:**
1. Navegue até o [console do Amazon S3](https://console.aws.amazon.com/s3/).
1. No painel de navegação, escolha **Buckets** e, em seguida, o bucket do Amazon S3.
1. Navegue até a pasta contendo os dados brutos, os metadados do ativo, ou os metadados da hierarquia do ativo.
1. Selecione os arquivos e em **Ações**, escolha **Baixar**.
## Arquivos de índice de dados de armazenamento
AWS IoT SiteWise usa esses arquivos para otimizar o desempenho da consulta de dados. Eles aparecem no seu bucket do Amazon S3, mas você não precisa usá-los.
### Caminho do arquivo
AWS IoT SiteWise armazena arquivos de índice de dados na camada fria usando o modelo a seguir.
```
keyPrefix/index/series=timeseriesId/startYear=startYear/startMonth=startMonth/startDay=startDay/index_timeseriesId_startTimestamp_quality
```
**Example caminho do arquivo para o arquivo de índice de armazenamento de dados**
`keyPrefix/index/series=7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a/startYear=2022/startMonth=02/startDay=03/index_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1643846400_GOOD`