Crea blocchi note
Questo documento descrive come creare Blocchi note di Colab Enterprise in BigQuery. Notebooks sono BigQuery Studio asset di codice 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 alla pagina Attivare BigQuery Studio per la gestione degli asset per salvare, condividere e gestire versioni degli asset di codice come blocchi note.
Autorizzazioni obbligatorie
Imposta le autorizzazioni appropriate per creare, modificare o visualizzare i blocchi note.
Tutti gli utenti con
Ruolo di Amministratore Dataform (roles/dataform.admin
)
dispongono dell'accesso come proprietario a tutti i blocchi note creati nel progetto.
Per saperne di più su Identity and Access Management (IAM), consulta Controllo dell'accesso con IAM.
Autorizzazioni per creare blocchi note
Per creare ed eseguire blocchi note, è necessario quanto segue autorizzazioni:
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 IAM ruoli:
- 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 IAM ruoli:
- 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: questi passaggi:
Vai alla pagina BigQuery.
Nella barra delle schede del riquadro dell'editor, fai clic sul
freccia menu a discesa accanto al segno + e fai clic su Crea un blocco note Python.Si apre il nuovo blocco note contenente celle in cui vengono visualizzate query di esempio il 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: questi passaggi:
Vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e individua la tabella su cui eseguire la query.
Fai clic su >.
Visualizza le azioni accanto alla tabella, fai clic su Esegui una query nel blocco note PythonSi apre il nuovo blocco note contenente celle in cui vengono visualizzate query di esempio la 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 poi su Esplora con il blocco note Python.
Si apre il nuovo blocco note, contenente celle con codice per restituire la query SQL 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 passaggi:
Nella console Google Cloud, vai alla Pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Blocchi note e, se necessario, nella cartella Blocchi note condivisi. Seleziona un blocco note.
Seleziona il riquadro Attività.
Fai clic su
Visualizza le azioni accanto a una versione del blocco note e 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 per utilizzarlo in e BigQuery Studio. Il blocco note caricato è 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
Nella finestra di dialogo Carica blocco note, nel campo Blocco note, fai clic su Sfoglia, quindi seleziona il blocco note che vuoi per il caricamento.
(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 è un e la risorsa di computing che esegue il codice nel tuo blocco note.
Per ulteriori informazioni sui runtime, vedi 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, nella 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 hanno già un runtime attivo.
Connettiti a un runtime non predefinito
Se vuoi utilizzare un runtime diverso da quello predefinito, devi prima crea quel 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, nella cartella Blocchi note condivisi. Fai clic sul nome di un blocco note per aprirlo.
Nel blocco note, fai clic sull'icona
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 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, nella cartella Blocchi note condivisi. Fai clic sul nome di un blocco note per aprirlo.
Nel blocco note, fai clic sull'icona
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 Modello di runtime Vertex AI per l'utilizzo.
In Nome runtime, digita un nome per il runtime.
Fai clic su Connetti.
Concedi l'accesso ai blocchi note
Per concedere ad altri utenti l'accesso a un blocco note, aggiungili al ruolo IAM.
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 le 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 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.
(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 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.
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 le 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 disattivando il salvataggio dell'output del blocco note.
Quando disabiliti il salvataggio dell'output per un blocco note selezionato, BigQuery elimina tutti gli output salvati nel file del blocco note e non salva l'output delle esecuzioni successive.
Tuttavia, gli utenti che hanno accesso al blocco note può comunque visualizzare il relativo 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, e seleziona il blocco note per il quale vuoi disabilitare il salvataggio dell'output.
Fai clic su > Modifica > Impostazioni blocco note.
Attiva/disattiva la visibilità dell'intestazioneNella finestra Impostazioni blocco note, seleziona Ometti l'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:
segui questi passaggi:
- Fai clic sul link
Show diff
. Si apre la finestra di dialogo Esamina modifiche da remoto. - (Facoltativo) Per confrontare il codice sorgente del blocco note, seleziona Origine non elaborata casella di controllo.
- (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 i dati inseriti se necessaria.
- 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, nella cartella Blocchi note condivisi. Trova il blocco note che vuoi rinominare.
Fai clic su
Visualizza le 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.