Creare notebook

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

Prima di iniziare

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

   Go to project selector

2. Make sure that billing is enabled for your Trusted Cloud project.

3. Enable the BigQuery API.

   Enable the API

Autorizzazioni obbligatorie

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

Tutti gli utenti con il ruolo Dataform Admin (roles/dataform.admin) hanno accesso proprietario a tutti i notebook 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 i notebook, devi disporre delle seguenti autorizzazioni IAM:

• 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

• 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 di BigQuery Studio (roles/bigquery.studioUser)

  Il ruolo Utente di BigQuery Studio combina i seguenti ruoli IAM:

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

  • Code Creator (roles/dataform.codeCreator)

Autorizzazioni per modificare i notebook

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

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Utente runtime del 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 della sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Utente runtime del blocco note (roles/aiplatform.notebookRuntimeUser)
• Visualizzatore di codice (roles/dataform.codeViewer)

Creare notebook

Consulta le sezioni seguenti per scoprire come creare un taccuino.

Impostare la regione predefinita per gli asset di codice

Se è la prima volta che crei un asset di codice, devi impostare la regione predefinita per gli asset di codice. Non puoi modificare la regione di una risorsa di codice dopo averla creata.

Tutti gli asset di codice in BigQuery Studio utilizzano la stessa regione predefinita. Per impostare la regione predefinita per gli asset di codice:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, individua il progetto in cui hai attivato gli asset codice.

3. Fai clic su more_vert Visualizza azioni accanto al progetto, quindi fai clic su Cambia la mia regione di codice predefinita.

4. In Regione, seleziona la regione che vuoi utilizzare per gli asset di codice.

5. Fai clic su Seleziona.

Per un elenco delle regioni in cui è disponibile, consulta Località di BigQuery Studio.

Creare un blocco note 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 arrow_drop_down accanto al segno + e poi su Crea blocco note Python.

   Si apre il nuovo notebook contenente celle che mostrano query di esempio relative al 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 more_vert Visualizza azioni accanto alla tabella, poi su Esegui query in > Blocco note Python.

   Si apre il nuovo notebook, contenente celle che mostrano query di esempio per la tabella selezionata.

Creare un notebook per esplorare il set di risultati di una query

Per creare un notebook per esplorare il set di risultati di una query:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

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

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

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

Creare un notebook da un altro notebook esistente

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

1. Nella Trusted Cloud console, 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. Seleziona un notebook.

3. Fai clic su schedule Cronologia delle versioni.

4. Fai clic su more_vert Visualizza azioni accanto a una versione del notebook, quindi su Apri come nuovo notebook Python.

   Viene aperta una copia del blocco note come nuovo blocco note.

Aggiorna notebook

Puoi caricare un notebook locale per utilizzarlo in BigQuery Studio. Il notebook caricato sarà visibile nella pagina BigQuery della Trusted Cloud console.

Per caricare un notebook:

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

   Vai a BigQuery

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

   • Accanto a Notebook, fai clic su more_vert Visualizza azioni > Carica in Notebook.
   • Accanto al Trusted Cloud nome del progetto, fai clic su more_vert Visualizza azioni > Carica nel progetto > Notebook Python.

3. Nella finestra di dialogo Carica notebook, nel campo Notebook, fai clic su Sfoglia e seleziona il notebook da caricare.

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

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

6. Fai clic su Carica.

Il notebook viene visualizzato nel riquadro Explorer.

Connettiti a un runtime

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

Per ulteriori informazioni sui runtime, consulta 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:

1. Nella Trusted Cloud console, 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 su Connetti o esegui una cella qualsiasi nel notebook.

   La connessione al runtime predefinito potrebbe richiedere diversi minuti se non hai ancora un runtime attivo.

Connettiti a un runtime non predefinito

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

Per connetterti a un runtime non predefinito:

1. Nella Trusted Cloud console, 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 arrow_drop_down 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 Trusted Cloud console, 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 arrow_drop_down accanto a Connetti e poi su Connetti a un runtime.

4. Fai clic su Crea nuovo runtime.

5. In Modello di runtime, seleziona il modello di runtime di Vertex AI da utilizzare.

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

7. Fai clic su Connetti.

Concedere l'accesso ai notebook

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

1. Nella Trusted Cloud console, 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 notebook a cui vuoi concedere l'accesso.

3. Fai clic su more_vert Visualizza azioni accanto al notebook, 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: può modificare il notebook.
   • Visualizzatore codice: può visualizzare il notebook.

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

8. Fai clic su Salva.

9. Per tornare alla pagina delle informazioni del notebook, fai clic su Chiudi.

Condividere i notebook

Per condividere un notebook con altri utenti, puoi generare e condividere un link al notebook. Affinché gli altri utenti possano vedere il blocco note che condividi, devi prima concedere l'accesso al blocco note.

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

1. Nella Trusted Cloud console, 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 notebook che vuoi condividere.

3. Fai clic su more_vert Visualizza azioni accanto al notebook, quindi su Condividi > Copia link.

4. Condividi il link con altri utenti.

Disattivare il salvataggio dell'output del notebook

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 viene salvato.
• Visualizza una versione archiviata del notebook e il relativo output nella cronologia delle revisioni.

Per disattivare il salvataggio dell'output per un notebook selezionato:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook, quindi seleziona il blocco note per cui vuoi disattivare il salvataggio dell'output.

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

4. Nella finestra Impostazioni del notebook, seleziona Escludi output delle celle di codice durante il salvataggio del notebook.

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 Differenza in linea.
4. Esamina le modifiche e decidi quali conservare, rivedendo il tuo input se necessario.
5. Fai clic su Salva modifiche.

Rinominare i notebook

Per rinominare un taccuino:

1. Nella Trusted Cloud console, 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 notebook che vuoi rinominare.

3. Fai clic su more_vert Visualizza 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 ulteriori informazioni, vedi Risolvere i problemi di Colab Enterprise.

Passaggi successivi

• Scopri come gestire i notebook.
• Scopri come pianificare i notebook.