Automatisieren von Abfragedatenexporten nach Azure

Artikel
10/26/2023

Mit Microsoft Entra ID können Sie den Export von Abfragedaten aus Microsoft Viva Insights in Workplace Analytics automatisieren. Dazu können Sie einen OData-Abfragelink in Workplace Analytics verwenden, um eine Verbindung mit einem Azure-Datenspeicher Ihrer Wahl herzustellen und automatisch zu aktualisieren, z. B. über Azure Data Factory oder Azure Synapse Analytics.

Auswählen eines Setuppfads

Verwenden Sie zum Einrichten der automatisierten OData-Verbindung zwischen Abfragedaten und einem Azure-Datenspeicher einen der folgenden Pfade, um eine neue Azure-Analyse-App zu erstellen und zu konfigurieren, die unternehmensspezifische Informationen (Geheimnisse) zu Ihrem privaten Netzwerk und Ihrem ausgewählten Datenspeicher benötigt.

Einrichten mit Azure Data Factory Benutzeroberfläche: Dieser Pfad führt Sie durch das Erstellen und Registrieren einer App und das Erstellen einer Data Factory für den Datenexport über die Azure Data Factory-Benutzeroberfläche.
Einrichten mit Azure Synapse Analytics: Dieser Pfad führt Sie durch das Erstellen und Registrieren einer App und das Erstellen einer OData-Pipeline zum Exportieren von Abfragedaten über die Azure Synapse Analytics.
Einrichten mit Azure PowerShell: Dieser Pfad automatisiert den End-to-End-Prozess über PowerShell mit vordefinierten Skripts, die die App erstellen und registrieren, zur Eingabe der spezifischen Parameter Ihres organization auffordern und die Data Factory erstellen und bereitstellen.

Voraussetzungen

Viva Insights oder Workplace Analytics-Analyst: Muss einer Lizenz und einer Analystenrolle für Viva Insights oder Workplace Analytics zugewiesen sein und Abfrageergebnisse mit den Daten haben, die Sie exportieren möchten.
Microsoft Azure-Abonnement : Wenn Sie kein Azure-Abonnement haben, erstellen Sie jetzt ein kostenloses Konto . Für dieses Setup verwenden Sie Microsoft Entra ID, den OData-Connector und Data Factory.
Azure-Datenspeicher : Ihr Datenspeicher muss vom OData-Connector unterstützt werden.
Azure-Administrator : Sie benötigen Azure-Administratorrechte, um die App in Azure zu erstellen und zu registrieren. Außerdem müssen Sie den globalen Azure-Administrator bitten, Ihnen Berechtigungen in Azure Data Factory zu erteilen, um Ihre neue App mit dem Azure-Datenspeicher zu verbinden.

So richten Sie die benutzeroberfläche Azure Data Factory ein

In den folgenden Schritten erfahren Sie, wie Sie den Export von Workplace Analytics-Abfragedaten in den Azure-Datenspeicher Ihrer Wahl mit der Azure Data Factory-Benutzeroberfläche automatisieren. Führen Sie die folgenden Schritte in Verbindung mit der Azure-Dokumentation aus, um dieses Setup abzuschließen.

Führen Sie die Schritte unter Registrieren einer Anwendung mithilfe des Azure-Portal aus, um eine neue Analyse-App in Microsoft Entra ID zu erstellen und zu registrieren.
Wählen Sie in Microsoft Entra App-Registrierungen die App aus Schritt 1 aus, und erteilen Sie ihr dann Berechtigungen für den Zugriff auf Workplace Analytics, indem Sie API-Berechtigungen anzeigen und dann Berechtigung hinzufügen auswählen.
Geben Sie den Namen oder die ID der Workplace Analytics-App ein, suchen Sie nach dem Namen der Workplace Analytics-App , und wählen Sie dann den entsprechenden Namen aus der Liste aus.

So suchen Sie die Anwendungs-ID (Client):
- Wählen Sie in Active Directoryalle Anwendungen aus, und geben Sie dann Workplace Analytics für die Unternehmens-App ein, die Sie verwenden möchten.
- Wählen Sie es aus der Liste aus.
- Kopieren Sie unter Anwendungs-ID die ID, und fügen Sie sie in die APIs ein, die mein organization suchfeld verwendet.
Wählen Sie unter API-Berechtigungen anforderndie Option Anwendungsberechtigungen aus, wählen Sie Analyst und dann Berechtigungen hinzufügen aus.
Unter API-Berechtigungen muss der globale Administrator Administratoreinwilligung für [Workplace Analytics...] erteilen auswählen, bevor Sie mit dem nächsten Schritt fortfahren können.
Führen Sie die Schritte unter Erstellen einer Data Factory aus, um eine neue Analytics Data Factory in Microsoft Entra ID zu erstellen.
Wählen Sie in der Azure Data Factory Übersichtdie Option & Monitor erstellen aus, um Azure Data Factory zu öffnen.

Hinweis

Lassen Sie alle Browserfenster geöffnet, da Sie zwischen ihnen wechseln müssen, um die folgenden Schritte auszuführen.
Wählen Sie Azure Data FactoryPipeline erstellen aus.
Wählen Sie die Auslassungspunkte (...) neben Datasets und dann Neues Dataset aus. Weitere Informationen finden Sie unter Datasets in Azure Data Factory.
Geben Sie unter Datenspeicher auswählen die Zeichenfolge odata ein, und wählen Sie dann OData aus.
Geben Sie unter Allgemein einen Namen und eine Beschreibung für die Abfragedaten ein, mit der Sie eine Verknüpfung herstellen.
Wählen Sie Verbindung aus, wählen Sie Neu aus, und geben Sie dann einen Namen und eine Beschreibung für den OData-Link ein, z . B. WPA_Odata_Collab.
Wählen Sie unter Verbinden über Integration Runtimedie Option AutoResolveIntegrationRuntime aus.
Wählen Sie in Workplace Analytics die OptionErgebnisse des Abfrage-Designers>analysieren>aus, und kopieren Sie dann den OData-Link für die Abfragedaten, die Sie mit Azure verbinden möchten.

Wichtig

