Per iniziare

Quando collabori con il tuo contatto di vendita o di assistenza per configurare l'accesso a Data Transfer v2.0, ti verrà fornito un nome del bucket. Devi fornire al tuo contatto commerciale un gruppo Google che ti consenta di controllare l'accesso ai tuoi file di dati in Google Cloud Storage.

Puoi scegliere di accedere ai tuoi dati utilizzando un'utilità o puoi scrivere il tuo codice.

Accedere ai dati utilizzando gsutil

Lo strumento gsutil è un'applicazione della riga di comando, scritta in Python, che ti consente di accedere ai tuoi dati senza dover scrivere codice. Ad esempio, puoi utilizzare gsutil come parte di uno script o di un file batch anziché creare applicazioni personalizzate.

Per iniziare a utilizzare gsutil, leggi la documentazione di gsutil. Lo strumento ti chiederà le credenziali la prima volta che lo utilizzi e le memorizzerà per un uso successivo.

Esempi di gsutil

Puoi elencare tutti i tuoi file utilizzando gsutil nel seguente modo:

gsutil ls gs://[bucket_name]/[object name/file name]

gsutil utilizza gran parte della stessa sintassi di UNIX, incluso l'asterisco (*) come carattere jolly, quindi puoi elencare tutti i file NetworkImpression:

gsutil ls gs://[bucket_name]/dcm_account6837_impression_*

Scaricare un file è altrettanto semplice:

gsutil cp gs://[bucket_name]/dcm_account6837_impression_2015120100.log.gz

Puoi copiare i file dai bucket Google DT dispersi nel tuo bucket GCS dell'API Google utilizzando uno script shell Unix. Esistono due opzioni:

  • In gsutil, se utilizzi un sistema Unix, esegui il seguente comando per tutti i bucket ogni giorno:

    $ day=$(date --date="1 days ago" +"%m-%d-%Y")
    $ gsutil -m cp gs://{<dcmhashid_A>,<dcmhashid_B>,etc.}/*$day*.log.gz gs://<client_bucket>/
  • In alternativa, una soluzione un po' più complessa è utilizzare un file bash:

    #!/bin/bash
    
    set -x
    
    buckets={dfa_-hasid_A dfa_-hashid_B,...} #include all hash ids
    day=$(date --date="1 days ago" +"%m-%d-%Y")
    for b in ${buckets[@]}; do /
        gsutil -m cp gs://$b/*$day*.log.gz gs:/// /
    done

Accedere ai dati in modo programmatico

Google Cloud Storage dispone di API ed esempi per molti linguaggi di programmazione che ti consentono di accedere ai tuoi dati in modo programmatico. Di seguito sono riportati i passaggi specifici di Data Transfer v2.0 che devi eseguire per creare un'integrazione funzionante.

Recupero di un account di servizio

Per iniziare a utilizzare Data Transfer v2.0, devi prima utilizzare lo strumento di configurazione, che ti guida nella creazione di un progetto nella console API di Google e nell'attivazione dell'API.

Per configurare un nuovo service account:

  1. Fai clic su Crea credenziali > Chiave dell'account di servizio.
  2. Scegli se scaricare la chiave pubblica/privata del service account come file P12 standard o come file JSON che può essere caricato da una libreria client API di Google.

Viene generata e scaricata sul tuo computer una nuova coppia di chiave pubblica/privata, che sarà l'unica copia esistente. Sei responsabile della sua archiviazione in sicurezza.

Assicurati di lasciare aperta questa finestra, perché ti servirà l'indirizzo email del service account nel passaggio successivo.

Aggiungere un service account al gruppo

  • Vai a Google Gruppi
  • Fai clic su I miei gruppi e seleziona il gruppo che utilizzi per gestire l'accesso al bucket Cloud Storage di DT v2.0.
  • Fai clic su Gestisci.
  • Non fare clic su Invita membri.
  • Fai clic su Aggiungi membri direttamente.
  • Copia l'indirizzo email del service account dal passaggio precedente nella casella dei membri.
  • Seleziona Nessuna email
  • Fai clic sul pulsante Aggiungi.

Ho fatto clic per errore su Invita membri

Ambito

Tutti gli ambiti passati a Cloud Storage devono essere di sola lettura

Ad esempio, quando si utilizza la libreria client Java, l'ambito corretto da utilizzare è:

StorageScopes.DEVSTORAGE_READ_ONLY