{"id":15291322,"url":"https://github.com/azure/azure-kusto-java","last_synced_at":"2026-04-30T07:01:42.573Z","repository":{"id":33846253,"uuid":"144020195","full_name":"Azure/azure-kusto-java","owner":"Azure","description":"Microsoft Azure Kusto Library for Java","archived":false,"fork":false,"pushed_at":"2026-04-28T09:13:27.000Z","size":6418,"stargazers_count":45,"open_issues_count":9,"forks_count":45,"subscribers_count":16,"default_branch":"master","last_synced_at":"2026-04-28T11:19:41.050Z","etag":null,"topics":["azure-data-explorer","java","kusto","sdk"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Azure.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-08-08T13:48:37.000Z","updated_at":"2026-04-28T09:13:32.000Z","dependencies_parsed_at":"2023-10-16T04:16:27.577Z","dependency_job_id":"23534627-e903-40c8-a29c-779cf2a25804","html_url":"https://github.com/Azure/azure-kusto-java","commit_stats":null,"previous_names":[],"tags_count":64,"template":false,"template_full_name":null,"purl":"pkg:github/Azure/azure-kusto-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Azure","download_url":"https://codeload.github.com/Azure/azure-kusto-java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32457110,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure-data-explorer","java","kusto","sdk"],"created_at":"2024-09-30T16:11:56.810Z","updated_at":"2026-04-30T07:01:42.553Z","avatar_url":"https://github.com/Azure.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Microsoft Azure Kusto (Azure Data Explorer) SDK for Java\n\n![Released Version](https://img.shields.io/maven-central/v/com.microsoft.azure.kusto/kusto-ingest.svg)\n\n\nmaster: [![Build status](https://msazure.visualstudio.com/One/_apis/build/status/Custom/Kusto/azure-kusto-java-sdk%20ci?branchName=master)](https://msazure.visualstudio.com/One/_build/latest?definitionId=57651)\n![Github Actions Build](https://github.com/Azure/azure-kusto-java/actions/workflows/build.yml/badge.svg)\n\n\nThis is the Microsoft Azure Kusto client library which allows communication with Kusto to bring data in (ingest) and query information already stored in the database.\nThis library contains 3 different modules:\n- data: The main client that allows interaction with Kusto, including creating a connection, issuing (control) commands and querying data\n- ingest: Provides an easy way to bring data into Kusto\n- quickstart: Self-contained, configurable and runnable sample app for easily getting started with the SDK\n- samples: Sample code implementing various scenarios\n\n# Install\n\n## Maven\n\nThis method is the easiest to follow, just add the following dependency to your pom.xml (with the right version tag from maven central):\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.microsoft.azure.kusto\u003c/groupId\u003e\n    \u003cartifactId\u003ekusto-ingest\u003c/artifactId\u003e\n    \u003cversion\u003e[see badge below]\u003c/version\u003e\n\u003c/dependency\u003e\n```\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.microsoft.azure.kusto/kusto-ingest/badge.svg?style=plastic)](https://maven-badges.herokuapp.com/maven-central/com.microsoft.azure.kusto/kusto-ingest)\n\n\n## Clone\nDownload the source code, compile and install locally.\n\nOne way to do this is by using maven like in the following example:\n```\ngit clone git://github.com/Azure/azure-kusto-java.git\ncd azure-kusto-java\nmvn install\n```\n\n# Prerequisites\n\n- A Java Developer Kit (JDK), version 11 or later\n- Maven\n\n# Samples\n\n- [Execute a query](samples/README.md#execute-query-sample)\n- [Ingest a file](samples/README.md#file-ingestion-sample)\n- [Check status of an ingest operation](samples/README.md#query-table-status-sample)\n\n## Using A Proxy\nThe SDK includes support for the built-in proxy system properties in java.\nFor example, when the address of your proxy server is 1.2.3.4:8989, you can run:  \n`java -ea -Dhttp.proxyHost=1.2.34 -Dhttp.proxyPort=8989 -Dhttps.proxyHost=1.2.3.4 -Dhttps.proxyPort=8989`  \nAnd the SDK will know to use these values automatically.\n\nAlternatively, you can define a proxy programmatically when creating a client, using `HttpClientProperties`:  \n```java\nHttpClientProperties httpClientProperties = HttpClientProperties.builder()\n        .proxy(new ProxyOptions(ProxyOptions.Type.HTTP, new InetSocketAddress(\"myproxy.contoso.com\", 8080)))\n        .build();\n\nClient = ClientFactory.createClient(\u003cengine_connection_string\u003e, httpClientProperties); \n// Or for DM:\nIngestClient ingestClient = IngestClientFactory.createClient(\u003cdm_connection_string\u003e, httpClientProperties)\n\n```\n\n## Best Practices\nSee the SDK [best practices guide](https://docs.microsoft.com/azure/data-explorer/kusto/api/netfx/kusto-ingest-best-practices), which though written for the .NET SDK, applies similarly here.\n\n# Need Support?\n- **Have a feature request for SDKs?** Please post it on [User Voice](https://feedback.azure.com/forums/915733-azure-data-explorer) to help us prioritize\n- **Have a technical question?** Ask on [Stack Overflow with tag \"azure-data-explorer\"](https://stackoverflow.com/questions/tagged/azure-data-explorer)\n- **Need Support?** Every customer with an active Azure subscription has access to [support](https://docs.microsoft.com/en-us/azure/azure-supportability/how-to-create-azure-support-request) with guaranteed response time.  Consider submitting a ticket and get assistance from Microsoft support team\n- **Found a bug?** Please help us fix it by thoroughly documenting it and [filing an issue](https://github.com/Azure/azure-kusto-java/issues/new).\n\n# Looking for SDKs for other languages/platforms?\n- [Node](https://github.com/azure/azure-kusto-node)\n- [Python](https://github.com/azure/azure-kusto-python)\n- [.NET](https://docs.microsoft.com/en-us/azure/kusto/api/netfx/about-the-sdk)\n\n# Contributing\n\nThis project welcomes contributions and suggestions.  Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit https://cla.microsoft.com.\n\nWhen you submit a pull request, a CLA-bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Formatting\nThe code in this project is formatted using formatter-maven-plugin.    \nCode that isn't formatted will not be accepted.  \n\nTo format your code, run the following command:  \n`mvn formatter:format`\n\nIt is also recommended importing the format file `kusto-style.xml` into your editor (the file is in the eclipse xml format).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazure%2Fazure-kusto-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazure%2Fazure-kusto-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazure%2Fazure-kusto-java/lists"}