Bei automatisch aktualisierten Daten müssen Sie eine Verknüpfung mit einer Abfrage herstellen, die die Option Automatische Aktualisierung in Workplace Analytics verwendet. Für statische Abfrageergebnisse müssen Sie jedes Mal einen neuen OData-Link eingeben, um die Abfragedaten im verbundenen Azure-Datenspeicher zu aktualisieren.
Fügen Sie unter Dienst-URL den OData-Abfragelink ein, den Sie im vorherigen Schritt kopiert haben.
Geben Sie in Microsoft Entra Ressource einhttps://workplaceanalytics.office.com.
Wählen Sie in Active Directoryübersicht für die neue App aus, und kopieren Sie dann die Anwendungs-ID (Client-ID).
Kopieren Sie in Azure Data Factory>Neue id des verknüpftenDienstprinzipals> die Client-ID. Weitere Informationen finden Sie unter Screenshot, der die Eigenschaften des verknüpften Diensts zeigt.
Wählen Sie unter Authentifizierungstyp entweder Microsoft Entra Dienstprinzipal mit Schlüssel oder Microsoft Entra Dienstprinzipal mit Zertifikat aus. Lassen Sie den neuen verknüpften Dienst (OData) in einem separaten Browserfenster geöffnet. Ausführliche Informationen zu diesen Optionen finden Sie unter Verwenden von Azure Key Vault-Geheimnissen in Pipelineaktivitäten.
Wählen Sie in Microsoft Entra ID>Ihr neu registrierten Analyse-AppZertifikate & Geheimnisse aus, und führen Sie dann eine der folgenden Aktionen aus.
- Wählen Sie unter Schlüsselauthentifizierungdie Option Neuer geheimer Clientschlüssel aus, und geben Sie unter Geheimen Clientschlüssel hinzufügen eine Beschreibung ein, wählen Sie den Zeitpunkt des Ablaufs aus, und wählen Sie dann Hinzufügen aus. Wählen Sie unter Geheime Clientschlüssel das neue Geheimnis und dann das Symbol Kopieren aus, um es zu kopieren.
- Wählen Sie für Zertifikatauthentifizierung (bevorzugt für höhere Sicherheit) ein Zertifikat aus, und kopieren Sie es.
Führen Sie in Azure Data Factory die folgenden Schritte für den entsprechenden Authentifizierungstyp aus:
- Fügen Sie für Dienstprinzipalschlüssel den neuen geheimen Clientschlüssel ein, den Sie im vorherigen Schritt unter Dienstprinzipalschlüssel kopiert haben.
- Kopieren Sie für Azure Key Vault das Zertifikat und die anderen erforderlichen Informationen, und fügen Sie es ein. Weitere Informationen finden Sie unter Festlegen und Abrufen eines Geheimnisses aus Azure Key Vault.
Wählen Sie Verbindung testen aus, um den verknüpften OData-Dienst zu testen.
Wenn Verbindung erfolgreich angezeigt wird, wählen Sie Erstellen aus.
Wählen Sie unter Verknüpfter Verbindungsdienst> für den neuen verknüpften OData-Dienst das neue Dataset aus, das Sie soeben in den vorherigen Schritten erstellt haben.
Wählen Sie unter Verbindungspfad>die Option Bearbeiten aus, und geben Sie dann den Namen der Entitätsmenge ein. Um ihn zu finden, kopieren Sie den OData-Abfragelink aus denErgebnissen des WorkplaceAnalytics-Abfrage-Designers>>analysieren>, und öffnen Sie den Abfragelink in einem neuen Browserfenster. Suchen Sie nach Metadaten , um den Entitätsnamen zu finden, der nach $metadata# angezeigt wird. Der in dieser Grafik gezeigte Entitätssatzname lautet z. B. Personen:
Wählen Sie Datenvorschau für den Pfad aus, um zu bestätigen, dass Sie die richtige Entität eingegeben haben.
Bestätigen Sie in Azure Data Factory>Eigenschaften den Namen und die Beschreibung für dieses neue Dataset.
Wählen Sie oben Alle veröffentlichen und dann Veröffentlichen aus.
Erstellen Sie in Pipelines eine neue Pipeline, die das neue OData-Dataset verwenden kann, um die Abfragedaten in die externe Ressource zu kopieren. Weitere Informationen finden Sie unter Erstellen einer Pipeline.
Wählen Sie für die neue Pipeline Quelle und unter Quelldataset den Namen des neuen OData-Datasets und unter Abfrage verwenden die Option Tabelle aus.
Erstellen Sie einen verknüpften Dienst für den Datenspeicher, in den Sie exportieren möchten. Weitere Informationen finden Sie unter Verknüpfte Dienste.
Wählen Sie in Azure Data Factory>Authentifizierung die neue Pipeline aus, und wählen Sie dann Trigger>jetzt hinzufügen aus, um die zuletzt veröffentlichte Pipeline manuell auszuführen, wie in der folgenden Grafik dargestellt. Sie können auch einen Trigger für diese neue Pipeline planen, indem Sie Trigger>hinzufügen Neu/Neu bearbeiten> auswählen und die erforderlichen Informationen dafür ausfüllen. Ausführliche Informationen finden Sie unter Pipelineausführung und Trigger in Azure Data Factory.
Wählen Sie unterSenkensenkedataset> den Namen des verknüpften Diensts aus, den Sie in einem vorherigen Schritt erstellt haben.

Sie können diese neue Data Factory dann verwenden, um auf Abfragedaten aus Workplace Analytics zuzugreifen und sie mithilfe der Azure Resource Manager-Vorlage in ihren ausgewählten Datenspeicher (Blobspeicher) zu kopieren. Sie können diese neue App im Laufe der Zeit für mehrere Projekte wiederverwenden, ohne diese Schritte wiederholen zu müssen. Sie können die erstellte Data Factory auch für neue Pipelines wiederverwenden.

So richten Sie Azure Synapse Analytics ein

In den folgenden Schritten erfahren Sie, wie Sie den Export von Workplace Analytics-Abfragedaten in den Azure-Datenspeicher Ihrer Wahl mit dem Azure Synapse Analytics automatisieren. Führen Sie die folgenden Schritte in Verbindung mit der Azure-Dokumentation aus, um dieses Setup abzuschließen.

