Operatori foglia

Un operatore foglia non ha figli. I tipi di operatori foglia sono:

• Array unnest
• Genera relazione
• Relazione tra unità
• Relazione vuota
• Scan
• Analisi dei filtri

Nota sull'interfaccia PostgreSQL: Gli esempi in questo argomento sono destinati ai database con dialetto GoogleSQL. Questa funzionalità non supporta l'interfaccia PostgreSQL.

Schema del database

Le query e i piani di esecuzione in questa pagina si basano sul seguente schema del database:

CREATE TABLE Singers (
  SingerId   INT64 NOT NULL,
  FirstName  STRING(1024),
  LastName   STRING(1024),
  SingerInfo BYTES(MAX),
  BirthDate  DATE
) PRIMARY KEY(SingerId);

CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName);

CREATE TABLE Albums (
  SingerId        INT64 NOT NULL,
  AlbumId         INT64 NOT NULL,
  AlbumTitle      STRING(MAX),
  MarketingBudget INT64
) PRIMARY KEY(SingerId, AlbumId),
  INTERLEAVE IN PARENT Singers ON DELETE CASCADE;

CREATE INDEX AlbumsByAlbumTitle ON Albums(AlbumTitle);

CREATE INDEX AlbumsByAlbumTitle2 ON Albums(AlbumTitle) STORING (MarketingBudget);

CREATE TABLE Songs (
  SingerId  INT64 NOT NULL,
  AlbumId   INT64 NOT NULL,
  TrackId   INT64 NOT NULL,
  SongName  STRING(MAX),
  Duration  INT64,
  SongGenre STRING(25)
) PRIMARY KEY(SingerId, AlbumId, TrackId),
  INTERLEAVE IN PARENT Albums ON DELETE CASCADE;

CREATE INDEX SongsBySingerAlbumSongNameDesc ON Songs(SingerId, AlbumId, SongName DESC), INTERLEAVE IN Albums;

CREATE INDEX SongsBySongName ON Songs(SongName);

CREATE TABLE Concerts (
  VenueId      INT64 NOT NULL,
  SingerId     INT64 NOT NULL,
  ConcertDate  DATE NOT NULL,
  BeginTime    TIMESTAMP,
  EndTime      TIMESTAMP,
  TicketPrices ARRAY<INT64>
) PRIMARY KEY(VenueId, SingerId, ConcertDate);

Puoi utilizzare le seguenti istruzioni DML (Data Manipulation Language) per aggiungere dati a queste tabelle:

INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
VALUES (1, "Marc", "Richards", "1970-09-03"),
       (2, "Catalina", "Smith", "1990-08-17"),
       (3, "Alice", "Trentor", "1991-10-02"),
       (4, "Lea", "Martin", "1991-11-09"),
       (5, "David", "Lomond", "1977-01-29");

INSERT INTO Albums (SingerId, AlbumId, AlbumTitle)
VALUES (1, 1, "Total Junk"),
       (1, 2, "Go, Go, Go"),
       (2, 1, "Green"),
       (2, 2, "Forever Hold Your Peace"),
       (2, 3, "Terrified"),
       (3, 1, "Nothing To Do With Me"),
       (4, 1, "Play");

INSERT INTO Songs (SingerId, AlbumId, TrackId, SongName, Duration, SongGenre)
VALUES (2, 1, 1, "Let's Get Back Together", 182, "COUNTRY"),
       (2, 1, 2, "Starting Again", 156, "ROCK"),
       (2, 1, 3, "I Knew You Were Magic", 294, "BLUES"),
       (2, 1, 4, "42", 185, "CLASSICAL"),
       (2, 1, 5, "Blue", 238, "BLUES"),
       (2, 1, 6, "Nothing Is The Same", 303, "BLUES"),
       (2, 1, 7, "The Second Time", 255, "ROCK"),
       (2, 3, 1, "Fight Story", 194, "ROCK"),
       (3, 1, 1, "Not About The Guitar", 278, "BLUES");

Nota: puoi eseguire query e recuperare piani di esecuzione anche se le tabelle non contengono dati.

Estrai array

Un operatore di estrazione di array appiattisce un array di input in righe di elementi. Ogni riga risultante contiene massimo due colonne: il valore dell'array e la posizione in base zero facoltativa nell'array.

La seguente query mostra questo operatore:

SELECT a, b FROM UNNEST([1,2,3]) a WITH OFFSET b;

/*---+---+
 | a | b |
 +---+---+
 | 1 | 0 |
 | 2 | 1 |
 | 3 | 2 |
 +---+---*/

La query appiattisce l'array [1,2,3] nella colonna a e mostra la posizione dell'array nella colonna b.

Il piano di esecuzione viene visualizzato nel seguente modo:

Proprietà e statistiche di esecuzione

Una proprietà di un operatore descrive una caratteristica utilizzata quando l'operatore viene eseguito. Una statistica di esecuzione è un valore raccolto durante l'esecuzione della query per aiutarti a valutare le prestazioni dell'operatore.

Proprietà

Nome	Descrizione
Metodo di esecuzione	Nell'esecuzione per riga, l'operatore elabora una riga alla volta. Nell'esecuzione batch, l'operatore elabora un batch di righe contemporaneamente.

Statistiche di esecuzione

Nome	Descrizione
Latenza	Tempo trascorso di tutte le esecuzioni eseguite nell'operatore.
Latenza cumulativa	Il tempo totale dell'operatore corrente e dei relativi discendenti.
Tempo CPU	Somma del tempo di CPU dedicato all'esecuzione dell'operatore.
Tempo di CPU cumulativo	Il tempo di CPU totale dedicato all'esecuzione dell'operatore e dei relativi discendenti.
Tempo di esecuzione	Il tempo totale impiegato per eseguire la query ed elaborare i risultati.
Righe restituite	Il numero di righe generate da questo operatore
Numero di esecuzioni	Il numero di volte in cui l'operatore è stato eseguito. Alcune esecuzioni possono essere eseguite in parallelo.

Genera relazione

Un operatore generate relation restituisce zero o più righe.

Proprietà e statistiche di esecuzione

Una proprietà di un operatore descrive una caratteristica utilizzata quando l'operatore viene eseguito. Una statistica di esecuzione è un valore raccolto durante l'esecuzione della query per aiutarti a valutare le prestazioni dell'operatore.

Proprietà

Nome	Descrizione
Metodo di esecuzione	Nell'esecuzione per riga, l'operatore elabora una riga alla volta. Nell'esecuzione batch, l'operatore elabora un batch di righe contemporaneamente.

Statistiche di esecuzione

Nome	Descrizione
Latenza	Tempo trascorso di tutte le esecuzioni eseguite nell'operatore.
Latenza cumulativa	Il tempo totale dell'operatore corrente e dei relativi discendenti.
Tempo CPU	Somma del tempo di CPU dedicato all'esecuzione dell'operatore.
Tempo di CPU cumulativo	Il tempo di CPU totale dedicato all'esecuzione dell'operatore e dei relativi discendenti.
Tempo di esecuzione	Il tempo totale impiegato per eseguire la query ed elaborare i risultati.
Righe restituite	Il numero di righe generate da questo operatore
Numero di esecuzioni	Il numero di volte in cui l'operatore è stato eseguito. Alcune esecuzioni possono essere eseguite in parallelo.

Relazione con unità

La relazione unità restituisce una riga. Si tratta di un caso speciale dell'operatore generate relation.

La seguente query mostra questo operatore:

SELECT 1 + 2 AS Result;

/*--------+
 | Result |
 +--------+
 | 3      |
 +--------*/

Il piano di esecuzione viene visualizzato nel seguente modo:

Proprietà e statistiche di esecuzione

Una proprietà di un operatore descrive una caratteristica utilizzata quando l'operatore viene eseguito. Una statistica di esecuzione è un valore raccolto durante l'esecuzione della query per aiutarti a valutare le prestazioni dell'operatore.

Proprietà

Nome	Descrizione
Metodo di esecuzione	Nell'esecuzione per riga, l'operatore elabora una riga alla volta. Nell'esecuzione batch, l'operatore elabora un batch di righe contemporaneamente.

Statistiche di esecuzione

Nome	Descrizione
Latenza	Tempo trascorso di tutte le esecuzioni eseguite nell'operatore.
Latenza cumulativa	Il tempo totale dell'operatore corrente e dei relativi discendenti.
Tempo CPU	Somma del tempo di CPU dedicato all'esecuzione dell'operatore.
Tempo di CPU cumulativo	Il tempo di CPU totale dedicato all'esecuzione dell'operatore e dei relativi discendenti.
Tempo di esecuzione	Il tempo totale impiegato per eseguire la query ed elaborare i risultati.
Righe restituite	Il numero di righe generate da questo operatore
Numero di esecuzioni	Il numero di volte in cui l'operatore è stato eseguito. Alcune esecuzioni possono essere eseguite in parallelo.

