Gestire i blocchi note

Questo documento descrive come gestire i notebook di Colab Enterprise in BigQuery, ad esempio come visualizzarli, confrontarli, ripristinarli ed eliminarli.

Questo documento descrive anche come visualizzare e gestire i metadati dei notebook in Dataplex.

Notebooks sono asset di codice BigQuery Studio basati su Dataform.

Prima di iniziare

1. Crea un notebook.
2. Per gestire i metadati dei notebook in Dataplex, assicurati che l'API Dataplex sia abilitata nel tuo progetto Google Cloud .

Autorizzazioni obbligatorie

Per condividere i notebook, devi disporre dei seguenti ruoli IAM (Identity and Access Management):

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Proprietario del codice (roles/dataform.codeOwner) a livello di risorsa.

Per salvare ed eliminare i notebook, devi disporre dei seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Proprietario del codice (roles/dataform.codeOwner) o Editor di codice (roles/dataform.codeEditor)

Per lavorare con le revisioni dei notebook, devi disporre dei seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente della sessione di lettura BigQuery (roles/bigquery.readSessionUser)

• Uno dei seguenti ruoli:

  • Proprietario del codice (roles/dataform.codeOwner)
  • Editor di codice (roles/dataform.codeEditor)
  • Visualizzatore di codice (roles/dataform.codeViewer)

Per ulteriori informazioni su IAM di BigQuery, consulta Controllo dell'accesso con IAM.

Per gestire i metadati dei notebook in Dataplex, assicurati di disporre dei ruoli Dataplex richiesti.

Concedere l'accesso ai blocchi note

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

Importante: gli utenti che hanno accesso al notebook possono visualizzare tutto l'output generato dal codice nel notebook, anche se l'output contiene dati provenienti da tabelle a cui non hanno accesso. Per impedire la condivisione dell'output salvato, disattiva il salvataggio dell'output del notebook.

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, la cartella Blocchi note condivisi. Trova il notebook a cui vuoi concedere l'accesso.

3. Fai clic su Visualizza azioni accanto al notebook, quindi su Condividi > Gestisci autorizzazioni.

4. Nel riquadro Gestisci autorizzazioni, fai clic su Aggiungi utente/gruppo.

5. Nel campo Nuovi principali, inserisci un principale.

6. Nell'elenco Ruolo, seleziona uno dei seguenti ruoli:

   • Proprietario del codice: può eseguire qualsiasi azione sul notebook, inclusa l'eliminazione o la condivisione.
   • Editor di codice: può modificare il notebook.
   • Code Viewer: può visualizzare il notebook.
   Nota: per eseguire il notebook, il principale deve disporre anche dei ruoli Utente runtime notebook (roles/aiplatform.notebookRuntimeUser) e Utente BigQuery (roles/bigquery.user).

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 notebook, fai clic su Chiudi.

Condividere i notebook

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

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

Importante: gli utenti che hanno accesso al notebook possono visualizzare tutto l'output generato dal codice nel notebook, anche se l'output contiene dati provenienti da tabelle a cui non hanno accesso. Per impedire la condivisione dell'output salvato, disattiva il salvataggio dell'output del notebook.

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 Blocchi note condivisi. Trova il notebook che vuoi condividere.

3. Fai clic su Visualizza azioni accanto al notebook, quindi su Condividi > Copia link.

4. Condividi il link con altri utenti.

Visualizza tutti i notebook

Per visualizzare un elenco di tutti i notebook del progetto:

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

   Vai a BigQuery

2. Nel riquadro Explorer, fai clic su Visualizza azioni accanto a Notebook, quindi esegui una delle seguenti operazioni:

• Per aprire l'elenco nella scheda corrente, fai clic su Mostra tutto.
• Per aprire l'elenco in una nuova scheda, fai clic su Mostra tutto in > Nuova scheda.
• Per aprire l'elenco in una scheda divisa, fai clic su Mostra tutto in > Scheda divisa.

Visualizzare i metadati del notebook

Per visualizzare i metadati del notebook:

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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook di cui vuoi visualizzare i metadati.

3. Consulta il riquadro Riepilogo per visualizzare informazioni sul notebook, ad esempio la regione utilizzata per i dati e la data dell'ultima modifica.

Lavorare con le versioni dei notebook

Utilizza le seguenti sezioni per scoprire come visualizzare, confrontare e ripristinare le versioni di un notebook.

Visualizzare le versioni del notebook

Per visualizzare le versioni del notebook:

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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook di cui vuoi visualizzare l'attività.

3. Fai clic sulla scheda Attività per visualizzare un elenco delle versioni del notebook in ordine decrescente per data.

Confrontare le versioni dei notebook

Per confrontare le versioni dei notebook:

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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook per il quale vuoi confrontare le informazioni sulla versione.

3. Nella scheda Attività, fai clic su Visualizza azioni accanto a una versione del notebook e poi su Confronta. Si apre il riquadro di confronto, che mette a confronto la versione del notebook selezionata con la versione corrente del notebook.

4. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, fai clic su Confronta e poi su In linea.

5. (Facoltativo) Per confrontare il codice sorgente delle versioni, fai clic su Confronta e poi su Mostra codice sorgente non elaborato.

6. (Facoltativo) Per nascondere loutput comando nel notebook, fai clic su Confronta e poi deseleziona Mostra output.

Ripristinare una versione del notebook

Utilizza una delle seguenti opzioni per ripristinare una versione del notebook. Il ripristino dal riquadro di confronto ti consente di confrontare le versioni corrente e precedente del notebook prima di scegliere di ripristinare la versione precedente. Il ripristino di un notebook crea una nuova versione anziché sovrascrivere la versione corrente. Nessuna cronologia delle versioni andrà persa.

Riquadro Attività

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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook di cui vuoi ripristinare una versione precedente.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza azioni accanto alla versione del blocco note che vuoi ripristinare, quindi fai clic su Ripristina.

5. Fai clic su Conferma.

Riquadro di confronto

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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook di cui vuoi ripristinare una versione precedente.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza azioni accanto a una versione del notebook, quindi fai clic su Confronta. Viene visualizzato il riquadro di confronto, che mostra la versione del notebook selezionata con la versione più recente.

5. Se vuoi ripristinare la versione precedente del notebook dopo il confronto, fai clic su Ripristina.

6. Fai clic su Conferma.

Scaricare un blocco note

Per scaricare un notebook:

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, la cartella Blocchi note condivisi. Fai clic sul nome del notebook che vuoi scaricare.

3. Fai clic su Scarica.

Eliminare i notebook

Per eliminare un taccuino:

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 Blocchi note condivisi. Trova il notebook che vuoi eliminare.

3. Fai clic su Visualizza azioni accanto al blocco note e poi su Elimina.

4. Per confermare l'eliminazione, digita delete nella finestra di dialogo.

5. Fai clic su Elimina.

Gestire i metadati in Dataplex

Dataplex ti consente di archiviare e gestire i metadati dei notebook. Notebooks sono disponibili in Dataplex per impostazione predefinita, senza configurazione aggiuntiva.

Puoi utilizzare Dataplex per gestire i notebook in tutte le località BigQuery. La gestione dei notebook in Dataplex è soggetta alle quote e ai limiti di Dataplex e ai prezzi di Dataplex.

Dataplex recupera automaticamente i seguenti metadati dai notebook:

• Nome dell'asset di dati
• Asset di dati principale
• Posizione dell'asset di dati
• Tipo di asset di dati
• Progetto Google Cloud corrispondente

Dataplex registra i notebook come entries con i seguenti valori di entry:

Gruppo di voci di sistema

Il gruppo di voci di sistema per i notebook è @dataform. Per visualizzare i dettagli delle voci del notebook in Dataplex, devi visualizzare il gruppo di voci di sistema dataform. Per istruzioni su come visualizzare un elenco di tutte le voci di un gruppo di voci, consulta Visualizzare i dettagli di un gruppo di voci nella documentazione di Dataplex.

Tipo di voce del sistema

Il tipo di voce di sistema per i notebook è dataform-code-asset. Per visualizzare i dettagli dei notebook, devi visualizzare il tipo di voce di sistema dataform-code-asset, filtrare i risultati con un filtro basato sugli aspetti e impostare il campo type all'interno dell'aspetto dataform-code-asset su NOTEBOOK. Quindi, seleziona una voce del notebook selezionato. Per istruzioni su come visualizzare i dettagli di un tipo di voce selezionato, consulta Visualizzare i dettagli di un tipo di voce nella documentazione di Dataplex. Per istruzioni su come visualizzare i dettagli di una voce selezionata, consulta Visualizzare i dettagli di una voce nella documentazione di Dataplex.

Tipo di aspetto del sistema

Il tipo di aspetto del sistema per i notebook è dataform-code-asset. Per fornire un contesto aggiuntivo ai notebook in Dataplex annotando le voci dei notebook con gli aspetti, visualizza il tipo di aspetto dataform-code-asset, filtra i risultati con un filtro basato sugli aspetti e imposta il campo type all'interno dell'aspetto dataform-code-asset su NOTEBOOK. Per istruzioni su come annotare le voci con gli aspetti, consulta Gestire gli aspetti e arricchire i metadati nella documentazione di Dataplex.

Tipo

Il tipo di canvas di dati è NOTEBOOK. Questo tipo ti consente di filtrare i notebook nel dataform-code-asset tipo di voce di sistema e nel dataform-code-asset tipo di aspetto utilizzando la aspect:dataplex-types.global.dataform-code-asset.type=NOTEBOOK query in un filtro basato sugli aspetti.

Per istruzioni su come cercare gli asset in Dataplex, consulta Cercare asset di dati in Dataplex nella documentazione di Dataplex.

Risoluzione dei problemi

Per ulteriori informazioni, consulta Risolvere i problemi di Colab Enterprise.

Passaggi successivi

• Scopri di più sui notebook di Colab Enterprise in BigQuery.
• Scopri come creare quaderni.
• Scopri come orchestrare i notebook.