Azure Cosmos DB Node.js-SDK für SQL-API: Versionshinweise und Ressourcen

GILT FÜR: SQL-API

Resource Link
Herunterladen des SDK NPM
API-Dokumentation Referenzdokumentation zum JavaScript SDK
SDK-Installationsanweisungen Installationsanweisungen
Mitwirkung am SDK GitHub
Beispiele Node.js-Codebeispiele
Tutorial mit ersten Schritten Erste Schritte mit dem JavaScript SDK
Tutorial zu Web-Apps Erstellen einer Node.js-Webanwendung mithilfe von Azure Cosmos DB
Aktuell unterstützte Plattform Node.js v12.x: SDK-Version 3.x.x
Node.js v10.x: SDK-Version 3.x.x
Node.js v8.x: SDK-Version 3.x.x
Node.js v6.x: SDK-Version 2.x.x
Node.js v4.2.0: SDK-Version 1.x.x
Node.js v0.12: SDK-Version 1.x.x
Node.js v0.10: SDK-Version 1.x.x

Versionshinweise

3.1.0

  • Legen Sie den Standardwert für ResponseContinuationTokenLimitInKB auf 1 KB fest. Standardmäßig begrenzen wir diesen Wert auf 1 KB, um lange Header zu vermeiden (für Node.js gilt eine globale Begrenzung der Headergröße). Ein Benutzer kann dieses Feld so festlegen, dass längere Header möglich sind, was dem Back-End helfen kann, die Ausführung von Abfragen zu optimieren.
  • Entfernen Sie disableSSLVerification. Für diese Option gibt es neue Alternativen, die in #388 beschrieben sind.

3.0.4

  • Zulassen, dass initialHeaders Header von Partitionsschlüsseln explizit festlegt
  • package.json#files wird verwendet, um zu verhindern, dass externe Dateien veröffentlicht werden
  • Sortierfehlers bei Routingzuordnungen in einer älteren Version von node+v8 korrigiert
  • Fehler korrigiert, wenn der Benutzer teilweise Wiederholungsoptionen angibt

3.0.3

  • Verhindern, dass Webpack Module auflöst, die mit „require“ aufgerufen werden

3.0.2

  • Schon lange bestehenden Fehler behoben, bei dem RUs für Aggregatabfragen stets als 0 gemeldet wurden

3.0.0

🎉 Veröffentlichung von Version 3! 🎉 Viele neue Features, Fehlerbehebungen und einige wichtige Änderungen. Primäre Ziele dieser Version:

  • Wichtige neue Features implementieren
    • DISTINCT-Abfragen
    • LIMIT/OFFSET-Abfragen
    • Vom Benutzer abbrechbare Anforderungen
  • Aktualisierung auf die neueste Version der Cosmos-REST-API, in der alle Container unbegrenzte Skalierbarkeit haben
  • Verwendung von Cosmos im Browser vereinfacht
  • Bessere Abstimmung auf die neuen Richtlinien für das Azure JS SDK

Migrationshandbuch für wichtige Änderungen

Clientkonstruktoroptionen verbessert

Konstruktoroptionen wurden vereinfacht:

  • masterKey wurde in „key“ umbenannt und auf die oberste Ebene verschoben
  • Eigenschaften, die sich zuvor unter „options.auth“ befanden, wurden auf die oberste Ebene verschoben
// v2
const client = new CosmosClient({
    endpoint: "https://your-database.cosmos.azure.com",
    auth: {
        masterKey: "your-primary-key"
    }
})

// v3
const client = new CosmosClient({
    endpoint: "https://your-database.cosmos.azure.com",
    key: "your-primary-key"
})
QueryIterator-API vereinfacht

In Version 2 gab es viele verschiedene Möglichkeiten, Ergebnisse einer Abfrage zu durchlaufen oder abzurufen. Wir haben versucht, die API der Version 3 zu vereinfachen und ähnliche oder doppelte APIs zu entfernen:

  • iterator.next() und iterator.current() entfernt. Verwenden Sie fetchnext(), um Seiten mit Ergebnissen abzurufen.
  • Entfernen Sie iterator.forEach(). Verwenden Sie stattdessen asynchrone Iteratoren.
  • iterator.executeNext() in iterator.fetchNext() umbenannt
  • iterator.toArray() in iterator.fetchAll() umbenannt
  • Seiten sind nun ordnungsgemäße Antwortobjekte anstatt einfache JS-Objekte
  • const container = client.database(dbId).container(containerId)
