Gestire i notebook

Questo documento descrive come gestire Blocchi note Colab Enterprise in BigQuery incluse le modalità di visualizzazione, confronto, ripristino, pianificazione ed eliminazione dei blocchi note.

Notebooks sono BigQuery Studio asset di codice basati su Dataform.

Per utilizzare i blocchi note, devi prima abilitare BigQuery Studio per la gestione delle risorse.

Autorizzazioni obbligatorie

Per condividere i notebook, sono necessari i seguenti ruoli IAM (Identity and Access Management):

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

Per salvare ed eliminare i notebook, sono necessari i seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente 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 del blocco note, devi disporre dei seguenti IAM ruoli:

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

• Uno qualsiasi dei seguenti ruoli:

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

Per creare pianificazioni blocco note (Anteprima), devi avere i seguenti ruoli:

• Amministratore Dataform (roles/dataform.admin)
• Utente di sessione di lettura BigQuery (roles/bigquery.readSessionUser) o utente di BigQuery Studio (roles/bigquery.studioUser)

Per modificare le pianificazioni dei notebook (Anteprima), devi disporre del ruolo Editor Dataform (roles/dataform.editor).

Per visualizzare le pianificazioni del blocco note (Anteprima), devi disporre del Ruolo Visualizzatore Dataform (roles/dataform.viewer).

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

Concedi l'accesso ai blocchi note

Per concedere ad altri utenti l'accesso a un blocco note, aggiungili al ruolo IAM.

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, nonché, se necessario, la cartella Blocchi note condivisi. Trova il blocco note 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 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 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 blocco note, gli utenti devono avere accesso ai dati di accesso. 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 Blocchi note e, se necessario, espandi la cartella Blocchi note condivisi. Trova il blocco note 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 blocchi note nel tuo 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 blocco note, 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, se necessario, nella cartella Blocchi note condivisi. Fai clic sul nome del blocco note che ti interessa di cui visualizzare i metadati.

3. Esamina il riquadro Riepilogo per visualizzare le informazioni sul blocco note, ad esempio la regione per i dati e la data dell'ultima modifica.

Utilizzo delle versioni del blocco note

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

Visualizza le versioni del blocco note

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 Blocchi note, e, se necessario, la cartella Blocchi note condivisi. Fai clic sull' il nome del blocco note 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 blocco note selezionata con l'attuale versione del blocco note.

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

5. (Facoltativo) Per confrontare il codice sorgente delle versioni, fai clic su Confronta, quindi Fai clic su Mostra origine non elaborata.

6. (Facoltativo) Per nascondere l'output comando nel blocco note, fai clic su Confronta e e deseleziona Mostra output.

Ripristina una versione del blocco note

Utilizza una delle seguenti opzioni per ripristinare una versione del blocco note. 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. La cronologia delle versioni non viene 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. Clic il nome del blocco note 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. Clic il nome del blocco note di cui vuoi ripristinare una versione precedente.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza le azioni accanto a una versione del blocco note, quindi fai clic su Confronta. Si apre il riquadro di confronto, che mette a confronto la versione del blocco note selezionata con la versione più recente del blocco note.

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

Pianifica blocchi note

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per fornire un feedback sulla pianificazione dei notebook, invia un'email all'indirizzo [e-mail].

Puoi pianificare l'esecuzione automatica di un blocco note in termini di tempo e frequenza, ad esempio per addestrare un modello ML, chiama API esterne o esegui il codice di BigQuery DataFrames.

Le modifiche apportate a un blocco note vengono salvate automaticamente, ma disponibili solo per te e per gli utenti che hanno l'accesso al blocco note. Per aggiornare la pianificazione con una nuova versione del notebook, devi eseguire il deployment del notebook. Se esegui il deployment di un blocco note, ne aggiorni la pianificazione con la versione attuale del blocco note. Le pianificazioni eseguono l'ultima versione di cui è stato eseguito il deployment del blocco note.

Ogni pianificazione del blocco note viene eseguita da un account di servizio Dataform personalizzato, che selezioni durante la creazione della pianificazione. Per ulteriori informazioni sui tipi di account di servizio in Dataform, consulta Informazioni sugli account di servizio in Dataform.

Dataform scrive l'output delle esecuzioni del blocco note pianificate nel Bucket Cloud Storage selezionato durante per la creazione della programmazione.

Le pianificazioni dei notebook utilizzano un runtime E2 standard. Si applicano gli addebiti di Colab Enterprise per i runtime. Ti vengono addebitati i costi per basata sul tipo di macchina E2. Per informazioni sui prezzi dei runtime E2 standard, consulta Prezzi di Colab Enterprise.

Abilita la pianificazione del blocco note

Per pianificare la creazione di blocchi note, devi concedere i ruoli seguenti al account di servizio Dataform personalizzato per il quale prevedi di utilizzare pianificazioni blocco note:

Utente esecutore blocco note (roles/aiplatform.notebookExecutorUser)

Segui la procedura descritta in Concedere un singolo ruolo a un progetto per concedere il ruolo Utente Executor di notebook al tuo account di servizio Dataform personalizzato nel progetto selezionato.

Amministratore dello spazio di archiviazione (roles/storage.admin)

Segui Aggiungi un'entità a un criterio a livello di bucket per aggiungere il tuo account di servizio Dataform personalizzato come entità al del bucket Cloud Storage che prevedi di utilizzare per archiviare l'output pianificare le esecuzioni di blocchi note e concedere a questa entità il ruolo Amministratore Storage.

Utente account di servizio (roles/iam.serviceAccountUser)

Segui la procedura descritta in Concedere un singolo ruolo a un account di servizio per aggiungere il tuo account di servizio Dataform personalizzato come entità a se stesso. In altre parole, aggiungi l'account di servizio Dataform personalizzato come entità allo stesso account di servizio Dataform personalizzato. Concedi quindi il ruolo Utente account di servizio a questa entità.

Inoltre, devi concedere il seguente ruolo all'account di servizio Dataform predefinito:

Creatore token account di servizio(roles/iam.serviceAccountTokenCreator)

Segui la procedura descritta in Concedere l'accesso alla creazione di token a un account di servizio Dataform personalizzato per aggiungere l'account di servizio Dataform predefinito come entità al tuo account di servizio Dataform personalizzato e concedi a questa entità il ruolo Creatore token account di servizio.

Per scoprire di più sugli account di servizio in Dataform, consulta Informazioni sugli account di servizio in Dataform.

Crea una pianificazione

Per pianificare un notebook:

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. Fai clic sul nome del blocco note da pianificare.

3. Fai clic su Pianifica.

4. Nel riquadro Pianifica blocco note, nel campo Nome pianificazione, inserisci un nome per la pianificazione.

5. Nel campo Modello di runtime, seleziona un runtime.

6. Nel campo Account di servizio, seleziona un account di servizio Dataform personalizzato.

7. Nel campo Bucket Cloud Storage, fai clic su Sfoglia. e selezionare o creare un bucket Cloud Storage.

   All'account di servizio Dataform personalizzato selezionato deve essere concessa la classe Ruolo IAM Amministratore Storage per il bucket selezionato. Per maggiori informazioni, consulta Abilitare la pianificazione del blocco note.

8. Nella sezione Frequenza pianificazione:

   1. Nel menu a discesa Si ripete, seleziona la frequenza delle esecuzioni del blocco note pianificate.
   2. Nel campo Alle, inserisci l'ora per le esecuzioni pianificate del blocco note.
   3. Nel menu a discesa Fuso orario, seleziona il fuso orario per la pianificazione.

9. Fai clic su Crea pianificazione.

Quando crei la pianificazione, viene implementata automaticamente la versione corrente del notebook. Per aggiornare la pianificazione con una nuova versione del notebook, esegui il deployment del notebook.

L'ultima versione di cui è stato eseguito il deployment del blocco note vengono eseguite all'ora e alla frequenza selezionate.

Esegui il deployment di un notebook

Il deployment di un notebook aggiorna la pianificazione con la versione corrente del notebook. Le pianificazioni eseguono l'ultima versione di cui è stato eseguito il deployment del notebook.

Per eseguire il deployment di 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 blocco note selezionato.

3. Fai clic su Esegui il deployment.

La pianificazione corrispondente viene aggiornata con la versione corrente del notebook. L'ultima versione di cui è stato eseguito il deployment del blocco note viene eseguita all'ora pianificata.

Visualizzare i dettagli della pianificazione

Per visualizzare i dettagli della pianificazione di un notebook selezionato:

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 blocco note selezionato.

3. Fai clic su Visualizza pianificazione.

Visualizza esecuzioni precedenti

Per visualizzare le esecuzioni passate di una pianificazione del blocco note selezionata:

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. Fai clic sul nome del blocco note selezionato.

3. Fai clic su Visualizza pianificazione e poi su Visualizza esecuzioni passate.

Disattivare una programmazione

Per mettere in pausa le esecuzioni pianificate di un blocco note selezionato senza eliminare la pianificazione, puoi disabilitare la pianificazione.

Per disattivare una pianificazione per un blocco note selezionato:

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 blocco note selezionato.

3. Fai clic su Visualizza pianificazione.

4. Nella tabella dei dettagli della pianificazione, nella riga Stato pianificazione, fai clic sul pulsante di attivazione/disattivazione La pianificazione è attivata.

Attivare una pianificazione

Per riprendere le esecuzioni pianificate di una pianificazione disabilitata:

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. Fai clic sul nome del blocco note selezionato.

3. Fai clic su Visualizza pianificazione.

4. Nella riga Stato pianificazione della tabella dei dettagli della pianificazione, fai clic sul pulsante di attivazione/disattivazione La pianificazione è disabilitata.

Modificare una pianificazione

Per modificare una pianificazione:

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 blocco note selezionato.

3. Fai clic su Visualizza pianificazione e poi su Modifica.

4. Nella finestra di dialogo Pianifica blocco note, modifica la pianificazione. e fai clic su Aggiorna pianificazione.

Visualizza tutte le pianificazioni

Per visualizzare tutte le pianificazioni del blocco note nel tuo progetto:

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

   Vai alla pagina Orchestrazione

2. (Facoltativo) Per visualizzare i dettagli di una pianificazione selezionata e delle relative esecuzioni passate, fai clic sul nome della pianificazione.

Elimina una pianificazione

Per eliminare definitivamente una pianificazione per un blocco note selezionato:

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

   Vai alla pagina Orchestrazione

2. Nell'elenco di tutte le pianificazioni, seleziona la riga contenente la programmazione che vuoi eliminare.

3. (Facoltativo) Per eliminare più pianificazioni contemporaneamente, seleziona più righe.

4. Fai clic su Elimina.

5. Nella finestra di dialogo visualizzata, fai clic su Elimina.

Eliminare i notebook

Per eliminare 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 e la cartella Notebook e, se necessario, espandi la cartella Blocchi note condivisi. Individua il blocco note 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 blocchi note di Colab Enterprise in BigQuery.
• Scopri come creare blocchi note.