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á.
# AWS IoT TwinMaker conectores de dados
Os conectores precisam acessar seu armazenamento de dados subjacente para resolver as consultas enviadas e retornar resultados ou um erro.
Para saber mais sobre os conectores disponíveis, suas interfaces de solicitação e suas interfaces de resposta, consulte os tópicos a seguir.
Para obter mais informações sobre as propriedades usadas nas interfaces do conector, consulte a ação da [GetPropertyValueHistory](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html)API.
**nota**
Alguns conectores têm dois campos de registro de data e hora nas interfaces de solicitação e resposta para propriedades de hora de início e hora de término. Ambos `startDateTime` e `endDateTime` usam um número longo para representar o segundo epoch, que não é mais suportado. Para manter a compatibilidade com versões anteriores, ainda enviamos um valor do registro de data e hora para esse campo, mas recomendamos usar os campos `startTime` e `endTime` que sejam consistentes com o formato de data e hora da nossa API.
**Topics**
+ [Conector inicializador de esquema](#SchemaInitializer-connector)
+ [DataReaderByEntity](#DataReaderByEntity-connector)
+ [DataReaderByComponentType](#DataReaderByComponentType-connector)
+ [DataReader](#DataReader-connector)
+ [AttributePropertyValueReaderByEntity](#AttributePropertyValueReaderByEntity-connector)
+ [DataWriter](#DataWriter-connector)
+ [Exemplos](#examples-connector)
## Conector inicializador de esquema
Você pode usar o inicializador de esquema no tipo de componente ou no ciclo de vida da entidade para buscar o tipo de componente ou as propriedades do componente na fonte de dados subjacente. O inicializador de esquema importa automaticamente o tipo de componente ou as propriedades do componente sem chamar explicitamente uma ação de API para configurar `properties`.
### SchemaInitializer interface de solicitação
```
{
"workspaceId": "string",
"entityId": "string",
"componentName": "string",
"properties": {
// property name as key,
// value is of type PropertyRequest
"string": "PropertyRequest"
}
}
```
**nota**
O mapa de propriedades nessa interface de solicitação é um `PropertyRequest`. Para obter mais informações, consulte [PropertyRequest](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_PropertyRequest.html).
### SchemaInitializer interface de resposta
```
{
"properties": {
// property name as key,
// value is of type PropertyResponse
"string": "PropertyResponse"
}
}
```
**nota**
O mapa de propriedades nessa interface de solicitação é um `PropertyResponse`. Para obter mais informações, consulte [PropertyResponse](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_PropertyResponse.html).
## DataReaderByEntity
DataReaderByEntity é um conector de plano de dados usado para obter os valores de séries temporais das propriedades em um único componente.
Para obter informações sobre os tipos de propriedade, a sintaxe e o formato desse conector, consulte a ação da [GetPropertyValueHistory](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html)API.
### DataReaderByEntity interface de solicitação
```
{
"startDateTime": long, // In epoch sec, deprecated
"startTime": "string", // ISO-8601 timestamp format
"endDateTime": long, // In epoch sec, deprecated
"endTime": "string", // ISO-8601 timestamp format
"properties": {
// A map of properties as in the get-entity API response
// property name as key,
// value is of type [PropertyResponse](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_PropertyResponse.html)
"string": "PropertyResponse"
},
"workspaceId": "string",
"selectedProperties": List:"string",
"propertyFilters": List:PropertyFilter,
"entityId": "string",
"componentName": "string",
"componentTypeId": "string",
"interpolation": InterpolationParameters,
"nextToken": "string",
"maxResults": int,
"orderByTime": "string"
}
```
### DataReaderByEntity interface de resposta
```
{
"propertyValues": [
{
"entityPropertyReference": EntityPropertyReference, // The same as [EntityPropertyReference](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_EntityPropertyReference.html)
"values": [
{
"timestamp": long, // Epoch sec, deprecated
"time": "string", // ISO-8601 timestamp format
"value": DataValue // The same as [DataValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DataValue.html)
}
]
}
],
"nextToken": "string"
}
```
## DataReaderByComponentType
Para obter os valores de séries temporais de propriedades comuns que vêm do mesmo tipo de componente, use o conector DataReaderByEntity do plano de dados. Por exemplo, caso defina propriedades de séries temporais no tipo de componente e tiver vários componentes usando esse mesmo tipo, poderá consultar tais propriedades em todos os componentes em um determinado intervalo de tempo. Um caso de uso comum sobre isso é quando você deseja consultar o status do alarme de vários componentes para obter uma visão global de suas entidades.
Para obter informações sobre os tipos de propriedade, a sintaxe e o formato desse conector, consulte a ação da [GetPropertyValueHistory](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html)API.
### DataReaderByComponentType interface de solicitação
```
{
"startDateTime": long, // In epoch sec, deprecated
"startTime": "string", // ISO-8601 timestamp format
"endDateTime": long, // In epoch sec, deprecated
"endTime": "string", // ISO-8601 timestamp format
"properties": { // A map of properties as in the get-entity API response
// property name as key,
// value is of type [PropertyResponse](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_PropertyResponse.html)
"string": "PropertyResponse"
},
"workspaceId": "string",
"selectedProperties": List:"string",
"propertyFilters": List:PropertyFilter,
"componentTypeId": "string",
"interpolation": InterpolationParameters,
"nextToken": "string",
"maxResults": int,
"orderByTime": "string"
}
```
### DataReaderByComponentType interface de resposta
```
{
"propertyValues": [
{
"entityPropertyReference": EntityPropertyReference, // The same as [EntityPropertyReference](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_EntityPropertyReference.html)
"entityId": "string",
"componentName": "string",
"values": [
{
"timestamp": long, // Epoch sec, deprecated
"time": "string", // ISO-8601 timestamp format
"value": DataValue // The same as [DataValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DataValue.html)
}
]
}
],
"nextToken": "string"
}
```
## DataReader
DataReader é um conector de plano de dados que pode lidar com o caso de DataReaderByEntity DataReaderByComponentType e.
Para obter informações sobre os tipos de propriedade, a sintaxe e o formato desse conector, consulte a ação da [GetPropertyValueHistory](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html)API.
### DataReader interface de solicitação
Os `EntityId` e `componentName` são opcionais.
```
{
"startDateTime": long, // In epoch sec, deprecated
"startTime": "string", // ISO-8601 timestamp format
"endDateTime": long, // In epoch sec, deprecated
"endTime": "string", // ISO-8601 timestamp format
"properties": { // A map of properties as in the get-entity API response
// property name as key,
// value is of type PropertyRequest
"string": "PropertyRequest"
},
"workspaceId": "string",
"selectedProperties": List:"string",
"propertyFilters": List:PropertyFilter,
"entityId": "string",
"componentName": "string",
"componentTypeId": "string",
"interpolation": InterpolationParameters,
"nextToken": "string",
"maxResults": int,
"orderByTime": "string"
}
```
### DataReader interface de resposta
```
{
"propertyValues": [
{
"entityPropertyReference": EntityPropertyReference, // The same as [EntityPropertyReference](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_EntityPropertyReference.html)
"values": [
{
"timestamp": long, // Epoch sec, deprecated
"time": "string", // ISO-8601 timestamp format
"value": DataValue // The same as [DataValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DataValue.html)
}
]
}
],
"nextToken": "string"
}
```
## AttributePropertyValueReaderByEntity
AttributePropertyValueReaderByEntity é um conector de plano de dados que você pode usar para buscar o valor das propriedades estáticas em uma única entidade.
Para obter informações sobre os tipos de propriedade, a sintaxe e o formato desse conector, consulte a ação da [ GetPropertyValue](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_GetPropertyValue.html)API.
### AttributePropertyValueReaderByEntity interface de solicitação
```
{
"properties": {
// property name as key,
// value is of type [PropertyResponse](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_PropertyResponse.html)
"string": "PropertyResponse"
}
"workspaceId": "string",
"entityId": "string",
"componentName": "string",
"selectedProperties": List:"string",
}
```
### AttributePropertyValueReaderByEntity interface de resposta
```
{
"propertyValues": {
"string": { // property name as key
"propertyReference": EntityPropertyReference, // The same as [EntityPropertyReference](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_EntityPropertyReference.html)
"propertyValue": DataValue // The same as [DataValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DataValue.html)
}
}
```
## DataWriter
DataWriter é um conector de plano de dados que você pode usar para gravar pontos de dados de séries temporais no armazenamento de dados subjacente para propriedades em um único componente.
Para obter informações sobre os tipos de propriedade, a sintaxe e o formato desse conector, consulte a ação da [BatchPutPropertyValues](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_BatchPutPropertyValues.html)API.
### DataWriter interface de solicitação
```
{
"workspaceId": "string",
"properties": {
// entity id as key
"String": {
// property name as key,
// value is of type [PropertyResponse](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_PropertyResponse.html)
"string": PropertyResponse
}
},
"entries": [
{
"entryId": "string",
"entityPropertyReference": EntityPropertyReference, // The same as [EntityPropertyReference](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_EntityPropertyReference.html)
"propertyValues": [
{
"timestamp": long, // Epoch sec, deprecated
"time": "string", // ISO-8601 timestamp format
"value": DataValue // The same as [DataValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DataValue.html)
}
]
}
]
}
```
### DataWriter interface de resposta
```
{
"errorEntries": [
{
"errors": List:BatchPutPropertyError // The value is a list of type [BatchPutPropertyError](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_BatchPutPropertyError.html)
}
]
}
```
## Exemplos
Os exemplos de JSON a seguir são exemplos de sintaxe de resposta e solicitação para vários conectores.
+ **SchemaInitializer**:
Os exemplos a seguir mostram o inicializador de esquema em um ciclo de vida do tipo componente.
**Solicitação:**
```
{
"workspaceId": "myWorkspace",
"properties": {
"modelId": {
"definition": {
"dataType": { "type": "STRING" },
"isExternalId": true,
"isFinal": true,
"isImported": false,
"isInherited": false,
"isRequiredInEntity": true,
"isStoredExternally": false,
"isTimeSeries": false,
"defaultValue": {
"stringValue": "myModelId"
}
},
"value": {
"stringValue": "myModelId"
}
},
"tableName": {
"definition": {
"dataType": { "type": "STRING" },
"isExternalId": false,
"isFinal": false,
"isImported": false,
"isInherited": false,
"isRequiredInEntity": false,
"isStoredExternally": false,
"isTimeSeries": false,
"defaultValue": {
"stringValue": "myTableName"
}
},
"value": {
"stringValue": "myTableName"
}
}
}
}
```
**Resposta:**
```
{
"properties": {
"myProperty1": {
"definition": {
"dataType": {
"type": "DOUBLE",
"unitOfMeasure": "%"
},
"configuration": {
"myProperty1Id": "idValue"
},
"isTimeSeries": true
}
},
"myProperty2": {
"definition": {
"dataType": { "type": "STRING" },
"isTimeSeries": false,
"defaultValue": {
"stringValue": "property2Value"
}
}
}
}
}
```
+ **O inicializador de esquema no ciclo de vida da entidade:**
**Solicitação:**
```
{
"workspaceId": "myWorkspace",
"entityId": "myEntity",
"componentName": "myComponent",
"properties": {
"assetId": {
"definition": {
"dataType": { "type": "STRING" },
"isExternalId": true,
"isFinal": true,
"isImported": false,
"isInherited": false,
"isRequiredInEntity": true,
"isStoredExternally": false,
"isTimeSeries": false
},
"value": {
"stringValue": "myAssetId"
}
},
"tableName": {
"definition": {
"dataType": { "type": "STRING" },
"isExternalId": false,
"isFinal": false,
"isImported": false,
"isInherited": false,
"isRequiredInEntity": false,
"isStoredExternally": false,
"isTimeSeries": false
},
"value": {
"stringValue": "myTableName"
}
}
}
}
```
**Resposta:**
```
{
"properties": {
"myProperty1": {
"definition": {
"dataType": {
"type": "DOUBLE",
"unitOfMeasure": "%"
},
"configuration": {
"myProperty1Id": "idValue"
},
"isTimeSeries": true
}
},
"myProperty2": {
"definition": {
"dataType": { "type": "STRING" },
"isTimeSeries": false
},
"value": {
"stringValue": "property2Value"
}
}
}
}
```
+ **DataReaderByEntity e DataReader**:
**Solicitação:**
```
{
"workspaceId": "myWorkspace",
"entityId": "myEntity",
"componentName": "myComponent",
"selectedProperties": [
"Temperature",
"Pressure"
],
"startTime": "2022-04-07T04:04:42Z",
"endTime": "2022-04-07T04:04:45Z",
"maxResults": 4,
"orderByTime": "ASCENDING",
"properties": {
"assetId": {
"definition": {
"dataType": { "type": "STRING" },
"isExternalId": true,
"isFinal": true,
"isImported": false,
"isInherited": false,
"isRequiredInEntity": true,
"isStoredExternally": false,
"isTimeSeries": false
},
"value": {
"stringValue": "myAssetId"
}
},
"Temperature": {
"definition": {
"configuration": {
"temperatureId": "xyz123"
},
"dataType": {
"type": "DOUBLE",
"unitOfMeasure": "DEGC"
},
"isExternalId": false,
"isFinal": false,
"isImported": true,
"isInherited": false,
"isRequiredInEntity": false,
"isStoredExternally": false,
"isTimeSeries": true
}
},
"Pressure": {
"definition": {
"configuration": {
"pressureId": "xyz456"
},
"dataType": {
"type": "DOUBLE",
"unitOfMeasure": "MPA"
},
"isExternalId": false,
"isFinal": false,
"isImported": true,
"isInherited": false,
"isRequiredInEntity": false,
"isStoredExternally": false,
"isTimeSeries": true
}
}
}
}
```
**Resposta:**
```
{
"propertyValues": [
{
"entityPropertyReference": {
"entityId": "myEntity",
"componentName": "myComponent",
"propertyName": "Temperature"
},
"values": [
{
"time": "2022-04-07T04:04:42Z",
"value": {
"doubleValue": 588.168
}
},
{
"time": "2022-04-07T04:04:43Z",
"value": {
"doubleValue": 592.4224
}
}
]
}
],
"nextToken": "qwertyuiop"
}
```
+ **AttributePropertyValueReaderByEntity**:
**Solicitação:**
```
{
"workspaceId": "myWorkspace",
"entityId": "myEntity",
"componentName": "myComponent",
"selectedProperties": [
"manufacturer",
],
"properties": {
"assetId": {
"definition": {
"dataType": { "type": "STRING" },
"isExternalId": true,
"isFinal": true,
"isImported": false,
"isInherited": false,
"isRequiredInEntity": true,
"isStoredExternally": false,
"isTimeSeries": false
},
"value": {
"stringValue": "myAssetId"
}
},
"manufacturer": {
"definition": {
"dataType": { "type": "STRING" },
"configuration": {
"manufacturerPropId": "M001"
},
"isExternalId": false,
"isFinal": false,
"isImported": false,
"isInherited": false,
"isRequiredInEntity": false,
"isStoredExternally": true,
"isTimeSeries": false
}
}
}
}
```
**Resposta:**
```
{
"propertyValues": {
"manufacturer": {
"propertyReference": {
"propertyName": "manufacturer",
"entityId": "myEntity",
"componentName": "myComponent"
},
"propertyValue": {
"stringValue": "Amazon"
}
}
}
}
```
+ **DataWriter**:
**Solicitação:**
```
{
"workspaceId": "myWorkspaceId",
"properties": {
"myEntity": {
"Temperature": {
"definition": {
"configuration": {
"temperatureId": "xyz123"
},
"dataType": {
"type": "DOUBLE",
"unitOfMeasure": "DEGC"
},
"isExternalId": false,
"isFinal": false,
"isImported": true,
"isInherited": false,
"isRequiredInEntity": false,
"isStoredExternally": false,
"isTimeSeries": true
}
}
}
},
"entries": [
{
"entryId": "myEntity",
"entityPropertyReference": {
"entityId": "myEntity",
"componentName": "myComponent",
"propertyName": "Temperature"
},
"propertyValues": [
{
"timestamp": 1626201120,
"value": {
"doubleValue": 95.6958
}
},
{
"timestamp": 1626201132,
"value": {
"doubleValue": 80.6959
}
}
]
}
]
}
```
**Resposta:**
```
{
"errorEntries": [
{
"errors": [
{
"errorCode": "409",
"errorMessage": "Conflict value at same timestamp",
"entry": {
"entryId": "myEntity",
"entityPropertyReference": {
"entityId": "myEntity",
"componentName": "myComponent",
"propertyName": "Temperature"
},
"propertyValues": [
"time": "2022-04-07T04:04:42Z",
"value": {
"doubleValue": 95.6958
}
]
}
}
]
}
]
}
```