Crea blocchi note
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
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API BigQuery.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API BigQuery.
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.
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
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:
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.
Crea un blocco note dall'editor di BigQuery
Per creare un blocco note contenente una query predefinita per una determinata tabella:
Vai alla pagina BigQuery.
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:
Vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e individua la tabella su cui eseguire la query.
Fai clic su > blocco note Python.
Visualizza azioni accanto alla tabella, poi fai clic su Esegui query nelSi 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:
Vai alla pagina BigQuery.
Nel riquadro dell'editor, esegui una query che genera il risultato della query.
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:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Blocchi note e, se necessario, la cartella Blocchi note condivisi. Seleziona un blocco note.
Seleziona il riquadro Attività.
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:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto quindi esegui una delle seguenti operazioni:
- Accanto a Blocchi note, fai clic su > Carica su Notebooks. Visualizza azioni
- Accanto al nome del progetto Google Cloud, fai clic su > Carica nel progetto > Blocco note Python. Visualizza azioni
Nel campo Blocco note della finestra di dialogo Carica blocco note, fai clic su Sfoglia e seleziona il blocco note che vuoi caricare.
(Facoltativo) Nel campo Nome blocco note, modifica il nome del blocco note.
Nel campo Regione, seleziona la regione in cui vuoi caricare il blocco note.
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:
Nella console Google Cloud, vai alla pagina BigQuery.
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.
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:
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Nel blocco note, fai clic sul menu a discesa
accanto a Connetti, quindi fai clic su Connetti a un runtime.Fai clic su Connetti a un runtime esistente.
In Runtime, seleziona il runtime da utilizzare.
Fai clic su Connect (Connetti).
Connettiti a un nuovo runtime
Per connetterti a un nuovo runtime, segui questi passaggi:
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Nel blocco note, fai clic sul menu a discesa
accanto a Connetti, quindi fai clic su Connetti a un runtime.Fai clic su Crea nuovo runtime.
In Modello di runtime, seleziona il modello di runtime Vertex AI da utilizzare.
In Nome runtime, digita un nome per il runtime.
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.
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Fai clic su > Gestisci autorizzazioni.
Visualizza azioni accanto al blocco note, quindi fai clic su CondividiNel riquadro Gestisci autorizzazioni, fai clic su Aggiungi utente/gruppo.
Nel campo Nuove entità, inserisci un'entità.
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.
(Facoltativo) Per visualizzare un elenco completo dei ruoli e delle impostazioni di condivisione avanzate, fai clic su Condivisione avanzata.
Fai clic su Salva.
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.
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Fai clic su > Copia link.
Visualizza azioni accanto al blocco note, quindi fai clic su CondividiCondividi 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:
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Fai clic su > Modifica > Impostazioni blocco note.
Attiva/disattiva la visibilità dell'intestazioneNella finestra Impostazioni blocco note, seleziona Ometti output della cella di codice durante il salvataggio di questo blocco note.
Fai clic su Salva.
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:
- Fai clic sul link
Show diff
. Si apre la finestra di dialogo Rivedi modifiche da remoto. - (Facoltativo) Per confrontare il codice sorgente del blocco note, seleziona la casella di controllo Origine non elaborata.
- (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, seleziona la casella di controllo Differenze in linea.
- Esamina le modifiche e decidi quale mantenere, rivedendo il tuo input se necessario.
- Fai clic su Salva le modifiche.
Rinomina i blocchi note
Per rinominare un blocco note, segui questi passaggi:
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Fai clic su
Visualizza azioni accanto al blocco note, quindi fai clic su Rinomina.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.