Introducción a la biblioteca de ingesta de Kusto

  • Artículo

La biblioteca Kusto Ingest proporciona un cliente para ingerir datos en el clúster. La biblioteca admite la ingesta directa y en cola. Los métodos de ingesta se definen mediante el objeto cliente de ingesta de Kusto.

Para obtener una lista de interfaces y clases, consulte Referencia de cliente de ingesta de Kusto.

Obtención de la biblioteca

Seleccione la pestaña para su idioma preferido.

Permisos

Para ingerir datos en tablas existentes, debe tener al menos permisos De ingesta de base de datos o De ingesta de tablas. Para crear una tabla, debe tener al menos permisos de usuario de base de datos. Para más información, vea Control de acceso basado en roles.

Ingesta en cola

El cliente de ingesta en cola minimiza las dependencias del código de cliente en el servicio de ingesta de azure Data Explorer. En este modo, la ingesta se realiza mediante el envío de un mensaje de ingesta a una cola de Azure, que posteriormente procesa el servicio de ingesta de Azure Data Explorer. Si se requieren elementos de almacenamiento intermedios, el cliente de ingesta los genera mediante los recursos proporcionados por el servicio de ingesta.

La ingesta en cola permite que las solicitudes de ingesta se conserven cuando el servicio de ingesta de Azure Data Explorer no está disponible y permite que el servicio de ingesta administre la carga de ingesta en el clúster. Este método proporciona un mecanismo para realizar un seguimiento del progreso y el resultado de cada solicitud de ingesta, reintentar la ingesta en errores transitorios y mejora el rendimiento mediante una agregación eficaz y controlable en los datos entrantes.

Ingesta directa

El cliente de ingesta directa requiere interacción directa con el servicio de ingesta de Azure Data Explorer. En este modo, el servicio de ingesta no modera ni administra los datos. Cada solicitud de ingesta se traduce en un comando que se ejecuta directamente en el servicio. Cuando se usan métodos sincrónicos, la finalización del método indica el final de la operación de ingesta.

La ingesta directa tiene una latencia baja y no implica la agregación. Sin embargo, el código de cliente tiene que implementar lógica de reintentos o de control de errores, y el código de cliente podría sobrecargar el clúster con solicitudes, ya que no es consciente de la capacidad.

Nota

No se recomienda la ingesta directa para las soluciones de nivel de producción.

Contenido relacionado