IoT Hub veri bağlantısı

Azure IoT Hub , bulutta barındırılan ve IoT uygulamanızla yönettiği cihazlar arasında çift yönlü iletişim için merkezi bir ileti hub'ı işlevi gören yönetilen bir hizmettir. Azure Veri Gezgini, cihazdan buluta iletilerin yerleşik uç noktasını kullanarak müşteri tarafından yönetilen IoT Hub'larından sürekli alım sunar.

IoT alımı işlem hattı birkaç adımdan geçer. İlk olarak bir IoT Hub oluşturup cihazı buna kaydedersiniz. Ardından Azure Veri Gezgini belirli bir biçimdeki verilerin verilen alım özellikleri kullanılarak alınacağı bir hedef tablo oluşturursunuz. Iot Hub bağlantısının Azure Veri Gezgini tablosuna bağlanmak için olay yönlendirmesini bilmesi gerekir. Veriler, olay sistemi özellikleri eşlemesine göre seçili özelliklerle eklenir. Bu işlem Azure portalı üzerinden, C# veya Python ile program aracılığıyla veya Azure Resource Manager şablonuyla yönetilebilir.

Azure Veri Gezgini'da veri alımı hakkında genel bilgi için bkz. Azure Veri Gezgini veri alımına genel bakış.

Veri biçimi

• Veriler EventData nesneleri biçiminde Event Hub uç noktasından okunur.
• Desteklenen biçimlere bakın.

  Not

  IoT Hub .raw biçimini desteklemez.

• Bkz. desteklenen sıkıştırmalar.

Alma özellikleri

Alma özellikleri, veri alma işlemine verilerin nereye yönlendirileceği ve nasıl işlendiği hakkında bilgi verir. EventData.Properties'i kullanarak olayların alım özelliklerini belirtebilirsiniz. Aşağıdaki özellikleri ayarlayabilirsiniz:

Olay yönlendirme

Kümenize bir veri bağlantısı oluşturduğunuzda, alınan verilerin nereye gönderileceğine ilişkin yönlendirmeyi belirtirsiniz. Varsayılan yönlendirme, hedef veritabanıyla ilişkili bağlantı dizesi belirtilen hedef tabloya yapılır. Verileriniz için varsayılan yönlendirme statik yönlendirme olarak da adlandırılır. Olay verileri özelliklerini kullanarak verileriniz için alternatif bir yönlendirme belirtebilirsiniz.

Olay verilerini alternatif veritabanına yönlendirme

Verileri alternatif bir veritabanına yönlendirme varsayılan olarak kapalıdır. Verileri farklı bir veritabanına göndermek için önce bağlantıyı çok veritabanılı bir bağlantı olarak ayarlamanız gerekir. Azure portalında bunun nasıl yapıldığını gösteren bir örnek için bkz . Çok veritabanılı yönlendirmeyi açma. Veritabanı yönlendirmesine izin vermek için kullanılan kullanıcı, grup, hizmet sorumlusu veya yönetilen kimlik en azından kümede katkıda bulunan rolüne ve yazma izinlerine sahip olmalıdır.

Alternatif bir veritabanı belirtmek için Veritabanı alımı özelliğini ayarlayın.

Çoklu veritabanı yönlendirmeyi açma

Alternatif bir hedef veritabanı ayarlayabilmeniz için önce verileri birden çok veritabanına yönlendirmeye izin vermelisiniz. Verileri alternatif veritabanlarına yönlendirmeye izin vermek için aşağıdaki adımları kullanın:

1. Azure portalında kümenize göz atın.

2. Veritabanları>Veri bağlantıları'nı seçin.

3. Veri bağlantısı oluşturun veya düzenleyin ve Veri bağlantısı bölmesindeki Veri yönlendirme ayarları'nın altında, verileri diğer veritabanına yönlendirmeye izin ver (çok veritabanılı veri bağlantısı) seçeneğini açın.

   

Olay verilerini alternatif bir tabloya yönlendirme

Olay özelliklerini kullanarak her olay için hedef tablo özelliklerini de belirtebilirsiniz. Bağlantı, eventData.Properties içinde belirtilen verileri dinamik olarak yönlendirir ve bu olay için statik özellikleri geçersiz kılacaktır. Alternatif bir tablo belirtmek için Tablo alımı özelliğini ayarlayın.

Olay sistemi özellikleri eşlemesi

Sistem özellikleri, olayın alındığı saatte IoT Hub hizmeti tarafından ayarlanan özellikleri depolamak için kullanılan bir koleksiyondur. Azure Veri Gezgini IoT Hub bağlantısı, seçili özellikleri tablonuzdaki veri girişinde ekler.

Sistem özellikleri

IoT Hub, cihazdan buluta IoT Hub iletileri için aşağıdaki sistem özelliklerini kullanıma sunar:

Tablonun Veri Kaynağı bölümünde Olay sistemi özelliklerini seçtiyseniz, özellikleri tablo şemasına ve eşlemesine eklemeniz gerekir.

Şema eşleme örnekleri

Tablo şeması eşleme örneği

Verileriniz üç sütun (Timespan, Metricve Value) içeriyorsa ve eklediğiniz özellikler isesequence-numberiothub-connection-device-id, şu komutu kullanarak tablo şemasını oluşturun veya değiştirin:

    .create-merge table TestTable (TimeStamp: datetime, Metric: string, Value: int, IotHubDeviceId:long, IotHubSequenceNumber:long)

CSV eşleme örneği

Kaydın başına veri eklemek için aşağıdaki komutları çalıştırın. Sıralı değerleri not edin.

    .create table TestTable ingestion csv mapping "CsvMapping1"
    '['
    '   { "column" : "TimeStamp", "Properties":{"Ordinal":"2"}},'
    '   { "column" : "Metric", "Properties":{"Ordinal":"3"}},'
    '   { "column" : "Value", "Properties":{"Ordinal":"4"}},'
    '   { "column" : "IotHubDeviceId", "Properties":{"Ordinal":"0"}},'
    '   { "column" : "IotHubSequenceNumber", "Properties":{"Ordinal":"1"}}'
    ']'

JSON eşleme örneği

Veriler, sistem özellikleri eşlemesi kullanılarak eklenir. Şu komutları çalıştırın:

    .create table TestTable ingestion json mapping "JsonMapping1"
    '['
    '    { "column" : "TimeStamp", "Properties":{"Path":"$.timestamp"}},'
    '    { "column" : "Metric", "Properties":{"Path":"$.metric"}},'
    '    { "column" : "Value", "Properties":{"Path":"$.metric_value"}},'
    '    { "column" : "IotHubDeviceId", "Properties":{"Path":"$.iothub-connection-device-id"}},'
    '    { "column" : "IotHubSequenceNumber", "Properties":{"Path":"$.sequence-number"}}'
    ']'

Olay kullanıcı özellikleri eşlemesi

IoT Hub olay yükünü kullanıcı özellikleriyle zenginleştirme desteği yoktur. Kullanıcı özelliklerini olay gövdesi yukarı akışına eklemeyi göz önünde bulundurun.

IoT Hub bağlantısı

IoT Hub oluşturma

Henüz bir hub'ına sahip değilseniz IoT Hub'ı oluşturun. IoT Hub bağlantısı Azure portalı üzerinden, C# veya Python ile program aracılığıyla veya Azure Resource Manager şablonuyla yönetilebilir.

Olay gönderme

Bir cihazın simülasyonunu yapıp veri oluşturan örnek projeye bakın.

Sonraki adım