Edit

Share via


Troubleshoot the Azure Data Explorer connector in Azure Data Factory and Azure Synapse

APPLIES TO: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory in Microsoft Fabric is the next generation of Azure Data Factory, with a simpler architecture, built-in AI, and new features. If you're new to data integration, start with Fabric Data Factory. Existing ADF workloads can upgrade to Fabric to access new capabilities across data science, real-time analytics, and reporting.

This article provides suggestions to troubleshoot common problems with the Azure Data Explorer connector in Azure Data Factory and Azure Synapse.

Error code: KustoMappingReferenceHasWrongKind

  • Message: Mapping reference should be of kind 'Csv'. Mapping reference: '%reference;'. Kind '%kind;'.

  • Cause: The ingestion mapping reference is not CSV type.

  • Recommendation: Create a CSV ingestion mapping reference.

Error code: KustoWriteFailed

  • Message: Write to Kusto failed with following error: '%message;'.

  • Cause: Wrong configuration or transient errors when the sink reads data from the source.

  • Recommendation: For transient failures, set retries for the activity. For permanent failures, check your configuration and contact support.

For more troubleshooting help, try these resources: