Azure Veri Gezgini için veri akışı uç noktalarını yapılandırma

Azure IoT İşlemleri'nde Azure Veri Gezgini veri göndermek için bir veri akışı uç noktası yapılandırabilirsiniz. Bu yapılandırma, hedef uç noktayı, kimlik doğrulama yöntemini, tabloyu ve diğer ayarları belirtmenize olanak tanır.

Önkoşullar

  • Geliştirme makinenizde yüklü Azure CLI sürüm 2.62.0 veya üzeri. Sürümünüzü denetlemek ve az --version gerekirse güncelleştirmek için kullanınaz upgrade. Daha fazla bilgi için bkz. Azure CLI yükleme.

  • Azure CLI için Azure IoT İşlemleri uzantısı. Uzantıyı eklemek veya en son sürüme güncelleştirmek için aşağıdaki komutu kullanın:

    az extension add --upgrade --name azure-iot-ops
    

Azure Veri Gezgini veritabanı oluşturma

  1. Azure portalında Azure Veri Gezgini tam kümenizde bir veritabanı oluşturun.

  2. Veritabanınızda veriler için bir tablo oluşturun. Azure portalını kullanabilir ve sütunları el ile oluşturabilir veya sorgu sekmesinde KQL kullanabilirsiniz. Örneğin, örnek termostat verilerine yönelik bir tablo oluşturmak için aşağıdaki komutu çalıştırın:

    .create table thermostat (
        externalAssetId: string,
        assetName: string,
        CurrentTemperature: real,
        Pressure: real,
        MqttTopic: string,
        Timestamp: datetime
    )
    
  3. Tablonuzda ve veritabanınızda akış alımını etkinleştirin. Sorgu sekmesinde aşağıdaki komutu çalıştırın ve <DATABASE_NAME> veritabanınızın adını yazın:

    .alter database ['<DATABASE_NAME>'] policy streamingingestion enable
    

    Alternatif olarak, kümenin tamamında akış alımını etkinleştirin. Bkz. Mevcut bir kümede akış alımını etkinleştirme.

Yönetilen kimliğe izin atama

Azure Veri Gezgini için bir veri akışı uç noktası yapılandırmak için kullanıcı tarafından atanan veya sistem tarafından atanan yönetilen kimlik kullanmanızı öneririz. Bu yaklaşım güvenlidir ve kimlik bilgilerini el ile yönetme gereksinimini ortadan kaldırır.

Azure Veri Gezgini veritabanı oluşturulduktan sonra, Azure IoT İşlemleri yönetilen kimliğine veritabanına yazma izni veren bir rol atamanız gerekir.

Sistem tarafından atanan yönetilen kimliği kullanıyorsanız, Azure portalında Azure IoT İşlemleri örneğinize gidin ve Genel Bakış'ı seçin. Azure IoT İşlemleri Arc uzantısından sonra listelenen uzantının adını kopyalayın. Örneğin, azure-iot-operations-xxxx7. Sistem tarafından atanan yönetilen kimliğiniz, Azure IoT İşlemleri Arc uzantısının aynı adı kullanılarak bulunabilir.

  1. Azure Veri Gezgini veritabanınızda (küme değil), Genel Bakış altında İzinler>Ekle seçeneğine tıklayın ve ardından rol olarak Ingestor öğesini seçin. Bu, yönetilen kimliğe Azure Veri Gezgini veritabanına yazmak için gerekli izinleri verir. Daha fazla bilgi için bkz. Rol tabanlı erişim denetimi.
  2. Bulut bağlantıları için ayarlanmış kullanıcı tarafından atanan yönetilen kimliğinizin veya sistem tarafından atanan yönetilen kimliğinizin adını arayın. Örneğin, azure-iot-operations-xxxx7.
  3. Ardından Seç'i seçin.

Azure Veri Gezgini için veri akışı uç noktası oluşturma

  1. İşlem deneyiminde Veri akışı uç noktaları sekmesini seçin.

  2. Yeni veri akışı uç noktası oluştur'un altında, Azure Veri Gezgini>'yi seçin.

    Azure Veri Gezgini veri akışı uç noktası oluşturmak için işlem deneyiminin kullanıldığı ekran görüntüsü.

  3. Uç nokta için aşağıdaki ayarları girin:

    Ayar Tanım
    Ad Veri akışı uç noktasının adı.
    Sunucu Azure Veri Gezgini uç noktasının <cluster>.<region>.kusto.windows.net biçimindeki konak adı.
    Kimlik doğrulama yöntemi Kimlik doğrulaması için kullanılan yöntem. Sistem tarafından atanan yönetilen kimlik'i veya Kullanıcı tarafından atanan yönetilen kimlik'i seçin.
    Müşteri Kimliği Kullanıcıya atanmış yönetilen kimliğin istemci ID'si. Kullanıcı tarafından atanan yönetilen kimlik kullanılıyorsa gereklidir.
    Kiracı kimliği Kullanıcı tarafından atanan yönetilen kimliğin kiracı kimliği. Kullanıcı tarafından atanan yönetilen kimlik kullanılıyorsa gereklidir.
  4. Uç noktayı sağlamak için Uygula'yı seçin.

