Creare un set di dati di riferimento per l'ambiente Time Series Insights usando il portale di AzureCreate a reference data set for your Time Series Insights environment using the Azure portal

In questo articolo viene descritto come aggiungere un set di dati di riferimento all'ambiente Azure Time Series Insights.This article describes how to add a reference data set to your Azure Time Series Insights environment. Risulta utile associare i dati di riferimento ai dati di origine per aumentarne il valore.Reference data is useful to join to your source data to augment the values.

Un set di dati di riferimento è una raccolta di elementi che aumentano gli eventi dell'origine evento.A Reference Data Set is a collection of items that augment the events from your event source. Il motore in ingresso di Time Series Insights crea un join tra ogni evento dell'origine evento e la riga di dati corrispondente nel set di dati di riferimento.Time Series Insights ingress engine joins each event from your event source with the corresponding data row in your reference data set. Questo evento aumentato sarà quindi disponibile per le query.This augmented event is then available for query. Questo join è basato sulla colonna o le colonne di chiavi primarie definite nel set di dati di riferimento.This join is based on the Primary Key column(s) defined in your reference data set.

Non viene creato un join dei dati di riferimento in maniera retroattiva.Reference data is not joined retroactively. Questo significa che solo i dati in ingresso correnti e futuri vengono uniti in join al set di dati di riferimento, appena viene configurato e caricato.This means that only current and future ingress data is matched and joined to the reference date set, once it has been configured and uploaded.

Aggiungere un set di dati di riferimentoAdd a reference data set

  1. Accedere al portale di Azure.Sign in to the Azure portal.

  2. Individuare l'ambiente Time Series Insights esistente.Locate your existing Time Series Insights environment. Fare clic su Tutte le risorse nel menu sul lato sinistro del portale di Azure.Click All resources in the menu on the left side of the Azure portal. Selezionare l'ambiente Time Series Insights.Select your Time Series Insights environment.

  3. Selezionare la pagina Panoramica.Select the Overview page. Individuare l'URL di Time Series Insights Explorer e aprire il collegamento.Locate the Time Series Insights explorer URL and open the link.

    Visualizzare l'Explorer del proprio ambiente Time Series Insights (TSI).View the explorer for your TSI environment.

  4. Espandere il selettore di ambiente in TSI Explorer.Expand the environment selector in the TSI explorer. Scegliere l'ambiente attivo.Choose the active environment. Selezionare l'icona dei dati di riferimento nell'angolo superiore destro della pagina dell'Explorer.Select the reference data icon on the upper right in the explorer page.

    Aggiungere i dati di riferimento

  5. Selezionare il pulsante + Aggiungi un set di dati per iniziare ad aggiungere un nuovo set di dati.Select the + Add a data set button to begin adding a new data set.

    Aggiungi un set di dati

  6. Nella pagina Nuovo set di dati di riferimento scegliere il formato dei dati:On the New reference data set page, choose the format of the data:

    • Scegliere CSV per i dati delimitati da virgole.Choose CSV for comma-delimited data. La prima riga viene considerata una riga di intestazione.The first row is treated as a header row.
    • Scegliere Matrice JSON per i dati in formato JavaScript Object Notation (JSON).Choose JSON Array for javascript object notation (JSON) formatted data.

    Scegliere il formato dei dati.

  7. Specificare i dati usando uno dei due metodi seguenti:Provide the data, using one of the two methods:

    • Incollare i dati nell'editor di testo.Paste the data into the text editor. Quindi scegliere il pulsante Analizza dati di riferimento.Then, select Parse reference data button.
    • Selezionare il pulsante Scegli file per aggiungere i dati da un file di testo locale.Select Choose File button to add data from a local text file.

    Ad esempio, incollare dati CSV: Dati CSV incollatiFor example, paste CSV data: Pasted CSV data

    Ad esempio, incollare dati di matrice JSON: Dati di matrice JSON incollatiFor example, paste JSON array data: Paste JSON data

    In caso di errore di analisi dei valori dei dati, l'errore viene visualizzato in rosso in fondo alla pagina, ad esempio: CSV parsing error, no rows extracted.If there is an error parsing the data values, the error appears in red at the bottom of the page, such as CSV parsing error, no rows extracted.

  8. Se l'analisi dei dati riesce, viene visualizzata una griglia con le colonne e le righe che rappresentano i dati.Once the data is successfully parsed, a data grid is shown displaying the columns and rows representing the data. Esaminare la griglia dei dati per verificarne la correttezza.Review the data grid to ensure correctness.

    Aggiungere i dati di riferimento

  9. Esaminare ogni colonna per verificare il tipo di dati presupposto e cambiarlo se necessario.Review each column to see the data type assumed, and change the data type if needed. Selezionare il simbolo del tipo di dati nell'intestazione di colonna: # per il tipo di dati Double (dati numerici), T|F per il tipo di dati booleano o Abc per il tipo di dati stringa.Select the data type symbol in the column heading: # for double (numerical data), T|F for boolean, or Abc for string.

    Scegliere i tipi di dati nelle intestazioni di colonna.

  10. Rinominare le intestazioni di colonna se necessario.Rename the column headers if needed. Il nome di colonna chiave è necessario per creare un join con la proprietà corrispondente nell'origine evento.The key column name is necessary to join to the corresponding property in your event source. Verificare che i nomi di colonna chiave dei dati di riferimento corrispondano esattamente al nome evento nei dati in entrata, inclusa la combinazione di maiuscole/minuscole.Ensure that the reference data key column names match exactly to the event name to your incoming data, including case-sensitivity. I nomi non di colonna chiave vengono usati per aumentare i dati in entrata con i valori dei dati di riferimento corrispondenti.The non-key column names are used to augment the incoming data with the corresponding reference data values.

  11. Fare clic su Aggiungi una riga o Aggiungi una colonna per aggiungere altri valori di dati di riferimento, se necessario.Click Add a row or Add a column to add more reference data values, as needed.

  12. Digitare un valore nel campo Filtra righe per esaminare righe specifiche in base alle necessità.Type a value in the Filter the rows... field to review specific rows as needed. Il filtro è utile per esaminare i dati, ma non viene applicato quando si caricano i dati.The filter is useful for reviewing data, but is not applied when uploading the data.

  13. Assegnare un nome al set di dati specificandolo nel campo Nome del set di dati sopra la griglia dei dati.Name the data set, by filling in the Data set name field above the data grid.

    Assegnare un nome al set di dati.

  14. Specificare la colonna Chiave primaria nel set di dati, selezionandola dall'elenco a discesa sopra la griglia dei dati.Provide the Primary Key column in the data set, by selecting the drop-down above the data grid.

    Selezionare la colonna o le colonne chiave.

    Facoltativamente, selezionare il pulsante + per aggiungere una colonna chiave secondaria, come una chiave primaria composta.Optionally, select the + button to add a secondary key column, as a composite primary key. Se occorre annullare la selezione, selezionare il valore vuoto nell'elenco a discesa per rimuovere la chiave secondaria.If you need to undo the selection, choose the empty value from the drop-down to remove the secondary key.

  15. Per caricare i dati, selezionare il pulsante Carica righe.To upload the data, select the Upload rows button.

    Caricamento

    La pagina conferma il completamento del caricamento e visualizza il messaggio Il set di dati è stato caricato.The page confirms the completed upload and display the message Successfully uploaded dataset.

Passaggi successiviNext steps