Crea blocchi note

Questo documento descrive come creare notebook di Colab Enterprise in BigQuery. Notebooks sono BigQuery Studio asset di codice basati su Dataform.

Prima di iniziare

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

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the BigQuery API.

   Enable the API

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

   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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the BigQuery API.

   Enable the API

Abilita BigQuery Studio

Segui le istruzioni riportate in Abilitare BigQuery Studio per la gestione degli asset per salvare, condividere e gestire le versioni degli asset di codice, come i notebook.

Autorizzazioni obbligatorie

Imposta le autorizzazioni appropriate per creare, modificare o visualizzare i notebook.

Tutti gli utenti con Ruolo di Amministratore Dataform (roles/dataform.admin) dispongono dell'accesso come proprietario a tutti i blocchi note creati nel progetto.

Per ulteriori informazioni su Identity and Access Management (IAM) di BigQuery, consulta Controllo dell'accesso con IAM.

Autorizzazioni per creare blocchi note

Per creare ed eseguire blocchi note, devi avere quanto segue autorizzazioni:

• resourcemanager.projects.get
• resourcemanager.projects.list
• bigquery.config.get
• bigquery.jobs.create
• bigquery.readsessions.create
• bigquery.readsessions.getData
• bigquery.readsessions.update
• resourcemanager.projects.get
• resourcemanager.projects.list
• dataform.locations.get
• dataform.locations.list

• dataform.repositories.create

  Nota: gli utenti che hanno dataform.repositories.create può eseguire il codice utilizzando il servizio Dataform predefinito e tutte le autorizzazioni concesse a quell'account. Per ulteriori informazioni, consulta Considerazioni sulla sicurezza per le autorizzazioni di Dataform.

• dataform.repositories.list

• dataform.collections.create

• dataform.collections.list

• aiplatform.notebookRuntimeTemplates.apply

• aiplatform.notebookRuntimeTemplates.get

• aiplatform.notebookRuntimeTemplates.list

• aiplatform.notebookRuntimeTemplates.getIamPolicy

• aiplatform.notebookRuntimes.assign

• aiplatform.notebookRuntimes.get

• aiplatform.notebookRuntimes.list

• aiplatform.operations.list

Puoi ottenere queste autorizzazioni dai seguenti ruoli IAM:

• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)

• Utente BigQuery Studio (roles/bigquery.studioUser)

  Il ruolo Utente BigQuery Studio combina i seguenti ruoli IAM:

  • Utente job BigQuery (roles/bigquery.jobUser)
  • Utente runtime blocco note (roles/aiplatform.notebookRuntimeUser)

  • Creatore di codice (roles/dataform.codeCreator)

    Nota: gli utenti a cui è stato assegnato il ruolo Creatore di codice in un progetto possono elencare degli asset di codice nel progetto utilizzando l'API Dataform o Interfaccia a riga di comando (CLI) Dataform. Gli utenti non amministratori che utilizzano BigQuery Studio possono vedere solo le risorse di codice che hanno creato o che sono state condivise con loro.

Autorizzazioni per modificare i blocchi note

Per modificare ed eseguire blocchi note, devi disporre dei seguenti IAM ruoli:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Utente runtime blocco note (roles/aiplatform.notebookRuntimeUser)
• Editor di codice (roles/dataform.codeEditor)

Autorizzazioni per visualizzare i notebook

Per visualizzare ed eseguire i notebook, devi disporre dei seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Utente runtime blocco note (roles/aiplatform.notebookRuntimeUser)
• Visualizzatore di codice (roles/dataform.codeViewer)

Crea blocchi note

Utilizza le sezioni seguenti per scoprire come creare un blocco note.

Impostare la regione predefinita per gli asset di codice

Se è la prima volta che crei un asset di codice, imposta la regione predefinita per gli asset di codice. Non puoi modificare la regione di una risorsa di codice dopo la sua creazione.

Nota: se crei una query salvata e scegli una regione predefinita diversa da quella che hai utilizzato per gli asset di codice, ad esempio scegliendo us-west1 se hai utilizzato us-central1, la query e tutti gli asset di codice che crei in seguito utilizzeranno questa nuova regione per impostazione predefinita. Gli asset di codice esistenti continuano a utilizzare la regione a cui sono stati assegnati al momento della creazione.

Creare un notebook dall'editor BigQuery

Per creare un notebook contenente una query predefinita per una determinata tabella:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nella barra delle schede del riquadro dell'editor, fai clic sul menu a discesa con la freccia accanto al segno + e poi su Crea blocco note Python.

   Si apre il nuovo blocco note contenente celle in cui vengono visualizzate query di esempio il set di dati pubblico bigquery-public-data.ml_datasets.penguins.

