Fixes for version 0.0.22

BREAKING CHANGES:

• Change the default conversion from dynamic string.empty into dynamic null.

from azure.kusto.data.request import KustoClient, KustoConnectionStringBuilder
from azure.kusto.data.exceptions import KustoServiceError
from azure.kusto.data.helpers import dataframe_from_result_table

cluster = "https://help.kusto.windows.net:443"

kcsb = KustoConnectionStringBuilder.with_aad_device_authentication(cluster)
client = KustoClient(kcsb)
db = "Samples"

query = """print empty_dynamic = dynamic("")"""
response = client.execute(db, query)
empty = response.primary_results[0][0]["empty_dynamic"]

In the old version, the empty variable will have None type.
From version 0.0.23 and on the empty variable will have "" value.

FEATURES:

None.

FIXES:

• Fixed json.loads exception in python 3.5 - Decode the urllib pool manager response with UTF-8, so we can load it into json in python 3.5 .
• Handling dynamic values which are not dicts/arrays- Removed unneeded json.loads call for dynamic objects. It's been loaded once after we got the response.

v0.0.22

BREAKING CHANGES:

Stop supporting python 3.4 .

FEATURES:

• Support pandas 0.24.0 datetimes.
• Performance: Use connection pool instead of creating session for each request. For more detalis please read here.

FIXES:

• Raise better errors when trying to convert KustoResultDataTable into pandas DataFrame.

KustoResultTable: parse results when you receive them.

BREAKING CHANGES:

None.

FEATURES:

None.

FIXES:

• Azure packaging has changed. Kusto clients are now aligned.
  To read more about azure packaging, read this link.
• When converting datetime and timespan to pandas types, the conversion was not always correct. Read here to see how this was resolved.

Remove get_raw_response option

BREAKING CHANGES:

• get_raw_response is no longer an option to:
  KustoClient.execute
  KustoClient.execute_query
  KustoClient.execute_mgmt
  The return type will be azure.kusto.data._response.KustoResponseDataSet

FEATURES:

None

FIXES:

None

Create ClientRequestProperties class

Create ClientRequestProperties class.

BREAKING CHANGES:

• ClientRequestProperties class is introduced. The methods azure.kusto.data.request.KustoClient.execute* will no longer have the arguments accept_partial_results, timeout.
  In order to set them, an instance of ClientRequestProperties should be initiated and passed to the execute methods. Example:

from azure.kusto.data.request import ClientRequestProperties
properties = ClientRequestProperties()
properties.set_option(ClientRequestProperties.OptionDeferPartialQueryFailures, True)
properties.set_option(ClientRequestProperties.OptionServerTimeout, 10) # 10 seconds to timeout
r = client.execute_query("Database1", query, properties)

FEATURES:

• The ClientRequestProperties allow to pass options in the request body. See example above.

FIXES:

None

Add KustoAuthenticationError for detailed error when authentication error occurs.

Add anonymous authentication.

BREAKING CHANGES:

None

FEATURES:

• KustoAuthenticationError is introduced. Once authentication fails, the exception will have details of the request to acquire the token.

FIXES:

• Fix issue #73

Support new dynamic types serialization in query v2

Supporting dynamic types serialization both as dynamic (new serialization in query v2) and as string (old, for backwards compatibility).

BREAKING CHANGES:
None

FEATURES:
Support dynamic types in dataframe when dynamic types are serialized as dynamic (and not as strings).

FIXES:
None

Add anonymous authentication

Add anonymous authentication.

BREAKING CHANGES:

• Default authentication method changed from device to anonymous .
  In order to use device login it should be specified explicitly KustoConnectionStringBuilder.with_aad_device_authentication.

FEATURES:

• Added Anonymous authentication option. You can send a request without an authorization header (default option when providing just a cluster uri KustoClient("https://<cluster>.kusto.windows.net.").

FIXES:

None

Mandatory authority_id for app auth

Mandatory authority_id for app key and secret authentication

BREAKING CHANGES:

• although it was technically mandatory to supply authority_id (tenant id) when authenticating with app key and secret, it is now a mandatory argument

FEATURES:

None

FIXES:

None

Docs Fix

Fixing docs with regards to serializing kusto data table

BREAKING CHANGES:

None

FEATURES:

None

FIXES:

• Fix docs about how to serialize table + minor fix for KustoDataTable.str