Creare notebook

Questo documento descrive come creare notebook Colab Enterprise in BigQuery. Notebooks sono asset di codice di BigQuery Studio basati su Dataform.

Prima di iniziare

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery API.

    Enable the API

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the BigQuery API.

    Enable the API

  8. 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 di proprietario a tutti i blocchi note creati nel progetto.

    Per ulteriori informazioni su BigQuery Identity and Access Management (IAM), consulta la pagina Controllo dell'accesso con IAM.

    Autorizzazioni per creare blocchi note

    Per creare ed eseguire notebook, 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:

    Autorizzazioni per modificare i notebook

    Per modificare ed eseguire i notebook, devi disporre dei seguenti ruoli IAM:

    Autorizzazioni per visualizzare i blocchi note

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

    Creare notebook

    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, devi impostare la regione predefinita per gli asset di codice. Non puoi modificare la regione di un asset di codice dopo la creazione.

    Tutti gli asset di codice in BigQuery Studio utilizzano la stessa regione predefinita. Per impostare la regione predefinita per gli asset di codice:

    1. Vai alla pagina BigQuery.

      Vai a BigQuery

    2. Nel riquadro Explorer, trova il progetto in cui hai attivato gli asset di codice.

    3. Fai clic su Visualizza azioni accanto al progetto, quindi fai clic su Modifica la mia regione di codice predefinita.

    4. Per Regione, seleziona la regione che vuoi utilizzare per gli asset di codice.

    5. Fai clic su Seleziona.

    Per un elenco delle regioni in cui è disponibile, consulta Località di BigQuery Studio.

    Creare un notebook 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 accanto a Query SQL e poi fai clic su Crea notebook Python.

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

    3. (Facoltativo) Per visualizzare i dettagli del blocco note o la cronologia delle versioni, aggiungere nuovi commenti o rispondere a un commento esistente o ottenere un link a quest'ultimo, utilizza la seguente barra degli strumenti:

      Barra degli strumenti adiacente al notebook.

      Le funzionalità della barra degli strumenti Dettagli, Cronologia delle versioni e Commenti sono in anteprima. Per fornire un feedback o richiedere assistenza per queste funzionalità, invia un'email all'indirizzo bqui-workspace-pod@google.com.

    Creare un notebook da una tabella

    Per creare un blocco note contenente una query predefinita per una tabella specifica:

    1. Vai alla pagina BigQuery.

      Vai a BigQuery

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

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

      Si apre il nuovo notebook, contenente celle che mostrano query di esempio sulla tabella selezionata.

    Crea un notebook per esplorare il set di risultati di una query

    Per creare un blocco note per esplorare il set di risultati di una query:

    1. Vai alla pagina BigQuery.

      Vai a BigQuery

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

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

      Si apre il nuovo notebook, contenente celle con il codice per restituire la query SQL e i risultati della query.

    Creare un notebook da un notebook esistente

    Per aprire una versione di un notebook esistente come nuovo notebook, 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 notebook.

    3. Fai clic su Cronologia delle versioni.

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

      Una copia del notebook viene aperta come nuovo notebook.

    Aggiorna notebook

    Puoi caricare un notebook 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, quindi esegui una delle seguenti operazioni:

      • Accanto a Notebook, fai clic su Visualizza azioni > Carica su Notebook.
      • Accanto al nome del progetto Google Cloud , fai clic su Visualizza azioni > Carica nel progetto > Notebook Python.
    3. Nella finestra di dialogo Carica notebook, nel campo Notebook, fai clic su Sfoglia e seleziona il notebook 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 notebook.

    6. Fai clic su Carica.

    Il notebook viene visualizzato nel riquadro Explorer.

    Connetti a un runtime

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

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

    Connettersi 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 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 una cella qualsiasi del blocco note.

      La connessione al runtime predefinito potrebbe richiedere diversi minuti se non hai ancora un runtime attivo.

    Connettersi 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 a un runtime non predefinito:

    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 e poi 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 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 e poi su Connetti a un runtime.

    4. Fai clic su Crea nuovo runtime.

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

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

    7. Fai clic su Connetti.

    Concedere l'accesso ai notebook

    Per concedere l'accesso a un notebook ad altri utenti, aggiungili a un ruolo IAM appropriato.

    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 notebook, 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:

    7. (Facoltativo) Per visualizzare un elenco completo di ruoli e impostazioni di condivisione avanzate, fai clic su Condivisione avanzata.

    8. Fai clic su Salva.

    9. Per tornare alla pagina delle informazioni del blocco note, fai clic su Chiudi.

    Condividere i notebook

    Per condividere un notebook con altri utenti, puoi generare e condividere un link al notebook. Affinché altri utenti possano vedere il notebook che condividi, devi prima concedere l'accesso al notebook.

    Per eseguire un blocco note, gli utenti devono avere accesso ai dati a cui accede il blocco note. Per ulteriori informazioni, vedi Concedere l'accesso a un set di dati.

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

      Vai a BigQuery

    2. Nel riquadro Explorer, espandi il progetto e la cartella Notebook e, se necessario, espandi la cartella Notebook condivisi. Trova il notebook 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.

    Disattivare il salvataggio dell'output del notebook

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

    Quando disattivi il salvataggio dell'output per un notebook selezionato, BigQuery elimina tutto l'output salvato nel file del notebook e non salva l'output delle esecuzioni successive.

    Tuttavia, gli utenti che hanno accesso al notebook possono comunque visualizzare il suo output nei seguenti modi:

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

    Per disattivare il salvataggio dell'output per un notebook 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, 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 del notebook.

    4. Nella finestra Impostazioni notebook, seleziona Escludi output delle celle di codice durante il salvataggio del notebook.

    5. Fai clic su Salva.

    6. Fai clic su Ricarica.

    Risolvi conflitti

    Se tu e un altro utente apportate modifiche in conflitto in un notebook, 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. Si apre la finestra di dialogo Rivedi modifiche da remoto.
    2. (Facoltativo) Per confrontare il codice sorgente del notebook, 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 Diff in linea.
    4. Esamina le modifiche e decidi quali mantenere, rivedendo l'input se necessario.
    5. Fai clic su Salva modifiche.

    Rinominare i notebook

    Per rinominare un 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 notebook che vuoi rinominare.

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

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

    Risoluzione dei problemi

    Per saperne di più, vedi Risolvere i problemi relativi a Colab Enterprise.

    Passaggi successivi