Skip to main content

Kusto Data Client

Project description

from azure.kusto.data import KustoClient, KustoConnectionStringBuilder

cluster = "<insert here your cluster name>"
client_id = "<insert here your AAD application id>"
client_secret = "<insert here your AAD application key>"
authority_id = "<insert here your AAD tenant id>"

kcsb = KustoConnectionStringBuilder.with_aad_application_key_authentication(cluster, client_id, client_secret, authority_id)
# It is a good practice to re-use the KustoClient instance, as it maintains a pool of connections to the Kusto service.
# This sample shows how to create a client and close it in the same scope, for demonstration purposes.
with KustoClient(kcsb) as client:
    db = "Samples"
    query = "StormEvents | take 10"

    response = client.execute(db, query)
    for row in response.primary_results[0]:
        print(row[0], " ", row["EventType"])

Kusto Python Client Library provides the capability to query Kusto clusters using Python. It is Python 3.x compatible and supports all data types through familiar Python DB API interface.

It’s possible to use the library, for instance, from Jupyter Notebooks. which are attached to Spark clusters, including, but not exclusively, Azure Databricks. instances.

Async Client

Kusto now provides an asynchronous client for queries.

To use the client, first install the package with the “aio” extra:

pip install azure-kusto-data[aio]

The async client uses exact same interface as the regular client, except that it lives in the azure.kusto.data.aio namespace, and it returns Futures you will need to await its

from azure.kusto.data import KustoConnectionStringBuilder
from azure.kusto.data.aio import KustoClient

cluster = "<insert here your cluster name>"
client_id = "<insert here your AAD application id>"
client_secret = "<insert here your AAD application key>"
authority_id = "<insert here your AAD tenant id>"


async def sample():
    kcsb = KustoConnectionStringBuilder.with_aad_application_key_authentication(cluster, client_id, client_secret, authority_id)
    async with KustoClient(kcsb) as client:
        db = "Samples"
        query = "StormEvents | take 10"

        response = await client.execute(db, query)
        for row in response.primary_results[0]:
            print(row[0], " ", row["EventType"])

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

azure-kusto-data-4.5.0.tar.gz (40.9 kB view details)

Uploaded Source

Built Distribution

azure_kusto_data-4.5.0-py2.py3-none-any.whl (50.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file azure-kusto-data-4.5.0.tar.gz.

File metadata

  • Download URL: azure-kusto-data-4.5.0.tar.gz
  • Upload date:
  • Size: 40.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for azure-kusto-data-4.5.0.tar.gz
Algorithm Hash digest
SHA256 ee58b53b70e091499de4ec0caf99efc026d49cbf9acc322251277f1876bfcadf
MD5 48dc1912041a0680b584e3f2fc41f251
BLAKE2b-256 721563d439be3dfa88f224a0100d5d65050d4d1414250fb4511c11e97ec22fb6

See more details on using hashes here.

File details

Details for the file azure_kusto_data-4.5.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for azure_kusto_data-4.5.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ac7314c3fdf2854fcd7e2b614a391b595cbc39f1bf36038a74e350cc5cc6e234
MD5 ee8858a2f80647e50672963a8b1dbc57
BLAKE2b-256 05a5f050b5b78dd3402c2e569dc3aafac21c27703110b24e251d531fa20ef521

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page