// v2
container.items.query('SELECT * from c').toArray()
container.items.query('SELECT * from c').executeNext()
container.items.query('SELECT * from c').forEach(({ body: item }) => { console.log(item.id) })

// v3
container.items.query('SELECT * from c').fetchAll()
container.items.query('SELECT * from c').fetchNext()
for await(const { result: item } in client.databases.readAll().getAsyncIterator()) {
    console.log(item.id)
}
Feste Container sind jetzt partitioniert

Der Cosmos-Dienst unterstützt jetzt Partitionsschlüssel in allen Containern, einschließlich denjenigen, die zuvor als feste Container erstellt wurden. Das SDK der Version 3 wird auf die neueste API-Version aktualisiert, die diese Änderung implementiert, aber Sie ist nicht unterbrechend. Wenn Sie keinen Partitionsschlüssel für den Betrieb bereitstellen, verwenden wir standardmäßig einen Systemschlüssel, der mit allen Ihren vorhandenen Containern und Dokumenten funktioniert.

Upsert für gespeicherte Prozeduren entfernt

Zuvor war Upsert für nicht partitionierte Sammlungen erlaubt, aber mit dem Update der API-Version sind alle Sammlungen partitioniert, sodass wir den Upsert vollständig entfernt haben.

Bei Lesevorgängen von Elementen wird 404 nicht ausgelöst

const container = client.database(dbId).container(containerId)

// v2
try {
    container.items.read(id, undefined)
} catch (e) {
    if (e.code === 404) { console.log('item not found') }
}

// v3
const { result: item }  = container.items.read(id, undefined)
if (item === undefined) { console.log('item not found') }
Standardmäßige Schreibvorgänge in mehreren Regionen

Das SDK schreibt jetzt standardmäßig in mehrere Regionen, wenn dies von ihrer Cosmos-Konfiguration unterstützt wird. Dieses Verhalten musste zuvor abonniert werden.

Ordnungsgemäße Fehlerobjekte

Fehlerhafte Anforderungen lösen jetzt den ordnungsgemäßen Fehler oder dessen Unterklassen aus. Zuvor wurden einfache JS-Objekte ausgelöst.

Neue Funktionen

Vom Benutzer abbrechbare Anforderungen

Durch den Umstieg auf internes Abrufen können wir die AbortController-API des Browsers verwenden, um vom Benutzer abbrechbare Vorgänge zu unterstützen. Bei Vorgängen, bei denen möglicherweise mehrere Anforderungen bearbeitet werden (z. B. bei partitionsübergreifende Abfragen), werden alle Anforderungen für den Vorgang abgebrochen. Benutzer moderner Browser verfügen bereits über AbortController. Node.js-Benutzer müssen eine Polyfill-Bibliothek verwenden.

 const controller = new AbortController()
 const {result: item} = await items.query('SELECT * from c', { abortSignal: controller.signal});
 controller.abort()
Festlegen des Durchsatzes als Teil eines Erstellungsvorgangs für DB/Container
const { database }  = client.databases.create({ id: 'my-database', throughput: 10000 })
database.containers.create({ id: 'my-container', throughput: 10000 })
@azure/cosmos-sign

Die Generierung von Headertoken wurde in die neue Bibliothek @azure/cosmos-sign verlagert. Aufrufer der Cosmos-REST-API können damit Header mit dem gleichen Code signieren, den wir innerhalb von @azure/cosmos aufrufen.

UUID für generierte IDs

Version 2 enthielt benutzerdefinierten Code zum Generieren von Element-IDs. Wir haben auf die bekannte und gepflegte Communitybibliotheks-UUID umgestellt.

Verbindungszeichenfolgen

Es ist nun möglich, eine im Azure-Portal kopierte Verbindungszeichenfolge zu übergeben:

