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

Importations

Vous pouvez envoyer des requêtes d'importation à Cloud Storage de différentes manières :

  • Importation via une requête unique. Méthode d'importation par laquelle un objet est importé via une requête unique. Utilisez cette option si le fichier est suffisamment petit pour effectuer l'importation complète en cas d'échec de connexion. Pour plus d'informations sur les importations via des requêtes uniques, consultez la page Importer des objets à partir d'un fichier ou Importer des objets à partir de la mémoire.

    • Importation en plusieurs parties avec l'API JSON. Méthode d'importation qui permet d'importer à la fois les données d'un objet et ses métadonnées en une seule requête. Toutefois, l'API XML permet de définir les métadonnées d'objet dans tous les types d'importations.

  • 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 tarif 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. Stratégie d'importation dans laquelle vous fragmentez un fichier et importez les fragments en parallèle. Contrairement aux importations en plusieurs parties avec l'API XML, les importations composites parallèles utilisent l'opération de composition et l'objet final est stocké en tant qu'objet composite.

  • Importation en flux continu. 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 au début la taille totale de l'importation.

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

Remarques concernant la taille d'importation

Lorsque vous choisissez d'utiliser une importation via une 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 de la durée nécessaire 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 d'importation moyenne de 8 Mbit/s, vous pouvez utiliser des importations via des 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 consoleGoogle Cloud  :

Ligne de commande

Vous pouvez effectuer les types d'importation et de téléchargement suivants lorsque vous utilisez la 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 via une 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 effectuer des importations et des téléchargements, consultez la section Points de terminaison de requêtes pour en savoir plus sur les points de terminaison de requête que vous pouvez utiliser.

Étapes suivantes