Utilizzare le celle SQL

Questa guida descrive come utilizzare le celle SQL per eseguire query sui dati da un notebook Colab Enterprise.

Panoramica

Una cella SQL è una cella di codice per scrivere, modificare ed eseguire query SQL all'interno del notebook Colab Enterprise. Le celle SQL forniscono un flusso di lavoro alternativo a IPython Magics per BigQuery.

Funzionalità

Le celle SQL forniscono le seguenti funzionalità:

• Supporto per dry run: convalida istruzione SQL e approssimazione de l numero di byte elaborati dalla query
• Formattazione: linting delle parole chiave ed evidenziazione della sintassi
• Denominazione delle variabili di output di BigQuery DataFrame: fai riferimento alla variabile di output da altre celle del notebook
• Sostituzione delle variabili: fai riferimento alle variabili Python e alle celle SQL per supportare la parametrizzazione e la possibilità di eseguire query sui risultati di una query precedente
• Visualizzatore del set di risultati: visualizzatore leggero del set di risultati tabellari con paginazione per set di risultati di grandi dimensioni
• Integrazione delle celle di visualizzazione: l'output di una cella SQL può essere utilizzato come input per una cella di visualizzazione

Dialetto SQL e origine dati supportati

• Le celle SQL di Colab Enterprise supportano GoogleSQL.

• Puoi eseguire query SQL sui dati BigQuery.

Limitazioni

Tieni presente le seguenti limitazioni quando pianifichi il progetto:

• Puoi eseguire più istruzioni SQL in una singola cella SQL, ma solo i risultati dell'ultima istruzione SQL vengono salvati in un DataFrame.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non hai mai utilizzato Google Cloud, crea un account per valutare il rendimento dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per eseguire, testare e implementare i carichi di lavoro.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery, Compute Engine, Dataform, and Agent Platform APIs.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.