Führen Sie die Schritte unter Registrieren einer Anwendung mithilfe des Azure-Portal aus, um eine neue Analyse-App in Microsoft Entra ID zu erstellen und zu registrieren.
Wählen Sie in Microsoft Entra App-Registrierungen die App aus Schritt 1 aus, und erteilen Sie ihr dann Berechtigungen für den Zugriff auf Workplace Analytics, indem Sie API-Berechtigungen anzeigen und dann Berechtigung hinzufügen auswählen.
Geben Sie workplace Analytics oder Viva Insights App-Namen oder -ID ein, und suchen Sie danach, und wählen Sie dann den entsprechenden Namen aus der Liste aus.

So suchen Sie die Anwendungs-ID (Client):
- Wählen Sie in Active Directoryalle Anwendungen aus, und geben Sie dann Workplace Analytics oder Viva Insights für die Unternehmens-App ein, die Sie verwenden möchten.
- Wählen Sie es aus der Liste aus.
- Kopieren Sie unter Anwendungs-ID die ID, und fügen Sie sie in die APIs ein, die mein organization suchfeld verwendet.
Wählen Sie unter API-Berechtigungen anforderndie Option Anwendungsberechtigungen aus, wählen Sie Analyst und dann Berechtigungen hinzufügen aus.
Unter API-Berechtigungen muss der globale Administrator Administratoreinwilligung für [Workplace Analytics...] erteilen auswählen, bevor Sie mit dem nächsten Schritt fortfahren können.
Führen Sie die Schritte unter Erstellen eines Synapse-Arbeitsbereichs aus, um einen neuen Synapse-Arbeitsbereich in Ihrem Azure-Portal zu erstellen.
Wählen Sie in der Azure Synapse-Ressource im Portal Synapse Studio öffnen aus, um den Azure Synapse Arbeitsbereich zu öffnen.

Hinweis

Lassen Sie alle Browserfenster geöffnet, da Sie zwischen ihnen wechseln müssen, um die folgenden Schritte auszuführen.
Wählen Sie in Azure Synapse StudioIntegrieren aus, und fügen Sie dann eine Pipeline hinzu.
Wählen Sie im Neuen Menü Pipelineaktivitäten die Option Verschieben und Transformieren aus, und ziehen Sie dann daten kopieren in Ihren Pipelinearbeitsbereich.
Wählen Sie die Auslassungspunkte (...) neben Datasets und dann Neues Dataset aus.
Fügen Sie im Abschnitt Quelle eine neue Quelle hinzu.
Geben Sie unter Neues Integrationsdatasetdie Zeichenfolge odata ein, und wählen Sie dann OData aus.
Geben Sie unter Eigenschaften festlegen einen Namen ein, und erstellen Sie einen neuen verknüpften Dienst.
Geben Sie unter Neuer verknüpfter Dienst (Odata) einen Namen und eine Beschreibung für die Abfragedaten ein, mit der Sie eine Verknüpfung herstellen.
Wählen Sie unter Verbinden über Integration Runtimedie Option AutoResolveIntegrationRuntime aus.
Wählen Sie in Viva Insights in Workplace Analytics die OptionErgebnisse des Abfrage-Designers>analysieren>aus, und kopieren Sie dann den OData-Link für die Abfragedaten, die Sie mit Azure verbinden möchten.

Wichtig

