기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon S3를 사용하여 AWS IoT SiteWise 버퍼링된 대상 추가
<a name="destinations-buffered"></a>

버퍼링된 대상 유형을 사용하면 데이터가 실시간으로 필요하지 않은 AWS IoT SiteWise 경우 수집 비용을 절감할 수 있습니다. 이를 통해 IoT 데이터를 가져오기 전에 Amazon S3 버킷에 임시로 저장할 수 있습니다 AWS IoT SiteWise. 또는 데이터를 가져올 계획인지 여부에 관계없이 스토리지를 위해 S3에 데이터를 업로드할 수 있습니다 AWS IoT SiteWise. 이는 데이터를 수집하기 전에 디바이스 및 게이트웨이에서 데이터를 일괄 처리하고 버퍼링하는 데 유용합니다 AWS IoT SiteWise. 이 옵션을 사용하면 데이터가 Parquet 형식으로 지정된 S3 버킷에 구성된 빈도로 업로드됩니다. 그런 다음 추가 분석 및 처리를 위해이 데이터를 AWS IoT SiteWise 스토리지로 가져올 수 있습니다.

**Amazon S3를 사용하여 버퍼링된 대상을 추가하려면**

 AWS IoT SiteWise 콘솔 또는를 사용하여 Amazon S3 AWS CLI 를 사용하여 데이터를 SiteWise Edge 게이트웨이에 버퍼링하는 대상을 추가합니다.

------
#### [ Console ]

 AWS Management Console 를 사용하여 Amazon S3를 사용하여 버퍼링된 AWS IoT SiteWise 대상을 추가합니다.

1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)을 엽니다.

1. 탐색 창에서 **엣지 게이트웨이**를 선택합니다.

1. 대상을 추가할 게이트웨이를 선택합니다.

1. **대상** 섹션에서 **대상 추가**를 선택합니다.

1. **대상 추가** 페이지에서 **대상 세부 정보를** 입력합니다.

   1. 대상 이름 필드의 **대상 이름**입니다.

   1. **AWS IoT SiteWise Amazon S3 for Destination 유형을 사용하여 버퍼링된**를 선택합니다.Amazon S3를 사용하여 AWS IoT SiteWise 버퍼링된는 데이터를 Parquet 형식으로 Amazon Simple Storage Service에 배치로 전송한 다음 스토리지로 AWS IoT SiteWise 데이터를 가져옵니다. **** 

1. 게이트웨이 데이터를 저장할 위치의 Amazon S3 URL을 입력합니다. **S3 찾아보기를 선택하여 경로를 찾을 수 있습니다**. 버킷이 추가되면 **보기를** 선택하여 버킷을 볼 수도 있습니다.

1. 기간을 입력하고 데이터 업로드 빈도에 대한 시간 증분을 선택하여 게이트웨이가 Amazon S3에 **데이터를 업로드하는 빈도**를 지정합니다. 빈도 값은 0보다 크고 30일보다 작거나 같아야 합니다.

1. **데이터 스토리지 설정**에서 게이트웨이 데이터를 가져온 후 게이트웨이 데이터로 수행할 작업을 결정합니다 AWS IoT SiteWise. 데이터 스토리지와 관련하여 두 가지 결정을 내려야 합니다.
   + 가져온 데이터를 AWS IoT SiteWise 스토리지에 복사하려면 **스토리지에 데이터 복사** 확인란을 선택합니다. 이 옵션은 구성된 Amazon S3 버킷에서 가져온 데이터를 AWS IoT SiteWise 스토리지로 복제합니다.
   + Amazon S3 버킷에서 AWS IoT SiteWise 스토리지로 데이터를 가져오도록 선택한 경우 가져오기가 완료된 후 가져온 데이터를 삭제할지 여부도 지정할 수 있습니다. **Amazon S3에서 데이터 삭제** 확인란을 선택하여 AWS IoT SiteWise 스토리지로 가져온 후 구성된 Amazon S3 버킷에서 가져온 날짜를 삭제합니다.

1. 대상에 경로 필터를 추가합니다. 자세한 내용은 단원을 참조하십시오[AWS IoT SiteWise Edge 대상에 경로 필터 추가](destinations-add-path-filters.md).

------
#### [ AWS CLI ]

**Example : Amazon S3를 사용하여 버퍼링된 새 AWS IoT SiteWise 대상 생성**  
[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html) API를 사용하여 게시자를 구성합니다.  
`capabilityNamespace` 파라미터를 `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 : Amazon S3를 사용하여 버퍼링된 AWS IoT SiteWise 대상 업데이트**  
기존 AWS IoT SiteWise 실시간 대상을 업데이트하려면 먼저 `DescribeGatewayCapabilityConfiguration` API를 사용하여를 찾습니다`destinationId`.  
게시자 네임스페이스: `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": [
                "#"
              ]
            }
          }
        ]
      }
    ]
  }
