Gestisci blocchi note

Nota: i blocchi note BigQuery Studio inizieranno a essere addebitati in disponibilità generale dopo l'11 aprile 2024. Inizierai a visualizzare addebiti basati sull'utilizzo per i blocchi note di BigQuery Studio nella tua fattura.

Questo documento descrive come gestire i blocchi note di Colab Enterprise in BigQuery e come visualizzare, confrontare, ripristinare, pianificare ed eliminare i blocchi note.

Notebooks sono asset di codice di BigQuery Studio basati su Dataform.

Per utilizzare i blocchi note, devi prima abilitare BigQuery Studio per la gestione degli asset.

Importante: a marzo 2024, le API che supportano le funzionalità di BigQuery Studio sono state abilitate automaticamente per tutti i progetti BigQuery esistenti. Queste API sono abilitate per impostazione predefinita nei nuovi progetti BigQuery. Per scoprire di più, consulta Attivazione automatica delle API BigQuery Studio.

Autorizzazioni obbligatorie

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

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

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

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

Per lavorare con le revisioni del blocco note, devi disporre dei seguenti ruoli IAM:

• 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 disporre dei seguenti ruoli:

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

Per modificare le pianificazioni del blocco note (Anteprima), devi avere il ruolo Editor Dataform (roles/dataform.editor).

Per visualizzare le pianificazioni del blocco note (Anteprima), devi avere il 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 a un ruolo IAM appropriato.

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

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. Trova il blocco note a cui vuoi concedere l'accesso.

3. Fai clic su Visualizza 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 blocco note, tra cui eliminarlo o condividerlo.
   • Editor di codice: può modificare il blocco note.
   • Visualizzatore di codice: può visualizzare il blocco note.
   Nota: per eseguire il blocco note, l'entità deve anche avere i ruoli Utente runtime blocco note (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 al blocco note. Per consentire ad altri utenti di visualizzare 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 a cui accede. Per maggiori informazioni, consulta Concedere l'accesso a un set di dati.

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

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 blocco note, quindi fai clic su Condividi > Copia link.

4. Condividi il link con altri utenti.

Visualizza tutti i blocchi note

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 Blocchi note, quindi procedi in uno dei seguenti modi:

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

Visualizza i metadati del blocco note

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

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

Utilizzo delle versioni del blocco note

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

Visualizza le versioni del blocco note

Per visualizzare le versioni 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, la cartella Blocchi note condivisi. Fai clic sul nome del blocco note di cui vuoi visualizzare l'attività.

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

Confronta le versioni del blocco note

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

3. Nella scheda Attività, fai clic su Visualizza azioni accanto a una versione del blocco note, quindi fai clic su Confronta.

4. Nel riquadro Cronologia delle revisioni, utilizza i menu a discesa Versione per scegliere le versioni da confrontare.

5. (Facoltativo) Per confrontare il codice sorgente del blocco note, seleziona la casella di controllo Origine non elaborata.

6. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, seleziona la casella di controllo Differenze in linea.

7. (Facoltativo) Per nascondere l'output comando nel blocco note, deseleziona la casella di controllo Mostra output.

Ripristina una versione del blocco note

Utilizza una delle seguenti opzioni per ripristinare una versione del blocco note. Il ripristino dal riquadro Cronologia delle revisioni consente di confrontare le versioni attuali e precedenti del blocco note prima di scegliere di ripristinare la versione precedente. Il ripristino di un blocco note crea una nuova versione del blocco note invece di 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 Blocchi note e, se necessario, espandi la cartella Blocchi note condivisi. Fai clic sul 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.

Cronologia delle revisioni

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. Fai clic sul nome del blocco note di cui vuoi ripristinare una versione precedente.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza azioni accanto a una versione del blocco note, quindi fai clic su Confronta.

5. Nel riquadro Cronologia delle revisioni, fai clic su Visualizza azioni accanto al menu a discesa Versione, quindi su Ripristina revisione.

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 Blocchi note e, se necessario, la cartella Blocchi note condivisi. Fai clic sul nome del blocco note 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 feedback sulla pianificazione dei blocchi note, invia un'email all'indirizzo [e-mail].

Puoi pianificare l'esecuzione automatica di un blocco note in un orario e con una frequenza specifici, ad esempio per addestrare un modello ML, chiamare API esterne o eseguire codice di BigQuery DataFrames.

Le modifiche apportate a un blocco note vengono salvate automaticamente, ma sono disponibili solo per te e per gli utenti che hanno accesso al blocco note. Per aggiornare la pianificazione con una nuova versione del blocco note, devi eseguire il deployment del blocco note. 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 la creazione della pianificazione.

Le pianificazioni del blocco note utilizzano un runtime E2 standard. Si applicano i costi di Colab Enterprise per i runtime. L'elaborazione del runtime ti viene addebitata in base al tipo di macchina E2. Per informazioni sui prezzi dei runtime E2 standard, consulta i prezzi di Colab Enterprise.

Abilita la pianificazione del blocco note

Per pianificare la creazione di blocchi note, devi concedere i ruoli seguenti all'account di servizio Dataform personalizzato che prevedi di utilizzare per le pianificazioni dei blocchi note:

Utente esecutore blocco note (roles/aiplatform.notebookExecutorUser)

Segui l'opzione Concedi un singolo ruolo in un progetto per concedere il ruolo Utente esecutore di blocchi note al tuo account di servizio Dataform personalizzato sul progetto selezionato.

Amministratore Storage (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 bucket Cloud Storage che prevedi di utilizzare per archiviare l'output delle esecuzioni del blocco note pianificate, quindi concedi il ruolo Amministratore Storage a questa entità.

Utente account di servizio (roles/iam.serviceAccountUser)

Segui l'articolo Concedi un singolo ruolo a un account di servizio per aggiungere il tuo account di servizio Dataform personalizzato come entità. 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 ruolo seguente all'account di servizio Dataform predefinito:

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

Segui l'articolo Concedi l'accesso per la 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 il ruolo Creatore token account di servizio a questa entità.

Per saperne di più sugli account di servizio in Dataform, vedi Informazioni sugli account di servizio in Dataform.

Crea una pianificazione

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

3. Fai clic su Pianifica.

4. Nel riquadro Pianifica blocco note, inserisci un nome per la pianificazione nel campo Nome 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 seleziona o crea un bucket Cloud Storage.

   All'account di servizio Dataform personalizzato selezionato deve essere concesso il ruolo IAM Storage Admin per il bucket selezionato. Per maggiori informazioni, consulta Abilitare la pianificazione del blocco note.

8. Nella sezione Pianifica frequenza, segui questi passaggi:

   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 eseguito automaticamente il deployment della versione attuale del blocco note. Per aggiornare la pianificazione con una nuova versione del blocco note, esegui il deployment del blocco note.

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

Esegui il deployment di un blocco note

Il deployment di un blocco note aggiorna la sua pianificazione con la versione attuale del blocco note. Le pianificazioni eseguono l'ultima versione di cui è stato eseguito il deployment del blocco note.

Per eseguire il deployment di un 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, 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 blocco note. L'ultima versione di cui è stato eseguito il deployment del blocco note viene eseguita all'ora pianificata.

Visualizza dettagli pianificazione

Per visualizzare i dettagli di 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 Blocchi note 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, la 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 disabilitare 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 Blocchi note 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, alla riga Stato pianificazione, fai clic sul pulsante di attivazione/disattivazione La pianificazione è abilitata.

Abilita 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, 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 è 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 Blocchi note 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, quindi 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 Orchestrazione.

   Vai alla pagina Orchestrazione

2. (Facoltativo) Per visualizzare i dettagli di una pianificazione selezionata e delle esecuzioni precedenti, 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 pianificazione da 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.

Elimina blocchi note

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 Blocchi note 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, quindi fai clic su Elimina.

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

5. Fai clic su Elimina.

Risoluzione dei problemi

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