Decoratori delle tabelle in SQL precedente

Attenzione: questo documento descrive i decoratori delle tabelle nella sintassi delle query SQL precedente. La sintassi delle query preferita per BigQuery è GoogleSQL. Standard SQL non supporta i decoratori di tabelle, ma FOR SYSTEM_TIME AS OF in GoogleSQL offre funzionalità equivalenti ai decoratori temporali. Per i decoratori di intervalli, puoi ottenere una semantica simile in GoogleSQL utilizzando partizionate in base al tempo. Per ulteriori informazioni, vedi Decoratori di tabelle nella guida alla migrazione di GoogleSQL.

Normalmente, BigQuery esegue una scansione completa delle colonne eseguendo una query. Puoi utilizzare i decorator di tabella in SQL precedente per eseguire una query più conveniente di un sottoinsieme di dati. È possibile usare i decorator tabella ogni volta che viene letta una tabella, ad esempio quando copi una tabella, esportare una tabella, o elencando i dati utilizzando tabledata.list.

Nota: i decoratori di intervalli non sono supportati in GoogleSQL. Per visualizzare lo stato di questa richiesta di funzione, consulta Tracker delle richieste di funzionalità di BigQuery. Puoi fare clic sull'icona Vota per questo problema e ricevere notifiche via email (la stella) per registrare il tuo supporto per questa funzionalità.

I decoratori della tabella supportano valori <time> relativi e assoluti. Parente i valori sono indicati da un numero negativo e i valori assoluti sono indicati da un numero positivo. Ad esempio, -3600000 indica uno ora fa in millisecondi, rispetto all'ora corrente; 3600000 indica un'ora in millisecondi dopo 1/1/1970.

Decoratori del tempo

I decoratori temporali (noti in precedenza decoratori snapshot) fanno riferimento ai dati storici in un determinato momento.

Sintassi

@<time>

• Fa riferimento ai dati storici di una tabella in <time>, in millisecondi dall'epoca.
• <time> deve rientrare negli ultimi 7 giorni e maggiore o uguale all'ora di creazione della tabella, ma inferiore alla data e all'ora di creazione della tabella per l'eliminazione o la scadenza.
• @0 è un caso speciale che fa riferimento ai dati meno recenti disponibili per .

I decorator dell'ora vengono utilizzati anche al di fuori dell'SQL precedente. Puoi utilizzarle nella Comando bq cp per ripristinare le tabelle eliminate](/bigquery/docs/managing-tables#undeletetable) entro sette giorni dall'eliminazione della tabella.

Esempi

Per ottenere i dati storici per una tabella di un'ora fa:

Esempio di valore relativo

#legacySQL
SELECT COUNT(*) FROM [PROJECT_ID:DATASET.TABLE@-3600000]

Esempio di valore assoluto

1. Ottieni <time> per un'ora fa:

   #legacySQL
   SELECT INTEGER(DATE_ADD(USEC_TO_TIMESTAMP(NOW()), -1, 'HOUR')/1000)
   

2. Quindi, sostituisci <time> nella seguente query:

   #legacySQL
   SELECT COUNT(*) FROM [PROJECT_ID:DATASET.TABLE@time]
   

Decoratori di gamma

Sintassi

@<time1>-<time2>

• Fa riferimento ai dati della tabella aggiunti tra <time1> e <time2>, in millisecondi dall'epoca.
• <time1> e <time2> deve rientrare negli ultimi sette giorni.
• <time2> è facoltativo e il valore predefinito è "ora".

Esempi

Esempi di valore relativo

Per ottenere l'aggiunta dei dati della tabella tra un'ora e mezz'ora fa:

#legacySQL
SELECT COUNT(*) FROM [PROJECT_ID:DATASET.TABLE@-3600000--1800000]

Per ottenere i dati degli ultimi 10 minuti:

#legacySQL
SELECT COUNT(*) FROM [PROJECT_ID:DATASET.TABLE@-600000-]

Esempio di valore assoluto

Per ottenere l'aggiunta dei dati della tabella tra un'ora e mezz'ora fa:

1. Ottieni <time1> per un'ora fa:

   #legacySQL
   SELECT INTEGER(DATE_ADD(USEC_TO_TIMESTAMP(NOW()), -1, 'HOUR')/1000)
   

2. Ricevi <time2> per mezz'ora fa:

   #legacySQL
   SELECT INTEGER(DATE_ADD(USEC_TO_TIMESTAMP(NOW()), -30, 'MINUTE')/1000)
   

3. Sostituisci <time1> e <time2> nella seguente query:

   #legacySQL
   SELECT COUNT(*) FROM [PROJECT_ID:DATASET.TABLE@time1-time2]