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á. # Adicione um destino em AWS IoT SiteWise buffer usando o Amazon S3 O tipo de destino armazenado em buffer permite que você economize nos custos de ingestão AWS IoT SiteWise caso não precise dos dados em tempo real. Ele permite que você armazene temporariamente seus dados de IoT em um bucket do Amazon S3 antes de importá-los. AWS IoT SiteWise Ou você pode simplesmente carregar seus dados no S3 para armazenamento, independentemente de planejar importá-los AWS IoT SiteWise. Isso é útil para agrupar e armazenar dados em buffer de seus dispositivos e gateways antes de inseri-los. AWS IoT SiteWise Com essa opção, os dados são carregados no bucket S3 especificado no formato Parquet em uma frequência configurada. Em seguida, você pode importar esses dados para AWS IoT SiteWise armazenamento para análise e processamento adicionais. **Para adicionar um destino armazenado em buffer usando o Amazon S3** Use o AWS IoT SiteWise console ou AWS CLI adicione um destino que armazene dados usando o Amazon S3 em SiteWise seu gateway Edge. ------ #### [ Console ] Use o Console de gerenciamento da AWS para adicionar um AWS IoT SiteWise destino armazenado em buffer usando o Amazon S3. 1. Abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação, escolha **Gateways de borda**. 1. Selecione o gateway ao qual você deseja adicionar um destino. 1. Na seção **Destinos**, escolha **Adicionar destino**. 1. Na página **Adicionar destino**, insira **os detalhes do destino**: 1. Um nome para seu destino no campo **Nome do destino**. 1. **Selecione em **AWS IoT SiteWise buffer usando o Amazon S3** como tipo de destino.** AWS IoT SiteWise armazenado em buffer usando o Amazon S3 envia dados para o Amazon Simple Storage Service em lotes, no formato Parquet, e depois importa os dados para o armazenamento. AWS IoT SiteWise 1. Insira a URL do Amazon S3 para o local onde você deseja armazenar seus dados de gateway. Você pode procurar o caminho escolhendo **Browse S3**. Depois que um bucket é adicionado, você também pode ver o bucket escolhendo **Exibir**. 1. Especifique com que frequência seu gateway deve carregar dados para o Amazon S3 inserindo um período de tempo e selecionando um incremento de tempo para a frequência de upload de **dados**. O valor da frequência deve ser maior que 0 e menor ou igual a 30 dias. 1. Em **Configurações de armazenamento de dados**, determine o que fazer com os dados do gateway após importá-los para AWS IoT SiteWise. Há duas decisões a serem tomadas em relação ao armazenamento de dados: + Se você quiser copiar dados importados para o AWS IoT SiteWise armazenamento, marque a caixa de seleção **Copiar dados para armazenamento**. Essa opção duplica os dados importados do seu bucket AWS IoT SiteWise Amazon S3 configurado no armazenamento. + Se você optar por importar seus dados do seu bucket do Amazon S3 para o AWS IoT SiteWise armazenamento, você também pode especificar se os dados importados devem ser excluídos após a conclusão da importação. Marque a caixa **de seleção Excluir dados do Amazon S3** para excluir a data importada do bucket do Amazon S3 configurado após importá-la para o armazenamento. AWS IoT SiteWise 1. Adicione filtros de caminho ao seu destino. Para obter mais informações, consulte, [Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md). ------ #### [ AWS CLI ] **Example : Crie um novo AWS IoT SiteWise destino armazenado em buffer usando o Amazon S3** Use a [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar o editor. Defina o parâmetro `capabilityNamespace` como `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_BUFFERED", "name": "{{your-s3-destination-name}}", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/{{Optional}}/{{SomeFolder}}", "publishPolicy": { "publishFrequency": "15m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::{{123456789012}}:role/{{your-role-name}}" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` **Example : Atualize um AWS IoT SiteWise destino armazenado em buffer usando o Amazon S3** Para atualizar um destino existente AWS IoT SiteWise em tempo real, primeiro use a `DescribeGatewayCapabilityConfiguration` API para encontrar `destinationId` o. O namespace do publicador: `iotsitewise:publisher:3` ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "{{your-existing-destination-id}}", "type": "SITEWISE_BUFFERED", "name": "{{your-s3-destination-name}}", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/{{Optional}}/{{SomeFolder}}", "publishPolicy": { "publishFrequency": "15m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::{{123456789012}}:role/{{your-role-name}}" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` As opções de configuração a seguir são específicas para gateways habilitados para MQTT usando o namespace. `iotsitewise:publisher:3` `sources` Define as fontes de dados para as quais transferir dados de seu equipamento industrial AWS IoT SiteWise. Para gateways habilitados para MQTT, use. `MQTT` Tipo: matriz de objetos Obrigatório: Sim `destinations` Define para onde enviar os dados. Os destinos são em tempo real ou armazenados em buffer usando o Amazon S3. É necessário pelo menos um objeto de destino, mas você pode adicionar uma matriz vazia. Você pode ter um destino em tempo real para cada gateway. Para obter mais informações, consulte [AWS IoT SiteWise Entenda os destinos Edge](gw-destinations.md#source-destination). Tipo: matriz de objetos Obrigatório: Sim `id` O identificador exclusivo do destino. Você pode fornecer uma ID de destino existente ou deixá-la em branco para que uma nova ID seja gerada automaticamente para o destino. Tipo: string Obrigatório: não `type` Tipo de destino. As opções incluem: `SITEWISE_REALTIME` `SITEWISE_BUFFERED` e. Selecione `SITEWISE_BUFFERED`. + `SITEWISE_REALTIME`(padrão) — Envie dados diretamente para o AWS IoT SiteWise armazenamento em tempo real. Para obter mais informações, consulte [Adicione um destino em tempo real do AWS IoT SiteWise Edge](destinations-real-time.md). + `SITEWISE_BUFFERED`— Envie dados para o Amazon S3 em lotes no formato Parquet e, em seguida, importe para o armazenamento. AWS IoT SiteWise Tipo: String Obrigatório: Sim `name` Um nome exclusivo para o destino. Tipo: String Obrigatório: Sim `config` Configuração específica para o tipo de destino no formato JSON. A configuração varia entre destinos em tempo real e em buffer. Tipo: objeto Obrigatório: Sim `targetBucketArn` O ARN do bucket de publicação. Escolha o mesmo Região da AWS para ambos AWS IoT SiteWise e para o Amazon S3. Se um prefixo for escolhido, ele deverá ter entre 1 e 255 caracteres. AWS IoT SiteWise, incluindo o gateway, terá acesso a todo o bucket S3 especificado. Recomendamos usar um bucket dedicado para ingestão de dados em buffer. Tipo: String Obrigatório: Sim `publishPolicy` Detalhes da política de publicação. Tipo: objeto Obrigatório: Sim `publishFrequency` A frequência com que o gateway SiteWise Edge publica no bucket do Amazon S3. A frequência de upload de dados para o Amazon S3 deve ser maior que 0 minutos e menor ou igual a 30 dias. Você pode usar `m``h`, e `d` ao especificar uma idade de frequência de publicação. Observe que `m` representa minutos, `h` representa horas e `d` representa dias. O valor padrão é 15 minutos. Tipo: String Obrigatório: Sim `localSizeLimitGB` O tamanho máximo dos arquivos gravados no disco local em GB. Se esse limite for violado, o publicador publicará todos os dados armazenados em buffer no destino. Tipo: inteiro Obrigatório: Sim `siteWiseImportPolicy` Detalhes da política de importação para importação de dados para o. AWS IoT SiteWise Tipo: objeto Obrigatório: Sim `enableSiteWiseStorageImport` Defina isso `true` para importar dados de um bucket do Amazon S3 para AWS IoT SiteWise armazenamento. Inicialmente, ele faz uma cópia dos dados em AWS IoT SiteWise. Em seguida, se você `enableDeleteAfterImport` definir como verdadeiro, os dados no S3 serão excluídos após a cópia para o. AWS IoT SiteWise Aplicam-se implicações de preços. O valor padrão é `true`. Tipo: booliano Obrigatório: Sim `enableDeleteAfterImport` Defina isso `true` para excluir o arquivo no bucket do Amazon S3 após a ingestão no armazenamento. AWS IoT SiteWise O valor padrão é `true`. Tipo: booliano Obrigatório: Sim `bulkImportJobRoleArn` O ARN da função do IAM que AWS IoT SiteWise pressupõe a leitura de dados em buffer do Amazon S3 durante a ingestão de dados. Essa função é usada quando um dispositivo de borda é chamado AWS IoT SiteWise APIs para iniciar o processo de importação em massa. Se `enableSiteWiseStorageImport` estiver definido como`true`, esse parâmetro será obrigatório. Tipo: string Obrigatório: não ------ Adicione filtros de caminho para seu destino. Para obter mais informações, consulte [Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md).