Creare e utilizzare gli spazi di lavoro
Questo documento illustra come utilizzare gli spazi di lavoro in BigQuery, incluse le seguenti attività:
- Creazione di spazi di lavoro
- Eliminazione degli spazi di lavoro
- Lavorare con i file negli spazi di lavoro
- Eseguire il controllo delle versioni sui file negli spazi di lavoro
Prima di iniziare
Se non l'hai ancora fatto, crea un repository BigQuery.
Ruoli obbligatori
L'accesso agli spazi di lavoro è determinato dai ruoli concessi nel repository principale. Per ulteriori informazioni, consulta Ruoli richiesti.
Crea un workspace
La creazione dello spazio di lavoro viene gestita in modo diverso a seconda che tu stia utilizzando un repository BigQuery o un repository di terze parti.
Creare uno spazio di lavoro in un repository BigQuery
Per creare un nuovo spazio di lavoro in un repository BigQuery, segui questi passaggi:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository in cui vuoi creare uno spazio di lavoro.
Nell'editor, fai clic su Aggiungi area di lavoro.
Nel riquadro Crea spazio di lavoro, inserisci un ID unico per lo spazio di lavoro nel campo ID spazio di lavoro.
Gli ID possono includere solo numeri, lettere, trattini e trattini bassi.
Fai clic su Crea.
Creare uno spazio di lavoro in un repository di terze parti
Per creare un nuovo spazio di lavoro in un repository di terze parti:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository in cui vuoi creare uno spazio di lavoro.
Nell'editor, fai clic su Aggiungi area di lavoro. Si aprirà il riquadro Crea area di lavoro.
Scegli il pulsante di opzione Ramo remoto esistente o Nuovo ramo, a seconda che tu voglia utilizzare un ramo esistente o nuovo per lo spazio di lavoro.
Specifica il ramo da utilizzare:
- Se hai scelto il pulsante di opzione Branch remoto esistente, scegli un branch esistente nel campo Branch remoto.
Se hai scelto il pulsante di opzione Nuovo ramo, digita un nome nel campo ID spazio di lavoro. Il nome del ramo creato nel repository di terze parti è uguale all'ID dello spazio di lavoro BigQuery.
Gli ID possono includere solo numeri, lettere, trattini e trattini bassi.
Fai clic su Crea.
Creare una directory in uno spazio di lavoro
Per creare una directory in uno spazio di lavoro:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua lo spazio di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Fai clic sull'opzione Aggiungi.
Fai clic su Crea nel repository > Directory.
Nel campo Aggiungi un percorso della directory, digita un percorso della directory.
Fai clic su Crea directory.
Lavorare con i file in uno spazio di lavoro
Puoi creare nuovi file in un'area di lavoro o caricare file esistenti.
In un repository puoi creare o caricare i seguenti tipi di file:
- Query SQL
- Notebook Python
- Canvas dei dati
- Preparazione dei dati
- File di qualsiasi altro tipo
Creare un file
Per creare un file in uno spazio di lavoro:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua l'area di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Esegui una di queste operazioni:
- Fai clic sull'opzione Aggiungi.
- Seleziona una directory esistente e fai clic sull'opzione Azioni.
Fai clic su Crea nel repository e poi sul tipo di file che vuoi creare.
Nel campo Nome, digita un nome file.
(Facoltativo) Nel campo Cartella principale, digita il percorso della directory in cui creare il file.
Fai clic su Salva.
Carica un file
Per caricare un file in uno spazio di lavoro:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua l'area di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Esegui una di queste operazioni:
- Fai clic sull'opzione Aggiungi.
- Seleziona una directory esistente e fai clic sull'opzione Azioni.
Fai clic su Carica nel repository e poi sul tipo di file da caricare.
Nel riquadro di caricamento, esegui una delle seguenti operazioni:
- Nel campo Caricamento file, fai clic su Sfoglia, seleziona un file e poi fai clic su Apri.
- Nel campo URL, digita l'URL del file.
(Facoltativo) Nel campo Cartella principale, digita il percorso della directory in cui creare il file.
Fai clic su Carica.
Eliminazione di un file
Per eliminare un file da uno spazio di lavoro:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua l'area di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Seleziona il file che vuoi eliminare, fai clic sull'opzione Azioni e poi su Elimina.
Fai clic su Elimina.
Utilizzare il controllo delle versioni con un file
Questa sezione mostra come utilizzare il controllo delle versioni in BigQuery per tenere traccia dei file negli spazi di lavoro.
BigQuery utilizza Git per tenere traccia di ogni modifica apportata ai file all'interno di un repository. In un repository BigQuery, interagisci direttamente con il repository Git. In un repository collegato, interagisci con il ramo predefinito del repository remoto che hai configurato quando hai collegato il repository.
BigQuery mostra le opzioni di controllo delle versioni in base allo stato delle modifiche nello spazio di lavoro. Ad esempio, BigQuery mostra l'opzione di commit solo quando sono presenti modifiche locali non committate nella tua area di lavoro. Quando i file nello spazio di lavoro sono una copia esatta del ramo predefinito o predefinito, BigQuery mostra lo stato Aggiornato.
BigQuery mostra le seguenti opzioni di controllo della versione:
- Esegui il commit delle modifiche X
- Esegui il commit del numero X di modifiche locali nello spazio di lavoro o dei file modificati selezionati. BigQuery mostra le modifiche non committate.
- Esegui il push sul branch predefinito
- Esegui il push delle modifiche committate al ramo predefinito. Questa opzione è disponibile in un repository se non sono presenti modifiche non committate nello spazio di lavoro e sono presenti commit non sottoposti a push.
- Push a
your-branch-name - Esegui il push delle modifiche committate su
your-branch-name. Questa opzione è disponibile in un repository collegato a un repository Git di terze parti se non sono presenti modifiche non committate nello spazio di lavoro. Il nome del ramo remoto nel repository di terze parti corrisponde all'ID workspace BigQuery. - Esegui il pull dal branch predefinito
- Aggiorna gli spazi di lavoro con le modifiche recenti del branch predefinito. Questa opzione è disponibile in un repository se non sono presenti modifiche non committate nel tuo spazio di lavoro.
- Pull da
your-branch-name - Aggiorna lo spazio di lavoro con le modifiche recenti di
your-branch-name. Questa opzione è disponibile in un repository collegato a un repository Git di terze parti se non sono presenti modifiche non committate nello spazio di lavoro. Il nome del ramo remoto nel repository di terze parti corrisponde all'ID workspace BigQuery. - Ripristina l'ultimo commit
- Ripristina i file nello spazio di lavoro allo stato dell'ultimo commit.
Esegui il pull delle modifiche
Se lo spazio di lavoro non è sincronizzato con il repository, BigQuery mostra l'opzione Pull.
Per estrarre le modifiche dal repository nello spazio di lavoro:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua lo spazio di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Nel riquadro dell'area di lavoro:
- Se ti trovi in un repository BigQuery, fai clic su Esegui pull dal ramo predefinito.
Se ti trovi in un repository collegato a un repository Git di terze parti, esegui una delle seguenti operazioni:
- Fai clic su Esegui il pull dal ramo predefinito per eseguire il pull dal ramo predefinito del repository di terze parti.
- Fai clic su Esegui il pull da
your-branch-nameper eseguire il pull dal branch del repository di terze parti corrispondente allo spazio di lavoro corrente.
Esegui il commit delle modifiche
Dopo aver apportato una modifica in uno spazio di lavoro, BigQuery visualizza l'opzione Commit. Puoi eseguire il commit di tutte le modifiche locali o di file selezionati. I file che hai aggiunto o modificato sono identificati da un punto blu accanto nel riquadro dello spazio di lavoro.
Per eseguire il commit delle modifiche dallo spazio di lavoro al repository:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua lo spazio di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Nel riquadro dell'area di lavoro, fai clic su Esegui commit delle modifiche X.
Nel riquadro Esegui il commit delle modifiche, segui questi passaggi:
Seleziona i file modificati di cui vuoi eseguire il commit.
Se non selezioni alcun file, BigQuery esegue il commit di tutte le modifiche locali. Puoi filtrare i file modificati in base allo stato, al nome e al percorso.
Nel campo Aggiungi un messaggio commit, digita una descrizione per il commit.
Fai clic su Commit All changes (Esegui commit di tutte le modifiche) o su Commit X changes (Esegui commit di X modifiche).
Il nome del pulsante dipende dalla selezione dei file da committare.
Eseguire il push delle modifiche
BigQuery mostra l'opzione Push dopo l'commit delle modifiche.
Per eseguire il push delle modifiche dallo spazio di lavoro al repository:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua lo spazio di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Nel riquadro dell'area di lavoro:
- Se ti trovi in un repository BigQuery, fai clic su Esegui push nel ramo predefinito.
Se ti trovi in un repository collegato a un repository Git di terze parti, esegui una delle seguenti operazioni:
- Fai clic su Esegui il push al ramo predefinito per eseguire il push al ramo predefinito del repository di terze parti.
- Fai clic su Esegui push in
your-branch-nameper eseguire push nel ramo del repository di terze parti corrispondente all'area di lavoro corrente.
Annulla modifiche di cui non è stato eseguito il commit
Per ripristinare le modifiche non committate:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua lo spazio di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Nel riquadro dell'area di lavoro, fai clic sul menu a discesa con la freccia accanto al pulsante di controllo della versione e poi su Ripristina ultimo commit.
Risolvere i conflitti di unione
Un conflitto di unione può verificarsi quando una modifica locale nell'area di lavoro è incompatibile con una modifica apportata al ramo predefinito del repository. I conflitti di unione si verificano in genere quando più utenti modificano contemporaneamente lo stesso file.
In genere si verifica un conflitto di unione quando esegui il pull da un ramo dopo che un altro utente ha eseguito il push di una modifica in conflitto nello stesso ramo. Devi risolvere un conflitto di unione manualmente modificando il file interessato.
Il seguente esempio di codice mostra un conflitto di unione visualizzato in un file SQL:
<<<<<<< HEAD
SELECT 1 as CustomerOrders
=======
SELECT 1 as Orders
>>>>>>> refs/heads/main
Per risolvere un conflitto di unione:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua lo spazio di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Seleziona il file interessato e modificalo con le modifiche scelte.
(Facoltativo) Invia modifiche.
Visualizza cronologia commit
Per visualizzare la cronologia dei commit:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi la cartella Repositories (Repositoi).
Seleziona il repository contenente lo spazio di lavoro con cui vuoi lavorare.
Nell'editor, individua lo spazio di lavoro e fai clic su Apri.
Si aprirà il riquadro dello spazio di lavoro:
Nel riquadro dell'area di lavoro, fai clic sul menu a discesa della freccia sul pulsante di controllo della versione e poi su Visualizza cronologia dei commit.
Eliminare uno spazio di lavoro
Per eliminare uno spazio di lavoro e tutti i relativi contenuti:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, fai clic sulla cartella Repository.
Nel riquadro Repository Git, seleziona lo spazio di lavoro che vuoi eliminare.
Fai clic sull'opzione Azioni e poi su Elimina.
Fai clic su Elimina.
Passaggi successivi
- Scopri come creare repository.