Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Integration Runtime (IR) ist die Computeinfrastruktur, die Microsoft Purview verwendet, um Datenüberprüfungen in verschiedenen Netzwerkumgebungen durchzuführen.
Eine selbstgehostete Integration Runtime (SHIR) kann verwendet werden, um die Datenquelle in einem lokalen Netzwerk oder einem virtuellen Netzwerk zu überprüfen. Für die Installation einer selbstgehosteten Integration Runtime ist ein lokaler Computer oder ein virtueller Computer innerhalb eines privaten Netzwerks erforderlich.
In diesem Artikel werden sowohl die Einrichtung einer selbstgehosteten Integration Runtime als auch die Problembehandlung und Verwaltung behandelt.
Wichtig
Laden Sie die selbstgehostete Integration Runtime herunter: Microsoft Integration Runtime.
| Weitere Informationen | Finden Sie unter |
|---|---|
| Einrichten einer neuen selbstgehosteten Integration Runtime | Anforderungen an den Computer |
| Quellspezifische Computeranforderungen sind in jedem Quellartikel unter Voraussetzungen aufgeführt | |
| Einrichtungshandbuch | |
| Netzwerk | Netzwerkanforderungen |
| Proxyserver | |
| Private Endpunkte | |
| Problembehandlung für Proxy und Firewall | |
| Fehlerbehebung der Verbindung | |
| Verwaltung | Allgemein |
Hinweis
Die Microsoft Purview-Integration Runtime kann nicht für eine Azure Synapse Analytics oder Azure Data Factory Integration Runtime auf demselben Computer freigegeben werden. Sie muss auf einem separaten Computer installiert werden.
Voraussetzungen
Die folgenden Versionen von Windows werden unterstützt:
- Windows 8.1
- Windows 10
- Windows 11
- Windows Server 2012
- Windows Server 2012 R2
- Windows Server 2016
- Windows Server 2019
- Windows Server 2022
- Windows Server 2025
Die Installation der selbstgehosteten Integration Runtime auf einem Domänencontroller wird nicht unterstützt.
Der FIPS-Modus wird für SHIR-Computer derzeit nicht unterstützt.
Wichtig
Das Scannen einiger Datenquellen erfordert ein zusätzliches Setup auf dem Computer der selbstgehosteten Integration Runtime. Beispielsweise JDK, Visual C++ Redistributable oder ein bestimmter Treiber. Details zu deiner Quelle findest du im jeweiligen Quellartikel . Alle Anforderungen werden im Abschnitt Voraussetzungen aufgeführt.
Zum Hinzufügen und Verwalten einer SHIR in Microsoft Purview benötigen Sie Datenquellenadministratorberechtigungen in Microsoft Purview.
Die selbstgehostete Integration Runtime erfordert ein 64-Bit-Betriebssystem mit .NET Framework 4.7.2 oder höher. Weitere Informationen finden Sie in den Systemanforderungen für .NET Framework.
Die empfohlene Mindestkonfiguration für die selbstgehostete Integration Runtime-Maschine ist ein 2-GHz-Prozessor mit 8 Kernen, 28 GB RAM und 80 GB verfügbarem Festplattenspeicher. Das Scannen einiger Datenquellen erfordert je nach Szenario möglicherweise eine höhere Computerspezifikation. Überprüfen Sie auch die Voraussetzungen im entsprechenden Connectorartikel.
Wenn der Hostcomputer in den Ruhezustand versetzt wird, reagiert die selbstgehostete Integration Runtime nicht auf Datenanforderungen. Konfigurieren Sie einen geeigneten Energiesparplan auf dem Computer, bevor Sie die selbstgehostete Integration Runtime installieren. Wenn der Computer für den Ruhezustand konfiguriert ist, zeigt das Installer der selbstgehosteten Integration Runtime eine Meldung an.
Sie müssen ein Administrator auf dem Computer sein, um die selbstgehostete Integration Runtime erfolgreich installieren und konfigurieren zu können.
Scanausführungen erfolgen mit einer bestimmten Häufigkeit gemäß dem von Ihnen festgelegten Zeitplan. Die Prozessor- und RAM-Nutzung auf dem Computer folgt dem gleichen Muster mit Spitzen- und Leerlaufzeiten. Die Ressourcennutzung hängt auch stark von der Menge der gescannten Daten ab. Wenn mehrere Scanaufträge ausgeführt werden, sehen Sie, dass die Ressourcenauslastung in Spitzenzeiten steigt.
Aktivieren Sie den langen Windows-Pfad standardmäßig, indem Sie die folgenden Schritte ausführen.
Wichtig
Wenn Sie die Self-Hosted Integration Runtime zum Scannen von Parquet-Dateien verwenden, müssen Sie die 64-Bit-Version von JRE 8 (Java Runtime Environment) oder OpenJDK auf Ihrem IR-Computer installieren. Eine Installationsanleitung finden Sie im Abschnitt Java Runtime Environment am Ende der Seite .
Überlegungen zur Verwendung einer selbstgehosteten IR
- Sie können eine einzelne selbstgehostete Integration Runtime verwenden, um mehrere Datenquellen zu scannen.
- Sie können nur eine Instance der selbstgehosteten Integration Runtime auf einem einzelnen Computer installieren. Wenn Sie über zwei Microsoft Purview-Konten verfügen, die lokale Datenquellen überprüfen müssen, installieren Sie die selbstgehostete IR auf zwei Computern, einen für jedes Microsoft Purview-Konto.
- Die selbstgehostete Integration Runtime muss sich nicht auf demselben Computer wie die Datenquelle befinden, es sei denn, sie wird im jeweiligen Quellartikel speziell als Voraussetzung genannt. Wenn sich die selbstgehostete Integration Runtime in der Nähe der Datenquelle befindet, verkürzt sich die Zeit, die für die selbstgehostete Integration Runtime besteht, um eine Verbindung mit der Datenquelle herzustellen.
- Um Speicherplatz zu optimieren, wird empfohlen, die numerischen Ordner zusammen mit den numerischen Ordnern unter den Ordnern "Data Scan" und "MITIlib", die älter als sieben Tage sind, im auf Ihrem Computer generierten Temp-Ordner regelmäßig sauber zu machen.
Einrichten einer selbstgehosteten Integration Runtime
Verwenden Sie die folgenden Verfahren, um eine selbstgehostete Integration Runtime zu erstellen und einzurichten.
Erstellen einer selbstgehosteten Integration Runtime
Hinweis
Zum Hinzufügen oder Verwalten einer SHIR in Microsoft Purview benötigen Sie Datenquellenadministratorberechtigungen in Microsoft Purview.
Wählen Sie auf der Startseite des klassischen Microsoft Purview-Governanceportals im linken Navigationsbereich die Option Datenzuordnung aus.
Wählen Sie unter Quellen und Scannen im linken Bereich die Option Integration Runtimes und dann + Neu aus.
Wählen Sie auf der Seite Integration Runtime-Setupdie Option Selbstgehostet aus, um eine selbstgehostete IR zu erstellen, und wählen Sie dann Weiter aus.
Geben Sie einen Namen für Ihre IR ein, und wählen Sie Erstellen aus.
Führen Sie auf der Einstellungsseite der Integration Runtime die Schritte im Abschnitt Manuelle Einrichtung aus. Sie müssen die Integration Runtime von der Downloadsite auf einen virtuellen Computer oder Computer herunterladen, auf dem Sie sie ausführen möchten.
Kopieren Sie den Authentifizierungsschlüssel, und fügen Sie ihn ein.
Laden Sie die selbstgehostete Integration Runtime von Microsoft Integration Runtime auf einen lokalen Windows-Computer herunter. Führen Sie das Installationsprogramm aus. Selbstgehostete Integration Runtime-Versionen wie 5.4.7803.1 und 5.6.7795.1 werden unterstützt.
Fügen Sie auf der Seite "Integration Runtime (selbstgehostet))" einen der beiden zuvor gespeicherten Schlüssel ein, und wählen Sie "Registrieren" aus.
Wählen Sie auf der Seite Neuer Knoten der Integration Runtime (selbstgehostet) die Option Fertig stellen aus.
Nachdem die selbstgehostete Integration Runtime erfolgreich registriert wurde, sehen Sie das folgende Fenster:
Sie können mehrere Knoten für eine selbstgehostete Integration Runtime mit demselben Schlüssel registrieren. Weitere Informationen finden Sie unter Hochverfügbarkeit und Skalierbarkeit.
Verwalten einer selbstgehosteten Integration Runtime
Sie können eine selbstgehostete Integration Runtime bearbeiten, indem Sie im klassischen Microsoft Purview-Governanceportal zu Integration Runtimes navigieren, indem Sie auf die IR zeigen und dann Bearbeiten auswählen.
- Auf der Registerkarte Einstellungen können Sie die Beschreibung aktualisieren, den Schlüssel kopieren oder neue Schlüssel neu generieren.
- Auf der Registerkarte Knoten sehen Sie eine Liste der registrierten Knoten zusammen mit dem Status, der IP-Adresse und der Option zum Löschen von Knoten. Weitere Informationen finden Sie unter Hochverfügbarkeit und Skalierbarkeit.
- Auf der Registerkarte Version können Sie den Status der IR-Version anzeigen. Weitere Informationen finden Sie unter Selbstgehostete Integration Runtime automatische Aktualisierung und Ablaufbenachrichtigung.
Sie können eine selbstgehostete Integration Runtime löschen, indem Sie zu Integration Runtimes navigieren, den Mauszeiger auf die IR bewegen und dann die Schaltfläche Löschen auswählen.
Symbole und Benachrichtigungen im Infobereich
Wenn Sie den Mauszeiger über das Symbol oder die Meldung im Infobereich bewegen, können Sie Details zum Status der selbstgehosteten Integration Runtime sehen.
Dienstkonto für selbstgehostete Integration Runtime
Das Standardanmeldedienstkonto der selbstgehosteten Integration Runtime ist NT SERVICE\DIAHostService. Sie können es unter Dienste -> Integration Runtime Dienst -> Eigenschaften -> Anmelden sehen.
Stellen Sie sicher, dass das Konto über die Berechtigung zur Anmeldung als Dienst verfügt. Andernfalls kann die selbstgehostete Integration Runtime nicht erfolgreich gestartet werden. Sie können die Berechtigung unter Lokale Sicherheitsrichtlinie -> Sicherheitseinstellungen -> Lokale Richtlinien -> Zuweisen von Benutzerrechten -> Als Dienst anmelden
Hochverfügbarkeit und Skalierbarkeit
Sie können eine selbstgehostete Integration Runtime mehreren lokalen Computern oder virtuellen Computern in Azure zuordnen. Diese Computer werden Knoten genannt. Sie können bis zu vier Knoten mit einer selbstgehosteten Integration Runtime verknüpfen. Mehrere Knoten bieten folgende Vorteile:
- Höhere Verfügbarkeit der selbstgehosteten Integration Runtime, sodass sie nicht mehr der Single Point of Failure für den Scan ist. Diese Verfügbarkeit trägt dazu bei, die Kontinuität zu gewährleisten, wenn Sie bis zu vier Knoten verwenden.
- Es kann mehr gleichzeitige Scans ausgeführt werden. Jede selbstgehostete Integration Runtime kann mehrere Scanausführungen gleichzeitig ermöglichen, die automatisch basierend auf der CPU/dem Arbeitsspeicher des Computers bestimmt werden. Sie können weitere Knoten installieren, wenn Sie mehr Parallelität benötigen.
- Beim Scannen von Quellen wie Azure Blob, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2 und Azure Files kann jeder Scanlauf alle diese Knoten verwenden, um die Scanleistung zu steigern. Für andere Quellen wird der Scan auf einem der Knoten ausgeführt.
Sie können mehrere Knoten zuordnen, indem Sie die selbstgehostete Integration Runtime-Software aus dem Download Center installieren. Registrieren Sie es dann mit demselben Authentifizierungsschlüssel.
Hinweis
Bevor Sie einen weiteren Knoten aus Gründen der Hochverfügbarkeit und Skalierbarkeit hinzufügen, stellen Sie sicher, dass die Option für den Remotezugriff auf das Intranet auf dem ersten Knoten aktiviert ist. Wählen Sie dazu Microsoft Integration Runtime Konfigurations-Manager>Einstellungen>Remotezugriff auf das Intranet.
Netzwerkanforderungen
Ihr selbstgehosteter Integration Runtime-Computer muss eine Verbindung mit mehreren Ressourcen herstellen, um ordnungsgemäß zu funktionieren:
- Die Microsoft Purview-Dienste, die zum Verwalten der selbstgehosteten Integration Runtime verwendet werden.
- Die Datenquellen, die Sie mit der selbstgehosteten Integration Runtime überprüfen möchten.
- Wenn Ihr Konto vor dem 15. Dezember 2023 erstellt wurde, muss Ihre Integration Runtime eine Verbindung mit dem von Microsoft Purview erstellten verwalteten Speicherkonto herstellen können. Wenn Ihr Konto nach diesem Datum erstellt (oder mit API-Version 2023-05-01-Preview bereitgestellt wird), wird ein Speicherkonto für die Erfassung verwendet. Microsoft Purview verwendet diese Ressource unter anderem zum Erfassen der Überprüfungsergebnisse.
Es gibt zwei Firewalls, die Sie berücksichtigen müssen:
- Die Unternehmensfirewall, die auf dem zentralen Router der organization ausgeführt wird
- Die Windows-Firewall , die auf dem lokalen Computer, auf dem die selbstgehostete Integration Runtime installiert ist, als Daemon konfiguriert ist
Hier sind die Domänen und ausgehenden Ports aufgeführt, die Sie sowohl in Unternehmens- als auch in Windows-/Computerfirewalls zulassen müssen.
Tipp
- Fügen Sie für Domänen, die mit "<managed_storage_account>" aufgeführt sind, den Namen der verwalteten Ressourcen hinzu, die Ihrem Microsoft Purview-Konto zugeordnet sind. Sie finden sie im Azure-Portal –> Ihr Microsoft Purview-Konto –>Einstellungen – Registerkarte Verwaltete> Ressourcen.
- Wenn Ihr Konto nicht über ein verwaltetes Speicherkonto verfügt, wird der Aufnahmespeicher verwendet. Weitere Informationen zu den Domänen mit "<ingestion_storage_account>" finden Sie in der untenstehenden Tabelle. Die Speicherinformationen finden Sie unter Azure-Portal ->Eigenschaften ->Erfassungsspeicher-ID. Um die Endpunktdetails zu überprüfen, wechseln Sie zu Übersicht ->JSON-Ansicht -> Eigenschaft "primaryEndpoint".
| Domänennamen | Ausgehende Ports | Beschreibung |
|---|---|---|
Public Cloud: *.frontend.clouddatahub.netAzure Government: *.frontend.datamovement.azure.usChina: *.frontend.datamovement.azure.cn |
443 | Erforderlich, um eine Verbindung mit dem Microsoft Purview-Dienst herzustellen. Derzeit ist ein Platzhalter erforderlich, da es keine dedizierte Ressource gibt. |
Public Cloud: *.servicebus.windows.netAzure Government: *.servicebus.usgovcloudapi.netChina: *.servicebus.chinacloudapi.cn |
443 | Erforderlich für das Einrichten der Überprüfung im klassischen Microsoft Purview-Governanceportal. Dieser Endpunkt wird für die interaktive Dokumenterstellung von der Benutzeroberfläche aus verwendet, z. B. zum Testen der Verbindung, Durchsuchen von Ordnerlisten und Tabellenlisten für den Bereichsscan. Informationen zum Vermeiden der Verwendung von Platzhaltern finden Sie unter Abrufen der URL von Azure Relay. |
Public Cloud: <tenantId>-api.purview-service.microsoft.comAzure Government: <tenantId>-api.purview-service.microsoft.usChina: <tenantId>-api.purview-service.microsoft.cn |
443 | Erforderlich, um eine Verbindung mit dem Microsoft Purview-Dienst herzustellen. Wenn Sie private Purview-Endpunkte verwenden, wird dieser Endpunkt durch den privaten Plattformendpunkt abgedeckt. |
Public Cloud: <purview_account>.purview.azure.comAzure Government: <purview-account>.purview.azure.usChina: <purview_account>.purview.azure.cn |
443 | Erforderlich, um eine Verbindung mit dem Microsoft Purview-Dienst herzustellen. Wenn Sie private Purview-Endpunkte verwenden, wird dieser Endpunkt vom privaten Endpunkt des Kontos abgedeckt. |
Public Cloud: <managed_storage_account>.blob.core.windows.net oder <ingestion_storage_account>.*.blob.storage.azure.netAzure Government: <managed_storage_account>. blob.core.usgovcloudapi.net oder<ingestion_storage_account>. blob.core.usgovcloudapi.netChina: <managed_storage_account>.blob.core.chinacloudapi.cnoder <ingestion_storage_account>.blob.core.chinacloudapi.cn |
443 | Erforderlich, um eine Verbindung mit dem von Microsoft Purview verwalteten Azure-Blobspeicherkonto herzustellen. Wenn Sie private Purview-Endpunkte verwenden, wird dieser Endpunkt durch den privaten Endpunkt der Erfassung abgedeckt. |
Public Cloud: <managed_storage_account>.queue.core.windows.net oder <ingestion_storage_account>.*.queue.storage.azure.netAzure Government: <managed_storage_account>. queue.core.usgovcloudapi.net oder<ingestion_storage_account>. queue.core.usgovcloudapi.netChina: <managed_storage_account>.queue.core.chinacloudapi.cnoder <ingestion_storage_account>.queue.core.chinacloudapi.cn |
443 | Erforderlich, um eine Verbindung mit dem von Microsoft Purview verwalteten Azure Queue-Speicherkonto herzustellen. Wenn Sie private Purview-Endpunkte verwenden, wird dieser Endpunkt durch den privaten Endpunkt der Erfassung abgedeckt. |
download.microsoft.com |
443 | Erforderlich, um die selbstgehosteten Integration Runtime-Updates herunterzuladen. Wenn Sie die automatische Aktualisierung deaktiviert haben, können Sie die Konfiguration dieser Domäne überspringen. |
Public Cloud: login.windows.net und login.microsoftonline.comAzure Government: login.microsoftonline.usChina: login.partner.microsoftonline.cn |
443 | Erforderlich, um sich bei der Microsoft Entra ID anzumelden. |
Hinweis
Da Azure Relay derzeit keine Servicetags unterstützt, müssen Sie für die Kommunikation mit Azure Relay Diensttag-AzureCloud oder Internet in NSG-Regeln verwenden.
Je nachdem, welche Quellen Sie überprüfen möchten, müssen Sie auch andere Domänen und ausgehende Ports für andere Azure- oder externe Quellen zulassen. Hier finden Sie einige Beispiele:
| Domänennamen | Ausgehende Ports | Beschreibung |
|---|---|---|
<your_storage_account>.dfs.core.windows.net |
443 | Beim Scannen von Azure Data Lake Store Gen 2. |
<your_storage_account>.blob.core.windows.net |
443 | Wann Azure Blob Storage scannen. |
<your_sql_server>.database.windows.net |
1433 | Wann die Azure SQL-Datenbank gescannt wird. |
*.powerbi.com und *.analysis.windows.net |
443 | Wann Power BI-Mandant scannen. |
<your_ADLS_account>.azuredatalakestore.net |
443 | Wann Scan Azure Data Lake Store Gen 1. |
| Verschiedene Domänen | Abhängig | Domänen und Ports für alle anderen Quellen zu speichern, die vom SHIR gescannt werden. |
Für einige Clouddatenspeicher wie Azure SQL-Datenbank und Azure Storage müssen Sie möglicherweise die IP-Adresse des Computers mit der selbstgehosteten Integration Runtime in der Firewallkonfiguration zulassen, oder Sie können einen privaten Endpunkt des Diensts im Netzwerk Ihrer selbstgehosteten Integration Runtime erstellen.
Wichtig
In den meisten Umgebungen müssen Sie außerdem sicherstellen, dass Ihr DNS korrekt konfiguriert ist. Zur Bestätigung können Sie nslookup von Ihrem SHIR-Computer aus verwenden, um die Konnektivität mit jeder der Domänen zu überprüfen. Jeder nslookup sollte die IP der Ressource zurückgeben. Wenn Sie private Endpunkte verwenden, sollte die private IP-Adresse zurückgegeben werden und nicht die öffentliche IP-Adresse. Wenn keine IP-Adresse zurückgegeben wird oder wenn bei Verwendung privater Endpunkte die öffentliche IP-Adresse zurückgegeben wird, müssen Sie Ihre DNS/VNET-Zuordnung oder Ihr Privater Endpunkt/VNET-Peering ansprechen.
Abrufen der URL von Azure Relay
Eine erforderliche Domäne und ein Port, die in die Zulassungsliste Ihrer Firewall aufgenommen werden müssen, sind für die Kommunikation mit Azure Relay. Die selbstgehostete Integration Runtime verwendet es für interaktives Authoring, z. B. zum Testen einer Verbindung und zum Durchsuchen einer Ordner-/Tabellenliste. Wenn Sie .servicebus.windows.net nicht zulassen möchten und spezifischere URLs haben möchten, können Sie alle FQDNs sehen, die für Ihre selbstgehostete Integration Runtime erforderlich sind. Gehen Sie folgendermaßen vor:
Wechseln Sie zum klassischen Microsoft Purview-Governanceportal –> Datenzuordnung –> Integration Runtimes, und bearbeiten Sie Ihre selbstgehostete Integration Runtime.
Wählen Sie auf der Seite Bearbeiten die Registerkarte Knoten aus.
Wählen Sie Dienst-URLs anzeigen , um alle FQDNs abzurufen.
Sie können diese FQDNs in der Zulassungsliste der Firewallregeln hinzufügen.
Hinweis
Einzelheiten zum Azure Relay Connections-Protokoll finden Sie unter Azure Relay Hybrid Connections-Protokoll.
Überlegungen zu Proxyservern
Wenn Ihre Unternehmensnetzwerk-Umgebung einen Proxyserver für den Zugriff auf das Internet verwendet, konfigurieren Sie die selbstgehostete Integration Runtime für die Verwendung geeigneter Proxyeinstellungen. Sie können den Proxy während der ersten Registrierungsphase oder nach der Registrierung festlegen.
Nach der Konfiguration verwendet die selbstgehostete Integration Runtime den Proxyserver, um eine Verbindung mit den Diensten herzustellen, die das HTTP- oder HTTPS-Protokoll verwenden. Aus diesem Grund wählen Sie bei der Ersteinrichtung "Link ändern " aus.
Es gibt zwei unterstützte Konfigurationsoptionen von Microsoft Purview:
- Verwenden Sie keinen Proxy: Die selbstgehostete Integration Runtime verwendet nicht explizit einen Proxy, um eine Verbindung mit Clouddiensten herzustellen.
- Systemproxy verwenden: Die selbstgehostete Integration Runtime verwendet die Proxyeinstellung, die in den Konfigurationsdateien der ausführbaren Datei konfiguriert ist. Wenn in diesen Dateien kein Proxy angegeben ist, stellt die selbstgehostete Integration Runtime eine direkte Verbindung zu den Diensten her, ohne einen Proxy zu verwenden.
- Benutzerdefinierten Proxy verwenden: Konfigurieren Sie die HTTP-Proxyeinstellung so, dass sie für die selbstgehostete Integration Runtime verwendet wird, anstatt Konfigurationen in diahost.exe.config und diawp.exe.config zu verwenden. Adress - und Portwerte sind erforderlich. Die Werte für Benutzername und Kennwort sind je nach Authentifizierungseinstellung Ihres Proxys optional. Alle Einstellungen werden in der selbstgehosteten Integration Runtime mit Windows DPAPI verschlüsselt und lokal auf dem Computer gespeichert.
Hinweis
Die Verbindung mit Datenquellen über einen Proxy wird für andere Connectors als Azure Datenquellen und Power BI nicht unterstützt.
Der Integration Runtime-Hostdienst wird automatisch neu gestartet, nachdem Sie die aktualisierten Proxyeinstellungen gespeichert haben.
Wenn Sie nach der Registrierung der selbstgehosteten Integration Runtime Proxyeinstellungen anzeigen oder aktualisieren möchten, verwenden Sie Microsoft Integration Runtime Konfigurations-Manager.
- Öffnen Sie Microsoft Integration Runtime Konfigurations-Manager.
- Wählen Sie die Registerkarte Einstellungen.
- Wählen Sie unter HTTP-Proxy den Link Ändern aus, um das Dialogfeld HTTP-Proxy festlegen zu öffnen.
- Wählen Sie Weiter aus. Anschließend wird eine Warnung angezeigt, in der Sie um Ihre Berechtigung gebeten werden, die Proxyeinstellung zu speichern und den Integration Runtime-Hostdienst neu zu starten.
Hinweis
Wenn Sie einen Proxyserver mit NTLM-Authentifizierung einrichten, wird der Integration Runtime-Hostdienst unter dem Domänenkonto ausgeführt. Wenn Sie später das Kennwort für das Domänenkonto ändern, denken Sie daran, die Konfigurationseinstellungen für den Dienst zu aktualisieren und den Dienst neu zu starten. Aufgrund dieser Anforderung wird empfohlen, über ein dediziertes Domänenkonto auf den Proxyserver zuzugreifen, bei dem Sie das Kennwort nicht häufig aktualisieren müssen.
Wenn Sie den Systemproxy verwenden, stellen Sie sicher, dass Ihr Proxyserver ausgehenden Datenverkehr für die Netzwerkregeln zulässt.
Konfigurieren von Proxyservereinstellungen
Wenn Sie die Option Systemproxy verwenden für den HTTP-Proxy auswählen, verwendet die selbstgehostete Integration Runtime die Proxyeinstellungen in den folgenden vier Dateien unter dem Pfad C:\Program Files\Microsoft Integration Runtime\5.0\, um unterschiedliche Vorgänge auszuführen:
- .\Shared\diahost.exe.config
- .\Shared\diawp.exe.config
- .\Gateway\DataScan\Microsoft.DataMap.Agent.exe.config
- .\Gateway\DataScan\DataTransfer\Microsoft.DataMap.Agent.Connectors.Azure.DataFactory.ServiceHost.exe.config
Wenn in diesen Dateien kein Proxy angegeben ist, stellt die selbstgehostete Integration Runtime eine direkte Verbindung zu den Diensten her, ohne einen Proxy zu verwenden.
Das folgende Verfahren enthält Anweisungen zum Aktualisieren der diahost.exe.config Datei.
Erstellen Sie in Explorer eine sichere Kopie von C:\Program Files\Microsoft Integration Runtime\5.0\Shared\diahost.exe.config als Sicherung der Originaldatei.
Öffnen Sie Notepad als Administrator.
Öffnen Sie im Editor die Textdatei C:\Program Files\Microsoft Integration Runtime\5.0\Shared\diahost.exe.config.
Suchen Sie den Standard-system.net Tag, wie im folgenden Code gezeigt:
<system.net> <defaultProxy useDefaultCredentials="true" /> </system.net>Anschließend können Sie Proxyserverdetails hinzufügen, wie im folgenden Beispiel gezeigt:
<system.net> <defaultProxy> <proxy bypassonlocal="true" proxyaddress="<your proxy server e.g. http://proxy.domain.org:8888/>" /> </defaultProxy> </system.net>Das Proxy-Tag ermöglicht es anderen Eigenschaften, erforderliche Einstellungen wie
scriptLocationanzugeben. Siehe <Proxy-Element> (Netzwerkeinstellungen) für die Syntax.<proxy autoDetect="true|false|unspecified" bypassonlocal="true|false|unspecified" proxyaddress="uriString" scriptLocation="uriString" usesystemdefault="true|false|unspecified "/>Speichern Sie die Konfigurationsdatei an ihrem ursprünglichen Speicherort.
Wiederholen Sie den gleichen Vorgang, um diawp.exe.config und Microsoft.DataMap.Agent.exe.config Dateien zu aktualisieren.
Wechseln Sie dann zum Pfad C:\Program Files\Microsoft Integration Runtime\5.0\Gateway\DataScan\DataTransfer, erstellen Sie eine Datei mit dem Namen "Microsoft.DataMap.Agent.Connectors.Azure.DataFactory.ServiceHost.exe.config", und konfigurieren Sie die Proxyeinstellung wie folgt. Sie können die Einstellungen auch wie oben beschrieben erweitern.
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.net>
<defaultProxy>
<proxy bypassonlocal="true" proxyaddress="<your proxy server e.g. http://proxy.domain.org:8888/>" />
</defaultProxy>
</system.net>
</configuration>
Lokaler Datenverkehr muss vom Proxy ausgeschlossen werden, z. B. wenn sich Ihr Microsoft Purview-Konto hinter privaten Endpunkten befindet. Aktualisieren Sie in solchen Fällen die folgenden vier Dateien unter dem Pfad, um die Umgehungsliste C:\Program Files\Microsoft Integration Runtime\5.0\ mit der erforderlichen Umgehungsliste einzuschließen:
- .\Shared\diahost.exe.config
- .\Shared\diawp.exe.config
- .\Gateway\DataScan\Microsoft.DataMap.Agent.exe.config
- .\Gateway\DataScan\DataTransfer\Microsoft.DataMap.Agent.Connectors.Azure.DataFactory.ServiceHost.exe.config
Ein Beispiel für die Umgehungsliste zum Scannen einer Azure SQL-Datenbank und ADLS gen 2-Speicher:
<system.net>
<defaultProxy>
<bypasslist>
<add address="scaneastus4123.blob.core.windows.net" />
<add address="scaneastus4123.queue.core.windows.net" />
<add address="Atlas-abc12345-1234-abcd-a73c-394243a566fa.servicebus.windows.net" />
<add address="contosopurview123.purview.azure.com" />
<add address="contososqlsrv123.database.windows.net" />
<add address="contosoadls123.dfs.core.windows.net" />
<add address="contosoakv123.vault.azure.net" />
</bypasslist>
<proxy proxyaddress=http://proxy.domain.org:8888 bypassonlocal="True" />
</defaultProxy>
</system.net>
Starten Sie den Hostdienst der selbstgehosteten Integration Runtime neu, der die Änderungen aufnimmt. Um den Dienst neu zu starten, verwenden Sie das Dienste-Applet aus der Systemsteuerung. Oder wählen Sie im Integration Runtime Konfigurations-Manager die Schaltfläche "Dienst beenden" und dann "Dienst starten" aus. Wenn der Dienst nicht gestartet wird, haben Sie wahrscheinlich eine falsche XML-Tagsyntax in der Anwendungskonfigurationsdatei hinzugefügt, die Sie bearbeitet haben.
Wichtig
Vergessen Sie nicht, alle vier oben genannten Dateien zu aktualisieren.
Außerdem müssen Sie sicherstellen, dass Microsoft Azure in der Zulassungsliste Ihres Unternehmens enthalten ist. Sie können die Liste der gültigen Azure-IP-Adressen herunterladen. IP-Bereiche für jede Cloud, aufgeschlüsselt nach Region und nach den markierten Diensten in dieser Cloud, sind jetzt auf MS Download verfügbar:
Mögliche Symptome für Probleme im Zusammenhang mit der Firewall und dem Proxyserver
Wenn Fehlermeldungen wie die folgenden angezeigt werden, ist der wahrscheinliche Grund eine falsche Konfiguration der Firewall oder des Proxyservers. Eine solche Konfiguration verhindert, dass die selbstgehostete Integration Runtime eine Verbindung mit Microsoft Purview-Diensten herstellt. Um sicherzustellen, dass Ihre Firewall und Proxyserver ordnungsgemäß konfiguriert sind, lesen Sie den vorherigen Abschnitt.
Wenn Sie versuchen, die selbstgehostete Integration Runtime zu registrieren, wird die folgende Fehlermeldung angezeigt: "Fehler beim Registrieren dieses Integration Runtime-Knotens! Stellen Sie sicher, dass der Authentifizierungsschlüssel gültig ist und der Integration Service-Hostdienst auf diesem Computer ausgeführt wird."
Wenn Sie Integration Runtime Konfigurations-Manager öffnen, wird die status "Getrennt" oder "Verbindung wird hergestellt" angezeigt. Wenn Sie Windows-Ereignisprotokolle anzeigen, sehen Sie unter Ereignisanzeige>Anwendungs- und Dienstprotokolle>Microsoft Integration Runtime Fehlermeldungen wie die folgende:
Unable to connect to the remote server A component of Integration Runtime has become unresponsive and restarts automatically. Component name: Integration Runtime (Self-hosted)
Java Runtime Environment Installation
Wenn Sie Parquet-Dateien mithilfe der selbstgehosteten Integration Runtime mit Microsoft Purview scannen, müssen Sie entweder die Java Runtime Environment oder OpenJDK auf Ihrem selbstgehosteten IR-Computer installieren.
Beim Scannen von Parquet-Dateien mit der selbstgehosteten IR lokalisiert der Dienst die Java-Laufzeit, indem er zunächst die Registrierung (HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment\{Current Version}\JavaHome) auf JRE überprüft, falls nicht gefunden, und zweitens die Systemvariable JAVA_HOME für OpenJDK überprüft. Sie können JAVA_HOME unter Systemeinstellungen, Umgebungsvariablen auf Ihrem Computer festlegen. Erstellen oder bearbeiten Sie die Variable JAVA_HOME, um auf die Java JRE auf Ihrem Computer zu verweisen. Beispiel: C:\Program Files\Java\jdk1.8\jre
- So verwenden Sie JRE: Die 64-Bit-IR erfordert 64-Bit-JRE. Sie finden es hier.
- So verwenden Sie OpenJDK: Es wird seit IR-Version 3.13 unterstützt. Packen Sie die jvm.dll mit allen anderen erforderlichen Assemblys von OpenJDK in eine selbstgehostete IR-Maschine, und legen Sie die Systemumgebungsvariable entsprechend JAVA_HOME.
So überprüfen Sie die Version der selbstgehosteten Integration Runtime
Sie können die Version Ihrer selbstgehosteten Integration Runtime im klassischen Microsoft Purview-Governanceportal> – Datenzuordnung –> Integration Runtimes überprüfen:
Sie können die Version auch in Ihrem selbstgehosteten Integration Runtime-Client überprüfen –> Registerkarte Hilfe.
Automatische Aktualisierung der selbstgehosteten Integration Runtime
Die automatische Aktualisierung ist standardmäßig aktiviert, wenn Sie eine selbstgehostete Integration Runtime installieren. Sie haben zwei Möglichkeiten, die Version der selbstgehosteten Integration Runtime zu verwalten: automatisch aktualisieren oder manuell verwalten. In der Regel veröffentlicht Microsoft Purview jeden Monat zwei neue Versionen der selbstgehosteten Integration Runtime, die neue Featurereleases, Fehlerbehebungen oder Verbesserungen enthalten. Daher empfehlen wir Benutzern, auf eine neuere Version zu aktualisieren, um die neuesten Funktionen und Verbesserungen zu erhalten.
Die selbstgehostete Integration Runtime wird automatisch auf eine neuere Version aktualisiert. Wenn eine neue Version verfügbar ist, obwohl sie noch nicht für Ihre Instance geplant ist, können Sie das Update auch über das Portal auslösen.
Hinweis
Wenn Sie über mehrere selbstgehostete Integration Runtime-Knoten verfügen, gibt es während des automatischen Updates keine Ausfallzeiten. Die automatische Aktualisierung erfolgt zuerst in einem Knoten, während andere an Aufgaben arbeiten. Wenn der erste Knoten das Update abgeschlossen hat, übernimmt er die verbleibenden Aufgaben, wenn andere Knoten aktualisiert werden. Wenn Sie nur über einen selbstgehosteten Integration Runtime-Knoten verfügen, tritt während des automatischen Updates eine gewisse Downtime auf.
AutoUpdate-Version im Vergleich zur neuesten Version
Um die Stabilität der selbstgehosteten Integration Runtime sicherzustellen, veröffentlichen wir zwar zwei Versionen, aber nur eine Version pro Monat. Daher stellen Sie manchmal fest, dass die AutoUpdate-Version die vorherige Version der tatsächlichen neuesten Version ist. Wenn Sie die neueste Version erhalten möchten, können Sie zum Download-Center gehen und dies manuell tun. Darüber hinaus wird die automatische Aktualisierung auf eine neue Version vom Dienst verwaltet und kann nicht geändert werden.
Auf der Registerkarte "Version" der selbstgehosteten Integration Runtime im klassischen Microsoft Purview-Governanceportal wird die neuere Version angezeigt, wenn die aktuelle Version alt ist. Wenn Ihre selbstgehostete Integration Runtime online ist, ist diese Version die AutoUpdate-Version und aktualisiert Ihre selbstgehostete Integration Runtime automatisch zum geplanten Zeitpunkt. Wenn Ihre selbstgehostete Integration Runtime jedoch offline ist, wird auf der Seite nur die neuere Version angezeigt.
Wenn Sie über mehrere Knoten verfügen und aus irgendeinem Grund, warum einige von ihnen nicht erfolgreich automatisch aktualisiert werden. Dann werden diese Knoten auf die Version zurückgesetzt, die vor dem automatischen Update auf allen Knoten gleich war.
Ablauf der selbstgehosteten Integration Runtime
Jede Version der selbstgehosteten Integration Runtime läuft in einem Jahr ab. Die ablaufende Nachricht wird 90 Tage vor Ablauf im klassischen Microsoft Purview-Governanceportal und im selbstgehosteten Integration Runtime-Client angezeigt.