Självstudie: Utföra CSV-parser-inmatning

Kommaavgränsade värden (CSV) parser inmatning ger möjlighet att mata in CSV-filer i en Azure Data Manager för Energy-instans.

I den här självstudien lär du dig att:

• Mata in en EXEMPEL-CSV-fil för wellbore-data i en Azure Data Manager for Energy-instans med postman.
• Sök efter lagringsmetadataposter som skapats under CSV-inmatning med hjälp av Postman.

Förutsättningar

Slutför följande krav innan du påbörjar den här självstudien.

Få information om Azure Data Manager for Energy-instansen

• Du behöver en Azure Data Manager för Energy-instans. Om du inte redan har en skapar du en genom att följa stegen i Snabbstart: Skapa en Azure Data Manager för Energi-instans.

• I den här självstudien behöver du följande parametrar:

  Parameter	Värde att använda	Exempel	Var du hittar det här värdet
  CLIENT_ID	App-ID (klient-ID)	00001111-aaaa-2222-bbbb-3333cccc4444	Du använder den här appen eller klient-ID:t när du registrerar programmet med Microsofts identitetsplattform. Se Registrera ett program.
  CLIENT_SECRET	Klienthemligheter	_fl******************	En klienthemlighet kallas ibland för ett programlösenord och är ett strängvärde som appen kan använda i stället för ett certifikat för att identifiera sig själv. Se Lägga till en klienthemlighet.
  TENANT_ID	Katalog-ID (klientorganisation)	72f988bf-86f1-41af-91ab-xxxxxxxxxxxx	Hovra över ditt kontonamn i Azure-portalen för att hämta katalogen eller klientorganisations-ID:t. Alternativt söker du efter och väljer Klient-ID för Microsoft Entra ID-egenskaper>>i Azure-portalen.
  SCOPE	App-ID (klient-ID)	00001111-aaaa-2222-bbbb-3333cccc4444	Det här värdet är detsamma som appen eller klient-ID:t som nämndes tidigare.
  refresh_token	Uppdatera tokenvärde	0.ATcA01-XWHdJ0ES-qDevC6r...........	Följ Så här genererar du autentiseringstoken för att skapa en uppdateringstoken och spara den. Du behöver den här uppdateringstoken senare för att generera en användartoken.
  DNS	URI	<instance>.energy.Azure.com	Hitta det här värdet på översiktssidan för Azure Data Manager for Energy-instansen.
  data-partition-id	Datapartitioner	<instance>-<data-partition-name>	Hitta det här värdet på översiktssidan för Azure Data Manager for Energy-instansen.

Följ guiden Hantera användare för att lägga till lämpliga rättigheter för den användare som kör den här självstudien.

Konfigurera Postman och kör begäranden

1. Ladda ned och installera Postman-skrivbordsappen.

2. Importera följande filer till Postman:

   • Postman-samling för CSV-arbetsflöde
   • Postman-miljö för CSV-arbetsflöde

   Om du vill importera Postman-samlingen och miljövariablerna följer du stegen i Importera data till Postman.

3. Uppdatera AKTUELLT VÄRDE för Postman-miljön med den information som du fick i informationen om Azure Data Manager for Energy-instansen.

4. Postman-samlingen för CSV-parserinmatning innehåller 10 begäranden som du måste köra sekventiellt.

   Se till att välja Arbetsflödesmiljö för inmatning innan du utlöser Postman-samlingen.

   

5. Utlös varje begäran genom att välja knappen Skicka .

   På varje begäran validerar Postman den faktiska API-svarskoden mot den förväntade svarskoden. Om det finns ett matchningsfel anger testavsnittet fel.

Här är ett exempel på en lyckad Postman-begäran:

Här är ett exempel på en misslyckad Postman-begäran:

Mata in wellbore-data med postman

Utför följande steg för att mata in en csv-exempelfil för wellbore-data i Azure Data Manager for Energy-instansen med hjälp av Postman-samlingen:

1. Hämta en användaråtkomsttoken: Generera användartoken som ska användas för att autentisera ytterligare API-anrop.

2. Skapa ett schema: Generera ett schema som följer kolumnerna i CSV-filen.

3. Hämta schemainformation: Hämta schemat som skapades i föregående steg och verifiera det.

4. Skapa en juridisk tagg: Skapa en juridisk tagg som ska läggas till i CSV-data i dataefterlevnadssyfte.

5. Hämta en signerad URL för att ladda upp en CSV-fil: Hämta den signerade URL-sökväg som CSV-filen ska laddas upp till.

6. Ladda upp en CSV-fil: Ladda ned Wellbore.csv-exemplet till den lokala datorn och välj sedan den här filen i Postman genom att klicka på knappen Välj fil.

   

7. Ladda upp CSV-filmetadata: Ladda upp information om filmetadata, till exempel filplats och andra relevanta fält.

8. Skapa ett CSV-parsningsarbetsflöde: Skapa den riktade acykliska grafen (DAG) för arbetsflödet för CSV-parsningsinmatning.

9. Utlös ett CSV-parsningsarbetsflöde: Utlös DAG för arbetsflödet för CSV-parsningsinmatning.

10. Sök efter inmatad CSV-parsningsarbetsflödesstatus: Hämta status för CSV-parsarens DAG-körning.

Sök efter inmatade wellbore-data med postman

Slutför följande steg för att söka efter lagringsmetadataposter som skapades under CSV-inmatningen med hjälp av Postman-samlingen:

• Sök efter inmatade CSV-poster: Sök efter csv-posterna som skapades tidigare.

  

Gå vidare

Gå vidare till nästa kurs:

Självstudie: Utföra manifestbaserad filinmatning