```

다음 구성 옵션은 `iotsitewise:publisher:3` 네임스페이스를 사용하는 MQTT 지원 게이트웨이에만 적용됩니다.

`sources`  
산업 장비에서 로 데이터를 전송할 데이터 소스를 정의합니다 AWS IoT SiteWise. MQTT 지원 게이트웨이의 경우를 사용합니다`MQTT`.  
타입: 객체 배열  
필수 항목 여부: 예

`destinations`  
데이터를 전송할 위치를 정의합니다. 대상은 Amazon S3를 사용하여 실시간 또는 버퍼링됩니다. 하나 이상의 대상 객체가 필요하지만 빈 배열을 추가할 수 있습니다. 각 게이트웨이에 대해 하나의 실시간 대상을 가질 수 있습니다. 자세한 내용은 [AWS IoT SiteWise 엣지 대상 이해](gw-destinations.md#source-destination) 단원을 참조하십시오.  
유형: 객체 배열  
필수 항목 여부: 예    
`id`  
대상의 고유 식별자입니다. 기존 대상 ID를 제공하거나 비워 두어 대상에 대해 새 ID가 자동으로 생성되도록 할 수 있습니다.  
유형: 문자열  
필수 항목 여부: 아니요  
`type`  
대상의 유형입니다. 옵션에는 `SITEWISE_REALTIME` 및가 포함됩니다`SITEWISE_BUFFERED`. `SITEWISE_BUFFERED`을 선택합니다.  
+ `SITEWISE_REALTIME` (기본값) - 실시간으로 AWS IoT SiteWise 스토리지로 직접 데이터를 전송합니다. 자세한 내용은 [AWS IoT SiteWise Edge 실시간 대상 추가](destinations-real-time.md) 단원을 참조하십시오.
+ `SITEWISE_BUFFERED` - 데이터를 Parquet 형식으로 Amazon S3에 배치로 전송한 다음 AWS IoT SiteWise 스토리지로 가져옵니다.
유형: 문자열  
필수 항목 여부: 예  
`name`  
대상의 고유한 이름입니다.  
유형: 문자열  
필수 항목 여부: 예  
`config`  
JSON 형식의 대상 유형별 구성입니다. 구성은 실시간 대상과 버퍼링된 대상에 따라 다릅니다.  
유형: 객체  
필수 항목 여부: 예    
`targetBucketArn`  
게시할 버킷 ARN입니다. AWS IoT SiteWise 및 Amazon S3 모두에 AWS 리전 대해 동일한를 선택합니다. 접두사를 선택한 경우 1\~255자여야 합니다.  
AWS IoT SiteWise게이트웨이를 포함한는 지정된 전체 S3 버킷에 액세스할 수 있습니다. 버퍼링된 데이터 수집에는 전용 버킷을 사용하는 것이 좋습니다.
유형: 문자열  
필수 항목 여부: 예  
`publishPolicy`  
게시 정책의 세부 정보입니다.  
유형: 객체  
필수 항목 여부: 예    
`publishFrequency`  
SiteWise Edge 게이트웨이가 Amazon S3 버킷에 게시하는 빈도입니다. Amazon S3에 대한 데이터 업로드 빈도는 0분보다 크고 30일 이하여야 합니다. 게시 빈도 기간을 지정할 `d` 때 `m``h`, 및를 사용할 수 있습니다. `m`은 분, `h`는 시간, `d`는 일을 나타냅니다. 기본값은 15분입니다.  
유형: 문자열  
필수 항목 여부: 예  
`localSizeLimitGB`  
로컬 디스크에 기록된 파일의 최대 크기는 GB입니다. 이 임계값을 위반하면 게시자는 버퍼링된 모든 데이터를 대상에 게시합니다.  
유형: 정수  
필수 항목 여부: 예  
`siteWiseImportPolicy`  
데이터를 가져오기 위한 가져오기 정책의 세부 정보입니다 AWS IoT SiteWise.  
유형: 객체  
필수 항목 여부: 예    
`enableSiteWiseStorageImport`  
Amazon S3 버킷에서 AWS IoT SiteWise 스토리지로 데이터를 가져오`true`려면이 값을 로 설정합니다. 처음에는 데이터 사본을 만듭니다 AWS IoT SiteWise. 그런 다음를 true`enableDeleteAfterImport`로 설정하면 복사 후 S3의 데이터가 삭제됩니다 AWS IoT SiteWise. 요금 영향이 적용됩니다. 기본값은 `true`입니다.  
유형: Boolean  
필수 항목 여부: 예  
`enableDeleteAfterImport`  
 AWS IoT SiteWise 스토리지에 수집한 후 Amazon S3 버킷의 파일을 삭제`true`하려면이 값을 로 설정합니다. 기본값은 `true`입니다.  
유형: Boolean  
필수 항목 여부: 예  
`bulkImportJobRoleArn`  
데이터 수집 중에가 Amazon S3에서 버퍼링된 데이터를 읽도록 AWS IoT SiteWise 수임하는 IAM 역할의 ARN입니다. 이 역할은 엣지 디바이스가 AWS IoT SiteWise APIs 호출하여 대량 가져오기 프로세스를 시작할 때 사용됩니다.  
`enableSiteWiseStorageImport`이 로 설정된 경우 `true`이 파라미터가 필요합니다.
유형: 문자열  
필수 항목 여부: 아니요

------

대상에 대한 경로 필터를 추가합니다. 자세한 내용은 [AWS IoT SiteWise Edge 대상에 경로 필터 추가](destinations-add-path-filters.md) 단원을 참조하십시오.