Esercitazione: Eseguire l'inserimento del parser CSV

  • Articolo

L'inserimento di parser delimitati da virgole (CSV) consente di inserire file CSV in un'istanza di Azure Data Manager per l'energia.

In questa esercitazione apprenderai a:

  • Inserire un file CSV di dati di esempio in un'istanza di Azure Data Manager per l'energia usando Postman.
  • Cercare i record di metadati di archiviazione creati durante l'inserimento CSV usando Postman.

Prerequisiti

Prima di iniziare questa esercitazione, completare i prerequisiti seguenti.

Ottenere i dettagli per l'istanza di Azure Data Manager per l'energia

  • È necessario un'istanza di Azure Data Manager per l'energia. Se non è già disponibile, crearne uno seguendo la procedura descritta in Avvio rapido: Creare un'istanza di Azure Data Manager per l'energia.

  • Per questa esercitazione sono necessari i parametri seguenti:

    Parametro Valore da usare Esempio Dove trovare questo valore
    CLIENT_ID ID applicazione (client) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx L'app o l'ID client vengono usati durante la registrazione dell'applicazione con Microsoft Identity Platform. Vedere Registrare un'applicazione.
    CLIENT_SECRET Segreti client _fl****************** A volte chiamato password dell'applicazione, un segreto client è un valore stringa che l'app può usare al posto di un certificato per l'identità stessa. Vedere Aggiungere un segreto client.
    TENANT_ID ID della directory (tenant) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Passare il puntatore del mouse sul nome dell'account nel portale di Azure per ottenere l'ID della directory o del tenant. In alternativa, cercare e selezionare Microsoft Entra ID>Properties>Tenant ID nella portale di Azure.
    SCOPE ID applicazione (client) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Questo valore corrisponde all'app o all'ID client menzionato in precedenza.
    refresh_token Valore del token di aggiornamento 0.ATcA01-XWHdJ0ES-qDevC6r........... Seguire Come generare il token di autenticazione per creare un token di aggiornamento e salvarlo. Questo token di aggiornamento è necessario in un secondo momento per generare un token utente.
    DNS URI <instance>.energy.Azure.com Trovare questo valore nella pagina di panoramica dell'istanza di Azure Data Manager for Energy.
    data-partition-id Partizioni di dati <instance>-<data-partition-name> Trovare questo valore nella pagina di panoramica dell'istanza di Azure Data Manager for Energy.

Seguire la guida Gestire gli utenti per aggiungere diritti appropriati per l'utente che esegue questa esercitazione.

Configurare Postman ed eseguire richieste

  1. Scaricare e installare l'app desktop Postman .

  2. Importare i file seguenti in Postman:

    Per importare le variabili di ambiente e raccolta Postman, seguire la procedura descritta in Importare dati in Postman.

  3. Aggiornare CURRENT VALUE per l'ambiente Postman con le informazioni ottenute nei dettagli dell'istanza di Azure Data Manager for Energy.

  4. La raccolta Postman per l'inserimento del parser CSV contiene 10 richieste che è necessario eseguire in sequenza.

    Assicurarsi di scegliere Ambiente flusso di lavoro di inserimento prima di attivare la raccolta Postman.

    Screenshot of the Postman environment.

  5. Attivare ogni richiesta selezionando il pulsante Invia .

    In ogni richiesta, Postman convalida il codice di risposta API effettivo rispetto al codice di risposta previsto. In caso di mancata corrispondenza, la sezione test indica gli errori.

Di seguito è riportato un esempio di richiesta Postman riuscita:

Screenshot of a successful Postman call.

Di seguito è riportato un esempio di richiesta Postman non riuscita:

Screenshot of a failed Postman call.

Inserire dati wellbore usando Postman

Per inserire un file CSV di dati di esempio nell'istanza di Azure Data Manager for Energy usando la raccolta Postman, seguire questa procedura:

  1. Ottenere un token di accesso utente: generare il token utente, che verrà usato per autenticare altre chiamate API.

  2. Creare uno schema: generare uno schema conforme alle colonne presenti nel file CSV.

  3. Ottenere i dettagli dello schema: ottenere lo schema creato nel passaggio precedente e convalidarlo.

  4. Creare un tag legale: creare un tag legale che verrà aggiunto ai dati CSV ai fini della conformità dei dati.

  5. Ottenere un URL firmato per caricare un file CSV: ottenere il percorso dell'URL firmato in cui verrà caricato il file CSV.

  6. Caricare un file CSV: scaricare l'esempio di Wellbore.csv nel computer locale e quindi selezionare questo file in Postman facendo clic sul pulsante Seleziona file .

    Screenshot of uploading a CSV file.

  7. Caricare i metadati del file CSV: caricare le informazioni sui metadati del file, ad esempio il percorso del file e altri campi pertinenti.

  8. Creare un flusso di lavoro di inserimento parser CSV: creare il grafo aciclico diretto (DAG) per il flusso di lavoro di inserimento del parser CSV.

  9. Attivare un flusso di lavoro di inserimento parser CSV: attivare il dag per il flusso di lavoro di inserimento del parser CSV.

  10. Cercare lo stato del flusso di lavoro di inserimento del parser CSV inserito: ottenere lo stato dell'esecuzione del dag del parser CSV.

Cercare dati ben interrotti inseriti usando Postman

Per cercare i record di metadati di archiviazione creati durante l'inserimento CSV usando la raccolta Postman, completare il passaggio seguente:

  • Cercare i record CSV inseriti: cercare i record CSV creati in precedenza.

    Screenshot of searching ingested CSV records.

Passaggio successivo

Passare all'esercitazione successiva:

Esercitazione: Eseguire l'inserimento di file basato su manifesto