Documentation sur Oracle Cloud Infrastructure

Exécution d'un chargement en plusieurs parties

Sur Compute Cloud@Customer, vous pouvez charger des objets en plusieurs parties.

Les chargements en plusieurs parties permettent de charger des parties individuelles en parallèle afin de réduire la durée de chargement.

Le chargement en plusieurs parties permet de charger des objets qui sont trop grands pour une opération de chargement unique. Les parties de l'objet ne doivent pas dépasser 50 GiB.

Vous pouvez effectuer une pause entre les chargements de parties individuelles et reprendre le chargement lorsque votre programme et vos ressources le permettent.

Parties d'objet

Avec le chargement en plusieurs parties, vous avez fractionné l'objet à charger en différentes parties. Les différentes parties peuvent avoir une taille de 50 GiB. La taille maximale d'un objet chargé est 10 TiB.

Déterminez le numéro de partie à utiliser pour chaque partie. Les numéros de partie peuvent être compris entre 1 et 10 000. Vous n'avez pas besoin d'affecter des numéros contigus, mais le stockage d'objets construit l'objet en organisant les numéros de partie dans l'ordre croissant.

API de chargement en plusieurs parties

Avant d'utiliser l'API de chargement en plusieurs parties, vous devez créer les parties à charger. Le service de stockage d'objets fournit des opérations d'API pour les étapes restantes.

Un chargement en plusieurs parties effectué à l'aide de l'API comprend les étapes suivantes :

  1. Démarrez un chargement.

  2. Charger les parties d'objet.

  3. Validez le chargement.

Le service offre également des opérations d'API pour lister les chargements en plusieurs parties en cours, lister des parties d'objet dans un chargement en plusieurs parties en cours et abandonner des chargements en plusieurs parties lancés au moyen de l'API.

Interface de ligne de commande de chargement en plusieurs parties

Lorsque vous effectuez un chargement en plusieurs parties à l'aide de l'interface de ligne de commande, vous n'avez pas besoin de fractionner l'objet en parties, comme vous devez le faire pour l'API. À la place, vous spécifiez la taille de votre choix et le stockage d'objets fractionne l'objet en parties et effectue le chargement de toutes les parties automatiquement. Vous pouvez choisir de définir le nombre maximal de parties pouvant être chargées en parallèle. Par défaut, l'interface de ligne de commande limite le nombre de parties pouvant être chargées en parallèle à trois. Lorsque vous utilisez l'interface de ligne de commande, vous n'avez pas à effectuer une validation lorsque le chargement est terminé.

Vous pouvez également utiliser l'interface de ligne de commande pour lister les chargements en plusieurs parties en cours et annuler les chargements en plusieurs parties lancés au moyen de l'API.

  • Cette tâche n'est pas disponible dans la console.

  • Utilisez la commande oci os object put et les paramètres requis pour charger un objet en plusieurs parties.

    Syntaxe :

    oci os object put --namespace-name <object_storage_namespace> --bucket-name <bucket_name> --file <file_location> --parallel-upload-count <maximum_number_parallel_uploads> --part-size <upload_part_size_in_MB> --force [OPTIONS]

    Exemple : 

    oci os object put   \
--namespace-name examplenamespace  \
--file /boot/initramfs-0-rescue-e542c19f0fbf4e41a41428d933a7357f.img   \
--parallel-upload-count 5   \
--part-size 15   \
--force

Upload ID: a21bba2c-8922-4b9c-a98a-9ef3569c0138
Split file into 6 parts for upload.
Uploading object [####################################] 100%
{
  "etag": "0964effc8dc4394fd317f03a025ae5d0",
  "last-modified": "2021-05-11T21:35:19",
  "opc-multipart-md5": "UIVRhiwSHY6o0E4pi/yfGg==-6"
}

    Pour la liste complète des commandes, indicateurs et options de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

  • Un chargement en plusieurs parties effectué à l'aide de l'API comprend les étapes suivantes :

    1. Démarrage d'un chargement.
    2. Chargement des parties d'objet.
    3. Validation du chargement.

    Avant d'utiliser l'API de chargement en plusieurs parties, vous devez créer les parties à charger. Le service de stockage d'objets fournit des opérations d'API pour les étapes restantes. Le service offre également des opérations d'API pour lister les chargements en plusieurs parties en cours, lister des parties d'objet dans un chargement en plusieurs parties en cours et abandonner des chargements en plusieurs parties lancés au moyen de l'API.

    Note

    Ces exigences en matière d'API de chargement en plusieurs parties ne s'appliquent pas à l'interface de ligne de commande.

    Pour plus d'informations sur l'utilisation de l'API de chargement en plusieurs parties, voir Utilisation de l'API de chargement en plusieurs parties.

    Utilisez l'opération PutObject pour charger un objet en plusieurs parties.

    Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.