Azure Veri Gezgini için IoT Hub veri bağlantısı oluşturma

Bu makalede, büyük bir veri akışı platformu ve IoT alma hizmeti olan IoT Hub'dan Azure Veri Gezgini'a veri alma işlemi gösterilmektedir.

Azure portal veya ARM şablonuyla bağlantı oluşturmayı öğrenmek için bkz. IoT veri bağlantısı oluşturma.

IoT Hub'dan Azure Veri Gezgini alma hakkında genel bilgi için bkz. IoT Hub bağlanma.

Not

Yalnızca veri bağlantısını oluşturduktan sonra sıraya alınan olaylar alınıyor.

Önceki SDK sürümlerini temel alan kod örnekleri için arşivlenmiş makaleye bakın.

Önkoşullar

• Azure aboneliği. Ücretsiz bir Azure hesabı oluşturun.
• Azure Veri Gezgini kümesi ve veritabanı. Küme ve veritabanı oluşturma.
• Hedef tablo. Tablo oluşturun veya var olan bir tabloyu kullanın.
• Tablo için alım eşlemesi .
• Veri alımı için veri içeren bir IoT Hub.

IoT Hub veri bağlantısı oluşturma

Bu bölümde, IoT Hub ile Azure Veri Gezgini tablonuz arasında bir bağlantı kuracaksınız. Bu bağlantı olduğu sürece veriler IoT Hub hedef tablonuza iletilir.

Portal

1. Azure Veri Gezgini kümenizin sol menüsünde Veritabanları'nı ve ardından hedef tablonuzu içeren veritabanını seçin.

   

2. Veri bağlantıları'nı ve Veri bağlantısı ekle'yi seçin. Açılan listeden IoT Hub'ı seçin.

   

3. Formu aşağıdaki bilgilerle doldurun.

   Ayar	Alan açıklaması
   Veri bağlantısı adı	Azure Veri Gezgini'de oluşturmak istediğiniz bağlantının adı
   Abonelik	Event Hubs kaynağının bulunduğu abonelik kimliği.
   IoT Hub	IoT Hub adı
   Paylaşılan erişim ilkesi	Paylaşılan erişim ilkesinin adı. Okuma izinlerine sahip olmalıdır
   Tüketici grubu	IoT Hub yerleşik uç noktasında tanımlanan tüketici grubu
   Olay sistemi özellikleri	IoT Hub olay sistemi özellikleri. Sistem özellikleri eklerken, tablo şemasını ve eşlemesini seçili özellikleri içerecek şekilde oluşturun veya güncelleştirin.

   

   Not

   • Olay sistemi özellikleri tek kayıtlı olaylar için desteklenir.
   • CSV eşlemesi için özellikler kaydın başına eklenir. JSON eşlemesi için, özellikler açılan listede görünen ada göre eklenir.

4. Kullanım örneğine bağlı olarak, çok veritabanılı yönlendirmeyi açmak isteyebilirsiniz. Veritabanı yönlendirme hakkında daha fazla bilgi için bkz . Olay yönlendirme.

   

5. Aşağıdaki yönlendirme ayarlarını doldurun:

   Ayar	Önerilen değer	Alan açıklaması
   Tablo adı	TestTable	testdb'de oluşturduğunuz tablo.
   Veri biçimi	JSON	Desteklenen biçimler AVRO, CSV, JSON, ORC, PARQUET, PSV, SCSV, SOHSV, TSV, TXT, TSVE, APACHE AVRO ve W3CLOG'dur.
   Eşleme	TestMapping	Gelen verileri testdb'nin sütun adlarına ve veri türlerine eşleyen testdb'de oluşturduğunuz eşleme. Belirtilmezse, tablonun şemasından türetilen bir kimlik verileri eşlemesi kullanılır.

   

   Not

   • JSON verileri varsayılan olarak çokluson olarak ayrıştırılır. Verileri katı JSON biçiminde almak için Biçim hatalarını yoksay'ı seçin.
   • Olay sistemi özelliklerini seçtiyseniz, tablo şemasına ve eşlemesine sistem özelliklerini eklemeniz gerekir.

6. Oluştur’u seçin.

Uyarı

El ile yük devretme durumunda veri bağlantısını yeniden oluşturun.

ARM şablonu