const client = new CosmosClient("AccountEndpoint=https://test-account.documents.azure.com:443/;AccountKey=c213asdasdefgdfgrtweaYPpgoeCsHbpRTHhxuMsTaw==;")
Add DISTINCT and LIMIT/OFFSET queries (#306)
 const { results } = await items.query('SELECT DISTINCT VALUE r.name FROM ROOT').fetchAll()
 const { results } = await items.query('SELECT * FROM root r OFFSET 1 LIMIT 2').fetchAll()

Verbesserte Browsererfahrung

Obwohl es möglich war, das SDK von Version 2 im Browser zu verwenden, war dies keine ideale Lösung. Sie mussten mehrere in Node.js integrierte Polyfill-Bibliotheken und einen Bundler wie Webpack oder Parcel verwenden. Mithilfe des SDK von Version 3 ist die Standarderfahrung für Browserbenutzer wesentlich besser.

  • Anforderungsinterna durch FETCH (#245) ersetzt
  • Verwendung von BUFFER entfernt (#330)
  • In Knoten integrierte Verwendung zugunsten universeller Pakete/APIs entfernt (#328)
  • Auf node-abort-controller umgestiegen (#294)

Behebung von Programmfehlern

  • Angebot zum Lesen korrigiert und erneutes Angebot von Tests (#224)
  • EnableEndpointDiscovery korrigiert (#207)
  • Fehlende RUs in paginierten Ergebnissen korrigiert (#360)
  • SQL-Abfrageparametertyp erweitert (#346)
  • ttl zu ItemDefinition hinzugefügt (#341)
  • CP-Abfragemetriken korrigiert (#311)
  • activityId zu FeedResponse hinzugefügt (#293)
  • _ts-Typ von string in number geändert (#252)(#295)
  • Aggregation der Belastungsanforderungen korrigiert (#289)
  • Partitionsschlüssel mit leeren Zeichenfolgen zulässig (#277)
  • Zeichenfolge zum Konfliktabfragetyp hinzugefügt (#237)
  • uniqueKeyPolicy zu Container hinzugefügt (#234)

Entwicklungssysteme

Nicht immer die sichtbarsten Änderungen, aber sie helfen unserem Team, schneller besseren Code zu liefern.

  • Rollup für Produktionsbuilds verwendet (#104)
  • Auf TypeScript 3.5 aktualisiert (#327)
  • Zu TS-Projektverweisen konvertiert. Testordner extrahiert (#270)
  • noUnusedLocals und noUnusedParameters aktiviert (#275)
  • Azure Pipelines YAML für CI-Builds (#298)

2.1.5

  • Keine Änderungen am Code. Problem mit einigen zusätzliche Dateien im 2.1.4-Paket behoben.

2.1.4

  • Regionales Failover innerhalb einer Wiederholungsrichtlinie korrigiert
  • hasMoreResults-Eigenschaft von ChangeFeed korrigiert
  • Updates bei Entwicklungsabhängigkeiten
  • PolicheckExclusions.txt hinzugefügt

2.1.3

  • _ts-Typ von string in number geändert
  • Standardindizierungstests korrigiert
  • uniqueKeyPolicy zu v2 rückportiert
  • Demo- und Demodebugkorrekturen

2.1.2

  • Korrekturen beim Rückportierangebot in v3-Branch
  • Fehler in der Typsignatur von executeNext() korrigiert
  • Tippfehler korrigiert

2.1.1

  • Umstrukturierung des Builds. Ermöglicht das Pullen der SDK-Version zum Buildzeitpunkt.

2.1.0

Neue Funktionen

  • ChangeFeed-Unterstützung hinzugefügt (#196)
  • MultiPolygon-Datentyp für Indizierung hinzugefügt (#191)
  • „key“-Eigenschaft zum Konstruktor als Alias für masterKey (#202) hinzugefügt

Fehlerbehebungen

  • Fehler korrigiert, bei dem next() einen falschen Wert für den Iterator zurückgab

Entwicklungsverbesserungen

  • Integrationstest für die TypeScript-Nutzung hinzugefügt (#199)
  • Direkte Installation über GitHub aktiviert (#194)

2.0.5

  • Schnittstelle für Knoten-Agent-Typ hinzugefügt. Typescript-Benutzer müssen @types/node nicht mehr als Abhängigkeit installieren.
  • Bevorzugte Standorte werden jetzt ordnungsgemäß berücksichtigt.
  • Verbesserungen bei der Mitarbeit an der Entwicklerdokumentation
  • Verschiedene Tippfehler wurden behoben.

2.0.4

  • Das in 2.0.3 eingeführte Problem mit Typdefinitionen wurde behoben.

2.0.3

  • Die Abhängigkeit big-integer wurde entfernt.
  • Wechsel zu Verweisdirektiven für den AsyncIterable-Typ. Typescript-Benutzer müssen die Einstellung „lib“ nicht mehr anpassen.
  • Tippfehler wurden korrigiert.

2.0.2

  • Verknüpfungen der Readme-Datei wurden korrigiert.

2.0.1

  • Fehler beim Wiederholen der Schnittstellenimplementierung wurden behoben.

2.0.0

  • Allgemeine Verfügbarkeit von Version 2.0.0 des JavaScript SDK
  • Unterstützung für Schreibvorgänge in mehreren Regionen hinzugefügt

2.0.0-3

  • RC1 von Version 2.0.0 des JavaScript SDK für die Public Preview.
  • Neues Objektmodell, bei dem CosmosClient und Methoden der obersten Ebene auf die entsprechenden Datenbanken, Container und Elementklassen aufgeteilt werden.
  • Unterstützung für Zusagen.
  • In TypeScript konvertiertes SDK.

1.14.4

  • npm-Dokumentation wurde berichtigt.

1.14.3

  • Unterstützung für Standardwiederholungen bei Verbindungsproblemen hinzugefügt.
  • Unterstützung für das Lesen des Sammlungsänderungsfeeds hinzugefügt.
  • Sitzungskonsistenzfehler behoben, der zeitweilig dazu geführt hat, dass die Lesesitzung nicht verfügbar war.
  • Unterstützung für Abfragemetriken hinzugefügt.
  • Maximale Anzahl von Verbindungen des HTTP-Agents geändert.

1.14.2

  • Die Dokumentation wurde aktualisiert, damit anstelle von Azure DocumentDB auf Azure Cosmos DB verwiesen wird.
  • Unterstützung für proxyUrl-Einstellung in ConnectionPolicy hinzugefügt.

1.14.1

  • Kleinere Fehlerbehebung für Dateisysteme mit Berücksichtigung der Groß-/Kleinschreibung durchgeführt.

1.14.0

  • Unterstützung für Sitzungskonsistenz hinzugefügt.
  • Für dieses SDK muss die neueste Version des Azure Cosmos DB-Emulators vorhanden sein.

1.13.0

  • Partitionsübergreifende Abfragen sind jetzt aufteilungssicher.
  • Unterstützung für Ressourcenlinks mit führenden und nachgestellten Schrägstrichen (und entsprechende Tests) hinzugefügt.

1.12.2

  • npm-Dokumentation wurde berichtigt.

1.12.1

  • Ein Fehler in executeStoredProcedure, durch den beteiligte Dokumente Unicode-Sonderzeichen aufwiesen (LS, PS), wurde behoben.
  • Ein Fehler bei der Verarbeitung von Dokumenten mit Unicode-Zeichen im Partitionsschlüssel wurde behoben.
  • Ein Fehler bei der Unterstützung für das Erstellen von Sammlungen mit den Namensmedien wurde behoben. GitHub-Problem 114.
  • Ein Fehler bei der Unterstützung für die Berechtigung des Autorisierungstokens wurde behoben. GitHub-Problem 178.

1.12.0

  • Unterstützung für eine neue Konsistenzebene mit dem Namen „Präfixkonsistenz“ hinzugefügt.
  • Unterstützung für UriFactory hinzugefügt.
  • Ein Fehler bei der Unicode-Unterstützung wurde behoben. GitHub-Problem 171.

1.11.0

  • Unterstützung für Aggregationsabfragen (COUNT, MIN, MAX, SUM und AVG) wurde hinzugefügt.
  • Die Option zum Steuern des Parallelitätsgrads für partitionsübergreifende Abfragen wurde hinzugefügt.
  • Die Option zum Deaktivieren der TLS-Überprüfung bei der Ausführung für den Azure Cosmos DB-Emulator wurde hinzugefügt.
  • Minimaler Durchsatz für partitionierte Sammlungen wurde von 10.100 RU/s auf 2.500 RU/s gesenkt.
  • Ein Fehler beim Fortsetzungstoken für Sammlung mit einer Partition wurde behoben. GitHub-Problem 107.
  • Ein Fehler bei „executeStoredProcedure“ bei der Verarbeitung von 0 als einzelner Parameter wurde behoben. GitHub-Problem 155.

1.10.2

  • Fehler bei Benutzer-Agent-Header zum Einbeziehen der SDK-Version wurde behoben.
  • Kleinere Codebereinigung.

1.10.1

  • Deaktivieren Sie die TLS-Überprüfung, wenn als Ziel des SDK „emulator(hostname=localhost)“ verwendet wird.
  • Unterstützung für das Aktivieren der Skriptprotokollierung während der Ausführung einer gespeicherten Prozedur wurde hinzugefügt.

1.10.0

  • Unterstützung für parallele partitionsübergreifende Abfragen hinzugefügt.
  • Unterstützung für TOP-/ORDER BY-Abfragen für partitionierte Sammlungen hinzugefügt.

1.9.0

  • Unterstützung für Wiederholungsrichtlinie für gedrosselte Anforderungen hinzugefügt. (Bei gedrosselten Anforderungen wird die Ausnahme „Anforderungsrate zu groß“, Fehlercode 429, angezeigt.) Standardmäßig führt Azure Cosmos DB für jede Anforderung neun Wiederholungen durch, wenn der Fehlercode 429 auftritt, und berücksichtigt dabei die „retryAfter“-Zeit im Antwortheader. Eine feste Wiederholungsintervalldauer kann jetzt als Teil der „RetryOptions“-Eigenschaft für das „ConnectionPolicy“-Objekt festgelegt werden, wenn Sie die „retryAfter“-Zeit ignorieren möchten, die vom Server zwischen den Wiederholungen zurückgegeben wird. Azure Cosmos DB wartet jetzt bei jeder gedrosselten Anforderung (unabhängig von der Anzahl der Wiederholungen) maximal 30 Sekunden und gibt die Antwort mit dem Fehlercode 429 zurück. Diese Dauer kann auch in der RetryOptions-Eigenschaft im ConnectionPolicy-Objekt überschrieben werden.
  • Cosmos DB gibt nun „x-ms-throttle-retry-count“ und „x-ms-throttle-retry-wait-time-ms“ als Antwortheader in jeder Anforderung zurück, um die Anzahl der Wiederholungen bei einer Drosselung und die kumulative Zeit, die die Anforderung zwischen den Wiederholungen gewartet hat, anzugeben.
  • Die „RetryOptions“-Klasse wurde hinzugefügt, die die „RetryOptions“-Eigenschaft in der „ConnectionPolicy“-Klasse verfügbar macht, welche zum Überschreiben einiger der Standardwiederholungsoptionen verwendet werden kann.

1.8.0

  • Unterstützung für Datenbankkonten in mehreren Regionen hinzugefügt.

1.7.0

  • Unterstützung des TTL-Features (Time To Live) für Dokumente hinzugefügt.

1.6.0

1.5.6

  • Fehler in „RangePartitionResolver.resolveForRead“ behoben, durch den aufgrund einer ungültigen Verkettung der Ergebnisse keine Links zurückgegeben wurden.

1.5.5

  • Problem mit „hashPartitionResolver resolveForRead()“ behoben: Bei einem nicht angegebenen Partitionsschlüssel wurde eine Ausnahme ausgelöst, anstatt eine Liste aller registrierten Links zurückzugeben.

1.5.4

  • Behebt Problem 100: Dedizierter HTTPS-Agent: Vermeidung des Änderns des globalen Agents für Azure Cosmos DB-Zwecke. Verwenden Sie für alle Anforderungen der Bibliothek einen dedizierten Agent.

1.5.3

  • Behebt Problem Nr. 81: ordnungsgemäße Verarbeitung von Bindestrichen in Medien-IDs

1.5.2

  • Behebt Problem Nr. 95 : Warnung des EventEmitter-Listeners bei Arbeitsspeicherverlusten.

1.5.1

  • Behebt Problem 92: Umbenennung des Ordners „Hash“ in „hash“ für Systeme, bei denen die Groß-/Kleinschreibung beachtet wird.

1.5.0

  • Unterstützung für Sharding implementiert, indem Hash- und Bereichspartitionsresolver hinzugefügt wurden.

1.4.0

  • Upsert implementiert. Neue „upsertXXX“-Methoden für „DocumentClient“.

1.3.0

  • Version ausgelassen, um die Versionsnummer in Einklang mit den anderen SDKs zu bringen.

1.2.2

  • Q Promises Wrapper auf neues Repository aufgeteilt.
  • Paketdatei für Npm-Registrierung aktualisiert.

1.2.1

  • ID-basiertes Routing implementiert.
  • Behebt Problem 49 : Konflikt zwischen current-Eigenschaft und current()-Methode.

1.2.0

  • Unterstützung für „GeoSpatial“-Index hinzugefügt.
  • „ID“-Eigenschaft wird für alle Ressourcen überprüft. IDs für Ressourcen dürfen nicht die Zeichen ?, /, #, //, enthalten und nicht mit einem Leerzeichen enden.
  • Neue Überschrift „Fortschritt der Indextransformation“ zu „ResourceResponse“ hinzugefügt.

1.1.0

  • V2-Indizierungsrichtlinie implementiert.

1.0.3

  • Problem 40 : Implementierung der eslint- und grunt-Konfiguration im Core und Promise SDK.

1.0.2

  • Problem 45 – Promise Wrapper enthält keinen fehlerhaften Header.

1.0.1

  • Möglichkeit zum Abfragen von Konflikten durch Hinzufügen von „readConflicts“, „readConflictAsync“ und „queryConflicts“ implementiert.
  • API-Dokumentation aktualisiert.
  • Problem 41 : client.createDocumentAsync-Fehler.

1.0.0

  • Allgemeine Verfügbarkeit (GA) des SDK

Veröffentlichungs- und Deaktivierungstermine

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. Neue Features, Funktionen und Optimierungen werden nur dem aktuellen SDK hinzugefügt. Daher wird empfohlen, immer so früh wie möglich auf die neueste SDK-Version zu aktualisieren.

Version Veröffentlichungsdatum Deaktivierungstermine
3.1.0 26. Juli 2019 ---
3.0.4 22. Juli 2019 ---
3.0.3 17. Juli 2019 ---
3.0.2 9. Juli 2019 ---
3.0.0 28. Juni 2019 ---
2.1.5 20. März 2019 ---
2.1.4 15. März 2019 ---
2.1.3 8. März 2019 ---
2.1.2 28. Januar 2019 ---
2.1.1 5. Dezember 2018 ---
2.1.0 4. Dezember 2018 ---
2.0.5 7. November 2018 ---
2.0.4 30. Oktober 2018 ---
2.0.3 30. Oktober 2018 ---
2.0.2 10. Oktober 2018 ---
2.0.1 25. September 2018 ---
2.0.0 24. September 2018 ---
2.0.0-3 (RC) 2. August 2018 ---
1.14.4 3.Mai 2018 30. August 2020
1.14.3 3.Mai 2018 30. August 2020
1.14.2 21. Dezember 2017 30. August 2020
1.14.1 10. November 2017 30. August 2020
1.14.0 09. November 2017 30. August 2020
1.13.0 11. Oktober 2017 30. August 2020
1.12.2 10. August 2017 30. August 2020
1.12.1 10. August 2017 30. August 2020
1.12.0 10. Mai 2017 30. August 2020
1.11.0 16. März 2017 30. August 2020
1.10.2 27. Januar 2017 30. August 2020
1.10.1 22. Dezember 2016 30. August 2020
1.10.0 3. Oktober 2016 30. August 2020
1.9.0 7. Juli 2016 30. August 2020
1.8.0 14. Juni 2016 30. August 2020
1.7.0 26. April 2016 30. August 2020
1.6.0 29. März 2016 30. August 2020
1.5.6 8. März 2016 30. August 2020
1.5.5 2. Februar 2016 30. August 2020
1.5.4 1. Februar 2016 30. August 2020
1.5.2 26. Januar 2016 30. August 2020
1.5.2 22. Januar 2016 30. August 2020
1.5.1 4. Januar 2016 30. August 2020
1.5.0 31. Dezember 2015 30. August 2020
1.4.0 06. Oktober 2015 30. August 2020
1.3.0 06. Oktober 2015 30. August 2020
1.2.2 10. September 2015 30. August 2020
1.2.1 15. August 2015 30. August 2020
1.2.0 5. August 2015 30. August 2020
1.1.0 9. Juli 2015 30. August 2020
1.0.3 4. Juni 2015 30. August 2020
1.0.2 23. Mai 2015 30. August 2020
1.0.1 15. Mai 2015 30. August 2020
1.0.0 8. April 2015 30. August 2020

Häufig gestellte Fragen

Wie werde ich über die Einstellung eines SDK benachrichtigt?

Um einen reibungslosen Übergang zu einem unterstützten SDK zu ermöglichen, informiert Microsoft 12 Monate vor Ende des Supports über die Einstellung eines SDK. Sie werden über verschiedene Kommunikationskanäle benachrichtigt: Azure-Portal, Azure-Updates und direkte Kommunikation mit den entsprechenden Dienstadministratoren.

Kann ich mit einem Azure Cosmos DB SDK, das eingestellt werden soll, während der 12-monatigen Frist Anwendungen erstellen?

Ja, mit einem solchen Azure Cosmos DB SDK können Sie während der 12-monatigen Frist Anwendungen erstellen, bereitstellen und ändern. Es wird empfohlen, nach Bedarf innerhalb der 12-monatigen Frist zu einer neueren unterstützten Version des Azure Cosmos DB SDK zu migrieren.

Was geschieht nach dem Einstellungsdatum mit Anwendungen, die das nicht unterstützte Azure Cosmos DB SDK verwenden?

Nach dem Einstellungsdatum werden von Azure Cosmos DB für die eingestellten SDK-Versionen keine Fehlerbehebungen mehr durchgeführt und keine neuen Funktionen hinzugefügt, und es wird auch kein Support mehr dafür angeboten. Wenn Sie kein Upgrade durchführen möchten, werden von den eingestellten Versionen des SDK gesendete Anforderungen weiterhin vom Azure Cosmos DB-Dienst bedient.

Welche SDK-Versionen werden über die neuesten Funktionen und Updates verfügen?

Neue Funktionen und Updates werden nur der aktuellen Nebenversion der neuesten unterstützten SDK-Hauptversion hinzugefügt. Es wird empfohlen, immer die aktuelle Version zu verwenden, um von neuen Funktionen, Leistungsverbesserungen und Fehlerbehebungen zu profitieren. Wenn Sie eine alte, noch nicht eingestellte Version des SDK verwenden, funktionieren Ihre Anforderungen an Azure Cosmos DB weiterhin, Sie haben jedoch keinen Zugriff auf neue Funktionen.

Was muss ich tun, wenn ich meine Anwendung nicht vor einem Stichtag aktualisieren kann?

Es wird empfohlen, so früh wie möglich auf das neueste SDK zu aktualisieren. Nachdem ein SDK für die Einstellung markiert wurde, bleiben Ihnen 12 Monate zur Aktualisierung Ihrer Anwendung. Wenn Sie die Aktualisierung nicht bis zum Einstellungsdatum vornehmen können, werden von den eingestellten Versionen des SDK gesendete Anforderungen weiterhin von Azure Cosmos DB verarbeitet, sodass Ihre ausgeführten Anwendungen weiterhin funktionieren. Für die eingestellten SDK-Versionen werden jedoch von Azure Cosmos DB keine Fehlerbehebungen mehr durchgeführt und keine neuen Funktionen hinzugefügt, und es wird auch kein Support mehr dafür angeboten.

Wenn Sie über einen Supportplan verfügen und technischen Support benötigen, kontaktieren Sie uns, indem Sie ein Supportticket erstellen.

Weitere Informationen

Weitere Informationen zu Cosmos DB finden Sie auf der Seite zum Dienst Microsoft Azure Cosmos DB.