Gestisci blocchi note

Nota: i blocchi note di BigQuery Studio inizieranno a essere addebitati in disponibilità generale dall'11 aprile 2024. Inizierai a vedere costi basati sull'utilizzo per i blocchi note di BigQuery Studio nella fattura.

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 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 ulteriori informazioni le informazioni, vedi Attivazione automatica delle API BigQuery Studio.

Autorizzazioni obbligatorie

Per condividere i blocchi note, è necessario quanto segue Identity and Access Management (IAM) ruoli:

• 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 blocchi note, devi disporre dei seguenti IAM ruoli:

• 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 sessione di lettura BigQuery (roles/bigquery.readSessionUser) o Utente BigQuery Studio (roles/bigquery.studioUser)

Per modificare le pianificazioni del blocco note (Anteprima), devi disporre 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 degli output salvati, disattiva 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 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 una di i seguenti ruoli:

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

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 blocco note, gli utenti devono avere accesso ai dati di accesso. 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 degli output salvati, disattiva 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 le 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 le azioni accanto a Blocchi note, 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.

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, 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 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 sull' 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 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, nella cartella Blocchi note condivisi. Fai clic sull' nome del blocco note per cui vuoi confrontare le informazioni sulla versione.

3. Nella scheda Attività, fai clic su Visualizza le 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 versioni da confrontare.

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

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, cancella la casella di controllo Mostra output.

Ripristina una versione del blocco note

Utilizza una delle seguenti opzioni per ripristinare una versione del blocco note. Ripristino da Il riquadro Cronologia delle revisioni ti consente di confrontare la versione attuale e quella precedente del blocco note prima di scegliere di ripristinare la versione precedente. Il ripristino di un blocco note crea una nuova versione del blocco note 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 Blocchi note e se espandi 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 alla versione del blocco note che vuoi ripristinare e 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 espandi 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.

5. Nel riquadro Cronologia delle revisioni, fai clic su Visualizza le azioni accanto al menu a discesa Versione e poi fai clic 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, nella cartella Blocchi note condivisi. Fai clic sull' 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 un feedback sulla pianificazione del blocco note, invia un'email all'indirizzo [e-mail].

Puoi pianificare l'esecuzione automatica di un blocco note di tempo e frequenza specificati, 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 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 gli account di servizio in Dataform, vedi 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 del blocco note utilizzano un runtime E2 standard. Si applicano i costi 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 i 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 l'articolo Concedere un singolo ruolo in un progetto per concedere il ruolo Utente esecutore blocco note al tuo 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 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 l'articolo Concedere 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 al account di servizio Dataform predefinito:

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

Segui 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 un account di servizio Dataform personalizzato, e concedere il ruolo Creatore token account di servizio a questa entità.

Per scoprire di più sugli account di servizio in Dataform, consulta 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, nella cartella Blocchi note condivisi. Fai clic sul nome del blocco note che ti interessa 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 modulo Dataform personalizzato l'account di servizio.

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 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: eseguire il deployment del blocco note.

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 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, nella 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, nella 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 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, nella 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, nella 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 è 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, nella 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 Orchestrazione.

   Vai alla pagina Orchestrazione

2. (Facoltativo) Per visualizzare i dettagli di una pianificazione selezionata e le relative 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 i la pianificazione 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.

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