Aşağıdaki örnekte, IoT Hub veri bağlantısı eklemeye yönelik bir Azure Resource Manager şablonu gösterilmektedir. Formu kullanarak şablonu Azure portal düzenleyebilir ve dağıtabilirsiniz.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "IotHubs_iothubdemo_name": {
            "type": "string",
            "defaultValue": "iothubdemo",
            "metadata": {
                "description": "Specifies the IoT Hub name."
            }
        },
        "iothubpolices_iothubowner_name": {
            "type": "string",
            "defaultValue": "iothubowner",
            "metadata": {
                "description": "Specifies the shared access policy name."
            }
        },
        "consumergroup_default_name": {
            "type": "string",
            "defaultValue": "$Default",
            "metadata": {
                "description": "Specifies the consumer group of the IoT Hub."
            }
        },
        "Clusters_kustocluster_name": {
            "type": "string",
            "defaultValue": "kustocluster",
            "metadata": {
                "description": "Specifies the name of the cluster"
            }
        },
        "databases_kustodb_name": {
            "type": "string",
            "defaultValue": "kustodb",
            "metadata": {
                "description": "Specifies the name of the database"
            }
        },
        "tables_kustotable_name": {
            "type": "string",
            "defaultValue": "kustotable",
            "metadata": {
                "description": "Specifies the name of the table"
            }
        },
        "mapping_kustomapping_name": {
            "type": "string",
            "defaultValue": "kustomapping",
            "metadata": {
                "description": "Specifies the name of the mapping rule"
            }
        },
        "dataformat_type": {
            "type": "string",
            "defaultValue": "csv",
            "metadata": {
                "description": "Specifies the data format"
            }
        },
           "databaseRouting_type": {
            "type": "string",
            "defaultValue": "Single",
            "metadata": {
                "description": "The database routing for the connection. If you set the value to **Single**, the data connection will be routed to a single database in the cluster as specified in the *databaseName* setting. If you set the value to **Multi**, you can override the default target database using the *Database* EventData property."
            }
        },
        "dataconnections_kustodc_name": {
            "type": "string",
            "defaultValue": "kustodc",
            "metadata": {
                "description": "Name of the data connection to create"
            }
        },
        "subscriptionId": {
            "type": "string",
            "defaultValue": "[subscription().subscriptionId]",
            "metadata": {
                "description": "Specifies the subscriptionId of the IoT Hub"
            }
        },
        "resourceGroup": {
            "type": "string",
            "defaultValue": "[resourceGroup().name]",
            "metadata": {
                "description": "Specifies the resourceGroup of the IoT Hub"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "Location for all resources."
            }
        }
    },
    "variables": {
    },
    "resources": [{
            "type": "Microsoft.Kusto/Clusters/Databases/DataConnections",
            "apiVersion": "2019-09-07",
            "name": "[concat(parameters('Clusters_kustocluster_name'), '/', parameters('databases_kustodb_name'), '/', parameters('dataconnections_kustodc_name'))]",
            "location": "[parameters('location')]",
            "kind": "IotHub",
            "properties": {
                "iotHubResourceId": "[resourceId(parameters('subscriptionId'), parameters('resourceGroup'), 'Microsoft.Devices/IotHubs', parameters('IotHubs_iothubdemo_name'))]",
                "consumerGroup": "[parameters('consumergroup_default_name')]",
                "sharedAccessPolicyName": "[parameters('iothubpolices_iothubowner_name')]",
                "tableName": "[parameters('tables_kustotable_name')]",
                "mappingRuleName": "[parameters('mapping_kustomapping_name')]",
                "dataFormat": "[parameters('dataformat_type')]",
                 "databaseRouting": "[parameters('databaseRouting_type')]"
            }
        }
    ]
}

IoT Hub veri bağlantısını kaldırma

IoT Hub bağlantısını Azure portal kaldırmak için aşağıdakileri yapın:

1. Kümenize gidin. Soldaki menüden Veritabanları'nı seçin. Ardından hedef tabloyu içeren veritabanını seçin.
2. Soldaki menüden Veri bağlantıları'nı seçin. Ardından ilgili IoT Hub veri bağlantısının yanındaki onay kutusunu seçin.
3. Üst menü çubuğunda Sil'i seçin.

---

İlgili içerik

• Azure Veri Gezgini web kullanıcı arabiriminde verileri sorgulama