Använda scheman i dataflödesdiagram

Dataflödesdiagram hanterar scheman på ett annat sätt än klassiska dataflöden. I stället för att ange schemat för källan eller omvandlingen konfigurerar du scheman på nodanslutningarna mellan noder i diagrammet.

Information om definitioner av meddelandescheman, format (JSON, Delta) och hur du laddar upp scheman finns i Förstå meddelandescheman.

Schemaplats i dataflödesdiagram

I ett klassiskt dataflöde konfigureras scheman på källan (schemaRef i sourceSettings) och transformering (schemaRef i builtInTransformationSettings). I ett dataflödesdiagram konfigureras scheman på anslutningarna mellan noder.

Varje post i matrisen nodeConnections kan innehålla en schemafrom sidan av anslutningen. Det här schemat beskriver det förväntade formatet för data som flödar mellan dessa två noder.

Konfigurera ett indataschema

För att specificera ett schema för data som kommer in i en anslutning, lägg till ett schema fält till from sidan av anslutningen.

nodeConnections: [
  {
    from: {
      name: 'source'
      schema: {
        schemaRef: 'aio-sr://my-namespace/sensor-data:1'
        serializationFormat: 'Json'
      }
    }
    to: {
      name: 'transform'
    }
  }
]

Följer schemaRef formatet aio-sr://<namespace>/<name>:<version> och refererar till ett schema som lagras i schemaregistret.

Serialiseringsformat som stöds:

Format Beskrivning
Json JSON-format (standard för MQTT och Kafka)

Konfigurera ett utdataschema

Måldestinationer för dataflödesdiagram stöder ett outputSchemaSettings fält för att styra serialiseringsformatet för utdata.

{
  name: 'output'
  nodeType: 'Destination'
  destinationSettings: {
    endpointRef: 'my-adls-endpoint'
    dataDestination: 'my-container'
  }
}

När du använder lagringsmål (ADLS, Fabric, ADX) konfigureras utdataschemat och serialiseringsformatet på målslutpunkten. Se Konfigurera ett dataflödesmål.

Anmärkning

Dataflödesdiagram stöder för närvarande endast MQTT-, Kafka- och OpenTelemetry-slutpunkter. Lagringsslutpunkter stöds inte som dataflödesdiagrammål.

Skillnader från dataflödesscheman

Aspekt Dataflöden Dataflödesdiagram
Schemalokalisering Vid källa (sourceSettings.schemaRef) och omvandling (builtInTransformationSettings.schemaRef) Vid nodanslutningar (nodeConnections[].from.schema)
Utdataschema Om transformering (builtInTransformationSettings.serializationFormat) På målnoden (outputSchemaSettings)
Körningsverifiering Stöds inte för närvarande för källscheman Stöds inte för närvarande för källscheman
Målformat som stöds JSON, Parquet, Delta JSON