Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Utilizzare le stored procedure SQL

Una stored procedure è una raccolta di istruzioni che possono essere chiamate da altre query o altre stored procedure. Una procedura può accettare argomenti di input e restituire valori come output. Assegni un nome a una procedura e la memorizzi in un set di dati BigQuery. Una stored procedure può accedere o modificare i dati in più set di dati da parte di più utenti. Può anche contenere una query con più istruzioni.

Alcune stored procedure sono integrate in BigQuery e non devono essere create. Queste sono chiamate procedure di sistema e puoi scoprire di più su di esse nel riferimento alle procedure di sistema.

Le stored procedure supportano le istruzioni del linguaggio procedurale, che consentono di eseguire operazioni come definire variabili e implementare il flusso di controllo. Puoi scoprire di più sulle istruzioni del linguaggio procedurale nel riferimento al linguaggio procedurale.

Creare una stored procedure

Scegli una delle seguenti opzioni per creare una stored procedure:

SQL

Per creare una procedura, utilizza l' CREATE PROCEDURE istruzione.

Nell'esempio concettuale seguente, procedure_name rappresenta la procedura e il corpo della procedura viene visualizzato tra le istruzioni BEGIN e END:

CREATE PROCEDURE dataset_name.procedure_name()
BEGIN
-- statements here
END

L'esempio seguente mostra una procedura che contiene una query con più istruzioni. La query con più istruzioni imposta una variabile, esegue un'istruzione INSERT e visualizza il risultato come stringa di testo formattata.

CREATE OR REPLACE PROCEDURE mydataset.create_customer()
BEGIN
  DECLARE id STRING;
  SET id = GENERATE_UUID();
  INSERT INTO mydataset.customers (customer_id)
    VALUES(id);
  SELECT FORMAT("Created customer %s", id);
END

Nell'esempio precedente, il nome della procedura è mydataset.create_customer, e il corpo della procedura viene visualizzato tra le istruzioni BEGIN e END.

Per chiamare la procedura, utilizza l' CALL istruzione:

CALL mydataset.create_customer();

Terraform

Utilizza la google_bigquery_routine risorsa.

Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

L'esempio seguente crea una stored procedure denominata my_stored_procedure:

# Creates a SQL stored procedure.

# Create a dataset to contain the stored procedure.
resource "google_bigquery_dataset" "my_dataset" {
  dataset_id = "my_dataset"
}

# Create a stored procedure.
resource "google_bigquery_routine" "my_stored_procedure" {
  dataset_id      = google_bigquery_dataset.my_dataset.dataset_id
  routine_id      = "my_stored_procedure"
  routine_type    = "PROCEDURE"
  language        = "SQL"
  definition_body = "SELECT * FROM `bigquery-public-data.ml_datasets.penguins`;"
}

Per applicare la configurazione Terraform in un Google Cloud progetto, completa i passaggi nelle sezioni seguenti.

Preparare Cloud Shell

Avvia Cloud Shell.
Imposta il progetto predefinito in cui vuoi applicare le configurazioni Terraform. Google Cloud

Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform

Preparare la directory

Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo root).

In Cloud Shell, crea una directory e un nuovo file all'interno della directory. Il nome file deve avere l' .tf estensione, ad esempio main.tf. In questo tutorial, il file viene chiamato main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

Copia il codice campione nel file main.tf appena creato.

Facoltativamente, copia il codice da GitHub. Questa operazione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
Salva le modifiche.
Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
```
terraform init
```
Facoltativamente, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:
```
terraform init -upgrade
```

Applicare le modifiche

Esamina la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative:
```
terraform plan
```
Apporta le correzioni necessarie alla configurazione.
Applica la configurazione Terraform eseguendo il seguente comando e inserendo yes al prompt:
```
terraform apply
```
Attendi che Terraform visualizzi il messaggio "Apply complete!".
Apri il Google Cloud progetto per visualizzare i risultati. Nella Google Cloud console, vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Passare un valore con un parametro di input

Una procedura può avere parametri di input. Un parametro di input consente l'input per una procedura, ma non consente l'output.

CREATE OR REPLACE PROCEDURE mydataset.create_customer(name STRING)
BEGIN
  DECLARE id STRING;
  SET id = GENERATE_UUID();
  INSERT INTO mydataset.customers (customer_id, name)
    VALUES(id, name);
  SELECT FORMAT("Created customer %s (%s)", id, name);
END

Passare un valore con un parametro di output

Una procedura può avere parametri di output. Un parametro di output restituisce un valore dalla procedura, ma non consente l'input per la procedura. Per creare un parametro di output, utilizza la parola chiave OUT prima del nome del parametro.

Ad esempio, questa versione della procedura restituisce il nuovo ID cliente tramite il parametro id:

CREATE OR REPLACE PROCEDURE mydataset.create_customer(name STRING, OUT id STRING)
BEGIN
  SET id = GENERATE_UUID();
  INSERT INTO mydataset.customers (customer_id, name)
    VALUES(id, name);
  SELECT FORMAT("Created customer %s (%s)", id, name);
END

Per chiamare questa procedura, devi utilizzare una variabile per ricevere il valore di output:

--- Create a new customer record.
DECLARE id STRING;
CALL mydataset.create_customer("alice",id);

--- Display the record.
SELECT * FROM mydataset.customers
WHERE customer_id = id;

Passare un valore in entrata e in uscita con un parametro di input/output

Una procedura può anche avere parametri di input/output. Un parametro di input/output restituisce un valore dalla procedura e accetta anche l'input per la procedura. Per creare un parametro di input/output, utilizza la parola chiave INOUT prima del nome del parametro. Per saperne di più, vedi Modalità argomento.

Autorizzare le routine

Puoi autorizzare le stored procedure come routine. Le routine autorizzate ti consentono di condividere i risultati delle query con utenti o gruppi specifici senza concedere loro l'accesso alle tabelle sottostanti che hanno generato i risultati. Ad esempio, una routine autorizzata può calcolare un'aggregazione sui dati o cercare un valore di tabella e utilizzarlo in un calcolo.

Le routine autorizzate possono creare, eliminare, e manipolare le tabelle, nonché richiamare altre stored procedure sulla tabella sottostante.

Per saperne di più, vedi Routine autorizzate.

Chiamare una stored procedure

Per chiamare una stored procedure dopo averla creata, utilizza l'istruzione CALL. Ad esempio, l'istruzione seguente chiama la stored procedure create_customer:

CALL mydataset.create_customer();

Chiamare una procedura di sistema

Per chiamare una procedura di sistema integrata, utilizza l'istruzione CALL. Ad esempio, l'istruzione seguente chiama la procedura di sistema BQ.REFRESH_MATERIALIZED_VIEW:

CALL BQ.REFRESH_MATERIALIZED_VIEW;