Crea 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 creare blocchi note di Colab Enterprise in BigQuery. Notebooks sono asset di codice di BigQuery Studio basati su Dataform.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API BigQuery.

   Abilita l'API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Attiva l'API BigQuery.

   Abilita l'API

Abilita BigQuery Studio

Segui le istruzioni in Attivare BigQuery Studio per la gestione degli asset per salvare, condividere e gestire le versioni degli asset di codice come i blocchi note.

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

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

Tutti gli utenti con il ruolo Amministratore Dataform (roles/dataform.admin) hanno accesso come proprietario a tutti i blocchi note 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 blocchi note, 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

  Nota: gli utenti che dispongono dell'autorizzazione dataform.repositories.create possono eseguire il codice utilizzando l'account di servizio Dataform predefinito e tutte le autorizzazioni concesse a quell'account. Per maggiori informazioni, consulta Considerazioni sulla sicurezza per le autorizzazioni Dataform.

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

• Utente BigQuery Studio (roles/bigquery.studioUser)

  Il ruolo Utente BigQuery Studio combina i seguenti ruoli IAM:

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

  • Creatore di codice (roles/dataform.codeCreator)

    Nota: gli utenti a cui è stato assegnato il ruolo Creatore di codice in un progetto possono elencare i nomi degli asset di codice in quel progetto utilizzando l'API Dataform o l'interfaccia a riga di comando (CLI) di Dataform. I non amministratori che utilizzano BigQuery Studio possono visualizzare solo gli asset di codice che hanno creato o che sono stati condivisi con loro.

Autorizzazioni per modificare i blocchi note

Per modificare ed eseguire blocchi note, devi disporre dei seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Utente runtime blocco note (roles/aiplatform.notebookRuntimeUser)
• Editor di codice (roles/dataform.codeEditor)

Autorizzazioni per visualizzare i blocchi note

Per visualizzare ed eseguire i blocchi note, devi disporre dei seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Utente runtime blocco note (roles/aiplatform.notebookRuntimeUser)
• Visualizzatore di codice (roles/dataform.codeViewer)

Crea blocchi note

Utilizza le sezioni seguenti per scoprire come creare un blocco note.

Impostare la regione predefinita per gli asset di codice

Se è la prima volta che crei un asset di codice, imposta la regione predefinita per gli asset di codice. Non puoi modificare la regione per un asset di codice dopo averlo creato.

Nota: se crei una query salvata e scegli una regione predefinita diversa da quella che utilizzavi per gli asset di codice, ad esempio scegliendo us-west1 se hai utilizzato us-central1, per impostazione predefinita la query e tutti gli asset di codice creati successivamente utilizzeranno la nuova regione. Gli asset di codice esistenti continuano a utilizzare la regione assegnata al momento della creazione.

Crea un blocco note dall'editor di BigQuery

Per creare un blocco note 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 sulla freccia accanto al segno +, quindi fai clic su Crea blocco note Python.

   Si apre il nuovo blocco note contenente celle che mostrano query di esempio sul set di dati pubblico bigquery-public-data.ml_datasets.penguins.

Crea un blocco note da una tabella

Per creare un blocco note contenente una query predefinita per una tabella specifica, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e individua la tabella su cui eseguire la query.

3. Fai clic su Visualizza azioni accanto alla tabella, poi fai clic su Esegui query nel > blocco note Python.

   Si apre il nuovo blocco note contenente celle che mostrano query di esempio sulla tabella selezionata.

Crea un blocco note per esplorare il set di risultati di una query

Per creare un blocco note ed esplorare il set di risultati di una query, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

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

3. Nel riquadro Risultati delle query, fai clic su Esplora i dati e quindi su Esplora con il blocco note Python.

   Si apre il nuovo blocco note, contenente celle con codice per restituire l'SQL della query e i risultati della query.

Crea un blocco note da un blocco note esistente

Per aprire qualsiasi versione di un blocco note esistente come nuovo 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. Seleziona un blocco note.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza azioni accanto a una versione del blocco note, quindi fai clic su Apri come nuovo blocco note Python.

   Una copia del blocco note viene aperta come nuovo blocco note.