Creare un blocco note da una tabella

Per creare un notebook contenente una query predefinita per una tabella specifica:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e individua la tabella su cui vuoi eseguire una query.

3. Fai clic su Visualizza le azioni accanto alla tabella, fai clic su Esegui una query nel blocco note Python >.

   Si apre il nuovo blocco note contenente celle in cui vengono visualizzate query di esempio la tabella selezionata.

Crea un blocco note per esplorare il set di risultati di una query

Per creare un blocco note ed esplorare il set di risultati di una query, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro dell'editor, esegui una query che genera il risultato della query.

3. Nel riquadro Risultati delle query, fai clic su Esplora i dati e poi su Esplora con il blocco note Python.

   Si apre il nuovo blocco note, contenente celle con codice per restituire la query SQL e i risultati della query.

Crea un blocco note da un blocco note esistente

Per aprire qualsiasi versione di un blocco note esistente come nuovo blocco note, segui questi passaggi passaggi:

1. Nella console Google Cloud, vai alla Pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Blocchi note e, se necessario, nella cartella Blocchi note condivisi. Seleziona un notebook.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza le azioni accanto a una versione del blocco note e fai clic su Apri come nuovo blocco note Python.

   Una copia del blocco note viene aperta come nuovo blocco note.

Aggiorna notebook

Puoi caricare un blocco note locale per utilizzarlo in BigQuery Studio. Il notebook caricato è quindi visibile nella pagina BigQuery della console Google Cloud.

Per caricare un blocco note, procedi nel seguente modo:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto ed esegui una delle seguenti operazioni:

   • Accanto a Blocchi note, fai clic su . Visualizza azioni > Carica su Notebooks.
   • Accanto al nome del progetto Google Cloud, fai clic su Visualizza azioni > Carica nel progetto > Notebook Python.

3. Nella finestra di dialogo Carica blocco note, nel campo Blocco note, fai clic su Sfoglia, quindi seleziona il blocco note che vuoi per il caricamento.

4. (Facoltativo) Nel campo Nome blocco note, modifica il nome del blocco note.

5. Nel campo Regione, seleziona la regione in cui vuoi caricare il blocco note.

6. Fai clic su Carica.

Il blocco note viene visualizzato nel riquadro Explorer.

Connettiti a un runtime

Utilizza le sezioni seguenti per scoprire come collegare un blocco note a un runtime Vertex AI. Un runtime è una risorsa di calcolo che esegue il codice nel blocco note.

Per ulteriori informazioni sui runtime, vedi Runtime e modelli di runtime.

Connettiti al runtime predefinito

Il runtime predefinito è un runtime preimpostato che richiede una configurazione minima.

Per connetterti al runtime predefinito, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook e, se necessario, la cartella Blocchi note condivisi. Fai clic sul nome di un blocco note per aprirlo.

3. Nel blocco note, fai clic su Connetti o esegui qualsiasi cella del blocco note.

   La connessione al runtime predefinito potrebbe richiedere diversi minuti se non hanno già un runtime attivo.

Connettiti a un runtime non predefinito

Se vuoi utilizzare un runtime diverso da quello predefinito, devi prima crea quel runtime aggiuntivo in Vertex AI.

Per connetterti a un runtime non predefinito:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook e, se necessario, la cartella Blocchi note condivisi. Fai clic sul nome di un blocco note per aprirlo.

3. Nel notebook, fai clic sul menu a discesa accanto a Connetti e poi su Connetti a un runtime.

4. Fai clic su Connetti a un runtime esistente.

5. In Runtime, seleziona il runtime da utilizzare.

6. Fai clic su Connetti.

Connettiti a un nuovo runtime

Per connetterti a un nuovo runtime:

1. Nella console Google Cloud, vai alla Pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook e, se necessario, la cartella Blocchi note condivisi. Fai clic sul nome di un taccuino per aprirlo.

3. Nel notebook, fai clic sul menu a discesa accanto a Connetti e poi su Connetti a un runtime.

4. Fai clic su Crea nuovo runtime.

5. In Modello di runtime, seleziona Modello di runtime Vertex AI per l'utilizzo.

6. In Nome runtime, digita un nome per il runtime.

7. Fai clic su Connetti.

Concedere l'accesso ai blocchi note

Per concedere ad altri utenti l'accesso a un notebook, aggiungili a un ruolo IAM appropriato.

Importante: gli utenti che hanno accesso al notebook possono visualizzare tutto l'output generato dal codice nel notebook, anche se l'output contiene dati provenienti da tabelle a cui non hanno accesso. Per impedire la condivisione dell'output salvato, disattiva il salvataggio dell'output del notebook.

