Konfigurowanie łącznika dla OPC UA

Serwery OPC UA to aplikacje oprogramowania komunikujące się z elementami zawartości. Serwery OPC UA uwidaczniają punkty danych OPC UA reprezentujące punkty danych. Punkty danych OPC UA zapewniają dane historyczne dotyczące stanu, wydajności, jakości lub stanu zasobów w czasie rzeczywistym.

Zasób w operacjach usługi Azure IoT to jednostka logiczna tworzona do reprezentowania zasobu fizycznego lub urządzenia. Zasób operacji usługi Azure IoT może mieć właściwości niestandardowe, punkty danych, strumienie i zdarzenia, które opisują jego zachowanie i cechy. Zasób jest skojarzony z co najmniej jednym urządzeniiem. Operacje usługi Azure IoT przechowują definicje zasobów w rejestrze urządzeń platformy Azure.

Urządzenie w usłudze Azure IoT Operations to jednostka logiczna, która definiuje połączenia z fizycznymi elementami zawartości lub urządzeniami. Bez urządzenia dane nie mogą przepływać z urządzenia fizycznego ani zasobu do brokera MQTT. Podczas konfigurowania urządzenia i zasobu zostanie nawiązane połączenie z fizycznym zasobem lub urządzeniem i wartościami punktów danych, zdarzeniami i strumieniami przybywanymi do wystąpienia operacji usługi Azure IoT. Urządzenie ma co najmniej jeden przychodzący punkt końcowy. Operacje usługi Azure IoT przechowują definicje urządzeń w rejestrze urządzeń platformy Azure.

W tym artykule opisano sposób używania internetowego interfejsu użytkownika środowiska operacji i interfejsu wiersza polecenia platformy Azure do:

• Zdefiniuj urządzenia łączące serwery OPC UA z wystąpieniem operacji usługi Azure IoT.
• Dodaj zasoby i zdefiniuj punkty danych i zdarzenia, aby umożliwić przepływ danych z serwerów OPC UA do brokera MQTT.

Te zasoby, punkty danych i zdarzenia mapują dane przychodzące z serwerów OPC UA na przyjazne nazwy, których można użyć w brokerze MQTT i przepływach danych.

Łącznik może używać uwierzytelniania anonymous lub username password podczas nawiązywania połączenia z serwerem OPC UA.

Wymagania wstępne

Aby skonfigurować urządzenia i zasoby, potrzebna jest instancja usługi Azure IoT Operations.

Aby zalogować się do internetowego interfejsu użytkownika środowiska operacji, musisz mieć konto Microsoft Entra ID z co najmniej uprawnieniami współautora dla grupy zasobów zawierającej wystąpienie usługi Kubernetes — Azure Arc . Nie można zalogować się przy użyciu konta Microsoft (MSA). Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z dostępem do internetowego interfejsu użytkownika środowiska operacji.

Administrator IT musi skonfigurować szablon łącznika OPC UA dla wystąpienia operacji usługi Azure IoT w witrynie Azure Portal.

Serwer OPC UA, z którego można uzyskać dostęp z klastra operacji usługi Azure IoT. Jeśli nie masz serwera OPC UA, użyj symulatora OPC PLC z repozytorium przykładów operacji usługi Azure IoT.

Tworzenie urządzenia

Wdrożenie operacji usługi Azure IoT może obejmować przykładowy symulator OPC PLC. Aby utworzyć urządzenie korzystające z symulatora OPC PLC:

Środowisko operacji

1. Wybierz pozycję urządzenia , a następnie pozycję Utwórz urządzenie:

   

   Wskazówka

   Aby wyszukać urządzenia, możesz użyć pola filtru.

2. Na stronie Podstawowe wprowadź nazwę urządzenia i wybierz pozycję Nowy na kafelku Microsoft.OpcUa , aby dodać punkt końcowy dla urządzenia:

   

3. Wprowadź informacje o punkcie końcowym. Aby na przykład użyć symulatora OPC PLC, wprowadź następujące wartości:

   (No changes needed)	Wartość
   Nazwa	opc-ua-connector-0
   Łącznik dla adresu URL OPC UA	opc.tcp://opcplc-000000:50000
   Uwierzytelnianie użytkownika	Anonymous

4. Wybierz pozycję Dalej i na stronie Dodatkowe informacje wprowadź wszelkie właściwości niestandardowe dla urządzenia.

