Les objets ajoutables dans les buckets zonaux vous permettent d'ajouter progressivement des données à un objet sans réécrire l'intégralité de l'objet, ce qui vous aide à gérer les flux de données continus. Les buckets zonaux sont disponibles via Rapid Bucket et utilisent la classe de stockage Rapid, une classe de stockage hautes performances optimisée pour les charges de travail nécessitant de nombreuses opérations d'E/S.
Ce document explique comment créer, écrire et lire des objets ajoutables. Il vous montre également comment suspendre, reprendre et finaliser des objets, lire la fin des objets et optimiser la latence d'écriture avec un pool de rédacteurs pré-ouverts. Avant de commencer, vous pouvez apprendre à créer un bucket zonal et à importer des objets dans un bucket.
Effectuer des écritures ajoutables dans des objets
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant importe un objet pouvant être ajouté :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant importe un objet pouvant être ajouté :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant importe un objet pouvant être ajouté :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant importe un objet pouvant être ajouté :
Rust
L'exemple suivant importe un objet pouvant être ajouté :
Lire les objets
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant effectue une lecture par plage sur un seul objet :
L'exemple suivant effectue une lecture complète sur un seul objet :
L'exemple suivant effectue des lectures par plage sur un seul objet :
L'exemple suivant effectue des lectures par plage sur plusieurs objets (une seule lecture par objet) :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant effectue une lecture par plage sur un seul objet :
L'exemple suivant effectue une lecture complète sur un seul objet :
L'exemple suivant effectue des lectures par plage sur un seul objet :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant effectue une lecture par plage sur un seul objet :
L'exemple suivant effectue une lecture complète sur un seul objet :
L'exemple suivant effectue des lectures par plage sur un seul objet :
L'exemple suivant effectue des lectures par plage sur plusieurs objets :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant effectue une lecture par plage sur un seul objet :
L'exemple suivant effectue une lecture complète sur un seul objet :
L'exemple suivant effectue des lectures par plage sur un seul objet :
L'exemple suivant effectue des lectures par plage sur plusieurs objets :
Rust
L'exemple suivant effectue une lecture par plage sur un seul objet :
L'exemple suivant effectue une lecture complète sur un seul objet :
L'exemple suivant effectue des lectures par plage sur un seul objet :
L'exemple suivant effectue des lectures par plage sur plusieurs objets :
Suspendre et réactiver l'accès pour un objet
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant met en pause et réactive un objet ajoutable :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant met en pause et réactive un objet ajoutable :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant met en pause et réactive un objet ajoutable :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant met en pause et réactive un objet ajoutable :
Rust
L'exemple suivant met en pause et réactive un objet ajoutable :
Finaliser un objet
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant finalise un objet pouvant être ajouté :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant finalise un objet pouvant être ajouté :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant finalise un objet pouvant être ajouté :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant finalise un objet pouvant être ajouté :
Rust
L'exemple suivant finalise un objet pouvant être ajouté :
Lire la fin d'un objet
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant lit la fin d'un objet ajoutable :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant lit la fin d'un objet ajoutable :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant lit la fin d'un objet ajoutable :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant lit la fin d'un objet ajoutable :
Rust
L'exemple suivant lit la fin d'un objet ajoutable :
Optimiser la latence d'écriture
Si vous gérez votre propre logique d'écriture parallèle gRPC, envisagez d'utiliser un pool de rédacteurs pré-ouverts sur des objets ajoutables non finalisés. Étant donné que l'objet de chaque rédacteur est déjà créé et que son flux est déjà ouvert, votre application peut ajouter des données immédiatement au lieu d'attendre la création de l'objet et la configuration du flux lorsqu'elle doit écrire.
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant utilise un pool de rédacteurs pré-ouverts pour un bucket zonal :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant utilise un pool de rédacteurs pré-ouverts pour un bucket zonal :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant utilise un pool de rédacteurs pré-ouverts pour un bucket zonal :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
L'exemple suivant utilise un pool de rédacteurs pré-ouverts pour un bucket zonal :