Erste Schritte mit Tools für elastische Datenbanken

Gilt für:Azure SQL-Datenbank

Dieses Dokument enthält eine Einführung in die Entwickleroberfläche für die Clientbibliothek für elastische Datenbanken, die anhand einer Beispiel-App vorgestellt wird. Mit der Beispiel-App wird eine einfache Shardinganwendung erstellt, und es werden die wichtigsten Funktionen des Features „Tools für elastische Datenbanken“ von Azure SQL-Datenbank erläutert. Dabei stehen die Anwendungsfälle für Shardzuordnungsverwaltung, datenabhängiges Routing und Abfragen mehrerer Shards im Mittelpunkt. Die Clientbibliothek ist sowohl für .NET als auch für Java verfügbar.

Tools für elastische Datenbanken für Java

Voraussetzungen

  • Ein Java Developer Kit (JDK), Version 1.8 oder höher
  • Maven
  • SQL-Datenbank oder eine lokale SQL Server-Instanz

Herunterladen und Ausführen der Beispiel-App

Verfahren Sie wie folgt, um die JAR-Dateien zu erstellen und erste Schritte mit dem Beispielprojekt auszuführen:

  1. Klonen Sie das GitHub-Repository, das die Clientbibliothek zusammen mit der Beispiel-App enthält.

  2. Bearbeiten Sie die Datei ./sample/src/main/resources/resource.properties, um folgende Eigenschaften festzulegen:

    • TEST_CONN_USER
    • TEST_CONN_PASSWORD
    • TEST_CONN_SERVER_NAME
  3. Führen Sie im Verzeichnis ./sample den folgenden Befehl aus, um das Beispielprojekt zu erstellen:

    mvn install
    
  4. Führen Sie im Verzeichnis ./sample den folgenden Befehl aus, um das Beispielprojekt zu starten:

    mvn -q exec:java "-Dexec.mainClass=com.microsoft.azure.elasticdb.samples.elasticscalestarterkit.Program"
    
  5. Experimentieren Sie mit den verschiedenen Optionen, um mehr über die Funktionen der Clientbibliothek zu erfahren. Sehen Sie sich den Code an, um mehr über die Implementierung der Beispiel-App zu erfahren.

    Progress-java

Herzlichen Glückwunsch! Sie haben mit den Tools für elastische Datenbanken in Azure SQL-Datenbank erfolgreich Ihre erste Shardinganwendung erstellt und ausgeführt. Verwenden Sie Visual Studio oder SQL Server Management Studio zum Herstellen einer Verbindung mit Ihrer Datenbank, und sehen Sie sich die vom Beispiel erstellten Shards. Sie sehen, dass mit dem Beispiel neue Beispiel-Shard-Datenbanken und eine Shard-Map-Managerdatenbank erstellt wurden.

Um die Clientbibliothek Ihrem eigenen Maven-Projekt hinzuzufügen, fügen Sie die folgende Abhängigkeit in Ihrer POM-Datei hinzu:

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

Tools für elastische Datenbanken für .NET

Voraussetzungen

  • Visual Studio 2012 oder eine neuere Version mit C#. Laden Sie eine kostenlose Version unter Visual Studio-Downloadsherunter.
  • NuGet 2.7 oder eine neuere Version. Die aktuelle Version finden Sie unter Installing NuGet (Installieren von NuGet).

Herunterladen und Ausführen der Beispiel-App

Um die Bibliothek zu installieren, wechseln Sie zu Microsoft.Azure.SqlDatabase.ElasticScale.Client. Die Bibliothek wird mit der im nachfolgenden Abschnitt beschriebenen Beispiel-App installiert.

Gehen Sie folgendermaßen vor, um das Beispiel herunterzuladen und auszuführen:

  1. Laden Sie das Beispiel Elastic DB Tools for Azure SQL – Getting Started herunter. Entzippen Sie das Beispiel an einem Speicherort Ihrer Wahl.

  2. Öffnen Sie zum Erstellen eines Projekts die Lösung ElasticDatabaseTools.sln im Verzeichnis elastic-db-tools-master.

  3. Legen Sie das Projekt ElasticScaleStarterKit als Startprojekt fest.

  4. Öffnen Sie im Projekt ElasticScaleStarterKit die Datei App.config. Befolgen Sie dann die Anweisungen in der Datei, um den Namen Ihres Servers und Ihre Anmeldeinformationen (Benutzername und Kennwort) hinzuzufügen.

  5. Erstellen Sie die Anwendung, und führen Sie sie aus. Wenn Sie dazu aufgefordert werden, lassen Sie die NuGet-Pakete der Projektmappe von Visual Studio wiederherstellen. Dadurch wird die aktuelle Version der Clientbibliothek für elastische Datenbanken von NuGet heruntergeladen.

  6. Experimentieren Sie mit den verschiedenen Optionen, um mehr über die Funktionen der Clientbibliothek zu erfahren. Beachten Sie die von der Anwendung ausgeführten Schritte in der Konsolenausgabe, und erkunden Sie den zugrunde liegenden Code.

    Progress

Herzlichen Glückwunsch! Sie haben mit den Tools für elastische Datenbanken in SQL-Datenbank erfolgreich Ihre erste Shardinganwendung erstellt und ausgeführt. Verwenden Sie Visual Studio oder SQL Server Management Studio zum Herstellen einer Verbindung mit Ihrer Datenbank, und sehen Sie sich die vom Beispiel erstellten Shards. Sie sehen, dass mit dem Beispiel neue Beispiel-Shard-Datenbanken und eine Shard-Map-Managerdatenbank erstellt wurden.

Wichtig

Wir empfehlen, immer die neueste Version von Management Studio zu verwenden, damit Sie mit Updates von Azure und SQL-Datenbank synchron sind. Aktualisieren Sie SQL Server Management Studio.

Zentrale Elemente des Codebeispiels

  • Verwalten von Shards und Shardzuordnungen: Der Code in der Datei ShardManagementUtils.cs veranschaulicht die Arbeit mit Shards, Bereichen und Zuordnungen. Weitere Informationen finden Sie unter Aufskalieren von Datenbanken mit dem Shardzuordnungs-Manager.

  • Datenabhängiges Routing: Das Routing von Transaktionen zum richtigen Shard wird in der Datei DataDependentRoutingSample.cs dargestellt. Weitere Informationen finden Sie unter Datenabhängiges Routing.

  • Abfragen über mehrere Shards hinweg: Shardübergreifende Abfragen werden in der Datei MultiShardQuerySample.cs veranschaulicht. Weitere Informationen finden Sie unter Abfragen mehrerer Shards.

  • Hinzufügen leerer Shards: Das iterative Hinzufügen neuer leerer Shards wird mit dem Code in der Datei CreateShardSample.cs durchgeführt. Weitere Informationen finden Sie unter Aufskalieren von Datenbanken mit dem Shardzuordnungs-Manager.

Weitere Elastic Scale-Operationen

Kosten

Die Bibliothek für Tools für elastische Datenbanken ist kostenlos. Bei der Verwendung der Tools für elastische Datenbanken entstehen neben den Gebühren für die Nutzung von Azure keine zusätzlichen Kosten.

Die Beispielanwendung erstellt z. B. neue Datenbanken. Die Kosten dieser Funktion richten sich nach der ausgewählten Edition von SQL-Datenbank und nach der Azure-Nutzung Ihrer Anwendung.

Preisinformationen finden Sie unter SQL-Datenbank – Preisdetails.

Nächste Schritte

Weitere Informationen zu den Tools für elastische Datenbanken finden Sie in den folgenden Artikeln: