Azure Cosmos DB Python SDK: risorse e note sulla versioneAzure Cosmos DB Python SDK: Release notes and resources

Download dell'SDKDownload SDKPyPIPyPI
Documentazione sull'APIAPI documentationDocumentazione di riferimento delle API di PythonPython API reference documentation
Istruzioni per l'installazione dell'SDKSDK installation instructionsIstruzioni per l'installazione dell'SDK di PythonPython SDK installation instructions
Contribuire all'SDKContribute to SDKGitHubGitHub
Attività inizialiGet startedIntroduzione all'SDK di PythonGet started with the Python SDK
Piattaforma attualmente supportataCurrent supported platformPython 2.7 e Python 3.5Python 2.7 and Python 3.5

Note sulla versioneRelease notes

2.3.02.3.0

2.2.12.2.1

  • Correzione di bug per il dizionario di aggregazione.Bug fix for aggregate dictionary.
  • Correzione di bug per la rimozione di barre iniziali nel collegamento a una risorsa.Bug fix for trimming slashes in the resource link.
  • Aggiunti test per la codifica Unicode.Added tests for Unicode encoding.

2.2.02.2.0

  • Aggiunta del supporto per un nuovo livello di coerenza denominato ConsistentPrefix.Added support for a new consistency level called ConsistentPrefix.

2.1.02.1.0

  • Aggiunta del supporto per le query di aggregazione (COUNT, MIN, MAX, SUM e AVG).Added support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG).
  • Aggiunta di un'opzione per disabilitare la verifica SSL durante l'esecuzione sull'emulatore Cosmos DB.Added an option for disabling SSL verification when running against Cosmos DB Emulator.
  • Rimossa la restrizione per cui il modulo delle richieste dipendenti deve essere esattamente 2.10.0.Removed the restriction of dependent requests module to be exactly 2.10.0.
  • Velocità effettiva minima ridotta nelle raccolte partizionate da 10.100 UR/s a 2.500 UR/s.Lowered minimum throughput on partitioned collections from 10,100 RU/s to 2500 RU/s.
  • Aggiunta del supporto per l'abilitazione della registrazione degli script durante l'esecuzione di stored procedure.Added support for enabling script logging during stored procedure execution.
  • Versione API REST incrementata a "2017-01-19" con questo rilascio.REST API version bumped to '2017-01-19' with this release.

2.0.12.0.1

  • Modifiche editoriali ai commenti alla documentazione.Made editorial changes to documentation comments.

2.0.02.0.0

  • Aggiunto il supporto per Python 3.5.Added support for Python 3.5.
  • Aggiunto il supporto per il pool di connessioni con modulo di richiesta.Added support for connection pooling using a requests module.
  • Aggiunto il supporto per la coerenza di sessione.Added support for session consistency.
  • Aggiunto il supporto per le query TOP/ORDERBY per le raccolte partizionate.Added support for TOP/ORDERBY queries for partitioned collections.

