Decorator per tabelle in SQL precedente

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

In genere, BigQuery esegue una scansione completa della colonna quando esegui una query. Puoi utilizzare i decoratori di tabelle in SQL precedente per eseguire una query più economica su un sottoinsieme di dati. I decoratori di tabelle possono essere utilizzati ogni volta che viene letta una tabella, ad esempio quando la copi, la esporti o elenchi i dati utilizzando tabledata.list.

Nota: i decoratori di intervallo non sono supportati in GoogleSQL. Per visualizzare lo stato di questa richiesta di funzionalità, consulta il tracker delle richieste di funzionalità di BigQuery. Puoi fare clic sull'icona Votare per questo problema e ricevere notifiche via email (la stella) per esprimere il tuo sostegno alla funzionalità.

I decoratori della tabella supportano valori <time> relativi e assoluti. I valori relativi sono indicati da un numero negativo, mentre 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 di tempo

I decorazioni temporali (in precedenza noti come decoratori snapshot) fanno riferimento ai dati storici di una tabella in un determinato momento.

Sintassi

@<time>

• Fa riferimento ai dati storici di una tabella in data <time>, in millisecondi dall'epoca.
• <time> deve essere negli ultimi sette 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 tabella.

I decoratori di tempo vengono utilizzati anche al di fuori di SQL precedente. Puoi utilizzarli nel 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. Ricevi <time> per un'ora fa:

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

2. Poi, 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> devono risalire agli ultimi sette giorni.
• <time2> è facoltativo e il valore predefinito è "ora".

Esempi

Esempi di valore relativo

Per ottenere i dati della tabella aggiunti tra un'ora e mezza e un'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 i dati della tabella aggiunti tra un'ora e mezza e un'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 un'attività svolta 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]