Tutorial: Durchführen einer CSV-Parsererfassung

Die CSV-Parsererfassung (Comma-separated values) bietet die Möglichkeit, CSV-Dateien in einer Azure Data Manager for Energy-Instanz zu erfassen.

In diesem Tutorial lernen Sie Folgendes:

• Erfassen einer CSV-Beispieldatei für Bohrlochdaten in einer Azure Data Manager for Energy-Instanz mithilfe von Postman
• Suchen nach Datensätzen mit Speichermetadaten, die während der CSV-Erfassung mithilfe von Postman erstellt wurden

Voraussetzungen

Bevor Sie mit diesem Tutorial beginnen, müssen Sie die folgenden Voraussetzungen erfüllen.

Abrufen von Details zur Azure Data Manager for Energy-Instanz

• Sie benötigen eine Azure Data Manager for Energy-Instanz. Wenn Sie noch nicht über eine Instanz verfügen, erstellen Sie eine mithilfe der Schritte unter Schnellstart: Erstellen einer Azure Data Manager for Energy-Instanz.

• Für dieses Tutorial benötigen Sie die folgenden Parameter:

  Parameter	Zu verwendender Wert	Beispiel	Speicherort dieses Werts
  CLIENT_ID	Anwendungs-ID (Client)	3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx	Sie verwenden diese App- oder Client-ID, wenn Sie die Anwendung bei der Microsoft Identity Platform registrieren. Weitere Informationen finden Sie unter Registrieren einer Anwendung.
  CLIENT_SECRET	Geheime Clientschlüssel	_fl******************	Geheime Clientschlüssel werden manchmal auch als Anwendungskennwörter bezeichnet und entsprechen einem Zeichenfolgenwert, den Ihre App anstelle eines Zertifikats für die Identifizierung verwenden kann. Informationen hierzu finden Sie unter Geheimen Clientschlüssel hinzufügen.
  TENANT_ID	Verzeichnis-ID (Mandant)	72f988bf-86f1-41af-91ab-xxxxxxxxxxxx	Bewegen Sie die Maus auf den Namen Ihres Kontos, um die Verzeichnis- bzw. Mandanten-ID anzuzeigen. Alternativ können Sie im Azure-Portal zu Microsoft Entra ID>Eigenschaften>Mandanten-ID navigieren und die Option auswählen.
  SCOPE	Anwendungs-ID (Client)	3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx	Dieser Wert entspricht der zuvor erwähnten App- bzw. Client-ID.
  refresh_token	Aktualisierungstokenwert	0.ATcA01-XWHdJ0ES-qDevC6r...........	Befolgen Sie die Anweisungen unter Generieren eines Authentifizierungstokens, um ein Aktualisierungstoken zu erstellen und zu speichern. Sie benötigen dieses Aktualisierungstoken später, um ein Benutzertoken zu generieren.
  DNS	URI	<instance>.energy.Azure.com	Dieser Wert ist auf der Übersichtsseite der Azure Data Manager for Energy-Instanz verfügbar.
  data-partition-id	Datenpartitionen	<instance>-<data-partition-name>	Dieser Wert ist auf der Übersichtsseite der Azure Data Manager for Energy-Instanz verfügbar.

Befolgen Sie den Leitfaden zum Verwalten von Benutzer*innen, um geeignete Berechtigungen für die Benutzer*innen hinzuzufügen, die dieses Tutorial ausführen.

Einrichten von Postman- und Ausführungsanforderungen

1. Laden Sie die Postman-Desktop-App herunter, und installieren Sie sie.

2. Importieren Sie die folgenden Dateien in Postman:

   • Postman-Sammlung für den CSV-Workflow
   • Postman-Umgebung für den CSV-Workflow

   Befolgen Sie zum Importieren der Postman-Sammlung und der Umgebungsvariablen die unter Importieren von Daten in Postman beschriebenen Schritte.

3. Aktualisieren Sie AKTUELLER WERT für die Postman-Umgebung mit den Informationen, die Sie in den Details für die Azure Data Manager for Energy-Instanz erhalten haben.

4. Die Postman-Sammlung für die CSV-Parsererfassung enthält zehn Anforderungen, die Sie sequenziell ausführen müssen.

   Stellen Sie sicher, dass Sie die Umgebung für den Erfassungsworkflow auswählen, bevor Sie die Postman-Sammlung auslösen.

   

5. Lösen Sie die einzelnen Anforderungen aus, indem Sie auf die Schaltfläche Senden klicken.

   Bei jeder Anforderung vergleicht Postman den tatsächlichen API-Antwortcode mit dem erwarteten Antwortcode. Bei einer Nichtübereinstimmung werden im Testabschnitt Fehler angezeigt.

Hier finden Sie ein Beispiel für eine erfolgreiche Postman-Anforderung:

Dies ist ein Beispiel für eine fehlgeschlagene Postman-Anforderung:

Erfassen von Bohrlochdaten mithilfe von Postman

Führen Sie die folgenden Schritte aus, um mithilfe der Postman-Sammlung eine CSV-Beispieldatei für Bohrlochdaten in der Azure Data Manager for Energy-Instanz zu erfassen:

1. Abrufen eines Benutzerzugriffstokens: Generieren Sie das Benutzertoken, das zum Authentifizieren weiterer API-Aufrufe verwendet wird.

2. Erstellen eines Schemas: Generieren Sie ein Schema, das den Spalten entspricht, die in der CSV-Datei vorhanden sind.

3. Abrufen von Schemadetails: Rufen Sie das im vorherigen Schritt erstellte Schema ab, und überprüfen Sie es.

4. Erstellen eines rechtlichen Tags: Erstellen Sie ein rechtliches Tag, das den CSV-Daten zum Zweck der Datenkonformität hinzugefügt wird.

5. Abrufen einer signierten URL für das Hochladen einer CSV-Datei: Rufen Sie den Pfad der signierten URL ab, in den die CSV-Datei hochgeladen werden soll.

6. Hochladen einer CSV-Datei: Laden Sie das Beispiel Wellbore.csv auf Ihren lokalen Computer herunter, und wählen Sie dann diese Datei in Postman aus, indem Sie auf die Schaltfläche Datei auswählen klicken.

   

7. Hochladen von CSV-Dateimetadaten: Laden Sie die Datei-Metadateninformationen (z. B. Dateispeicherort und andere relevante Felder) hoch.

8. Erstellen eines CSV-Parsererfassungsworkflows: Erstellen Sie den gerichteten azyklischen Graphen (Directed Acyclic Graph, DAG) für den CSV-Parsererfassungsworkflow.

9. Auslösen eines CSV-Parsererfassungsworkflows: Lösen Sie den DAG für den CSV-Parsererfassungsworkflow aus.

10. Suchen des erfassten Status für den CSV-Parsererfassungsworkflow: Rufen Sie den Status der DAG-Ausführung für den CSV-Parser ab.

Suchen nach erfassten Bohrlochdaten mithilfe von Postman

Führen Sie die folgenden Schritte aus, um nach den Speichermetadatensätzen zu suchen, die während der CSV-Erfassung mithilfe der Postman-Sammlung erstellt wurden:

• Suchen nach erfassten CSV-Datensätzen: Suchen Sie nach den zuvor erstellten CSV-Datensätzen.

  

Nächster Schritt

Fahren Sie mit dem nächsten Tutorial fort:

Tutorial: Durchführen der manifestbasierten Dateierfassung