Crea e gestisci le cartelle

Il seguente documento descrive come creare e gestire le cartelle in BigQuery. Puoi utilizzare le cartelle per organizzare e controllare l'accesso agli asset di codice di un singolo file, come notebook, query salvate, data canvas e file di preparazione dei dati. BigQuery offre cartelle utente per consentire ai singoli utenti di gestire i propri asset di codice e cartelle di team per gestire gli asset di codice di un team.

Le cartelle BigQuery sono basate su Dataform.

Prima di creare cartelle, scopri come funzionano le cartelle di BigQuery leggendo Organizza gli asset di codice con le cartelle.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare le attività descritte in questo documento, chiedi all'amministratore di concederti i ruoli IAM appropriati per il progetto, la cartella o la risorsa.

Per ottenere le autorizzazioni necessarie per utilizzare il browser file di BigQuery, chiedi all'amministratore di concederti il ruolo BigQuery User (roles/bigquery.user) o BigQuery Studio User (roles/bigquery.studioUser) sul progetto.

Le autorizzazioni concesse a una cartella vengono propagate a tutti i file e le cartelle al suo interno.

Quanto segue si applica ai file e alle cartelle che li contengono:

Ruolo	Concessa il giorno	Autorizzazioni e casi d'uso
Code Owner (roles/dataform.codeOwner)	File o cartella	Concede il controllo completo su una risorsa nel sistema di file e cartelle. Un utente con questo ruolo può eseguire tutte le azioni, tra cui l'eliminazione della risorsa, l'impostazione della relativa policy IAM e lo spostamento.
Editor di codice (roles/dataform.codeEditor)	File o cartella	Consente di modificare e gestire i contenuti. Un utente con questo ruolo può aggiungere contenuti alle cartelle, modificare file e ottenere la policy IAM per un file o una cartella. Questo ruolo è richiesto anche nella cartella di destinazione quando si sposta una risorsa.
Code Commenter (roles/dataform.codeCommenter)	File o cartella	Consente di commentare asset di codice o cartelle.
Code Viewer (roles/dataform.codeViewer)	File o cartella	Fornisce l'accesso di sola lettura. Un utente con questo ruolo può eseguire query sui contenuti di file e cartelle.
Code Creator (roles/dataform.codeCreator)	Progetto	Concede l'autorizzazione per creare nuovi file e cartelle all'interno di un progetto.

I seguenti ruoli sono specifici per la gestione delle cartelle del team:

Ruolo	Concessa il giorno	Autorizzazioni e casi d'uso
Team Folder Owner (roles/dataform.teamFolderOwner)	Cartella del team	Concede il controllo completo su una cartella del team nel sistema di file e cartelle. Un utente con questo ruolo può eliminare la cartella del team e impostare la relativa policy IAM.
Team Folder Contributor (roles/dataform.teamFolderContributor)	Cartella del team	Consente la gestione dei contenuti all'interno di una cartella del team. Un utente con questo ruolo può aggiornare una cartella del team.
Team Folder Commenter (roles/dataform.teamFolderCommenter)	Cartella del team	Consente di commentare una cartella del team e gli asset di codice che contiene.
Team Folder Viewer (roles/dataform.teamFolderViewer)	Cartella del team	Fornisce l'accesso di sola lettura a una cartella del team e ai relativi contenuti. Un utente con questo ruolo può visualizzare una cartella del team e ottenere la relativa policy IAM.
Team Folder Creator (roles/dataform.teamFolderCreator)	Progetto	Concede l'autorizzazione per creare nuove cartelle del team all'interno di un progetto.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per completare le attività descritte in questo documento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

• Crea una cartella:
  • folders.create sulla cartella utente, sulla cartella del team o sul progetto padre
  • folders.addContents sulla cartella principale o sulla cartella del team
• Recupera le proprietà di una cartella: folders.get sulla cartella
• Eseguire query sui contenuti di una cartella o di una cartella del team: folders.queryContents sulla cartella
• Aggiorna una cartella: folders.update sulla cartella
• Elimina una cartella: folders.delete sulla cartella
• Recupera la policy IAM per una cartella: folders.getIamPolicy sulla cartella
• Imposta la policy IAM per una cartella: folders.setIamPolicy sulla cartella
• Sposta una cartella:
  • folders.move sulla cartella che viene spostata
  • folders.addContents sulla cartella di destinazione o sulla cartella del team (non necessario se lo spostamento avviene in una cartella principale)
• Per creare una cartella del team: teamFolders.create sul progetto
• Elimina una cartella del team: teamFolders.delete sulla cartella del team
• Recupera la policy IAM per una cartella del team: teamFolders.getIamPolicy sulla cartella del team
• Imposta la policy IAM per una cartella del team: teamFolders.setIamPolicy sulla cartella del team
• Recupera le proprietà di una cartella del team: teamFolders.get sulla cartella del team
• Aggiorna una cartella del team: teamFolders.update sulla cartella del team

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per ottenere l'accesso completo a tutte le cartelle e a tutti i file del progetto, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Dataform Admin (roles/dataform.admin)
• Editor Dataform (roles/dataform.editor)
• Dataform Viewer (roles/dataform.viewer)

Visualizza risorse

Segui questi passaggi per visualizzare le cartelle e gli asset di codice in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro sinistro per aprirlo.

3. Esegui una delle seguenti operazioni per visualizzare le cartelle e gli asset di codice nel progetto e nella regione del codice selezionati:

   • Espandi il nodo Utente (il tuo indirizzo email) per visualizzare le cartelle e i file che hai creato.
   • Espandi il nodo Cartelle del team per visualizzare tutte le cartelle del team a cui hai accesso.
   • Espandi il nodo Condivisi con me per visualizzare tutte le cartelle e i file che altri utenti hanno condiviso con te.

Nota: quando apri una cartella, il percorso di navigazione nella parte superiore della visualizzazione della cartella mostra il percorso completo della tua posizione attuale. Il percorso è visibile fino al livello della cartella per cui disponi delle autorizzazioni.

Imposta la regione predefinita per gli asset di codice

Puoi avere cartelle e asset di codice in regioni di codice diverse.

Tutti i nuovi asset di codice nel tuo progetto Google Cloud utilizzano una regione predefinita. Dopo la creazione dell'asset, non puoi modificarne la regione.

Importante: se modifichi la regione durante la creazione di un asset di codice, questa diventa la regione predefinita per tutti gli asset di codice successivi. Gli asset di codice esistenti non sono interessati.

Per impostare la regione predefinita per i nuovi asset di codice, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Accanto al nome del progetto, fai clic su Visualizza azioni del riquadro dei file > Cambia regione del codice.

4. Seleziona la regione del codice che vuoi utilizzare come predefinita.

5. Fai clic su Salva.

Per un elenco delle regioni supportate, consulta Località di BigQuery Studio.

Aggiorna i contenuti della cartella

Per assicurarti che le modifiche recenti apportate da te o condivise da altri siano visibili nel browser dei file, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona la cartella che vuoi aggiornare, ad esempio il nodo principale dell'utente, la radice di una cartella del team o una singola cartella.

4. Fai clic su Visualizza azioni > Aggiorna contenuti.

Crea una cartella o un asset di codice

Utilizza questa procedura per creare una delle seguenti risorse:

• Una cartella utente o un asset di codice a qualsiasi livello.
• Una sottocartella di una cartella del team.
• Un asset di codice nella sottocartella di una cartella del team.

Per informazioni sulla creazione di una cartella del team, consulta Crea una cartella del team.

Per creare una cartella o un asset di codice in BigQuery, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona il nodo radice dell'utente o la cartella in cui vuoi creare la risorsa.

4. Fai clic su Visualizza azioni > Crea, quindi seleziona il tipo di risorsa che vuoi creare.

5. Nel riquadro Crea risorsa, digita un nome per la nuova risorsa.

6. Fai clic su Salva.

Crea una cartella del team

Per creare una cartella del team in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona il nodo principale della cartella del team.

4. Fai clic su Visualizza azioni > Crea cartella del team.

5. Nella finestra di dialogo Crea cartella del team, digita un nome per la cartella del team.

6. Fai clic su Crea.

Carica un asset di codice

Per caricare un asset di codice in BigQuery, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona la cartella in cui vuoi caricare l'asset di codice.

4. Fai clic su Visualizza azioni > Carica, quindi seleziona il tipo di asset di codice che vuoi caricare.

5. Nel riquadro di caricamento della risorsa, esegui una delle seguenti operazioni:

   • Fai clic sul pulsante di opzione Caricamento file, quindi cerca e seleziona un file locale.
   • Fai clic sul pulsante di opzione URL, quindi digita l'URL di un file di asset di codice che si trova in un repository GitHub.

6. Digita un nome per l'asset di codice.

7. (Facoltativo) Seleziona una regione in cui archiviare l'asset di codice.

   Nota: Se si seleziona una regione diversa dal valore predefinito, la regione selezionata diventa la regione predefinita in cui verranno create tutte le nuove risorse di codice in futuro.

8. Fai clic su Salva.

Scarica un asset di codice

Segui questi passaggi per scaricare un asset di codice in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona l'asset di codice che vuoi scaricare.

4. Fai clic su Visualizza azioni > Scarica.

Rinomina una cartella o un asset di codice

Per rinominare una cartella o un asset di codice in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona la cartella o l'asset di codice che vuoi rinominare.

4. Fai clic su Visualizza azioni > Rinomina.

5. Nella finestra di dialogo per la ridenominazione della risorsa, digita un nuovo nome per la risorsa.

6. Fai clic su Rinomina.

Condividi una cartella o un asset di codice

Per condividere una cartella o un asset di codice in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona la cartella o l'asset di codice che vuoi condividere.

4. Nel riquadro Autorizzazioni di condivisione, fai clic su Aggiungi utente/gruppo.

5. Nel campo Nuove entità, inserisci un'entità.

6. Esegui una delle seguenti operazioni:

   • Nell'elenco Ruolo, seleziona uno dei seguenti ruoli per condividere un asset di codice, inclusa una cartella utente:

     • roles/dataform.codeOwner: può eseguire qualsiasi azione sull'asset di codice, inclusa l'eliminazione o la condivisione.
     • roles/dataform.codeEditor: può eseguire qualsiasi azione sull'asset di codice, ad eccezione dell'eliminazione o della condivisione.
     • roles/dataform.codeCommenter: può visualizzare e commentare l'asset di codice.
     • roles/dataform.codeViewer: può visualizzare l'asset di codice.

   • Nell'elenco Ruolo, seleziona uno dei seguenti ruoli per condividere una cartella del team:

     • roles/dataform.teamFolderOwner: può eseguire qualsiasi azione sulla cartella del team, inclusa l'eliminazione o la condivisione.
     • roles/dataform.teamFolderContributor: può eseguire qualsiasi azione sulla cartella del team, ad eccezione dell'eliminazione o della condivisione.
     • roles/dataform.teamFolderCommenter: può visualizzare e commentare la cartella del team e gli asset di codice che contiene.
     • roles/dataform.teamFolderViewer: può visualizzare la cartella del team e gli asset di codice che contiene.

7. Fai clic su Salva.

8. Per tornare alla pagina delle informazioni sul notebook, fai clic su Chiudi.

Sposta una cartella o un asset di codice

Segui questi passaggi per spostare una cartella o un asset di codice in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. A seconda del numero di risorse che vuoi spostare, esegui una delle seguenti operazioni:

   • Sposta una singola risorsa: nel browser dei file, seleziona la cartella o l'asset di codice che vuoi spostare, quindi fai clic su Visualizza azioni > Sposta.
   • Sposta più risorse: nella visualizzazione delle cartelle, seleziona la casella di controllo accanto a ogni risorsa che vuoi spostare, quindi fai clic su Sposta.

4. Nella finestra di dialogo Sposta risorsa, seleziona la cartella utente o la cartella del team in cui vuoi spostare la risorsa.

5. Fai clic su Sposta.

Nota: le operazioni di spostamento collettivo sono indipendenti. Se lo spostamento di una risorsa non va a buon fine, l'operazione tenta comunque di completare lo spostamento di tutte le altre risorse selezionate.

Copia un asset di codice

Per copiare un asset di codice in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. Seleziona l'asset di codice che vuoi copiare.

4. Fai clic su Visualizza azioni > Copia.

5. Nella finestra di dialogo Copia risorsa, seleziona la cartella utente o del team in cui vuoi copiare la risorsa.

6. Fai clic su Copia.

Elimina una cartella o un asset di codice

Per eliminare una cartella o un asset di codice in BigQuery:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su File per aprire il browser di file:

   

3. A seconda del numero di risorse che vuoi eliminare, esegui una delle seguenti operazioni:

   • Elimina una singola risorsa: nel browser dei file, seleziona la cartella o l'asset di codice che vuoi eliminare, quindi fai clic su Visualizza azioni > Elimina.
   • Elimina più risorse: nella visualizzazione delle cartelle, seleziona la casella di controllo accanto a ogni risorsa che vuoi eliminare, quindi fai clic su Elimina.

4. Nella finestra di dialogo Elimina risorsa, fai clic su Elimina.

Nota: quando elimini più risorse, le cartelle selezionate devono essere vuote affinché l'operazione vada a buon fine. Le operazioni di eliminazione collettiva sono indipendenti; se l'eliminazione di una risorsa non va a buon fine, l'operazione tenta comunque di completare l'eliminazione per tutte le altre risorse selezionate.

Passaggi successivi

• Organizza gli asset di codice con le cartelle
• Crea notebook
• Crea query salvate
• Crea data canvas
• Crea preparazioni dei dati