Compartilhar via


Visão geral da biblioteca de Ingestão do Kusto

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

A biblioteca Kusto Ingest fornece um cliente para ingerir dados em seu banco de dados. A biblioteca dá suporte à ingestão enfileirada e direta . Os métodos de ingestão são definidos pelo objeto cliente de ingestão Kusto.

Para obter uma lista de interfaces e classes, consulte Referência do cliente de Ingestão do Kusto.

Obter a biblioteca

Selecione a guia para o idioma de sua preferência.

Permissões

Para ingerir dados em tabelas existentes, você deve ter pelo menos permissões de Database Ingestor ou Table Ingestor. Para criar uma tabela, você deve ter pelo menos permissões de Usuário do Banco de Dados. Para obter mais informações, confira Controle de acesso baseado em função.

Ingestão na fila

O cliente de ingestão enfileirado minimiza as dependências do código do cliente no serviço de ingestão. Nesse modo, a ingestão é realizada enviando uma mensagem de ingestão para uma fila do Azure, que é processada posteriormente pelo serviço de ingestão. Se algum item de armazenamento intermediário for necessário, o cliente de ingestão os gerará usando os recursos fornecidos pelo serviço de assimilação.

A ingestão enfileirada permite que as solicitações de ingestão sejam mantidas quando o serviço de ingestão não estiver disponível e permite que o serviço de ingestão gerencie a carga de ingestão em seu banco de dados. Esse método fornece um mecanismo para acompanhar o progresso e o resultado de cada solicitação de ingestão, repete a ingestão em falhas transitórias e melhora o desempenho por meio de 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. Nesse modo, o serviço de ingestão não modera nem gerencia os dados. Cada solicitação de ingestão é convertida em um comando que é executado diretamente no serviço. Quando métodos síncronos são usados, a conclusão do método indica o fim da operação de assimilação.

A ingestão direta tem baixa latência e não envolve agregação. No entanto, o código do cliente precisa implementar a lógica de repetição ou tratamento de erros, e o código do cliente pode sobrecarregar o banco de dados com solicitações, pois não está ciente da capacidade.

Observação

Não recomendamos a ingestão direta para soluções de grau de produção.