Hızlı Başlangıç: IoT Central uygulamasından verileri dışarı aktarma

Bu hızlı başlangıçta IoT Central uygulamanızı verileri Azure Veri Gezgini dışarı aktaracak şekilde yapılandıracaksınız. Azure Veri Gezgini, IoT Tak Çalıştır akıllı telefon uygulaması gibi cihazlardan telemetri verilerini depolamanıza, sorgulamanıza ve işlemenize olanak tanır.

Bu hızlı başlangıçta:

• IoT Central'daki veri dışarı aktarma özelliğini akıllı telefon uygulamasından Azure Veri Gezgini veritabanına telemetriye kullanın.
• Telemetride sorgu çalıştırmak için Azure Veri Gezgini kullanın.

Bu hızlı başlangıcı tamamlamak, Azure Veri Gezgini örneği için Azure hesabınızda küçük bir maliyete neden olur. IoT Central uygulamanızdaki ilk iki cihaz ücretsizdir.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• İlk hızlı başlangıcı tamamlayın Azure IoT Central uygulaması oluşturma. İkinci hızlı başlangıç olan Cihazınız için kuralları ve eylemleri yapılandırma isteğe bağlıdır.
• İlk hızlı başlangıçta seçtiğiniz IoT Central uygulama URL'si ön ekinin Azure IoT Central uygulaması oluşturma işlemine ihtiyacınız vardır.

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

  • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

  • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Azure hizmetlerini yükleme

IoT Central uygulamanızdaki verileri dışarı aktarabilmeniz için önce bir Azure Veri Gezgini kümesine ve veritabanına ihtiyacınız vardır. Bu hızlı başlangıçta, bunları oluşturmak ve yapılandırmak için Azure Cloud Shell'de bir bash betiği çalıştıracaksınız.

Betik aşağıdaki adımları tamamlar:

• REST API çağrılarının kimliğini doğrulamak için taşıyıcı belirteci oluşturabilmesi için Azure aboneliğinizde oturum açmanızı ister.
• Azure Veri Gezgini kümesi ve veritabanı oluşturur.
• IoT Central uygulamanız için yönetilen bir kimlik oluşturur.
• Yönetilen kimliği Azure Veri Gezgini veritabanına erişim izniyle yapılandırılır.
• IoT Central'dan gelen telemetriyi depolamak için veritabanına bir tablo ekler.

Betiği Azure Cloud Shell ortamınıza indirmek için aşağıdaki komutları çalıştırın:

wget https://raw.githubusercontent.com/Azure-Samples/iot-central-docs-samples/main/quickstart-cde/createADX.sh
chmod u+x createADX.sh

Betiği çalıştırmak için aşağıdaki komutu kullanın:

• değerini Azure Veri Gezgini kümeniz için benzersiz bir adla değiştirinCLUSTER_NAME. Küme adı yalnızca küçük harfler ve sayılar içerebilir. Küme adının uzunluğu 4 ile 22 karakter arasında olmalıdır.
• değerini IoT Central uygulamanız için ilk hızlı başlangıçta seçtiğiniz URL ön eki ile değiştirin CENTRAL_URL_PREFIX .
• İstendiğinde, hesabınızda oturum açmak için yönergeleri izleyin. Betiğin oturum açması gerekir çünkü REST API çağrısının kimliğini doğrulamak için bir taşıyıcı belirteci oluşturur.

./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX

Betiğin Azure Veri Gezgini URL çıkışını not edin. Bu değeri hızlı başlangıcın ilerleyen bölümlerinde kullanacaksınız.

Veri dışarı aktarmayı yapılandırma

IoT Central'dan veri dışarı aktarma hedefini yapılandırmak için:

1. IoT Central uygulamanızda Veri dışarı aktarma sayfasına gidin.
2. Hedefler sekmesini ve ardından Hedef ekle'yi seçin.
3. Hedef ad olarak Azure Veri Gezgini girin. Hedef türü olarak Azure Veri Gezgini'ı seçin.
4. Küme URL'si bölümünde, daha önce not aldığınız Azure Veri Gezgini URL'sini girin.
5. Veritabanı adı alanına phonedata girin.
6. Tablo adı alanına hızlandırma girin.
7. Yetkilendirme bölümünde Sistem tarafından atanan yönetilen kimlik'i seçin.
8. Kaydet'i seçin.

Veri dışarı aktarmayı yapılandırmak için:

1. Veri dışarı aktarma sayfasında Dışarı Aktarmalar sekmesini ve ardından Dışarı aktarma ekle'yi seçin.