5. Wybierz pozycję Dalej , aby przejrzeć szczegóły urządzenia. Następnie wybierz Utwórz.

Interfejs wiersza polecenia platformy Azure

Uruchom następujące polecenia:

az iot ops ns device create -n opc-ua-connector-cli -g {your resource group name} --instance {your instance name} 

az iot ops ns device endpoint inbound add opcua --device opc-ua-connector-cli -g {your resource group name} -i {your instance name} --name opc-ua-connector-0 --endpoint-address "opc.tcp://opcplc-000000:50000"

Aby dowiedzieć się więcej, zobacz az iot ops ns device.

Ta konfiguracja wdraża nowy device zasób wywoływany opc-ua-connector w klastrze z przychodzącym punktem końcowym o nazwie opc-ua-connector-0.

Gdy symulator OPC PLC jest uruchomiony, dane przepływa z symulatora do łącznika OPC UA, a następnie do brokera MQTT.

Konfigurowanie urządzenia do używania nazwy użytkownika i hasła

W poprzednim przykładzie używany jest Anonymous tryb uwierzytelniania. Ten tryb nie wymaga nazwy użytkownika ani hasła.

Aby użyć UsernamePassword trybu uwierzytelniania, wykonaj następujące kroki:

Środowisko operacji

Wykonaj kroki opisane w Zarządzanie wpisami tajnymi dla wdrożenia operacji usługi Azure IoT, aby dodać wpisy tajne dla nazwy użytkownika i hasła w usłudze Azure Key Vault, wdrożyć je w klastrze Kubernetes i odwoływać się do nich z konfiguracji urządzenia.

Interfejs wiersza polecenia platformy Azure

1. Wykonaj kroki opisane w artykule Zarządzanie wpisami tajnymi dla wdrożenia operacji usługi Azure IoT , aby dodać wpisy tajne dla nazwy użytkownika i hasła w usłudze Azure Key Vault, a następnie przeprojektuj je do klastra Kubernetes.

2. Użyj polecenia az iot ops ns device endpoint inbound add z parametrami --user-ref i --pass-ref, aby dodać odwołania do tajemnic usługi Azure Key Vault, które utworzyłeś.

Inne opcje zabezpieczeń

Aby zarządzać listą zaufanych certyfikatów dla łącznika OPC UA, zobacz Zarządzanie certyfikatami na potrzeby komunikacji zewnętrznej.

Podczas tworzenia przychodzącego punktu końcowego możesz również wybrać następujące opcje:

Option	Typ	Opis
Automatyczne akceptowanie niezaufanego certyfikatu serwera	Yes/No	Automatyczne akceptowanie niezaufanych certyfikatów serwera
Zasady zabezpieczeń	Rozwijana	Zasady zabezpieczeń używane do ustanawiania bezpiecznego kanału z serwerem OPC UA
Tryb zabezpieczeń	Rozwijana	Tryb zabezpieczeń używany do komunikowania się w bezpiecznym kanale z serwerem OPC UA

Dodaj zasób, punkty danych i zdarzenia

Środowisko operacji

Aby dodać element zawartości w środowisku operacji:

1. Wybierz kartę Zasoby . Przed utworzeniem jakichkolwiek zasobów zostanie wyświetlony następujący ekran:

   

   Wskazówka

   Możesz użyć pola filtru, aby wyszukać zasoby.

2. Wybierz Utwórz zasób.

3. Na ekranie szczegółów zasobu wprowadź następujące informacje o zasobie:

   • Przychodzący punkt końcowy. Wybierz punkt końcowy ruchu przychodzącego urządzenia z listy.
   • Nazwa zasobu
   • Opis

4. Skonfiguruj zestaw właściwości niestandardowych, które chcesz skojarzyć z zasobem. Możesz zaakceptować domyślną listę właściwości lub dodać własne. Domyślnie dostępne są następujące właściwości:

   • Producent
   • Identyfikator URI producenta
   • Model
   • Kod produktu
   • Wersja sprzętu
   • Wersja oprogramowania
   • Numer seryjny
   • Identyfikator URI dokumentacji

   

5. Wybierz przycisk Dalej , aby przejść do strony Zestawy danych .

Dodawanie zestawu danych do zasobu

Zestaw danych określa, gdzie łącznik wysyła dane zbierane z kolekcji punktów danych. Zasób OPC UA może zawierać wiele zestawów danych. Aby utworzyć zestaw danych:

1. Wybierz pozycję Utwórz zestaw danych.

2. Wprowadź szczegóły zestawu danych, takie jak jego nazwa i miejsce docelowe. W przypadku zasobów OPC UA miejsce docelowe jest tematem MQTT. Przykład:

   

   Użyj pola Instancji początkowej, aby określić węzeł początkowy do rozpoznawania względnych ścieżek przeglądania punktów danych w zestawie danych. Aby uzyskać więcej informacji, zobacz Dynamiczne rozwiązywanie problemów z węzłami przy użyciu ścieżek przeglądania.

3. Wybierz Utwórz i dalej, aby utworzyć zestaw danych.

Wskazówka

Użyj opcji Zarządzaj ustawieniami domyślnymi , aby skonfigurować domyślne ustawienia zestawu danych, takie jak interwał publikowania, interwał próbkowania i rozmiar kolejki.

Dodawanie poszczególnych punktów danych do zestawu danych

Ważne

Nazwa _ErrorMessage punktu danych jest zarezerwowana i nie powinna być używana.

Teraz możesz zdefiniować punkty danych skojarzone z zestawem danych. Aby dodać punkty danych OPC UA:

1. Wybierz pozycję Dodaj punkt danych.

2. Wprowadź szczegóły punktu danych:

   • Źródło danych. Ta wartość to identyfikator węzła z serwera OPC UA.
   • Nazwa punktu danych (opcjonalnie). Ta wartość to przyjazna nazwa, której chcesz użyć dla punktu danych. Jeśli nie określisz nazwy punktu danych, identyfikator węzła będzie używany jako nazwa punktu danych.
   • Interwał próbkowania (milisekundy). Możesz zastąpić wartość domyślną dla tego punktu danych.
   • Rozmiar kolejki. Możesz zastąpić wartość domyślną dla tego punktu danych.

   

   W poniższej tabeli przedstawiono przykładowe wartości punktów danych, których można użyć z wbudowanym symulatorem OPC PLC:

   Źródło danych	Nazwa punktu danych
   ns=3; s=FastUInt10	Temperatura
   ns=3; s=FastUInt100	Wilgotność

   Uwaga / Notatka

   Jeśli używasz względnych ścieżek przeglądania w celu rozpoznania węzłów dynamicznych, pole Źródło danych zawiera względną ścieżkę przeglądania. Aby uzyskać więcej informacji, zobacz Dynamiczne rozwiązywanie problemów z węzłami przy użyciu ścieżek przeglądania.

3. Na stronie punktów danych wybierz pozycję Dalej , aby przejść do strony Dodawanie zdarzeń .

Interfejs wiersza polecenia platformy Azure

Użyj następujących poleceń, aby dodać zasób termostatu do urządzenia za pomocą Azure CLI. Polecenia dodają zestaw danych i dwa punkty danych do zasobu za pomocą polecenia point add.

# Create the asset
az iot ops ns asset opcua create --name thermostat --instance {your instance name} -g  {your resource group name} --device opc-ua-connector --endpoint opc-ua-connector-0  --description 'A simulated thermostat asset'

# Add the dataset
az iot ops ns asset opcua dataset add --asset thermostat --instance {your instance name} -g {your resource group name} --name oven --data-source "ns=3;s=FastUInt10" --dest topic="azure-iot-operations/data/thermostat" retain=Keep qos=Qos1 ttl=3600

# Add the data points
az iot ops ns asset opcua datapoint add --asset thermostat --instance {your instance name} -g {your resource group name} --dataset oven --name temperature --data-source "ns=3;s=FastUInt10"
az iot ops ns asset opcua datapoint add --asset thermostat --instance {your instance name} -g {your resource group name} --dataset oven --name humidity --data-source "ns=3;s=FastUInt100"

# Show the dataset and datapoints
az iot ops ns asset opcua dataset show --asset thermostat -n default -g {your resource group name} --instance {your instance name}

Podczas tworzenia zasobu przy użyciu interfejsu wiersza polecenia platformy Azure można zdefiniować następujące elementy:

• Użyj polecenia point add wielokrotnie, aby przetworzyć wiele punktów danych.
• Wiele zdarzeń przy użyciu parametru --event wiele razy.
• Opcjonalne informacje dotyczące zasobu, takie jak:
  • Producent
  • Identyfikator URI producenta
  • Model
  • Kod produktu
  • Wersja sprzętu
  • Wersja oprogramowania
  • Numer seryjny
  • Identyfikator URI dokumentacji
