{"id":15290906,"url":"https://github.com/azure/azure-kusto-python","last_synced_at":"2025-05-14T08:06:39.762Z","repository":{"id":31690317,"uuid":"108257720","full_name":"Azure/azure-kusto-python","owner":"Azure","description":"Kusto client libraries for Python","archived":false,"fork":false,"pushed_at":"2025-05-04T11:59:28.000Z","size":1961,"stargazers_count":191,"open_issues_count":8,"forks_count":108,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-05-10T00:11:57.947Z","etag":null,"topics":["azure-data-explorer","kusto","python","sdk"],"latest_commit_sha":null,"homepage":null,"language":"Python","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":"CONTRIBUTING.md","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}},"created_at":"2017-10-25T10:55:44.000Z","updated_at":"2025-05-04T09:43:14.000Z","dependencies_parsed_at":"2023-11-07T15:28:17.214Z","dependency_job_id":"1782523d-14ba-4dfb-96f9-7b78dbf258d8","html_url":"https://github.com/Azure/azure-kusto-python","commit_stats":{"total_commits":463,"total_committers":48,"mean_commits":9.645833333333334,"dds":0.7084233261339092,"last_synced_commit":"eb4b68971d5a0c50059008fec21c98382f3bf279"},"previous_names":[],"tags_count":84,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazure-kusto-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Azure","download_url":"https://codeload.github.com/Azure/azure-kusto-python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254101618,"owners_count":22014909,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","kusto","python","sdk"],"created_at":"2024-09-30T16:10:01.977Z","updated_at":"2025-05-14T08:06:34.731Z","avatar_url":"https://github.com/Azure.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Microsoft Azure Kusto  (Azure Data Explorer) SDK  for Python\n\n[*azure-kusto-data*](\"https://github.com/Azure/azure-kusto-python/tree/master/azure-kusto-data\") Package provides the capability to query Kusto clusters with Python.\u003cbr\u003e\n[![PyPI version](https://badge.fury.io/py/azure-kusto-data.svg)](https://badge.fury.io/py/azure-kusto-data)\n[![Downloads](https://pepy.tech/badge/azure-kusto-data)](https://pepy.tech/project/azure-kusto-data)\u003cbr\u003e\n[*azure-kusto-ingest*](\"https://github.com/Azure/azure-kusto-python/tree/master/azure-kusto-ingest\") Package allows sending data to Kusto service - i.e. ingest data.\u003cbr\u003e\n[![PyPI version](https://badge.fury.io/py/azure-kusto-ingest.svg)](https://badge.fury.io/py/azure-kusto-ingest)\n[![Downloads](https://pepy.tech/badge/azure-kusto-ingest)](https://pepy.tech/project/azure-kusto-ingest)\u003cbr\u003e\n\n\n## Install\n### Option 1: Via PyPi\nTo install via the Python Package Index (PyPI), type:\n\n* `pip install azure-kusto-data`\n* `pip install azure-kusto-ingest`\n\n### Option 2: Source Via Git\nTo get the source code of the SDK via git just type:\n\n```python\ngit clone https://github.com/Azure/azure-kusto-python\ncd ./azure-kusto-python/azure-kusto-data\npython3 setup.py install\ncd ../azure-kusto-ingest\npython3 setup.py install\n```\n\n### Option 3: Source Zip\nDownload a zip of the code via GitHub or PyPi. Then follow the same instructions in option 2.\n\n### Optionals:\n* [_Pandas_](http://pandas.pydata.org/) - Package provides extra functionality for use with pandas. Since these are optional dependencies, install with pandas:\n    * `pip install azure-kusto-data[pandas]`\n    * `pip install azure-kusto-ingest[pandas]`\n\n## Minimum Requirements\n* Python 3.5 and above\n* See setup.py for dependencies\n\n## Authentication methods:\n\n* AAD Username/password - Provide your AAD username and password to Kusto client (**check the notice below**).\n* AAD application - Provide app ID and app secret to Kusto client.\n* AAD code - Provide only your AAD username, and authenticate yourself using a code, generated by ADAL.\n* AZ CLI - For those already using [azure-cli](https://github.com/Azure/azure-cli), provide access token for the logged in user`.\n\n**\u003c!\u003e IMPORTANT NOTICE \u003c!\u003e**:\nUser authentication (using username and password) has a major caveat:\nSometimes users are required to use Multi-Factor Authentication. In such a case, this flow won't work for them.\nIt is a limitation of the AAD library we are using under the hood. There are [several bugs reported](https://github.com/AzureAD/azure-activedirectory-library-for-python/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+mfa).\n\nThere is also a feature request for the adal team to work on implementing IWA (Intergrated Windows Auth) so that signed in users won't have to authenticate. Feel free to [upvote](https://github.com/AzureAD/microsoft-authentication-library-for-python/issues/31) if it is relevant in your case.\n\n## Samples:\n\n* [Kusto Quick Start Sample App](https://github.com/Azure/azure-kusto-python/tree/master/quick_start)\n\n* [Kusto query sample snippets](https://github.com/Azure/azure-kusto-python/blob/master/azure-kusto-data/tests/sample.py)\n\n* [Data ingest sample snippets](https://github.com/Azure/azure-kusto-python/blob/master/azure-kusto-ingest/tests/sample.py)\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-python/issues/new).\n\n## Looking for SDKs for other languages/platforms?\n- [Node](https://github.com/azure/azure-kusto-node)\n- [Java](https://github.com/azure/azure-kusto-java)\n- [.NET](https://docs.microsoft.com/en-us/azure/kusto/api/netfx/about-the-sdk)\n- [Go](https://github.com/Azure/azure-kusto-go)\n\n# Contribute\n\nWe gladly accept community contributions.\n\n- Issues: Please report bugs using the Issues section of GitHub\n- Forums: Interact with the development teams on StackOverflow or the Microsoft Azure Forums\n- Source Code Contributions: If you would like to become an active contributor to this project please follow the instructions provided in [Contributing.md](CONTRIBUTING.md).\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nFor general suggestions about Microsoft Azure please use our [UserVoice forum](http://feedback.azure.com/forums/34192--general-feedback).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazure%2Fazure-kusto-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazure%2Fazure-kusto-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazure%2Fazure-kusto-python/lists"}