1. Nella console Google Cloud, vai alla Pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook, nonché, se necessario, la cartella Blocchi note condivisi. Trova il blocco note a cui vuoi concedere l'accesso.

3. Fai clic su Visualizza le azioni accanto al blocco note, quindi fai clic su Condividi > Gestisci autorizzazioni.

4. Nel riquadro Gestisci autorizzazioni, fai clic su Aggiungi utente/gruppo.

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

6. Nell'elenco Ruolo, seleziona uno dei seguenti ruoli:

   • Proprietario del codice: può eseguire qualsiasi azione sul notebook, inclusa l'eliminazione o la condivisione.
   • Editor di codice: Can modificare il blocco note.
   • Code Viewer: può visualizzare il notebook.
   Nota: per eseguire il notebook, il principale deve disporre anche dei ruoli Utente runtime notebook (roles/aiplatform.notebookRuntimeUser) e Utente BigQuery (roles/bigquery.user).

7. (Facoltativo) Per visualizzare un elenco completo dei ruoli e delle impostazioni di condivisione avanzate: fai clic su Condivisione avanzata.

8. Fai clic su Salva.

9. Per tornare alla pagina delle informazioni sul blocco note, fai clic su Chiudi.

Condividi blocchi note

Per condividere un blocco note con altri utenti, puoi generare e condividere un link a del blocco note. Per consentire agli altri utenti di vedere il blocco note che condividi, devi concedi innanzitutto l'accesso al blocco note.

Per eseguire un notebook, gli utenti devono avere accesso ai dati a cui accede il notebook. Per ulteriori informazioni, vedi Concedi l'accesso a un set di dati.

Importante: gli utenti che hanno accesso al blocco note possono visualizzare tutti gli output generati dal codice nel blocco note, anche se l'output contiene dati e tabelle a cui non hanno accesso. Per impedire la condivisione dell'output salvato, disattiva il salvataggio dell'output del notebook.

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook e, se necessario, espandi la cartella Blocchi note condivisi. Trova il blocco note che vuoi condividere.

3. Fai clic su Visualizza le azioni accanto al blocco note, quindi fai clic su Condividi > Copia link.

4. Condividi il link con altri utenti.

Disattiva il salvataggio dell'output del blocco note

Puoi impedire la condivisione dell'output del blocco note salvato con altri utenti che hanno accesso al file del blocco note disattivando il salvataggio dell'output del blocco note.

Quando disattivi il salvataggio dell'output per un notebook selezionato, BigQuery elimina tutto l'output salvato nel file del notebook e non salva l'output delle esecuzioni successive.

Tuttavia, gli utenti che hanno accesso al notebook possono comunque visualizzarne l'output nei seguenti modi:

• Esegui il notebook per visualizzarne l'output corrente. Questo output non è stato salvato.
• Visualizza una versione archiviata del notebook e il relativo output nella cronologia delle revisioni.

Per disabilitare il salvataggio dell'output per un blocco note selezionato, segui questi passaggi:

1. Nella console Google Cloud, vai alla Pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Blocchi note, e seleziona il blocco note per il quale vuoi disabilitare il salvataggio dell'output.

3. Fai clic su Attiva/disattiva visibilità intestazione > Modifica > Impostazioni del notebook.

4. Nella finestra Impostazioni blocco note, seleziona Ometti l'output della cella di codice durante il salvataggio di questo blocco note.

5. Fai clic su Salva.

6. Fai clic su Ricarica.

Risolvi conflitti

Se tu e un altro utente apportate modifiche in conflitto in un notebook, il servizio genera l'errore Automatic saving failed. This file was updated remotely or in another tab. e fornisce un link Show diff. Per risolvere il conflitto: volgi i seguenti passaggi:

1. Fai clic sul link Show diff. Viene visualizzata la finestra di dialogo Rivedi modifiche da remoto.
2. (Facoltativo) Per confrontare il codice sorgente del notebook, seleziona la casella di controllo Codice sorgente non elaborato.
3. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, Seleziona la casella di controllo Differenze in linea.
4. Esamina le modifiche e decidi quale mantenere, rivedendo il tuo input se necessaria.
5. Fai clic su Salva modifiche.

Rinomina i blocchi note

Per rinominare un taccuino:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook e, se necessario, la cartella Blocchi note condivisi. Trova il blocco note che vuoi rinominare.

3. Fai clic su Visualizza le azioni accanto al blocco note, quindi fai clic su Rinomina.

4. Digita un nome per il notebook, quindi fai clic su Rinomina.

Risoluzione dei problemi

Per maggiori informazioni, vedi Risolvere i problemi di Colab Enterprise.

Passaggi successivi

• Scopri come gestire i notebook.