зеркало из
1
0
Форкнуть 0
azure-kusto-python/quick_start
mayamarom10 4f9af0f592
Changed dataframe_from_result_table function (#538)
* Added dictionary options as parameters for type matching for dataframe_from_result_table func

* reformatted the file

* reformatted the file

* reformatted the file

* Fixes after PR

* Fixes after PR

* Fixes after PR

* Fixes after PR

* Fixes after PR

* For python 3.7 3.8

* Nullable bools fix

* Nullable bools fix

* Nullable bools fix

* Nullable bools fix2

* PR comment fixes

* LRU cache default paramaters for python 3.7

* LRU cache maxsize=1

* modified changes requested

* black
2024-06-17 09:59:54 +03:00
..
README.md typo 2022-08-10 09:43:37 +03:00
dataset.csv Quick Start Sample App (#339) 2021-11-01 11:49:19 +02:00
dataset.json Quick Start Sample App (#339) 2021-11-01 11:49:19 +02:00
kusto_sample_config.json ignorefirstrecord fix (#413) 2022-09-20 17:05:15 +03:00
oneclick_instruction_box.md Update oneclick_instruction_box.md 2022-08-10 09:43:47 +03:00
quick_start.iml Changed dataframe_from_result_table function (#538) 2024-06-17 09:59:54 +03:00
requirements.txt User/t eitanmoed/distributed tracing (#419) 2023-02-08 11:27:33 +02:00
sample_app.py User/t eitanmoed/distributed tracing (#419) 2023-02-08 11:27:33 +02:00
utils.py ignorefirstrecord fix (#413) 2022-09-20 17:05:15 +03:00

README.md

Quickstart App

The quick start application is a self-contained and runnable example script that demonstrates authenticating, connecting to, administering, ingesting data into and querying Azure Data Explorer using the azure-kusto-python SDK. You can use it as a baseline to write your own first kusto client application, altering the code as you go, or copy code sections out of it into your app.

Tip: The app includes comments with tips on recommendations, coding best practices, links to reference materials and recommended TODO changes when adapting the code to your needs.

Using the App for the first time

Prerequisites

  1. Set up Python version 3.7 or higher on your machine. For instructions, consult a Python environment setup tutorial, like this.

Retrieving the app from GitHub

  1. Download the app files from this GitHub repo.
  2. Modify the kusto_sample_config.json file, changing KustoUri, IngestUri and DatabaseName appropriately for your cluster.

Retrieving the app from OneClick

  1. Open a browser and type your cluster's URL (e.g. https://mycluster.westeurope.kusto.windows.net/). You will be redirected to the Azure Data Explorer Web UI.
  2. On the left menu, select Data.
  3. Click Generate Sample App Code and then follow the instructions in the wizard.
  4. Download the app as a ZIP file.
  5. Extract the app source code. Note: The configuration parameters defined in the kusto_sample_config.json file are preconfigured with the appropriate values for your cluster. Verify that these are correct.

Run the app

  1. Open a command line window and navigate to the folder where you extracted the script.
  2. Run python -m pip install -r requirements.txt. If upgrading, append --upgrade.
  3. Run python sample_app.py.

Troubleshooting

  • If you are having trouble running the script from your IDE, first check if the script runs from the command line, then consult the troubleshooting references of your IDE.

Optional changes

You can make the following changes from within the script itself:

  • Change the location of the configuration file by editing CONFIG_FILE_NAME.