Relazione vuota

La relazione vuota non restituisce righe. Si tratta di un caso speciale dell'operatore generate relation.

La seguente query mostra questo operatore:

SELECT *
FROM   albums
LIMIT  0

/*
No result
*/

Il piano di esecuzione viene visualizzato nel seguente modo:

Proprietà e statistiche di esecuzione

Una proprietà di un operatore descrive una caratteristica utilizzata quando l'operatore viene eseguito. Una statistica di esecuzione è un valore raccolto durante l'esecuzione della query per aiutarti a valutare le prestazioni dell'operatore.

Proprietà

Nome	Descrizione
Metodo di esecuzione	Nell'esecuzione per riga, l'operatore elabora una riga alla volta. Nell'esecuzione batch, l'operatore elabora un batch di righe contemporaneamente.

Statistiche di esecuzione

Nome	Descrizione
Latenza	Tempo trascorso di tutte le esecuzioni eseguite nell'operatore.
Latenza cumulativa	Il tempo totale dell'operatore corrente e dei relativi discendenti.
Tempo CPU	Somma del tempo di CPU dedicato all'esecuzione dell'operatore.
Tempo di CPU cumulativo	Il tempo di CPU totale dedicato all'esecuzione dell'operatore e dei relativi discendenti.
Tempo di esecuzione	Il tempo totale impiegato per eseguire la query ed elaborare i risultati.
Righe restituite	Il numero di righe generate da questo operatore
Numero di esecuzioni	Il numero di volte in cui l'operatore è stato eseguito. Alcune esecuzioni possono essere eseguite in parallelo.

Scansione

Un operatore di scansione esamina una fonte di righe e le restituisce. Questi sono i tipi di operatori di scansione:

