Crea blocchi note

Nota: l'addebito per i blocchi note BigQuery Studio in disponibilità generale inizierà dopo l'11 aprile 2024. Inizierai a visualizzare addebiti basati sull'utilizzo per i blocchi note di BigQuery Studio nella 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. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

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

4. Attiva l'API BigQuery.

   Abilita l'API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

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 Abilitare BigQuery Studio per la gestione degli asset per salvare, condividere e gestire le versioni di 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. Nei nuovi progetti BigQuery, queste API sono abilitate per impostazione predefinita. Per saperne 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 saperne di più su BigQuery Identity and Access Management (IAM), consulta Controllo dell'accesso con IAM.

Autorizzazioni per la creazione di 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 hanno l'autorizzazione dataform.repositories.create possono eseguire il codice utilizzando l'account di servizio Dataform predefinito e tutte le autorizzazioni concesse a quell'account di servizio. 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 di 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 nel progetto utilizzando l'API Dataform o l'interfaccia a riga di comando (CLI) Dataform. I non amministratori che utilizzano BigQuery Studio possono vedere 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 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)
• 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 di un asset di codice dopo averlo creato.

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

Creare un blocco note dall'editor BigQuery

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

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nella barra delle schede del riquadro dell'editor, fai clic sulla freccia del menu a discesa accanto al segno +, quindi fai clic su Crea nuovo 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 trova la tabella su cui vuoi eseguire la query.

3. Fai clic su Visualizza azioni accanto alla tabella, poi fai clic su Query in > 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 in cui 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 generi un risultato.

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

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

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, 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 alla versione di un blocco note, quindi fai clic su Apri come nuovo blocco note Python.

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

Carica blocchi note

Puoi caricare un blocco note locale per utilizzarlo in BigQuery Studio. Il blocco note caricato è quindi visibile nella pagina BigQuery della console Google Cloud.

Per caricare un blocco note:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto ed esegui una delle seguenti operazioni:

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

3. Nella finestra di dialogo Carica blocco note, nel campo Blocco note, fai clic su Sfoglia, quindi 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.

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

Connettiti al runtime predefinito

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

Per connetterti al runtime predefinito:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, 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 una qualsiasi cella del blocco note.

   Se non hai già un runtime attivo, la connessione al runtime predefinito potrebbe richiedere diversi minuti.

Connettiti a un runtime non predefinito

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

Per connetterti al 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, 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 e quindi 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 Connetti.

Connettiti a un nuovo runtime

Per connetterti a un nuovo runtime:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, 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 e quindi 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 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 nel blocco note tutti gli output generati dal codice, anche se contengono 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, 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, compresa l'eliminazione o la condivisione.
   • 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 disporre anche dei 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 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 a cui ha accesso. Per maggiori informazioni, consulta Concedere l'accesso a un set di dati.

Importante: gli utenti che hanno accesso al blocco note possono vedere nel blocco note tutti gli output generati dal codice, anche se contengono 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 salvataggio output blocco note

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

Quando disattivi il salvataggio dell'output per un blocco note selezionato, BigQuery elimina tutti gli output salvati nel file blocco note e non salva l'output delle esecuzioni successive.

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

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

Per disattivare il salvataggio dell'output 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 Notebooks, quindi seleziona il blocco note per cui vuoi disattivare il salvataggio dell'output.

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

4. Nella finestra Impostazioni blocco note, seleziona Ometti l'output delle celle 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, segui questi passaggi:

1. Fai clic sul link Show diff. Viene visualizzata la finestra di dialogo Verifica 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 incorporate.
4. Esamina le modifiche e decidi quali mantenere, modificando l'input, se necessario.
5. Fai clic su Salva le modifiche.

Rinomina blocchi note

Per rinominare un blocco note:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, la cartella Blocchi note e, se necessario, la cartella Blocchi note condivisi. Trova il blocco note che desideri 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 ulteriori informazioni, consulta la pagina Risolvere i problemi di Colab Enterprise.

Passaggi successivi

• Scopri come gestire i blocchi note.