Gestire i notebook

Questo documento descrive come gestire i notebook Colab Enterprise in BigQuery, incluso come visualizzare, confrontare, ripristinare ed eliminare i notebook.

Questo documento descrive anche come visualizzare e gestire i metadati dei blocchi note in Knowledge Catalog.

Notebooks sono asset di codice di BigQuery Studio basati su Dataform.

Prima di iniziare

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

Autorizzazioni obbligatorie

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

• BigQuery Job User (roles/bigquery.jobUser)
• Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Code Owner (roles/dataform.codeOwner) a livello di risorsa.

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

• BigQuery Job User (roles/bigquery.jobUser)
• Utente 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:

• BigQuery Job User (roles/bigquery.jobUser)
• Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser)

• Uno qualsiasi dei seguenti ruoli:

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

Per saperne di più su BigQuery IAM, consulta Controllo dell'accesso con IAM.

Per gestire i metadati del notebook in Knowledge Catalog, assicurati di disporre dei ruoli Knowledge Catalog richiesti.

Concedere l'accesso ai notebook

Per concedere l'accesso a un notebook ad altri utenti, 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 a sinistra, fai clic su Spazio di esplorazione:

   

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro a sinistra per aprirlo.

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note.

4. Trova il blocco note a cui vuoi concedere l'accesso.

5. Fai clic su Apri azioni accanto al blocco note, quindi fai clic su Condividi.

6. Nel riquadro Autorizzazioni di condivisione, fai clic su Aggiungi utente/gruppo.

7. Nel campo Nuove entità, inserisci un'entità.

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

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

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

10. Fai clic su Salva.

11. 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 notebook, gli utenti devono avere accesso ai dati a cui accede il notebook. Per saperne di più, vedi 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 a sinistra, fai clic su Spazio di esplorazione:

   

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro a sinistra per aprirlo.

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note.

4. Trova il blocco note che vuoi condividere. Puoi utilizzare la funzione di ricerca o i filtri per trovare il tuo blocco note.

5. Fai clic su Visualizza azioni accanto al blocco note, quindi fai clic su Condividi > Copia link.

6. Condividi il link con altri utenti.

Visualizza tutti i notebook

Per visualizzare un elenco di tutti i notebook nel tuo progetto:

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

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro a sinistra per aprirlo.

3. 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 suddivisa, fai clic su Mostra tutto in > Scheda suddivisa.

Visualizzare i metadati del notebook

Per visualizzare i metadati del blocco note:

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

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note.

4. Fai clic sul nome del blocco note di cui vuoi visualizzare i metadati.

5. Esamina i dettagli del riepilogo per visualizzare informazioni sul notebook, ad esempio la regione che utilizza per i dati e la data dell'ultima modifica.

Utilizzare le versioni del notebook

Puoi scegliere di creare un notebook all'interno o all'esterno di un repository. Il controllo delle versioni dei blocchi note viene gestito in modo diverso a seconda della posizione del blocco note.

Controllo delle versioni dei notebook nei repository

I repository sono repository Git che si trovano in BigQuery o presso un provider di terze parti. Puoi utilizzare gli spazi di lavoro nei repository per eseguire il controllo delle versioni sui blocchi note. Per saperne di più, vedi Utilizzare il controllo delle versioni con un file.

Controllo delle versioni dei notebook al di fuori dei repository

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

Visualizzare le versioni del notebook

Per visualizzare le versioni del blocco note:

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

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note. Fai clic sul nome del notebook per cui vuoi visualizzare la cronologia delle versioni.

4. Per visualizzare un elenco delle versioni del blocco note in ordine cronologico decrescente, fai clic su Cronologia delle versioni.

Confrontare le versioni del notebook

Per confrontare le versioni di un blocco note:

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

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note.

4. Fai clic sul nome del blocco note per cui vuoi confrontare le informazioni sulla versione.

5. Fai clic su Cronologia delle versioni.

6. Fai clic su Visualizza azioni accanto a una versione del notebook, quindi fai clic su Confronta. Si apre il riquadro di confronto, che mette a confronto la versione del blocco note selezionata con la versione attuale.

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

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

9. (Facoltativo) Per nascondere l'output comando nel notebook, fai clic su Confronta e deseleziona Mostra output.

Ripristinare una versione del notebook

Il ripristino di una versione del blocco note dal riquadro di confronto ti consente di confrontare la versione attuale e quella precedente del blocco note prima di scegliere di ripristinare la versione precedente. Il ripristino di un notebook crea una nuova versione del notebook anziché sovrascrivere quella attuale. Nessuna cronologia delle versioni viene persa.

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

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note.

4. Fai clic sul nome del blocco note di cui vuoi ripristinare una versione precedente.

5. Fai clic su Cronologia delle versioni.

6. Fai clic su Visualizza azioni accanto alla versione, quindi fai clic su Confronta. Si apre il riquadro di confronto, che mette a confronto la versione del blocco note che hai selezionato con la versione più recente.

7. Se vuoi ripristinare la versione precedente del blocco note dopo il confronto, fai clic su Ripristina.

8. Fai clic su Conferma.

Scaricare un notebook

Per scaricare un blocco note:

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

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note.

4. Fai clic sul nome del blocco note che vuoi scaricare. Puoi utilizzare la funzione di ricerca o i filtri per trovare il tuo blocco note.

5. Espandi la barra dei menu e vai al menu File:

   

6. Seleziona Scarica e poi il tipo di file in cui vuoi scaricare il file.

Elimina notebook

Per eliminare un blocco note:

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

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

3. Nel riquadro Explorer, espandi il progetto e fai clic su Blocchi note.

4. Trova il blocco note che vuoi eliminare.

5. Fai clic su Visualizza azioni accanto al notebook, quindi fai clic su Elimina.

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

7. Fai clic su Elimina.

Gestire i metadati in Knowledge Catalog

Knowledge Catalog ti consente di archiviare e gestire i metadati dei notebook. Notebooks sono disponibili nel catalogo della conoscenza per impostazione predefinita, senza configurazione aggiuntiva.

Puoi utilizzare Knowledge Catalog per gestire i blocchi note in tutte le posizioni BigQuery. La gestione dei blocchi note in Knowledge Catalog è soggetta a quote e limiti di Knowledge Catalog e ai prezzi di Knowledge Catalog.

Knowledge Catalog recupera automaticamente i seguenti metadati dai blocchi note:

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

Knowledge Catalog registra i blocchi note come voci con i seguenti valori delle voci:

Gruppo di voci di sistema

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

Tipo di voce di 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 blocco note 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 Knowledge Catalog. Per istruzioni su come visualizzare i dettagli di una voce selezionata, consulta Visualizzare i dettagli di una voce nella documentazione di Knowledge Catalog.

Tipo di aspetto del sistema

Il tipo di aspetto di sistema per i notebook è dataform-code-asset. Per fornire un contesto aggiuntivo ai blocchi note in Knowledge Catalog annotando le voci del blocco note con aspetti, visualizzare il tipo di aspetto 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. Per istruzioni su come annotare le voci con gli aspetti, consulta Gestire gli aspetti e arricchire i metadati nella documentazione di Knowledge Catalog.

Tipo

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

Per istruzioni su come cercare asset in Knowledge Catalog, consulta Cercare asset di dati in Knowledge Catalog nella documentazione di Knowledge Catalog.

Risoluzione dei problemi

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

Passaggi successivi

• Scopri di più sui notebook di Colab Enterprise in BigQuery.
• Scopri come creare notebook.
• Scopri come pianificare i blocchi note.