1.9.01.9.0

  • Aggiunta del supporto per il criterio di ripetizione dei tentativi delle richieste limitateAdded retry policy support for throttled requests. (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.(Throttled requests receive a request rate too large exception, error code 429.) By default, Azure Cosmos DB retries nine times for each request when error code 429 is encountered, honoring the retryAfter time in the response header. 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.A fixed retry interval time can now be set as part of the RetryOptions property on the ConnectionPolicy object if you want to ignore the retryAfter time returned by server between the retries. 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.Azure Cosmos DB now waits for a maximum of 30 seconds for each request that is being throttled (irrespective of retry count) and returns the response with error code 429. Questo tempo può essere sottoposto a override nella proprietà RetryOptions dell'oggetto ConnectionPolicy.This time can also be overriden in the RetryOptions property on ConnectionPolicy object.
  • 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.Cosmos DB now returns x-ms-throttle-retry-count and x-ms-throttle-retry-wait-time-ms as the response headers in every request to denote the throttle retry count and the cummulative time the request waited between the retries.
  • Rimozione della classe RetryPolicy e della proprietà corrispondente (retry_policy) esposta nella classe document_client e introduzione di una classe RetryOptions che espone la proprietà RetryOptions nella classe ConnectionPolicy che può essere utilizzata per eseguire l’override di alcune opzioni di ripetizione dei tentativi predefinite.Removed the RetryPolicy class and the corresponding property (retry_policy) exposed on the document_client class and instead introduced a RetryOptions class exposing the RetryOptions property on ConnectionPolicy class that can be used to override some of the default retry options.

1.8.01.8.0

  • Aggiunta del supporto per gli account di database con più aree.Added the support for multi-region database accounts.

1.7.01.7.0

  • Aggiunta del supporto per la funzionalità di durata (TTL) relativa ai documenti.Added the support for Time To Live(TTL) feature for documents.

1.6.11.6.1

  • Correzioni di bug relativi al partizionamento lato server per consentire caratteri speciali nel percorso partitionkey.Bug fixes related to server side partitioning to allow special characters in partitionkey path.

1.6.01.6.0

1.5.01.5.0

  • Aggiungi resolver per partizioni hash e a intervalli come supporto per applicazioni di partizionamento orizzontale in più partizioni.Add Hash & Range partition resolvers to assist with sharding applications across multiple partitions.

1.4.21.4.2

  • Implementazione di Upsert.Implement Upsert. Nuovi metodi upsertXXX aggiunti per supportare la funzionalità Upsert.New UpsertXXX methods added to support Upsert feature.
  • Implementazione del routing basato su ID.Implement ID Based Routing. Nessuna modifica API pubblica, tutte modifiche interne.No public API changes, all changes internal.

1.2.01.2.0

  • Supporta l'indice geospaziale.Supports GeoSpatial index.
  • Convalida la proprietà id per tutte le risorse.Validates id property for all resources. Gli ID per le risorse non possono contenere i caratteri ?, /, #, , o terminare con uno spazio.Ids for resources cannot contain ?, /, #, , characters or end with a space.
  • Aggiunge la nuova intestazione "stato di trasformazione dell'indice" a ResourceResponse.Adds new header "index transformation progress" to ResourceResponse.

1.1.01.1.0

  • Implementazione del criterio di indicizzazione V2.Implements V2 indexing policy.

1.0.11.0.1

  • Supporto della connessione proxy.Supports proxy connection.

1.0.01.0.0

  • SDK con disponibilità generale.GA SDK.

Date di rilascio e di ritiroRelease & retirement dates

Microsoft invierà una notifica almeno 12 mesi prima del ritiro di un SDK per agevolare la transizione a una versione più recente o supportata.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.

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.New features and functionality and optimizations are only added to the current SDK, as such it is recommend that you always upgrade to the latest SDK version as early as possible.

Qualsiasi richiesta inviata a Cosmos DB con un SDK ritirato verrà rifiutata dal servizio.Any request to Cosmos DB using a retired SDK will be rejected by the service.

Avviso

Tutte le versioni dell'SDK per Python di Azure DocumentDB precedenti alla versione 1.0.0 verranno ritirate il 29 febbraio 2016.All versions of the Azure DocumentDB SDK for Python prior to version 1.0.0 will be retired on February 29, 2016.


VersioneVersion Data di rilascioRelease Date Data di ritiroRetirement Date
2.3.02.3.0 10 novembre 2017November 10, 2017 ---
2.2.12.2.1 29 settembre 2017Sep 29, 2017 ---
2.2.02.2.0 10 maggio 2017May 10, 2017 ---
2.1.02.1.0 01 maggio 2017May 01, 2017 ---
2.0.12.0.1 30 ottobre 2016October 30, 2016 ---
2.0.02.0.0 29 settembre 2016September 29, 2016 ---
1.9.01.9.0 07 luglio 2016July 07, 2016 ---
1.8.01.8.0 14 giugno 2016June 14, 2016 ---
1.7.01.7.0 26 aprile 2016April 26, 2016 ---
1.6.11.6.1 08 aprile 2016April 08, 2016 ---
1.6.01.6.0 29 marzo 2016March 29, 2016 ---
1.5.01.5.0 03 gennaio 2016January 03, 2016 ---
1.4.21.4.2 06 ottobre 2015October 06, 2015 ---
1.4.11.4.1 06 ottobre 2015October 06, 2015 ---
1.2.01.2.0 06 agosto 2015August 06, 2015 ---
1.1.01.1.0 09 luglio 2015July 09, 2015 ---
1.0.11.0.1 25 maggio 2015May 25, 2015 ---
1.0.01.0.0 07 aprile 2015April 07, 2015 ---
0.9.4-prelease0.9.4-prelease 14 gennaio 2015January 14, 2015 29 febbraio 2016February 29, 2016
0.9.3-prelease0.9.3-prelease 09 dicembre 2014December 09, 2014 29 febbraio 2016February 29, 2016
0.9.2-prelease0.9.2-prelease 25 novembre 2014November 25, 2014 29 febbraio 2016February 29, 2016
0.9.1-prelease0.9.1-prelease 23 settembre 2014September 23, 2014 29 febbraio 2016February 29, 2016
0.9.0-prelease0.9.0-prelease 21 agosto 2014August 21, 2014 29 febbraio 2016February 29, 2016

Domande frequentiFAQ

1. In che modo i clienti verranno avvisati circa l'SDK in fase di ritiro?1. How will customers be notified of the retiring SDK?

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.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. 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.Further, customers will be notified through various communication channels – Azure Management Portal, Developer Center, blog post, and direct communication to assigned service administrators.

2. I clienti potranno creare applicazioni usando la versione dell'SDK di Azure Cosmos DB "in fase di ritiro" durante il periodo di 12 mesi?2. Can customers author applications using a "to-be" retired Azure Cosmos DB SDK during the 12 month period?

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 dell'SDK di Azure Cosmos DB "in fase di ritiro".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. Durante il periodo di tolleranza di 12 mesi, i clienti sono invitati a eseguire la migrazione a una versione supportata più recente dell'SDK di Azure Cosmos DB.During the 12 month grace period, customers are advised to migrate to a newer supported version of Azure Cosmos DB SDK as appropriate.

3. I clienti potranno creare e modificare applicazioni usando una versione dell'SDK di Azure Cosmos DB ritirata dopo il periodo di notifica di 12 mesi?3. Can customers author and modify applications using a retired Azure Cosmos DB SDK after the 12 month notification period?

Dopo il periodo di notifica di 12 mesi, l'SDK verrà ritirato.After the 12 month notification period, the SDK will be retired. La piattaforma Azure Cosmos DB non consentirà alcun tentativo di accesso ad Azure Cosmos DB da applicazioni che usano una versione di SDK ritirata.Any access to Azure Cosmos DB by an applications using a retired SDK will not be permitted by the Azure Cosmos DB platform. Inoltre, Microsoft non fornirà più il supporto tecnico per la versione di SDK ritirata.Further, Microsoft will not provide customer support on the retired SDK.

4. Cosa accade alle applicazioni in esecuzione del cliente che usano una versione non supportata dell'SDK di Azure Cosmos DB?4. What happens to Customer’s running applications that are using unsupported Azure Cosmos DB SDK version?

Qualsiasi tentativo di connessione al servizio Azure Cosmos DB con una versione di SDK ritirata verrà rifiutato.Any attempts made to connect to the Azure Cosmos DB service with a retired SDK version will be rejected.

5. Le nuove funzioni e funzionalità verranno applicate anche a tutti gli SDK non ritirati?5. Will new features and functionality be applied to all non-retired SDKs?

Le nuove funzioni e funzionalità verranno aggiunte solo alle nuove versioni.New features and functionality will only be added to new versions. Se si usa una versione di SDK precedente non ritirata, le richieste inviate ad Azure Cosmos DB continueranno a funzionare come in precedenza, ma non sarà possibile accedere alle nuove funzionalità.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. Come si deve procedere se non è possibile aggiornare l'applicazione prima della data del ritiro?6. What should I do if I cannot update my application before a cut-off date?

Si consiglia di effettuare l'aggiornamento alla versione di SDK più recente quanto prima.We recommend that you upgrade to the latest SDK as early as possible. Una volta che un SDK è stato contrassegnato per il ritiro, l'utente ha a disposizione 12 mesi per aggiornare l'applicazione.Once an SDK has been tagged for retirement you will have 12 months to update your application. 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.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.

Vedere ancheSee also

Per altre informazioni su Cosmos DB, vedere la pagina del servizio Microsoft Azure Cosmos DB.To learn more about Cosmos DB, see Microsoft Azure Cosmos DB service page.