• Scansione tabella: esegue la scansione di una tabella.
• Scansione dell'indice: esegue la scansione di un indice.
• Scansione batch: le scansioni vengono eseguite su tabelle intermedie create da altri operatori relazionali (ad esempio, una tabella creata da un'applicazione incrociata distribuita).

Quando possibile, Spanner applica i predicati alle chiavi nell'ambito di una scansione. Le scansioni vengono eseguite in modo più efficiente quando Spanner applica i predicati, perché la scansione non deve leggere l'intera tabella o l'intero indice. I predicati vengono visualizzati nel piano di esecuzione come:

• Condizione di ricerca: la condizione di ricerca si applica se Spanner può determinare una riga specifica a cui accedere nella tabella. In generale, questo si verifica quando il filtro si trova su un prefisso della chiave primaria. Ad esempio, se la chiave primaria è costituita da Col1 e Col2, una clausola WHERE che include valori espliciti per Col1 o Col1 e Col2 è ricercabile. In questo caso, Spanner legge i dati solo all'interno dell'intervallo di chiavi.

Se una query deve cercare tutte le righe di una tabella, viene eseguita una scansione completa, che viene visualizzata nel piano di esecuzione come full scan: true.

La seguente query mostra questo operatore:

SELECT s.lastname
FROM   singers@{FORCE_INDEX=SingersByFirstLastName} as s
WHERE  s.firstname = 'Catalina';

/*----------+
 | LastName |
 +----------+
 | Smith    |
 +----------*/

Il segmento del piano di esecuzione viene visualizzato nel seguente modo:

Nel piano di esecuzione, l'operatore distributed union di primo livello invia i sottopiani ai server remoti. Ogni piano secondario ha un operatore serialize result e un operatore di scansione dell'indice. Il predicato Key Predicate: FirstName = 'Catalina' limita la scansione alle righe dell'indice SingersByFirstLastname che hanno FirstName uguale a Catalina. La scansione dell'indice restituisce l'output all'operatore di serializzazione dei risultati.

Spanner accoppia strettamente le scansioni con Filter Scan e le considera un unico operatore. Se non è presente alcuna Condizione di ricerca, l'operatore viene visualizzato come scansione completa.

Proprietà e statistiche di esecuzione

Una proprietà di un operatore descrive una caratteristica utilizzata quando l'operatore viene eseguito. Una statistica di esecuzione è un valore raccolto durante l'esecuzione della query per aiutarti a valutare le prestazioni dell'operatore.

L'operatore Scan ha proprietà distinte aggiuntive e statistiche di esecuzione.

Proprietà

Nome	Descrizione
Metodo di scansione	Può essere Riga, Batch o Automatico. Nell'esecuzione per riga, l'operatore elabora una riga alla volta. Nell'esecuzione batch, l'operatore elabora un batch di righe contemporaneamente. Nell'esecuzione automatica, l'operatore inizia la scansione utilizzando il metodo Riga, ma può passare al metodo Batch quando necessario.
Condizione di ricerca	Un predicato sulla chiave primaria utilizzato per eseguire ricerche efficienti di una tabella. Questa proprietà indica che non è necessario scansionare l'intera tabella per produrre il set di righe desiderato. Questa proprietà è applicabile solo a Table Scans e Index Scans.
Assegnazione delle variabili	Elenco delle colonne lette dalla tabella.
Metodo di esecuzione	Nell'esecuzione per riga, l'operatore elabora una riga alla volta. Nell'esecuzione batch, l'operatore elabora un batch di righe contemporaneamente.

Statistiche di esecuzione

Nome	Descrizione
Righe scansionate	Il numero di righe lette durante la scansione.
Conteggio ricerche	Il numero di ricerche eseguite da questo operatore di scansione.
Latenza	Tempo trascorso di tutte le esecuzioni eseguite nell'operatore.
Latenza cumulativa	Il tempo totale dell'operatore corrente e dei relativi discendenti.
Tempo CPU	Somma del tempo di CPU dedicato all'esecuzione dell'operatore.
Tempo di CPU cumulativo	Il tempo di CPU totale dedicato all'esecuzione dell'operatore e dei relativi discendenti.
Tempo di esecuzione	Il tempo totale impiegato per eseguire la query ed elaborare i risultati.
Righe restituite	Il numero di righe generate da questo operatore
Numero di esecuzioni	Il numero di volte in cui l'operatore è stato eseguito. Alcune esecuzioni possono essere eseguite in parallelo.

Scansione del filtro

Un operatore di scansione del filtro viene sempre visualizzato sopra una scansione di tabella o indice. Funziona con la scansione per ridurre il numero di righe lette dal database e la scansione risultante è in genere più veloce rispetto a una filtro. Spanner applica la scansione del filtro in determinate condizioni:

• Condizione residua: qualsiasi altra condizione in cui Spanner può valutare la scansione per limitare la quantità di dati letti.

La seguente query mostra questo operatore:

SELECT lastname
FROM   singers
WHERE  singerid = 1

/*----------+
 | LastName |
 +----------+
 | Richards |
 +----------*/

Il piano di esecuzione viene visualizzato nel seguente modo:

Proprietà e statistiche di esecuzione

Una proprietà di un operatore descrive una caratteristica utilizzata quando l'operatore viene eseguito. Una statistica di esecuzione è un valore raccolto durante l'esecuzione della query per aiutarti a valutare le prestazioni dell'operatore.

L'operatore Filter scan ha proprietà distinte aggiuntive.

Proprietà

Nome	Descrizione
Condizione residua	Un predicato applicato dopo la lettura della riga.
Metodo di esecuzione	Nell'esecuzione per riga, l'operatore elabora una riga alla volta. Nell'esecuzione batch, l'operatore elabora un batch di righe contemporaneamente.

Statistiche di esecuzione

Nome	Descrizione
Latenza	Tempo trascorso di tutte le esecuzioni eseguite nell'operatore.
Latenza cumulativa	Il tempo totale dell'operatore corrente e dei relativi discendenti.
Tempo CPU	Somma del tempo di CPU dedicato all'esecuzione dell'operatore.
Tempo di CPU cumulativo	Il tempo di CPU totale dedicato all'esecuzione dell'operatore e dei relativi discendenti.
Tempo di esecuzione	Il tempo totale impiegato per eseguire la query ed elaborare i risultati.
Righe restituite	Il numero di righe generate da questo operatore
Numero di esecuzioni	Il numero di volte in cui l'operatore è stato eseguito. Alcune esecuzioni possono essere eseguite in parallelo.