Elastic database tools for JAVA (Azure SQL Database)

The elastic database client library allows JAVA developers to create applications that use database sharding in Azure SQL Database. This repository contains the library/tools along with a sample project. For the C# version of the database tools client library, see https://github.com/Azure/elastic-db-tools. For more information on Azure SQL database tools for managing scaled out databases, see the documentation.

Prerequisites

• A Java Developer Kit (JDK), v 1.8 or later
• Maven
• A logical server in Azure or local SQL Server

Running the sample code in sample

Follow the steps below to build the JAR files and get started with the sample project:

• Clone the repository
• Edit the ./sample/src/main/resources/resource.properties file to add your username, password, and logical server name.
• From the ./sample directory, run the following command to build the sample project.
  mvn install
• From the ./sample directory, run the following command to start the sample project.
  mvn -q exec:java "-Dexec.mainClass=com.microsoft.azure.elasticdb.samples.elasticscalestarterkit.Program"

Download

For using the released JAR, simply add the following dependancy to your POM file:

<dependency>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>elastic-db-tools</artifactId>
      <version>1.0.0</version>
</dependency>

Contribute code

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

If you would like to become an active contributor to this project please follow the instructions provided in Microsoft Azure Projects Contribution Guidelines.

1. Fork the repository
2. Create your branch (git checkout -b my-new-branch)
3. Commit your changes (git commit -am 'Add some change/feature')
4. Push to the branch (git push origin my-new-branch)
5. Create new Pull Request

License

The elastic database client library for Java is licensed under the MIT license. See the LICENSE file for more details.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.