Usar o assistente de gerador de aplicativo de exemplo para criar um código a fim de ingerir e consultar seus dados

O assistente de gerador de aplicativo de exemplo é uma ferramenta que permite criar um aplicativo funcional para ingerir e consultar os seus dados na linguagem de programação de sua preferência. O código gerado faz referência às estruturas relevantes do SDK e é adaptado para o cluster e os dados. O aplicativo é um exemplo independente e executável que demonstra como se conectar a um cluster usando autenticação, administração e ingestão e consulta de dados usando o SDK.

Você pode usar o código gerado como uma linha de base para escrever seus aplicativos, alterar o código conforme o uso ou pode copiar seções de código em seus aplicativos. O código inclui comentários com dicas, práticas recomendadas, links para material de referência e alterações de TODO recomendadas ao adaptar o código às suas necessidades.

Pré-requisitos

• Uma conta Microsoft ou uma identidade de usuário do Microsoft Entra. Uma assinatura do Azure não é necessária.
• Um cluster e um banco de dados do Azure Data Explorer. Criar um cluster e um banco de dados.
• Entre na interface do usuário da Web do Azure Data Explorer e adicione uma conexão ao cluster.

Acesse o assistente

O assistente do gerador de aplicativo de exemplo orientará você pelo processo de ingestão.

Para acessar o assistente na interface do usuário da Web do Azure Data Explorer:

1. Selecione Consulta no painel esquerdo.

2. Clique com o botão direito do mouse na tabela desejada e selecione Gerar>código de amostra.

   

Gerar um aplicativo de exemplo

Esta seção descreve o assistente em geral. As opções selecionadas dependem do formato de dados que você está ingerindo, do tipo de fonte de dados que você está ingerindo e se está ingerindo em uma tabela nova ou existente.

O assistente fornece instruções para as seguintes opções:

• Ingestão em uma tabela existente
• Ingestão em uma nova tabela
• Ingerir dados de:
  • Armazenamento de Blobs
  • Um arquivo local

Destino

Na guia Destino:

1. Selecione o cluster e o banco de dados.

2. Escolha se deseja usar uma tabela existente ou uma tabela nova. Para uma tabela existente, selecione a tabela nas opções. Para uma nova tabela, dê um nome à tabela.

3. Selecione a linguagem de programação para seu aplicativo.

   

4. Selecione Avançar: origem.

Fonte

Na guia Origem:

1. Escolha entre as seguintes opções:

   • Consultar e ingerir: carregue dados para ingestão e receba o código correspondente para ingestão e consulta dos dados especificados.
   • Somente consulta: obtenha o código para consultar a tabela selecionada na guia anterior.

2. Se você selecionou Consultar e ingerir, selecione o arquivo de origem ou blob para ingestão.

3. Selecione Avançar: esquema.

Esquema

Na guia Esquema, o serviço gera automaticamente propriedades de esquema e assimilação, que você pode modificar conforme necessário. Para configurar o esquema:

1. Confirme o tipo de compactação gerado automaticamente.

2. Escolha o Formato de dados entre os formatos compatíveis com o Azure Data Explorer para ingestão. Formatos diferentes têm especificações diferentes.

3. Na janela Visualização de dados parciais, ajuste o esquema conforme necessário. Para fazer isso, selecione a seta na parte superior de uma coluna para abrir um menu com opções para alterar o tipo de dados, criar uma nova coluna, excluir uma coluna e muito mais. Se seus dados estiverem no formato Parquet, JSON ou Avro, você poderá aplicar transformações de mapeamento.

   

4. Selecione Avançar: Gerar aplicativo de exemplo.

Transformações de mapeamento

Os formatos de dados Parquet, JSON e Avro oferecem suporte a transformações simples no momento da ingestão. Para aplicar transformações de mapeamento, crie ou atualize uma coluna na janela Visualização de dados parciais.

As transformações de mapeamento podem ser executadas em uma coluna do tipo string ou datetime, com os dados de origem tendo o tipo de dados int ou long. As transformações de mapeamento com suporte são:

• DateTimeFromUnixSeconds
• DateTimeFromUnixMilliseconds
• DateTimeFromUnixMicroseconds
• DateTimeFromUnixNanoseconds

Para obter mais informações, consulte Mapeando transformações.

Generate

Depois de concluir o mapeamento de esquema e as manipulações de coluna, o assistente do gerador de aplicativos de exemplo inicia o processo de geração de código. Após a geração de código, o projeto de aplicativo de exemplo estará disponível para download como um arquivo ZIP.

Instruções detalhadas para executar o projeto com o SDK selecionado são fornecidas após a geração bem-sucedida e no arquivo de projeto de amostra. Além disso, o assistente oferece opções para usar consultas rápidas para exploração inicial de seus dados.

Conteúdo relacionado

• Configure seu ambiente de desenvolvimento para usar as bibliotecas do cliente Kusto