Descrição geral da biblioteca de Ingestão kusto

A biblioteca de Ingestão kusto fornece um cliente para ingerir dados no cluster. A biblioteca suporta a ingestão direta e em fila. Os métodos de ingestão são definidos pelo objeto de cliente de ingestão Kusto.

Para obter uma lista de interfaces e classes, veja Referência do cliente da Ingestão kusto.

Obter a biblioteca

Selecione o separador para o seu idioma preferido.

Permissões

Para ingerir dados em tabelas existentes, tem de ter, pelo menos, permissões de Ingestor de Bases de Dados ou Ingestor de Tabelas. Para criar uma tabela, tem de ter, pelo menos, permissões de Utilizador da Base de Dados. Para obter mais informações, veja Controlo de acesso baseado em funções.

Ingestão em fila

O cliente de ingestão em fila minimiza as dependências do código de cliente no serviço de ingestão de Data Explorer do Azure. Neste modo, a ingestão é realizada ao submeter uma mensagem de ingestão para uma fila do Azure, que é posteriormente processada pelo serviço de ingestão de Data Explorer do Azure. Se forem necessários itens de armazenamento intermédios, o cliente de ingestão gera-os através dos recursos fornecidos pelo serviço de ingestão.

A ingestão em fila permite que os pedidos de ingestão sejam mantidos quando o serviço de ingestão de Data Explorer do Azure está indisponível e permite que o serviço de ingestão faça a gestão da carga de ingestão no cluster. Este método fornece um mecanismo para controlar o progresso e o resultado de cada pedido de ingestão, repeti a ingestão em falhas transitórias e melhora o desempenho através de uma agregação eficiente e controlável em dados de entrada.

Ingestão direta

O cliente de ingestão direta requer interação direta com o serviço de ingestão de Data Explorer do Azure. Neste modo, o serviço de ingestão não modera nem gere os dados. Cada pedido de ingestão é traduzido para um comando que é executado diretamente no serviço. Quando são utilizados métodos síncronos, a conclusão do método indica o fim da operação de ingestão.

A ingestão direta tem baixa latência e não envolve agregação. No entanto, o código de cliente tem de implementar a lógica de repetição ou processamento de erros e o código de cliente pode sobrecarregar o cluster com pedidos, uma vez que não tem conhecimento da capacidade.

Nota

Não recomendamos a ingestão direta para soluções de nível de produção.