Creare azioni con l'assistenza di Gemini

Puoi utilizzare Gemini, un collaboratore basato sull'AI in Google Cloud, per generare codice SQL e Dataform core all'interno dei file .sqlx in Dataform.

Scopri come e quando Gemini per Google Cloud utilizza i tuoi dati.

Per Gemini in Dataform sono supportati solo i prompt in inglese.

Questo documento è destinato ad analisti di dati, data scientist e sviluppatori di dati che lavorano con i workflow in Dataform. Presuppone che tu conosca la sintassi di Google SQL e come creare azioni del workflow Dataform.

Prima di iniziare

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. 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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
  3. Attiva Gemini in BigQuery.

Generare una query

Puoi fornire a Gemini un'istruzione in linguaggio naturale (o un prompt) per generare una query SQL o Dataform Core in base alle azioni del flusso di lavoro definite nel repository. Ad esempio, puoi utilizzare Gemini per generare un'istruzione SQL SELECT in un file di definizione della tabella .sqlx.

Per generare una query SQL o Dataform Core:

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

    Vai alla pagina Dataform

  2. Seleziona o crea un repository, quindi seleziona o crea un workspace.

  3. Nel riquadro File, seleziona o crea un file .sqlx.

  4. Nella scheda del file, fai clic su pen_spark Gemini.

  5. Nella finestra di dialogo di Gemini, inserisci un prompt in linguaggio naturale.

    Se conosci l'azione SQL che vuoi utilizzare, puoi specificare il nome dell'azione tra apici inversi (`) nel prompt.

  6. Fai clic su Genera.

    Gemini esamina le azioni SQL definite nel repository per trovare azioni che potrebbero essere pertinenti al tuo prompt e suggerisce una query.

  7. (Facoltativo) Per fornire un feedback, fai clic su thumb_up Suggerimento utile, thumb_down Suggerimento sbagliato o chat_info Fornisci altro feedback.

  8. Per accettare il suggerimento, fai clic su Inserisci.

Suggerimenti per la generazione di query

I seguenti suggerimenti possono migliorare i suggerimenti forniti da Gemini in Dataform:

  • Fornisci il nome dell'azione SQL racchiuso tra apici inversi (`), ad esempio `action_name`.
  • Se i nomi delle colonne o le relative relazioni semantiche non sono chiare o sono complesse, puoi fornire il contesto nel prompt in modo da spiegare meglio a Gemini la risposta che ti interessa. Questa tecnica è nota come prompt engineering. Ad esempio, per fare in modo che la query generata faccia riferimento al nome di una colonna, descrivi il nome della colonna e la sua pertinenza rispetto alla risposta desiderata. Per far sì che una risposta faccia riferimento a termini complessi come lifetime value o margine lordo, descrivi il concetto e la sua pertinenza rispetto ai tuoi dati per migliorare i risultati della generazione dell'SQL.

Dati di Gemini e Dataform

Gemini in Dataform può accedere ai metadati delle tabelle per cui disponi dell'autorizzazione. Sono inclusi nomi delle tabelle, nomi delle colonne, tipi di dati e descrizioni delle colonne. Gemini in Dataform non può accedere ai dati nelle tabelle, nelle viste o nei modelli. Per ulteriori informazioni su come Gemini utilizza i tuoi dati, vedi In che modo Gemini per Google Cloud utilizza i tuoi dati.

Passaggi successivi