Caricamenti di oggetti

Questa pagina illustra i concetti relativi al caricamento degli oggetti. Puoi caricare e archiviare qualsiasi tipo MIME di dati fino a 5 TiB di dimensioni.

Tipi di caricamento

Puoi inviare richieste di caricamento a Cloud Storage nei seguenti modi:

  • Caricamento con richiesta singola. Un metodo di caricamento in cui un oggetto viene caricato come singola richiesta. Utilizza questa opzione se il file è abbastanza piccolo da poter essere caricato interamente se la connessione non riesce. Consulta Carica oggetto da file o Carica oggetto dalla memoria per le guide ai caricamenti con richiesta singola.

    • Caricamento multiparte dell'API JSON. Un metodo di caricamento che ti consente di caricare sia i dati dell'oggetto sia i relativi metadati in un'unica richiesta. Tuttavia, l'API XML consente di impostare i metadati degli oggetti in tutti i tipi di caricamenti.

  • Caricamento ripristinabile. Un metodo di caricamento che fornisce un trasferimento più affidabile, particolarmente importante con file di grandi dimensioni. I caricamenti ripristinabili sono una buona scelta per la maggior parte delle applicazioni, poiché funzionano anche per file di piccole dimensioni al costo di una richiesta HTTP aggiuntiva per caricamento. Puoi anche utilizzare i caricamenti ripristinabili per eseguire trasferimenti in modalità flusso, che ti consentono di caricare un oggetto di dimensioni sconosciute.

  • Caricamento multiparte dell'API XML. Un metodo di caricamento compatibile con i caricamenti multiparte di Amazon S3. I file vengono caricati in parti e assemblati in un unico oggetto con la richiesta finale. I caricamenti multiparte dell'API XML consentono di caricare le parti in parallelo, riducendo potenzialmente il tempo necessario per completare il caricamento complessivo.

Utilizzando questi tipi di caricamento di base, sono possibili strategie di caricamento più avanzate:

  • Caricamento composito parallelo. Una strategia di caricamento in cui suddividi un file in blocchi e li carichi in parallelo. A differenza dei caricamenti multiparte dell'API XML, i caricamenti compositi paralleli utilizzano l'operazione di composizione e l'oggetto finale viene archiviato come oggetto composito.

  • Caricamento in streaming. Un metodo di caricamento che consente di caricare i dati senza richiedere che vengano prima salvati in un file, il che è utile quando non conosci le dimensioni totali del caricamento all'inizio.

  • Caricamento con codifica di trasferimento in blocchi. Un caricamento con una singola richiesta che include l'intestazione Transfer-Encoding: chunked, che consente di inviare il caricamento in più blocchi di dati sequenziali.

Considerazioni sulle dimensioni di caricamento

Quando scegli se utilizzare un caricamento con richiesta singola anziché un caricamento ripristinabile o un caricamento multiparte dell'API XML, considera il tempo che sei disposto a perdere in caso di errore di rete e se devi riavviare il caricamento dall'inizio. Per connessioni più veloci, la dimensione limite può essere in genere maggiore.

Ad esempio, supponiamo che tu sia disposto a tollerare 30 secondi di tempo perso:

  • Se carichi da un sistema locale con una velocità di caricamento media di 8 Mbps, puoi utilizzare i caricamenti con richiesta singola per file di dimensioni fino a 30 MB.

  • Se carichi da un servizio all'interno della regione con una velocità di caricamento media di 500 Mbps, la dimensione limite per i file è di quasi 2 GB.

Supporto per strumento

Console

Quando utilizzi la consoleGoogle Cloud , puoi eseguire i seguenti tipi di caricamenti:

Riga di comando

Quando utilizzi Google Cloud CLI, puoi eseguire i seguenti tipi di caricamenti:

Librerie client

C++

Quando utilizzi la libreria client C++, puoi eseguire i seguenti tipi di caricamenti:

C#

Quando utilizzi la libreria client C#, puoi eseguire i seguenti tipi di caricamenti:

Vai

Quando utilizzi la libreria client Go, puoi eseguire i seguenti tipi di caricamenti:

Java

Quando utilizzi la libreria client Java, puoi eseguire i seguenti tipi di caricamenti:

Node.js

Quando utilizzi la libreria client Node.js, puoi eseguire i seguenti tipi di caricamenti:

PHP

Quando utilizzi la libreria client PHP, puoi eseguire i seguenti tipi di caricamenti:

Python

Quando utilizzi la libreria client Python, puoi eseguire i seguenti tipi di caricamenti:

Ruby

Quando utilizzi la libreria client Ruby, puoi eseguire i seguenti tipi di caricamenti:

Terraform

Quando utilizzi Terraform, puoi eseguire caricamenti con richiesta singola. I caricamenti ripristinabili vengono eseguiti automaticamente quando il file caricato è superiore a 16 MiB.

API REST

Se utilizzi le API REST per caricare oggetti, consulta Endpoint di richiesta per una discussione completa sugli endpoint di richiesta che puoi utilizzare.

Passaggi successivi