azure-kusto-java/quickstart
Cole d73eeb3663
Implements azure core http client (#388)
* Introduces KustoQuery wrapper object

* working on async client

* updating client with KustoQuery object

* updating client with KustoQuery object

* updating client with KustoQuery object

* will simplify later.

* will simplify later.

* will simplify later.

* ran formatter, fixed test, fixed bad merge

* AtomicBooleans in already modified test. Save some lines, might as well.

* hide KustoQuery object

* rename and hide KustoRequest

* adding E2ETests for async queries

* ran formatter

* no complete in sink

* move blocking operations off the io thread

* run formatter

* replace execute utilization

* fixes teardown. async still doesn't work yet.

* fixes msal4j issue

* build.yaml

* Introduces KustoQuery wrapper object

* working on async client

* updating client with KustoQuery object

* updating client with KustoQuery object

* updating client with KustoQuery object

* will simplify later.

* will simplify later.

* will simplify later.

* ran formatter, fixed test, fixed bad merge

* AtomicBooleans in already modified test. Save some lines, might as well.

* hide KustoQuery object

* rename and hide KustoRequest

* adding E2ETests for async queries

* ran formatter

* no complete in sink

* move blocking operations off the io thread

* run formatter

* replace execute utilization

* fixes teardown. async still doesn't work yet.

* fixes msal4j issue

* rebased

* rework azure branch

* remove unused dependencies

* fix some more issues with imports

* add default timeout 10 min

* re-add readme

* modified changelog

* modified changelog

* removes krL

* remove async test file

* remove closeable from query clients

* fixes pom version change and removes unused reactor property

* CI_EXECUTION

* storageaccountset guard clause

* close clients in E2ETest

* remove extra assertions from teardown

* remove reactor step verifiers for now

* readd deflate to cloudinfo

* renoved reactor test library for now

* run formatter

* added fixme

* move URIBuilder to further facilitate removal of Apache

* add more detail to assertion failure

* Made InvalidConnectionString extend DataClientException so users can optionally catch the more specific exception

* commenting everything async until implementation works

* commenting everything async until implementation works

* ran formatter

* remove unused Apache classes

* removed commented code

* move message to appropriate assertion

* removed last of the commented code and ran formatter

* readd the auto-delete policy

* make request object usage private

* put back more Apache things.

* renove trailing space

* Update BaseClient.java

---------

Co-authored-by: cole <cole.snyder@gmork.tech>
Co-authored-by: asafmahlev <asafmahlev@microsoft.com>
Co-authored-by: ohad bitton <32278684+ohadbitt@users.noreply.github.com>
2024-10-27 15:11:44 +02:00
..
src/main/java/com/microsoft/azure/kusto/quickstart Implements azure core http client (#388) 2024-10-27 15:11:44 +02:00
README.md
dataset.csv
dataset.json
kusto-style.xml
kusto_sample_config.json
oneclick_instruction_box.md
pom.xml Implements azure core http client (#388) 2024-10-27 15:11:44 +02:00

README.md

Quickstart App

The quickstart application is a self-contained and runnable example app that demonstrates authenticating, connecting to, administering, ingesting data into and querying Azure Data Explorer using the azure-kusto-java 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 Java version 8 or higher on your machine. For instructions, consult a Java environment setup tutorial, like this.
  2. Set up Apache Maven, which is the most popular Java dependency management tool.

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 app.
  2. Run mvn clean install to compile the source code into a binary.
  3. Run the binary using java -jar target\kusto-quickstart-[version]-jar-with-dependencies.jar.

Troubleshooting

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