Cette page explique les concepts liés à l'importation et au téléchargement d'objets. Vous pouvez importer et stocker n'importe quel type de données MIME d'une taille maximale de 5 Tio.
Importations
Vous pouvez envoyer des requêtes d'importation à Cloud Storage de différentes manières :
Importation par requête unique Méthode d'importation dans laquelle un objet est importé en tant que requête unique. Utilisez cette option si le fichier est suffisamment petit pour effectuer à nouveau l'importation complète en cas d'échec de connexion. Pour plus d'informations sur les importations de requêtes uniques, consultez la page Importer des objets à partir d'un fichier ou Importer des objets à partir de la mémoire.
Importer un objet à partir de la mémoire. Méthode d'importation où un objet est importé à partir de la mémoire au lieu d'un système de fichiers.
Importation avec reprise. Méthode d'importation offrant un transfert plus fiable, ce qui est particulièrement important avec les fichiers volumineux. Les importations avec reprise constituent un bon choix pour la plupart des applications, car elles fonctionnent également pour de petits fichiers au prix d'une requête HTTP supplémentaire par importation. Vous pouvez également utiliser des importations avec reprise pour effectuer des transferts en flux continu, ce qui vous permet d'importer un objet de taille inconnue.
Importation en plusieurs parties avec l'API XML. Méthode d'importation compatible avec les importations Amazon S3 en plusieurs parties. Les fichiers sont importés en plusieurs parties et assemblés en un objet unique avec la requête finale. Les importations en plusieurs parties avec l'API XML vous permettent d'importer les parties en parallèle, ce qui peut réduire le temps nécessaire à l'importation globale.
Grâce à ces types d'importation de base, vous pouvez utiliser des stratégies d'importation plus avancées :
Importation composite parallèle. Une stratégie d'importation dans laquelle vous fragmentez un fichier et importez les fragments en parallèle. Contrairement aux importations en plusieurs parties de l'API XML, les importations composites parallèles utilisent l'opération compose et l'objet final est stocké en tant qu'objet composite.
Importation en streaming. Une méthode d'importation qui vous permet d'importer des données sans que vous ayez besoin de les enregistrer d'abord dans un fichier, ce qui est utile lorsque vous ne connaissez pas la taille totale au début de l'importation.
Remarques concernant la taille d'importation
Lorsque vous choisissez d'utiliser une importation par requête unique au lieu d'une importation avec reprise ou d'une importation en plusieurs parties avec l'API XML, tenez compte de la durée que vous acceptez de perdre en cas d'échec du réseau et pour recommencer l'importation depuis le début. Pour des connexions plus rapides, votre taille limite peut être plus importante.
Par exemple, supposons que vous êtes prêt à tolérer 30 secondes de temps perdu :
Si vous procédez à une importation à partir d'un système local avec une vitesse de transfert moyenne de 8 Mbit/s, vous pouvez utiliser des importations de requêtes uniques pour des fichiers jusqu'à 30 Mo.
Si vous importez à partir d'un service régional, dont la vitesse d'importation moyenne est de 500 Mbit/s, la taille limite des fichiers est d'environ 2 Go.
Téléchargements
Tous les téléchargements à partir de Cloud Storage ont le même comportement de base : une requête GET
HTTP ou HTTPS pouvant inclure un en-tête Range
facultatif, qui définit une partie spécifique de l'objet à télécharger.
Grâce à ce comportement de téléchargement de base, vous pouvez reprendre les téléchargements interrompus et utiliser des stratégies de téléchargement plus avancées, telles que les téléchargements d'objets en plusieurs parties et les téléchargements en flux continu.
Assistance par outil
Console
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la console Google Cloud :
- Importations à requête unique, avec des importations avec reprise gérées automatiquement en votre nom.
- Téléchargements simples, généralement des téléchargements authentifiés via un navigateur
Ligne de commande
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez Google Cloud CLI :
Bibliothèques clientes
C++
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente C++ :
C#
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente C# :
Go
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente Go :
- Téléchargements simples
- Téléchargements en flux continu
- Importations à requête unique et importations avec reprise, selon la taille du fichier
- Importations en flux continu
Java
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente Java :
Node.js
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente Node.js :
PHP
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente PHP :
Python
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente Python :
- Téléchargements simples
- Téléchargements d'objets en plusieurs parties
- Importations à requête unique et importations avec reprise, selon la taille du fichier
- Importations en plusieurs parties avec l'API XML
Ruby
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la bibliothèque cliente Ruby :
Terraform
Vous pouvez effectuer des importations par requête unique lorsque vous utilisez Terraform. Les importations avec reprise s'effectuent automatiquement lorsque la taille du fichier importé est supérieure à 16 Mio.
API REST
API JSON
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez l'API JSON :
API XML
Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez l'API XML :
Si vous utilisez l'API REST pour importer et télécharger des données, consultez la section Points de terminaison de requêtes pour une discussion complète sur les points de terminaison de requête que vous pouvez utiliser.
Étape suivante
- Transférez des objets depuis votre instance Compute Engine.
- Rendez vos données accessibles publiquement.
- Affichez et modifiez les métadonnées de vos objets.
- Découvrez comment transférer des données vers Cloud Storage à l'aide du service de transfert de stockage.