Kullanılabilir kimlik doğrulama yöntemleri

Azure Veri Gezgini uç noktaları için aşağıdaki kimlik doğrulama yöntemleri kullanılabilir.

Sistem tarafından atanan yönetilen kimlik

Veri akışı uç noktasını yapılandırmadan önce Azure IoT İşlemleri yönetilen kimliğine Azure Veri Gezgini veritabanına yazma izni veren bir rol atayın:

  1. Azure portalında Azure IoT İşlemleri örneğinize gidin ve Genel Bakış'ı seçin.
  2. Azure IoT İşlemleri Arc uzantısından sonra listelenen uzantının adını kopyalayın. Örneğin, azure-iot-operations-xxxx7.
  3. Azure Veri Gezgini veritabanına (küme değil) gidin, Genel Bakış sekmesinde İzinler>'ye tıklayın ve ardından uygun bir rol seçin.
  4. Sistem tarafından atanan yönetilen kimliğinizin adını arayın. Örneğin, azure-iot-operations-xxxx7.
  5. Seç'i seçin.

Ardından, sistem tarafından atanan yönetilen kimlik ayarlarıyla veri akışı uç noktasını yapılandırın.

İşlem deneyimi veri akışı uç noktası ayarları sayfasında Temel sekmesini seçin ve ardından Kimlik doğrulama yöntemi olarak >Sistem tarafından atanan yönetilen kimlik seçeneğini tercih edin.

Sistem tarafından atanan yönetilen kimlik hedef kitlesini geçersiz kılmanız gerekiyorsa, audience ayarını belirtebilirsiniz.

Çoğu durumda, diğer ayarları belirtmeniz gerekmez. Bu yapılandırma, varsayılan hedef kitleye https://api.kusto.windows.netsahip bir yönetilen kimlik oluşturur.

Kullanıcı tarafından atanan yönetilen kimlik

Kimlik doğrulaması için kullanıcı tarafından atanan yönetilen kimliği kullanmak için önce güvenli ayarların etkinleştirildiği Azure IoT İşlemleri'ni dağıtmanız gerekir. Ardından bulut bağlantıları için kullanıcı tarafından atanan bir yönetilen kimlik ayarlamanız gerekir. Daha fazla bilgi edinmek için bkz . Azure IoT İşlemleri dağıtımında güvenli ayarları etkinleştirme.

Veri akışı uç noktasını yapılandırmadan önce kullanıcı tarafından atanan yönetilen kimliğe Azure Veri Gezgini veritabanına yazma izni veren bir rol atayın:

  1. Azure portalında Azure Veri Gezgini veritabanına (küme değil) gidin, Genel Bakış'ın altında İzinler>Ekle seçeneğine tıklayın ve ardından uygun bir rol seçin.
  2. Kullanıcı tarafından atanan yönetilen kimliğinizin adını arayın.
  3. Seç'i seçin.

Ardından, veri akışı uç noktasını kullanıcı tarafından atanan yönetilen kimlik ayarlarıyla yapılandırın.

İşlem deneyimi veri akışı uç noktası ayarları sayfasında, Temel sekmesini seçin, ardından Kimlik doğrulama yöntemi olarak Kullanıcı tarafından atanan yönetilen kimliği seçin.

Uygun alanlara kullanıcı tarafından atanan yönetilen kimlik istemci kimliğini ve kiracı kimliğini girin.

Burada kapsam isteğe bağlıdır ve varsayılan olarak olur https://api.kusto.windows.net/.default. Varsayılan kapsamı geçersiz kılmanız gerekiyorsa scope ayarını, Bicep veya Kubernetes aracılığıyla belirtin.

Gelişmiş ayarlar

Azure Veri Gezgini uç noktası için toplu işlem gecikme süresi ve ileti sayısı gibi gelişmiş ayarlar ayarlayabilirsiniz.

İletilerin batching hedefe gönderilmeden önce en fazla ileti sayısını ve en yüksek gecikme süresini yapılandırmak için ayarları kullanın. Bu ayar, ağ bant genişliği için iyileştirme yapmak ve hedefe yönelik istek sayısını azaltmak istediğinizde kullanışlıdır.

Alan Tanım Gerekli
latencySeconds İletileri hedefe göndermeden önce bekilecek saniye sayısı üst sınırı. Varsayılan değer 60 saniyedir. Hayır
maxMessages Hedefe gönderilecek en fazla ileti sayısı. Varsayılan değer 100000 iletidir. Hayır

Örneğin, en fazla ileti sayısını 1000 ve en fazla gecikme süresini 100 saniye olarak yapılandırmak için aşağıdaki ayarları kullanın:

İşlem deneyiminde, veri akışı uç noktası için Gelişmiş sekmesini seçin.

Azure Veri Gezgini gelişmiş ayarlarını yapmak için işlem deneyiminin kullanıldığı ekran görüntüsü.

Sonraki adımlar

Veri akışları hakkında daha fazla bilgi edinmek için bkz . Veri akışı oluşturma.