Importations et téléchargements

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.

  • 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.

  • Importation avec encodage de transfert par blocs Importation avec une requête unique qui inclut l'en-tête Transfer-Encoding: chunked, ce qui permet d'envoyer l'importation en plusieurs blocs de données séquentiels.

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 :

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 :

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 :

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