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.0.1.tar.gz (38.1 kB view details)

Uploaded Source

Built Distribution

azure_kusto_data-4.0.1-py2.py3-none-any.whl (47.8 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: azure-kusto-data-4.0.1.tar.gz
  • Upload date:
  • Size: 38.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.15

File hashes

Hashes for azure-kusto-data-4.0.1.tar.gz
Algorithm Hash digest
SHA256 a788958ab9d3ed2c3f39b7702587a625169bf073b356101f45b9a64f1ff05b03
MD5 92196cebf7d91761bc31601d1eb139ff
BLAKE2b-256 518e0ccf018f39c68d5d754c8c1947ef5b3d1749b59fb782d2cf034634e31c64

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for azure_kusto_data-4.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 7b3c2ccdb688f9938a04a1dfb9749acc43ca8896a3c87550b2dfe7476480417f
MD5 2f5894fd434b48b757a9d2ab07b5c124
BLAKE2b-256 3aff804117c9dc920778ceff7c8e9a4585c466c9a460be9bb9b473cf7904a89f

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