2. Dışarı aktarma adı olarak Telefon ivmeölçer girin.

3. Dışarı aktaracak veri türü olarak Telemetri'yi seçin.

4. İki filtre eklemek için aşağıdaki tabloda yer alan bilgileri kullanın:

   Veri Akışı Adı	İşleç	Değer
   Cihaz şablonu	Eşittir	mobil IoT Tak Çalıştır
   Algılayıcılar/Hızlandırma/X	Exists	Yok

   Tüm koşullar doğruysa verileri dışarı aktarma seçeneğinin ayarlandığından emin olun.

5. Azure Veri Gezgini hedef olarak ekleyin.

6. Hedefe bir veri dönüşümü ekleyin. Aşağıdaki sorguyu 2'ye ekleyin. Veri dönüştürme sayfasında derleme dönüştürme sorgusu alanı:

   import "iotc" as iotc;
   {
       Device: .device.id,
       EnqueuedTime: .enqueuedTime,
       X: .telemetry | iotc::find(.name == "accelerometer").value.x,
       Y: .telemetry | iotc::find(.name == "accelerometer").value.y,
       Z: .telemetry | iotc::find(.name == "accelerometer").value.z
   }
   

   

   Dönüştürmenin nasıl çalıştığını görmek ve sorguyla denemeler yapmak için aşağıdaki örnek telemetri iletisini 1'e yapıştırın. Giriş iletinizi ekleyin:

   {
     "messageProperties": {},
     "device": {
       "id": "8hltz8xa7n",
       "properties": {
         "reported": []
       },
       "approved": true,
       "types": [],
       "name": "8hltz8xa7n",
       "simulated": false,
       "provisioned": true,
       "modules": [],
       "templateId": "urn:modelDefinition:vlcd3zvzdm:y425jkkpqzeu",
       "templateName": "IoT Plug and Play mobile",
       "organizations": [],
       "cloudProperties": [],
       "blocked": false
     },
     "component": "sensors",
     "applicationId": "00001111-aaaa-2222-bbbb-3333cccc4444",
     "messageSource": "telemetry",
     "telemetry": [
       {
         "id": "dtmi:azureiot:PhoneSensors:__accelerometer;1",
         "name": "accelerometer",
         "value": {
           "x": 0.09960123896598816,
           "y": 0.09541380405426025,
           "z": 9.907781600952148
         }
       }
     ],
     "enqueuedTime": "2021-11-12T10:01:30.588Z",
     "enrichments": {}
   }
   

7. Dönüşümü kaydedin. Ardından veri dışarı aktarma tanımını kaydedin.

Dışarı aktarma durumu Sağlıklı olana kadar bekleyin:

Dışarı aktarılan verileri sorgulama

Dışarı aktarılan telemetriyi sorgulamak için:

1. Azure Veri Gezgini ortamınıza gitmek için daha önce çalıştırdığınız betiğin Azure Veri Gezgini URL çıkışını kullanın.

2. Küme düğümünü genişletin ve phonedata veritabanını seçin. Sorgu penceresinin kapsamı olarak Scope:yourclustername.eastus/phonedatadeğişir.

3. Azure Veri Gezgini'da yeni bir sekme açın ve aşağıdaki Kusto sorgusuna yapıştırın ve ardından çalıştır'ı seçerek ivmeölçer telemetrisini çizin:

['acceleration'] 
    | project EnqueuedTime, Device, X, Y, Z
    | render timechart 

Yeterli veri toplamak için birkaç dakika beklemeniz gerekebilir. Telemetri değerlerinin değiştiğini görmek için telefonunuzu farklı yönlerde bekletmeyi deneyin:

Kaynakları temizleme

Daha fazla IoT Central hızlı başlangıcını veya öğreticisini tamamlamayı planlamıyorsanız IoT Central uygulamanızı silebilirsiniz:

1. IoT Central uygulamanızda Uygulama > Yönetimi'ne gidin.
2. Sil'i seçin ve eyleminizi onaylayın.

Azure Veri Gezgini örneğini aboneliğinizden kaldırmak ve gereksiz yere faturalandırılmamak için Azure portalından IoTCentralExportData-rg kaynak grubunu silin veya Azure Cloud Shell'de aşağıdaki komutu çalıştırın:

az group delete --name IoTCentralExportData-rg

Sonraki adım

Bu hızlı başlangıçta, IoT Central'daki verileri sürekli olarak başka bir Azure hizmetine aktarmayı öğrendiniz.

Artık verilerinizi dışarı aktarmayı bildiğinize göre, önerilen bir sonraki adım: