Creare e gestire le cartelle

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Nota: per fornire un feedback o richiedere assistenza per questa funzionalità, invia un'email all'indirizzo [e-mail].

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, canvas di dati e file di preparazione dei dati. BigQuery offre cartelle utente per consentire ai singoli utenti di gestire i propri asset di codice e cartelle del 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 BigQuery leggendo Organizzare gli asset di codice con le cartelle.

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 nel progetto, nella cartella o nella risorsa.

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

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

Ai file e alle cartelle che li contengono si applicano le seguenti regole:

Ruolo	Concessa il giorno	Autorizzazioni e casi d'uso
Proprietario del codice (roles/dataform.codeOwner)	File o cartella	Concede il controllo completo di una risorsa nel sistema di file e cartelle. Un utente con questo ruolo può eseguire tutte le azioni, tra cui l'eliminazione, l'impostazione dei criteri IAM e lo spostamento della risorsa.
Editor di codice (roles/dataform.codeEditor)	File o cartella	Consente la modifica e la gestione dei contenuti. Un utente con questo ruolo può aggiungere contenuti alle cartelle, modificare i file e ottenere il criterio IAM per un file o una cartella. Questo ruolo è necessario anche nella cartella di destinazione quando sposti una risorsa.
Code Commenter (roles/dataform.codeCommenter)	File o cartella	Consente di commentare asset di codice o cartelle.
Visualizzatore di codice (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
Proprietario della cartella del team (roles/dataform.teamFolderOwner)	Cartella del team	Concede il controllo completo di una cartella del team nel sistema di file e cartelle. Un utente con questo ruolo può eliminare la cartella del team e impostare il relativo criterio 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

• Creare una cartella:
  • folders.create sulla cartella utente principale, sulla cartella del team o sul progetto
  • folders.addContents sulla cartella principale o sulla cartella del team
• Recupera le proprietà di una cartella: folders.get sulla cartella
• Esegui una 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 il criterio IAM per una cartella: folders.getIamPolicy sulla cartella
• Imposta il criterio IAM per una cartella: folders.setIamPolicy sulla cartella
• Spostare una cartella:
  • folders.move nella cartella in fase di spostamento
  • folders.addContents nella cartella di destinazione o nella cartella del team (non necessario se lo sposti in una cartella principale)
• Crea una cartella del team: teamFolders.create sul progetto
• Elimina una cartella del team: teamFolders.delete sulla cartella del team
• Recupera il criterio IAM per una cartella del team: teamFolders.getIamPolicy nella cartella del team
• Imposta il criterio 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)
• Visualizzatore Dataform (roles/dataform.viewer)

Visualizza risorse

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 dei file:

   

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

3. Per visualizzare le cartelle e gli asset di codice nel progetto e nella regione di codice selezionati, esegui una delle seguenti operazioni:

   • 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.

Modificare la regione del codice

Puoi avere cartelle e asset di codice in regioni di codice diverse. Per modificare la regione del codice che stai visualizzando:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

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

   

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

4. Seleziona la regione di codice che vuoi visualizzare.

5. Fai clic su Salva.

Creare 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 in una cartella del team.
• Un asset di codice nella sottocartella di una cartella del team.

Per informazioni sulla creazione di una cartella del team, vedi Creare una cartella del team.

Per creare 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 dei file:

   

3. Seleziona il nodo radice 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 di creazione della risorsa, digita un nome per la nuova risorsa.

6. Fai clic su Salva.

Creare 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 dei 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.

Caricare un asset di codice

Per caricare 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 dei 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, poi cerca e seleziona un file locale.
   • Fai clic sul pulsante di opzione URL e 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. Se selezioni una regione diversa dal valore predefinito, la regione selezionata diventa la regione predefinita in cui verranno creati tutti i nuovi asset di codice in futuro.

8. Fai clic su Salva.

Scaricare un asset di codice

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 dei file:

   

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

4. Fai clic su Visualizza azioni > Scarica.

Rinominare 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 dei file:

   

3. Seleziona la cartella o la risorsa di codice che vuoi rinominare.

4. Fai clic su Visualizza azioni > Rinomina.

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

6. Fai clic su Rinomina.

Condividere 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 dei 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, tranne eliminarlo o condividerlo.
     • 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, tranne eliminarla o condividerla.
     • 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 del blocco note, fai clic su Chiudi.

Spostare 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 dei file:

   

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

4. Fai clic su Visualizza azioni > Sposta.

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

6. Fai clic su Sposta.

Copiare una cartella o un asset di codice

Per copiare 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 dei file:

   

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

4. Fai clic su Visualizza azioni > Copia.

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

6. Fai clic su Copia.

Eliminare 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 dei file:

   

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

4. Fai clic su Visualizza azioni > Elimina.

5. Nella finestra di dialogo di eliminazione della risorsa, fai clic su Elimina.

Passaggi successivi

• Organizzare gli asset di codice con le cartelle
• Creare notebook
• Creare query salvate
• Creare canvas di dati
• Creare preparazioni dei dati