Azure Cosmos DB Async Java SDK für SQL-API: Versionshinweise und RessourcenAzure Cosmos DB Async Java SDK for SQL API: Release notes and resources

Das Async Java SDK für die SQL-API unterscheidet sich vom Java SDK für die SQL-API dahingehend, dass es asynchrone Vorgänge mit Unterstützung der Netty-Bibliothek bereitstellt.The SQL API Async Java SDK differs from the SQL API Java SDK by providing asynchronous operations with support of the Netty library. Das bereits vorhandene Java SDK für die SQL-API unterstützt asynchrone Vorgänge nicht.The pre-existing SQL API Java SDK does not support asynchronous operations.

SDK-DownloadSDK DownloadMavenMaven
API-DokumentationAPI documentationJava-API-ReferenzdokumentationJava API reference documentation
Am SDK mitwirkenContribute to SDKGitHubGitHub
Erste SchritteGet startedErste Schritte mit dem Async Java SDKGet started with the Async Java SDK
CodebeispielCode sampleGithubGithub
LeistungstippsPerformance tipsGithub-InfodateiGithub readme
Unterstützte MindestlaufzeitMinimum supported runtimeJDK 8JDK 8

VersionshinweiseRelease notes

2.0.12.0.1

  • Ein Fehler für nicht englische Gebietsschemas wurde behoben (GitHub #51).Fixed a bug for non-english locales (github #51).
  • In der Konfliktressource wurden Hilfsmethoden hinzugefügt.Added helper methods in Conflict Resource.

2.0.02.0.0

  • Die org.json-Abhängigkeit wurde aufgrund der Leistung und Lizenzierung durch jackson ersetzt (Github Nr. 29).Replaced org.json dependency by jackson due to performance reasons and licensing (github #29).
  • Die veraltete OfferV2-Klasse wurde entfernt.Removed deprecated OfferV2 class.
  • Die Zugriffsmethode wurde für die Offer-Klasse für Durchsatzinhalte hinzugefügt.Added accessor method to Offer class for throughput content.
  • Alle Methoden in „Document/Resource“, die org.json-Typen zurückgeben, wurden geändert, um einen jackson-Objekttyp zurückzugeben.Any method in Document/Resource returning org.json types changed to return a jackson object type.
  • getObject(.)-Methode von Klassen, die „JsonSerializable“ erweitern, wurde geändert, um einen jackson-ObjectNode-Typ zurückzugeben.getObject(.) method of classes extending JsonSerializable changed to return a jackson ObjectNode type.
  • getCollection(.)-Methode wurde geändert, um eine Sammlung von „ObjectNode“ zurückzugeben.getCollection(.) method changed to return Collection of ObjectNode.
  • Konstruktoren für JsonSerializable-Unterklassen mit org.json.JSONObject-Argumenten wurden entfernt.Removed JsonSerializable subclasses' constructors with org.json.JSONObject arg.
  • JsonSerializable.toJson (SerializationFormattingPolicy.Indented) verwendet nun zwei Leerzeichen für die Einrückung.JsonSerializable.toJson (SerializationFormattingPolicy.Indented) now uses two spaces for indentation.

1.0.21.0.2

  • Unterstützung für die Richtlinie des eindeutigen Index wurde hinzugefügt.Added support for Unique Index Policy.
  • Unterstützung für die Begrenzung der Antwort bezüglich der Größe von Fortsetzungstoken in Feedoptionen wurde hinzugefügt.Added support for limiting response continuation token size in feed options.
  • Unterstützung für die Partitionsaufteilung in partitionsübergreifenden Abfragen wurde hinzugefügt.Added support for Partition Split in Cross Partition Query.
  • Fehler in der JSON-Zeitstempelserialisierung wurde behoben (github #32).Fixed a bug in Json timestamp serialization (github #32).
  • Fehler in der JSON-Enumerationsserialisierung wurde behoben.Fixed a bug in Json enum serialization.
  • Fehler bei der Verwaltung von Dokumenten mit einer Größe von 2 MB wurde behoben (github #33).Fixed a bug in managing documents of 2MB size (github #33).
  • Abhängigkeit von com.fasterxml.jackson.core:jackson-databind wurde auf 2.9.5 aufgrund eines Fehlers aktualisiert (jackson-databind: github #1599).Dependency com.fasterxml.jackson.core:jackson-databind upgraded to 2.9.5 due to a bug (jackson-databind: github #1599)
  • Abhängigkeit von rxjava-extras wurde auf 0.8.0.17 aufgrund eines Fehlers aktualisiert (rxjava-extras: github #30).Dependency on rxjava-extras upgraded to 0.8.0.17 due to a bug (rxjava-extras: github #30).
  • Die Metadatenbeschreibung in der Pom-Datei wurde aktualisiert, damit sie mit dem Rest der Dokumentation übereinstimmt.The metadata description in pom file updated to be inline with the rest of documentation.
  • Syntaxverbesserung (github #41), (github 40 #)Syntax improvement (github #41), (github #40).

1.0.11.0.1

  • Rückstauunterstützung in Abfrage hinzugefügtAdded back-pressure support in query.
  • Unterstützung für die ID des Partitionsschlüsselbereichs in der Abfrage hinzugefügtAdded support for partition key range id in query.
  • Korrektur, um größeres Fortsetzungstoken im Anforderungsheader zu ermöglichen (Fehlerbehebung: GitHub Nr. 24).Fix to allow larger continuation token in request header (bugfix github #24).
  • Netty-Abhängigkeit aktualisiert auf 4.1.22. Sicherstellung, dass JVM nach Abschluss des Hauptthreads herunterfährt.Netty dependency upgraded to 4.1.22.Final to ensure JVM shuts down after main thread finishes.
  • Korrektur, um beim Lesen der Masterressourcen die Übergabe des Sitzungstokens zu verhindernFix to avoid passing session token when reading master resources.
  • Weitere Beispiele hinzugefügtAdded more examples.
  • Weitere Benchmarktestszenarien hinzugefügtAdded more benchmarking scenarios.
  • Java-Headerdateien zur ordnungsgemäßen Erstellung von Java-Dokumenten korrigiertFixed Java header files for proper java doc generation.

1.0.01.0.0

  • Allgemein verfügbares SDK mit End-to-End-Unterstützung für nicht blockierende EA-Vorgänge mit der Netty-Bibliothek im GatewaymodusGA SDK with end-to-end support for non-blocking IO using the Netty library in gateway mode.

Veröffentlichungs- und DeaktivierungstermineRelease and retirement dates

Wenn Microsoft ein SDK deaktiviert, werden Sie mindestens 12 Monate vorher benachrichtigt, um einen reibungslosen Übergang zu einer neueren/unterstützten Version zu gewährleisten.Microsoft will provide notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.

Neue Features, Funktionen und Optimierungen werden nur zum aktuellen SDK hinzugefügt.New features and functionality and optimizations are only added to the current SDK. Daher wird empfohlen, stets so früh wie möglich ein Upgrade auf die aktuelle SDK-Version auszuführen.So it's recommended that you always upgrade to the latest SDK version as early as possible.

Anforderungen an Cosmos DB mithilfe eines deaktivierten SDK werden vom Dienst abgelehnt.Any request to Cosmos DB using a retired SDK will be rejected by the service.


VersionVersion HerausgabedatumRelease Date DeaktivierungstermineRetirement Date
2.0.12.0.1 16. August 2018August 16, 2018 ---
2.0.02.0.0 20. Juni 2018June 20, 2018 ---
1.0.21.0.2 18. Mai 2018May 18, 2018 ---
1.0.11.0.1 20. April 2018April 20, 2018 ---
1.0.01.0.0 27. Februar 2018February 27, 2018 ---

Häufig gestellte FragenFAQ

1. Wie werden Kunden über die Deaktivierung eines SDK benachrichtigt?1. How will customers be notified of the retiring SDK?

Bei Deaktivierung eines SDK benachrichtigt Microsoft seine Kunden 12 Monate vor Beendigung der Unterstützung, um einen reibungslosen Übergang zu einem unterstützten SDK sicherzustellen.Microsoft will provide 12 month advance notification to the end of support of the retiring SDK in order to facilitate a smooth transition to a supported SDK. Kunden werden über verschiedene Kommunikationskanäle benachrichtigt: Azure-Verwaltungsportal, Developer Center, Blogbeitrag und direkter Austausch mit den Administratoren der entsprechenden Dienste.Further, customers will be notified through various communication channels – Azure Management Portal, Developer Center, blog post, and direct communication to assigned service administrators.

2. Können Kunden mit einem Azure Cosmos DB SDK, das deaktiviert werden soll, während des 12-monatigen Zeitraums Anwendungen entwickeln?2. Can customers author applications using a "to-be" retired Azure Cosmos DB SDK during the 12 month period?

Ja, mit einem solchen Azure Cosmos DB SDK können Kunden während der 12-monatigen Frist Anwendungen bei vollem Zugriff erstellen, bereitstellen und ändern.Yes, customers will have full access to author, deploy and modify applications using the "to-be" retired Azure Cosmos DB SDK during the 12 month grace period. Während der 12-monatigen Frist wird Kunden empfohlen, ggf. zu einer neueren unterstützten Version des Azure Cosmos DB SDK zu wechseln.During the 12 month grace period, customers are advised to migrate to a newer supported version of Azure Cosmos DB SDK as appropriate.

3. Können Kunden mit einem deaktivierten Azure Cosmos DB SDK nach Ablauf des 12-monatigen Benachrichtigungszeitraums Anwendungen erstellen und ändern?3. Can customers author and modify applications using a retired Azure Cosmos DB SDK after the 12 month notification period?

Das SDK wird nach Ablauf des 12-monatigen Benachrichtigungszeitraums deaktiviert.After the 12 month notification period, the SDK will be retired. Der Zugriff auf Azure Cosmos DB durch eine Anwendung mithilfe eines deaktivierten SDK wird von der Azure Cosmos DB-Plattform nicht zugelassen.Any access to Azure Cosmos DB by an applications using a retired SDK will not be permitted by the Azure Cosmos DB platform. Darüber hinaus bietet Microsoft keinen Kundensupport für das deaktivierte SDK.Further, Microsoft will not provide customer support on the retired SDK.

4. Was geschieht mit Kunden, die Anwendungen ausführen, für die eine nicht unterstützte Version des Azure Cosmos DB SDK verwendet wird?4. What happens to Customer’s running applications that are using unsupported Azure Cosmos DB SDK version?

Alle Versuche zum Herstellen einer Verbindung mit dem Azure Cosmos DB-Dienst mit einer deaktivierten SDK-Version werden abgelehnt.Any attempts made to connect to the Azure Cosmos DB service with a retired SDK version will be rejected.

5. Werden neue Features und Funktionen auf alle noch aktivierten SDKs angewendet?5. Will new features and functionality be applied to all non-retired SDKs?

Neue Features und Funktionen werden nur neuen Versionen hinzugefügt.New features and functionality will only be added to new versions. Wenn Sie eine alte, noch aktivierte Version des SDK verwenden, funktionieren Ihre Anforderungen an Azure Cosmos DB weiter wie bisher, aber Sie haben keinen Zugriff auf neue Funktionen.If you are using an old, non-retired, version of the SDK your requests to Azure Cosmos DB will still function as previous but you will not have access to any new capabilities.

6. Was muss ich tun, wenn ich meine Anwendung nicht vor einem Stichtag aktualisieren kann?6. What should I do if I cannot update my application before a cut-off date?

Es wird empfohlen, so früh wie möglich auf das neueste SDK zu aktualisieren.We recommend that you upgrade to the latest SDK as early as possible. Sobald ein SDK für die Deaktivierung markiert wurde, bleiben Ihnen 12 Monate zur Aktualisierung Ihrer Anwendung.Once an SDK has been tagged for retirement you will have 12 months to update your application. Wenn Sie aus einem beliebigen Grund die Aktualisierung der Anwendung in diesem Zeitraum nicht schaffen, kontaktieren Sie das Cosmos DB-Team, und bitten Sie vor dem Stichtag um Hilfe.If, for whatever reason, you cannot complete your application update within this timeframe then please contact the Cosmos DB Team and request their assistance before the cutoff date.

Weitere InformationenSee also

Weitere Informationen zu Cosmos DB finden Sie auf der Seite zum Dienst Microsoft Azure Cosmos DB.To learn more about Cosmos DB, see Microsoft Azure Cosmos DB service page.