Aggiorna blocchi note

Puoi caricare un blocco note locale da utilizzare in BigQuery Studio. Il blocco note caricato sarà quindi visibile nella pagina BigQuery della console Google Cloud.

Per caricare 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 quindi esegui una delle seguenti operazioni:

   • Accanto a Blocchi note, fai clic su Visualizza azioni > Carica su Notebooks.
   • Accanto al nome del progetto Google Cloud, fai clic su Visualizza azioni > Carica nel progetto > Blocco note Python.

3. Nel campo Blocco note della finestra di dialogo Carica blocco note, fai clic su Sfoglia e seleziona il blocco note che vuoi caricare.

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

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

6. Fai clic su Carica.

Il blocco note viene visualizzato nel riquadro Explorer.

Connettiti a un runtime

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

Per ulteriori informazioni sui runtime, consulta Runtime e modelli di runtime.

Connettiti al runtime predefinito

Il runtime predefinito è un runtime predefinito che richiede una configurazione minima.

Per connetterti al runtime predefinito, 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 di un blocco note per aprirlo.

3. Nel blocco note, fai clic su Connetti o esegui qualsiasi cella del blocco note.

   La connessione al runtime predefinito potrebbe richiedere diversi minuti, se non ne hai già uno attivo.

Connettiti a un runtime non predefinito

Per utilizzare un runtime diverso da quello predefinito, devi prima creare un runtime aggiuntivo in Vertex AI.

Per connetterti a un runtime non predefinito, 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 di un blocco note per aprirlo.

3. Nel blocco note, fai clic sul menu a discesa accanto a Connetti, quindi fai clic 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 Connect (Connetti).

Connettiti a un nuovo runtime

Per connetterti a un nuovo runtime, 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 di un blocco note per aprirlo.

3. Nel blocco note, fai clic sul menu a discesa accanto a Connetti, quindi fai clic su Connetti a un runtime.

4. Fai clic su Crea nuovo runtime.

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

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

7. Fai clic su Connect (Connetti).

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.

Disattiva il salvataggio dell'output del blocco note

Puoi impedire la condivisione dell'output del blocco note salvato con altri utenti che hanno accesso al file del blocco note disabilitando il salvataggio dell'output del blocco note.

Quando disabiliti il salvataggio degli output per un blocco note selezionato, BigQuery elimina tutti gli output salvati nel file del blocco note e non salva quelli delle esecuzioni successive.

Tuttavia, gli utenti che hanno accesso al blocco note possono comunque visualizzare l'output nei seguenti modi:

• Esegui il blocco note per visualizzare l'output attuale. Questo output non è stato salvato.
• Visualizzare una versione di archiviazione del blocco note e il relativo output nella cronologia delle revisioni.

Per disabilitare il salvataggio dell'output per un blocco note selezionato, 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, quindi seleziona il blocco note per il quale vuoi disattivare il salvataggio dell'output.

3. Fai clic su Attiva/disattiva la visibilità dell'intestazione > Modifica > Impostazioni blocco note.

4. Nella finestra Impostazioni blocco note, seleziona Ometti output della cella di codice durante il salvataggio di questo blocco note.

5. Fai clic su Salva.

6. Fai clic su Ricarica.

Risolvi conflitti

Se tu e un altro utente apportate modifiche in conflitto in un blocco note, 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, procedi nel seguente modo:

1. Fai clic sul link Show diff. Si apre la finestra di dialogo Rivedi modifiche da remoto.
2. (Facoltativo) Per confrontare il codice sorgente del blocco note, seleziona la casella di controllo Origine non elaborata.
3. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, seleziona la casella di controllo Differenze in linea.
4. Esamina le modifiche e decidi quale mantenere, rivedendo il tuo input se necessario.
5. Fai clic su Salva le modifiche.

Rinomina i blocchi note

Per rinominare 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. Trova il blocco note che vuoi rinominare.

3. Fai clic su Visualizza azioni accanto al blocco note, quindi fai clic su Rinomina.

4. Digita un nome per il blocco note, quindi fai clic su Rinomina.

Risoluzione dei problemi

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

Passaggi successivi

• Scopri come gestire i blocchi note.