Criar um conjunto de dados de referência para seu ambiente do Azure Time Series Insights Gen1 usando o portal do Azure

Este artigo descreve como adicionar um conjunto de dados de referência ao seu ambiente do Azure Time Series Insights. Os dados de referência são úteis para unir os dados de origem para aumentar os valores.

Um Conjunto de Dados de Referência é uma coleção de itens que aumentam os eventos da sua fonte de eventos. O mecanismo de entrada do Azure Time Series Insights une cada evento da sua fonte de eventos com a linha de dados correspondente em seu conjunto de dados de referência. Esse evento aumentado fica então disponível para consulta. Essa associação é baseada na(s) coluna(s) de Chave Primária definida(s) no conjunto de dados de referência.

Os dados de referência não são associados retroativamente. Assim, apenas os dados de entrada atuais e futuros são correspondidos e associados à data de referência definida, uma vez que tenham sido configurados e carregados.

Vídeo

Saiba mais sobre o modelo de dados de referência do Time Series Insight.

Adicionar um conjunto de dados de referência

1. Inicie sessão no portal do Azure.

2. Localize seu ambiente existente do Azure Time Series Insights. Selecione Todos os recursos no menu do lado esquerdo do portal do Azure. Selecione seu ambiente do Azure Time Series Insights.

3. Selecione a página Descrição geral. Expanda a seção Essentials perto da parte superior da página para localizar a URL do Time Series Insights Explorer e abrir o link.

   

   Exiba o Explorer para seu ambiente do Azure Time Series Insights.

4. Expanda o seletor de ambiente no Azure Time Series Insights Explorer. Escolha o ambiente ativo. Selecione o ícone de dados de referência no canto superior direito da página do Explorer.

   

5. Selecione o botão + Adicionar um conjunto de dados para começar a adicionar um novo conjunto de dados.

   

6. Na página Novo conjunto de dados de referência, escolha o formato dos dados:

   • Escolha CSV para dados delimitados por vírgula. A primeira linha é tratada como uma linha de cabeçalho.
   • Escolha JSON Array for JavaScript object notation (JSON) formatted data.

   

7. Forneça os dados, usando um dos dois métodos:

   • Cole os dados no editor de texto. Em seguida, selecione o botão Analisar dados de referência.
   • Selecione o botão Escolher arquivo para adicionar dados de um arquivo de texto local.

   Por exemplo, cole dados CSV:

   Por exemplo, cole dados de matriz JSON:

   Se houver um erro ao analisar os valores de dados, o erro aparecerá em vermelho na parte inferior da página, como CSV parsing error, no rows extracted.

8. Depois que os dados são analisados com êxito, uma grade de dados é mostrada exibindo as colunas e linhas que representam os dados. Revise a grade de dados para garantir a correção.

   

9. Analise cada coluna para entender o tipo de dados assumido e altere o tipo de dados, se necessário. Selecione o símbolo do tipo de dados no título da coluna: # para duplo (dados numéricos), T|F para booleano, ou Abc para corda.

   

10. Renomeie os cabeçalhos das colunas, se necessário. O nome da coluna de chave é necessário para se juntar à propriedade correspondente na origem do evento.

    Importante

    Certifique-se de que os nomes das colunas da chave de dados de referência correspondam exatamente ao nome do evento para os dados de entrada, incluindo a diferenciação de maiúsculas e minúsculas. Os nomes de colunas não-chave são usados para aumentar os dados de entrada com os valores de dados de referência correspondentes.

11. Digite um valor no campo Filtrar as linhas... para revisar linhas específicas conforme necessário. O filtro é útil para revisar dados, mas não é aplicado ao carregar os dados.

12. Nomeie o conjunto de dados, preenchendo o campo Nome do conjunto de dados acima da grade de dados.

    

13. Forneça a coluna Chave Primária no conjunto de dados, selecionando a lista suspensa acima da grade de dados.

    

    (Opcional) Selecione o + botão para adicionar uma coluna de chave secundária, como uma chave primária composta. Se você precisar desfazer a seleção, escolha o valor vazio na lista suspensa para remover a chave secundária.

14. Para carregar os dados, selecione o botão Carregar linhas .

    

    A página confirma o carregamento concluído e exibe a mensagem Conjunto de dados carregado com êxito.

    Aviso

    As colunas ou propriedades compartilhadas entre conjuntos de dados de referência exibirão um erro de carregamento de nome de propriedade duplicado. O erro não impedirá o carregamento bem-sucedido dos conjuntos de dados de referência. Ele pode ser removido combinando linhas que compartilham o nome da propriedade duplicada.

15. Selecione Adicionar uma linha, Importar linhas em massa ou Adicionar uma coluna para adicionar mais valores de dados de referência, conforme necessário.

    

    Importante

    Qualquer linha que compartilhe uma chave exclusiva com outra linha terá suas colunas substituídas pela última linha adicionada que compartilha essa chave exclusiva.

    Nota

    As linhas adicionadas não precisam ser retangulares - elas podem ter menos, maiores ou variáveis colunas das outras entradas no conjunto de dados de referência.

Próximos passos

• Gerir dados de referência através de programação.

• Para obter a referência completa da API, leia o documento da API de dados de referência.