Gestire i blocchi note

Questo documento descrive come gestire i notebook di Colab Enterprise in BigQuery, inclusa la visualizzazione, il confronto, il ripristino e l'eliminazione dei notebook.

Notebooks sono asset di codice BigQuery Studio basati su Dataform.

Prima di iniziare

Prima di iniziare, crea un blocco note.

Autorizzazioni obbligatorie

Per condividere i notebook, devi disporre dei seguenti ruoli IAM (Identity and Access Management):

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Proprietario del codice (roles/dataform.codeOwner) a livello di risorsa.

Per salvare ed eliminare i notebook, devi disporre dei seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Proprietario del codice (roles/dataform.codeOwner) o Editor di codice (roles/dataform.codeEditor)

Per lavorare con le revisioni dei notebook, devi disporre dei seguenti ruoli IAM:

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

• Uno dei seguenti ruoli:

  • Proprietario del codice (roles/dataform.codeOwner)
  • Editor di codice (roles/dataform.codeEditor)
  • Visualizzatore di codice (roles/dataform.codeViewer)

Per ulteriori informazioni su IAM di BigQuery, consulta Controllo dell'accesso con IAM.

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 notebook a cui vuoi concedere l'accesso.

3. Fai clic su 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 Nuovi principali, inserisci un principale.

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

Per condividere un blocco note con altri utenti, puoi generare e condividere un link al blocco note. 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.

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 e, se necessario, espandi la cartella Blocchi note condivisi. Trova il notebook che vuoi condividere.

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

4. Condividi il link con altri utenti.

Visualizza tutti i notebook

Per visualizzare un elenco di tutti i notebook del progetto:

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

   Vai a BigQuery

2. Nel riquadro Explorer, fai clic su Visualizza azioni accanto a Notebook, quindi esegui una delle seguenti operazioni:

• Per aprire l'elenco nella scheda corrente, fai clic su Mostra tutto.
• Per aprire l'elenco in una nuova scheda, fai clic su Mostra tutto in > Nuova scheda.
• Per aprire l'elenco in una scheda divisa, fai clic su Mostra tutto in > Scheda divisa.

Visualizzare i metadati del notebook

Per visualizzare i metadati 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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook di cui vuoi visualizzare i metadati.

3. Consulta il riquadro Riepilogo per visualizzare informazioni sul notebook, ad esempio la regione utilizzata per i dati e la data dell'ultima modifica.

Lavorare con le versioni dei blocchi note

Utilizza le seguenti sezioni per scoprire come visualizzare, confrontare e ripristinare le versioni di un notebook.

Visualizzare le versioni del notebook

Per visualizzare le versioni 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. Fai clic sul nome del notebook di cui vuoi visualizzare l'attività.

3. Fai clic sulla scheda Attività per visualizzare un elenco delle versioni del notebook in ordine decrescente per data.

Confrontare le versioni dei notebook

Per confrontare le versioni dei 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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook per il quale vuoi confrontare le informazioni sulla versione.

3. Nella scheda Attività, fai clic su Visualizza azioni accanto a una versione del notebook e poi su Confronta. Si apre il riquadro di confronto, che mette a confronto la versione del notebook selezionata con la versione corrente del notebook.

4. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, fai clic su Confronta e poi su In linea.

5. (Facoltativo) Per confrontare il codice sorgente delle versioni, fai clic su Confronta e poi su Mostra codice sorgente non elaborato.

6. (Facoltativo) Per nascondere loutput comando nel notebook, fai clic su Confronta e poi deseleziona Mostra output.

Ripristinare una versione del notebook

Utilizza una delle seguenti opzioni per ripristinare una versione del notebook. Il ripristino dal riquadro di confronto ti consente di confrontare le versioni corrente e precedente del notebook prima di scegliere di ripristinare la versione precedente. Il ripristino di un blocco note crea una nuova versione anziché sovrascrivere la versione corrente. Nessuna cronologia delle versioni andrà persa.

Riquadro Attività

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 del notebook di cui vuoi ripristinare una versione precedente.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza azioni accanto alla versione del blocco note che vuoi ripristinare, quindi fai clic su Ripristina.

5. Fai clic su Conferma.

Riquadro di confronto

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 del notebook di cui vuoi ripristinare una versione precedente.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza azioni accanto a una versione del notebook, quindi fai clic su Confronta. Viene visualizzato il riquadro di confronto, che mostra la versione del notebook selezionata con la versione più recente.

5. Se vuoi ripristinare la versione precedente del notebook dopo il confronto, fai clic su Ripristina.

6. Fai clic su Conferma.

Scaricare un blocco note

Per scaricare un 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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook che vuoi scaricare.

3. Fai clic su Scarica.

Eliminare i notebook

Per eliminare 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, espandi la cartella Blocchi note condivisi. Trova il notebook che vuoi eliminare.

3. Fai clic su Visualizza azioni accanto al blocco note e poi su Elimina.

4. Per confermare l'eliminazione, digita delete nella finestra di dialogo.

5. Fai clic su Elimina.

Risoluzione dei problemi

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

Passaggi successivi

• Scopri di più sui notebook di Colab Enterprise in BigQuery.
• Scopri come creare quaderni.
• Scopri come orchestrare i notebook.