• Wartości domyślne interwału próbkowania, interwału publikowania i rozmiaru kolejki.
• Wartości specyficzne dla punktu danych dla interwału próbkowania, interwału publikowania i rozmiaru kolejki.
• Wartości specyficzne dla zdarzenia dla interwału publikowania próbkowania i rozmiaru kolejki.
• Tryb obserwacji dla każdego punktu danych i zdarzenia

Dodawanie poszczególnych zdarzeń do zasobu

Teraz możesz zdefiniować zdarzenia skojarzone z zasobem. Aby dodać zdarzenia OPC UA w środowisku operacji:

1. Utwórz grupę zdarzeń, wybierając pozycję Utwórz grupę zdarzeń.

2. Wybierz pozycję Dodaj zdarzenie.

3. Wprowadź szczegóły zdarzenia:

   • Powiadomienie o zdarzeniach. Ta wartość jest powiadomieniem o zdarzeniach z serwera OPC UA.
   • Nazwa zdarzenia (opcjonalnie). Ta wartość to przyjazna nazwa, której chcesz użyć dla zdarzenia. Jeśli nie określisz nazwy zdarzenia, powiadomienie o zdarzeniu będzie używane jako nazwa zdarzenia.
   • Interwał publikowania (milisekundy). Możesz zastąpić wartość domyślną dla tego punktu danych.
   • Interwał próbkowania (milisekundy). Możesz zastąpić wartość domyślną dla tego punktu danych.
   • Rozmiar kolejki. Możesz zastąpić wartość domyślną dla tego punktu danych.
   • Liczba klatek kluczowych. Możesz zastąpić wartość domyślną dla tego punktu danych.

   

   Uwaga / Notatka

   Aby dynamicznie rozwiązywać identyfikatory węzłów, użyj pola Uruchom instancję, aby określić identyfikator węzła początkowego, i pola Źródło danych, aby określić względną ścieżkę przeszukiwania. Aby uzyskać więcej informacji, zobacz Dynamiczne rozwiązywanie problemów z węzłami przy użyciu ścieżek przeglądania.

4. Wybierz pozycję Zarządzaj ustawieniami domyślnymi, aby skonfigurować domyślne ustawienia zdarzeń dla zasobu. Te ustawienia dotyczą wszystkich zdarzeń OPC UA należących do zasobu. Możesz zastąpić te ustawienia dla każdego dodanego zdarzenia. Domyślne ustawienia zdarzeń obejmują:

   • Interwał publikowania (milisekund): szybkość publikowania danych przez serwer OPC UA.
   • Rozmiar kolejki: głębokość kolejki do przechowywania danych próbkowania przed ich opublikowaniem.

Filtry zdarzeń

Zdefiniuj filtry zdarzeń, aby dostosować informacje zawarte w powiadomieniach o zdarzeniach z serwera. Domyślnie serwer wysyła wybór standardowych pól w powiadomieniach o zdarzeniach. Dokładny wybór jest określany przez serwer dla typu zdarzenia. Przykład:

{
    "EventId":"OkaXYhfr20yUoj1QBbzcIg==",
    "EventType":"i=2130",
    "SourceNode":"i=2253",
    "SourceName":"WestTank",
    "Time":"2025-10-10T15:09:13.3946878Z",
    "ReceiveTime":"2025-10-10T15:09:13.3946881Z",
    "Message":"Raising Events",
    "Severity":500
}

Użyj filtru zdarzeń, aby:

• Uwzględnij dodatkowe pola w powiadomieniach o zdarzeniach.
• Wyklucz pola z powiadomień o zdarzeniach.
• Modyfikowanie nazw pól w powiadomieniach o zdarzeniach.

Poniższy zrzut ekranu przedstawia przykładowy filtr zdarzeń:

Pełny filtr zdarzeń pokazany na poprzednim zrzucie ekranu definiuje cztery pola wyjściowe:

Ścieżka przeglądania	Identyfikator definicji typu	Identyfikator pola
EventId	ns=0;i=2041	myEventId
EventType	ns=0;i=2041	pusta strona
SourceName	pusta strona	mySourceName
Severity	pusta strona	pusta strona

Trzy właściwości wiersza filtru to:

• Ścieżka przeglądania. Wymagana wartość identyfikująca plik źródłowy do uwzględnienia w powiadomieniu o przesłaniu dalej zdarzenia.
• Identyfikator definicji typu. Opcjonalna wartość określająca definicję typu OPC UA pola źródłowego.
• Identyfikator pola. Opcjonalna wartość określająca nazwę do użycia dla pola w przesłanym dalej powiadomieniu o zdarzeniu. Jeśli nie określisz identyfikatora pola, zostanie użyta oryginalna nazwa pola.

Wynikowy komunikat przekazany przez łącznik wygląda teraz następująco:

{
    "myEventId":"OkaXYhfr20yUoj1QBbzcIg==",
    "EventType":"i=2130",
    "mySourceName":"WestTank",
    "Severity":500
}

Przeglądanie zmian

Przejrzyj swój zasób, punkt danych OPC UA oraz szczegóły zdarzenia i wprowadź wszelkie potrzebne korekty.

Aktualizowanie zasobu

Środowisko operacji

Znajdź i wybierz utworzony wcześniej zasób. Użyj kart Szczegóły zasobu, punkty danych i Zdarzenia , aby wprowadzić zmiany:

Na karcie Wyświetlanie punktów danych dla zestawu danych można dodawać punkty danych, aktualizować istniejące punkty danych lub usuwać punkty danych.

Aby zaktualizować punkt danych, wybierz istniejący punkt danych i zaktualizuj informacje o punkcie danych. Następnie wybierz pozycję Aktualizuj:

Aby usunąć punkty danych, wybierz co najmniej jeden punkt danych, a następnie wybierz pozycję Usuń punkty danych:

Możesz również dodawać, aktualizować i usuwać zdarzenia i właściwości w taki sam sposób.

Po zakończeniu wprowadzania zmian wybierz pozycję Zapisz , aby zapisać zmiany.

Interfejs wiersza polecenia platformy Azure

Aby wyświetlić listę zasobów skojarzonych z określonym punktem końcowym, użyj następującego polecenia:

az iot ops ns asset query --device {your device name} --endpoint-name {your endpoint name}

Wskazówka

Możesz uściślić polecenie zapytania, aby wyszukać zasoby zgodne z określonymi kryteriami. Możesz na przykład wyszukać zasoby według producenta.

Aby wyświetlić szczegóły zasobu termostatu, użyj następującego polecenia:

az iot ops ns asset show --name thermostat --instance {your instance name} -g {your resource group}

Aby zaktualizować zasób, użyj az iot ops ns asset opcua update polecenia . Aby na przykład zaktualizować opis zasobu, użyj polecenia podobnego do następującego przykładu:

az iot ops ns asset opcua update --name thermostat --instance {your instance name} -g {your resource group} --description "Updated factory PLC"

Aby wyświetlić listę punktów danych zasobu termostatu w zestawie danych, użyj następującego polecenia:

az iot ops ns asset opcua dataset show --asset thermostat --name default -g {your resource group} --instance {your instance name}

Aby wyświetlić listę zdarzeń aktywów termostatu, użyj następującego polecenia:

az iot ops ns asset opcua event list --asset thermostat -g {your resource group} --instance {your instance name}

Aby dodać nowy punkt danych do zasobu termostatu, użyj polecenia takiego jak w poniższym przykładzie:

az iot ops ns asset opcua dataset point add --asset thermostat --instance {your instance name} -g {your resource group name} --dataset default --name humidity --data-source "ns=3;s=FastUInt100"

Aby usunąć punkt danych, użyj az iot ops ns asset opcua dataset point remove polecenia .

Zdarzenia zasobu można zarządzać przy użyciu az iot ops ns asset opcua event poleceń .

Usuwanie elementu zawartości

Środowisko operacji

Aby usunąć zasób, wybierz zasób, który chcesz usunąć. Na stronie Szczegóły zasobu wybierz pozycję Usuń. Potwierdź zmiany w celu usunięcia elementu zawartości:

Interfejs wiersza polecenia platformy Azure

Aby usunąć zasób, użyj polecenia, które wygląda jak w poniższym przykładzie:

az iot ops ns asset delete --name thermostat -g {your resource group name} --instance {your instance name}

Treści powiązane

• Zarządzanie konfiguracjami zasobów i urządzeń
• Łącznik dla OPC UA — omówienie
• zasób operacji IoT w systemie Az
• urządzenie operacyjne IoT az