Bei automatisch aktualisierten Daten müssen Sie eine Verknüpfung mit einer Abfrage herstellen, die die Option Automatische Aktualisierung verwendet. Für statische Abfrageergebnisse müssen Sie jedes Mal einen neuen OData-Link eingeben, um die Abfragedaten im verbundenen Azure-Datenspeicher zu aktualisieren.
Fügen Sie in Azure Synapse Neue verknüpfte Dienst-URL den OData-Abfragelink ein, den Sie im vorherigen Schritt kopiert haben.
Geben Sie in Microsoft Entra Ressource einhttps://workplaceanalytics.office.com.
Wählen Sie in Active Directoryübersicht für die neue App aus, und kopieren Sie dann die Anwendungs-ID (Client-ID).
Kopieren Sie in Azure Synapse Studio>Neuer verknüpfter Dienst (Odata)>Dienstprinzipal-ID die Client-ID. Weitere Informationen finden Sie unter Eigenschaften des verknüpften Diensts.
Wählen Sie unter Authentifizierungstyp entweder Microsoft Entra Dienstprinzipal mit Schlüssel oder Microsoft Entra Dienstprinzipal mit Zertifikat aus. Lassen Sie den neuen verknüpften Dienst (OData) in einem separaten Browserfenster geöffnet. Ausführliche Informationen zu diesen Optionen finden Sie unter Verwenden von Azure Key Vault-Geheimnissen in Pipelineaktivitäten.
Wählen Sie in Microsoft Entra ID>Ihr neu registrierten Analyse-AppZertifikate & Geheimnisse aus, und führen Sie dann eine der folgenden Aktionen aus.
- Wählen Sie für Schlüsselauthentifizierungdie Option Neuer geheimer Clientschlüssel aus, und geben Sie dann unter Geheimen Clientschlüssel hinzufügen eine Beschreibung ein, wählen Sie den Zeitpunkt des Ablaufs aus, und wählen Sie dann Hinzufügen aus. Wählen Sie unter Geheime Clientschlüssel das neue Geheimnis und dann das Symbol Kopieren aus, um es zu kopieren.
- Wählen Sie für Zertifikatauthentifizierung (bevorzugt für höhere Sicherheit) ein Zertifikat aus, und kopieren Sie es.
Führen Sie in Azure Synapse Studio die folgenden Schritte für den entsprechenden Authentifizierungstyp aus:
- Fügen Sie für Dienstprinzipalschlüssel den neuen geheimen Clientschlüssel ein, den Sie im vorherigen Schritt unter Dienstprinzipalschlüssel kopiert haben.
- Kopieren Sie für Azure Key Vault das Zertifikat und die anderen erforderlichen Informationen, und fügen Sie es ein. Weitere Informationen finden Sie unter Festlegen und Abrufen eines Geheimnisses aus Azure Key Vault.
Wählen Sie Verbindung testen aus, um den verknüpften OData-Dienst zu testen.
Wenn Verbindung erfolgreich angezeigt wird, wählen Sie Erstellen aus.
Wählen Sie unter Eigenschaften>für verknüpften Dienst festlegen für den neuen verknüpften OData-Dienst den neuen verknüpften Dienst aus, den Sie soeben in den vorherigen Schritten erstellt haben.
Wählen Sie unter Quellpfad>die Option Bearbeiten aus, und geben Sie dann den Namen der Entitätsmenge ein. Um ihn zu finden, kopieren Sie den OData-Abfragelink aus denErgebnissen des WorkplaceAnalytics-Abfrage-Designers>>analysieren>, und öffnen Sie den Abfragelink in einem neuen Browserfenster. Suchen Sie dann nach Metadaten , um den Entitätsnamen zu finden, der nach $metadata# angezeigt wird. Der in dieser Grafik gezeigte Entitätssatzname lautet z. B. Personen:
Wählen Sie Datenvorschau für den Pfad aus, um zu bestätigen, dass Sie die richtige Entität eingegeben haben.
Fügen Sie im Abschnitt Senke ein neues Senkendataset hinzu, wählen Sie im Neuen IntegrationsdatasetAzure Data Lake Storage Gen2 und dann Weiter aus.
Wählen Sie unter Format auswählen die Option Text mit Trennzeichen aus, und wählen Sie dann Weiter aus.
Geben Sie unter Eigenschaften festlegen einen Namen ein, wählen Sie Erste Zeile als Kopfzeile aus, und wählen Sie dann Ihr Standardmäßiges Synapse-Speicherkonto aus (das bereits verknüpft ist), oder erstellen Sie einen neuen verknüpften Dienst.
Geben Sie einen Dateipfad für das Ziel der kopierten Datei im Speicher ein. Wenn Sie Datei leer lassen, generiert die Kopierpipeline automatisch einen Namen für die Datei im Zielverzeichnis.
Überprüfen Sie, und wählen Sie bei erfolgreicher Ausführung oben alle veröffentlichen aus.
Wählen Sie nach der erfolgreichen Veröffentlichung Trigger hinzufügen und dann Jetzt auslösen oder den Trigger aus.
Navigieren Sie nach der erfolgreichen Ausführung zu Ihrem verknüpften Azure Data Lake-Dienst, um die übertragenen Daten zu suchen. Wählen Sie Weitere>Aktualisierung aus, um die neuesten verfügbaren Daten anzuzeigen.