Azure Cosmos DB Node.js SDK: risorse e note sulla versione

Download dell'SDKNPM
Documentazione sull'APIDocumentazione di riferimento delle API di Node.js
Istruzioni per l'installazione dell'SDKIstruzioni di installazione
Contribuire all'SDKGitHub
EsempiEsempi di codice Node.js
Esercitazione introduttivaIntroduzione all'SDK di Node.js
Esercitazione sull'app WebCreare un'applicazione Web Node.js con Azure Cosmos DB
Piattaforma attualmente supportata Node.js v6.x
Node.js v4.2.0
Node.js v0.12
Node.js v0.10

Note sulla versione

1.12.0

1.11.0

  • Aggiunta del supporto per le query di aggregazione (COUNT, MIN, MAX, SUM e AVG).
  • Aggiunta dell'opzione per il controllo del grado di parallelismo per query nella partizione.
  • Aggiunta dell'opzione per disabilitare la verifica SSL durante l'esecuzione sull'emulatore Azure Cosmos DB.
  • Velocità effettiva minima ridotta nelle raccolte partizionate da 10.100 UR/s a 2.500 UR/s.
  • Correzione del bug del token di continuazione per raccolta a partizione singola (github #107).
  • Correzione del bug executeStoredProcedure nella gestione di 0 come parametro singolo (github #155).

1.10.2

  • Corretta l'intestazione agente-utente per includere la versione di SDK.
  • Pulizia del codice di minore entità.

1.10.1

  • Disabilitazione della verifica SSL durante l'uso dell'SDK per l'emulatore(nomehost=host).
  • Aggiunta del supporto per l'abilitazione della registrazione degli script durante l'esecuzione di stored procedure.

1.10.0

  • Aggiunta del supporto per le query in parallelo nelle raccolte partizionate.
  • Aggiunta del supporto per le query TOP/ORDER BY nelle raccolte partizionate.

1.9.0

  • Aggiunta del supporto per il criterio di ripetizione dei tentativi delle richieste limitate (le richieste limitate ricevano un'eccezione troppo grande per la frequenza delle richieste, con codice di errore 429). Per impostazione predefinita, Cosmos DB esegue nove tentativi per ogni richiesta con codice di errore 429, rispettando l'intervallo di tempo di retryAfter specificato nell'intestazione della risposta. Adesso è possibile impostare un intervallo di tempo fisso per i tentativi come parte della proprietà RetryOptions nell'oggetto ConnectionPolicy se si desidera ignorare il tempo di retryAfter restituito dal server tra i tentativi. Azure Cosmos DB attende al massimo 30 secondi per ogni richiesta che viene limitata (indipendentemente dal numero di tentativi) e restituisce la risposta con il codice di errore 429. Questo tempo può essere sottoposto a override nella proprietà RetryOptions dell'oggetto ConnectionPolicy.
  • Cosmos DB restituisce ora i parametri x-ms-throttle-retry-count e x-ms-throttle-retry-wait-time-ms come intestazioni di risposta in ogni richiesta per indicare il numero di nuovi tentativi di limitazione e il tempo cumulativo di attesa della richiesta tra i tentativi.
  • La classe RetryOptions è stata aggiunta, esponendo la proprietà RetryOptions nella classe ConnectionPolicy che può essere utilizzata per eseguire l'override di alcune opzioni di ripetizione dei tentativi predefinite.

1.8.0

  • Aggiunta del supporto per gli account di database con più aree.

1.7.0

  • Aggiunta del supporto per la funzionalità di durata (TTL) relativa ai documenti.

1.6.0

1.5.6

  • Correzione del bug RangePartitionResolver.resolveForRead, relativo alla mancata restituzione di collegamenti a causa di un concatenamento non valido dei risultati.

1.5.5

  • Corretto hashParitionResolver resolveForRead(): quando la mancata indicazione di una chiave di partizione generava un'eccezione, invece di restituire un elenco di tutti i collegamenti registrati.

1.5.4

  • Correzione del problema n. 100 relativo all'agente HTTPS dedicato: evitare di modificare l'agente globale per gli scopi di Azure Cosmos DB. Usare un agente dedicato per tutte le richieste della libreria.

1.5.3

  • Correzione del problema n. 81 : gestione corretta dei trattini negli ID dei file multimediali.

1.5.2

  • Correzione del problema n. 95 : avviso di perdita del listener EventEmitter.

1.5.1

  • Correzione del problema n. 92 : ridenominazione della cartella Hash in hash per i sistemi con distinzione tra maiuscole e minuscole.

1.5.0

  • Implementazione del supporto per il partizionamento orizzontale mediante l'aggiunta di resolver della partizione a intervalli e hash.

1.4.0

  • Implementazione di Upsert. Nuovi metodi upsertXXX in documentClient.

1.3.0

  • Saltata per riallineare il numero di versione con altri SDK.

1.2.2

  • Divisione del wrapper Q promise per il nuovo repository
  • Aggiornamento del file del pacchetto del Registro di sistema npm

1.2.1

  • Implementazione del routing basato su ID
  • Correzione del problema n. 49 : conflitto tra la proprietà current e il metodo current().

1.2.0

  • Aggiunta del supporto per l'indice GeoSpatial
  • Convalida la proprietà id per tutte le risorse. Gli ID per le risorse non possono contenere i caratteri ?, /, #, // o terminare con uno spazio.
  • Aggiunge la nuova intestazione "stato di trasformazione dell'indice" a ResourceResponse.

1.1.0

  • Implementazione del criterio di indicizzazione V2.

1.0.3

  • Problema n. 40 : implementazione delle configurazioni eslint e grunt nell'SDK core e promise.

1.0.2

  • Problema #45 : il wrapper promise non include l'intestazione con errore

1.0.1

  • Implementazione della possibilità di eseguire query per i conflitti aggiungendo readConflicts, readConflictAsync e queryConflicts
  • Aggiornamento della documentazione relativa alle API
  • Problema n. 41 : errore client.createDocumentAsync.

1.0.0

  • SDK con disponibilità generale.

Date di rilascio e di ritiro

Microsoft invierà una notifica almeno 12 mesi prima del ritiro di un SDK per agevolare la transizione a una versione più recente o supportata.

Le nuove caratteristiche e funzionalità e le ottimizzazioni vengono aggiunte solo all'SDK corrente, è quindi consigliabile eseguire sempre l'aggiornamento alla versione più recente dell'SDK quanto prima.

Qualsiasi richiesta inviata a Cosmos DB con un SDK ritirato verrà rifiutata dal servizio.


Versione Data di rilascio Data di ritiro
1.12.0 10 maggio 2017 ---
1.11.0 16 marzo 2017 ---
1.10.2 27 gennaio 2017 ---
1.10.1 22 dicembre 2016 ---
1.10.0 03 ottobre 2016 ---
1.9.0 07 luglio 2016 ---
1.8.0 14 giugno 2016 ---
1.7.0 26 aprile 2016 ---
1.6.0 29 marzo 2016 ---
1.5.6 08 marzo 2016 ---
1.5.5 02 febbraio 2016 ---
1.5.4 01 febbraio 2016 ---
1.5.2 26 gennaio 2016 ---
1.5.2 22 gennaio 2016 ---
1.5.1 4 gennaio 2016 ---
1.5.0 31 dicembre 2015 ---
1.4.0 06 ottobre 2015 ---
1.3.0 06 ottobre 2015 ---
1.2.2 10 settembre 2015 ---
1.2.1 15 agosto 2015 ---
1.2.0 05 agosto 2015 ---
1.1.0 09 luglio 2015 ---
1.0.3 04 giugno 2015 ---
1.0.2 23 maggio 2015 ---
1.0.1 15 maggio 2015 ---
1.0.0 08 aprile 2015 ---

domande frequenti

1. In che modo i clienti verranno avvisati circa l'SDK in fase di ritiro?

Microsoft invierà una notifica anticipata 12 mesi prima fine del supporto dell'SDK in fase di ritiro per agevolare la transizione a un SDK supportato. I clienti verranno anche informati tramite vari canali di comunicazione, ad esempio il portale di gestione di Azure, il centro sviluppatori e comunicazioni dirette indirizzate agli amministratori dei servizi indicati.

2. I clienti potranno creare applicazioni usando la versione di DocumentDB SDK "in fase di ritiro" durante il periodo di 12 mesi?

Sì, durante il periodo di tolleranza di 12 mesi ai clienti sarà garantito l'accesso completo per creare, distribuire e modificare applicazioni tramite la versione di DocumentDB SDK "in fase di ritiro". Durante il periodo di tolleranza di 12 mesi, i clienti sono invitati a eseguire la migrazione a una versione supportata più recente di DocumentDB SDK.

3. I clienti potranno creare e modificare applicazioni usando una versione di DocumentDB SDK ritirata dopo il periodo di notifica di 12 mesi?

Dopo il periodo di notifica di 12 mesi, l'SDK verrà ritirato. La piattaforma DocumentDB non consentirà alcun tentativo di accesso a DocumentDB da applicazioni che usano una versione di SDK ritirata. Inoltre, Microsoft non fornirà più il supporto tecnico per la versione di SDK ritirata.

4. Cosa accade alle applicazioni in esecuzione del cliente che usano una versione non supportata di DocumentDB SDK?

Qualsiasi tentativo di connessione al servizio DocumentDB con una versione di SDK ritirata verrà rifiutato.

5. Le nuove funzioni e funzionalità verranno applicate anche a tutti gli SDK non ritirati?

Le nuove funzioni e funzionalità verranno aggiunte solo alle nuove versioni. Se si usa una versione di SDK precedente non ritirata, le richieste inviate a DocumentDB continueranno a funzionare come in precedenza ma non sarà possibile accedere alle nuove funzionalità.

6. Come si deve procedere se non è possibile aggiornare l'applicazione prima della data del ritiro?

Si consiglia di effettuare l'aggiornamento alla versione di SDK più recente quanto prima. Una volta che un SDK è stato contrassegnato per il ritiro, l'utente ha a disposizione 12 mesi per aggiornare l'applicazione. Se, per qualunque motivo, non è possibile completare l'aggiornamento dell'applicazione entro questo periodo di tempo, contattare il team di Cosmos DB e richiedere assistenza prima della data prevista per il ritiro.

Vedere anche

Per altre informazioni su Cosmos DB, vedere la pagina del servizio Microsoft Azure Cosmos DB.