Estensione di Google BigQuery

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
info

Versione 2.0.0

Inserisci righe in una tabella BigQuery. Elenca le righe della tabella.

Prerequisiti

Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare l'estensione da un proxy API utilizzando il criterio ExtensionCallout, devi:

  1. Assicurati di aver attivato l'API BigQuery per il tuo account.

  2. Prima di tentare di inserire righe, assicurati di aver creato un dataset e una tabella BigQuery (con schema).

  3. Utilizza la console Google Cloud per generare una chiave per l'account di servizio.

  4. Utilizza i contenuti del file JSON della chiave risultante quando aggiungi e configuri l'estensione utilizzando il riferimento alla configurazione.

Informazioni su Google BigQuery

Google BigQuery è un data warehouse aziendale scalabile e serverless che consente di eseguire query SQL rapidissime grazie alla potenza di elaborazione dell'infrastruttura Google. In assenza di un'infrastruttura da gestire, puoi concentrarti sull'analisi dei dati per trovare informazioni significative utilizzando un ambiente SQL familiare senza bisogno di un amministratore di database.

Per un'introduzione pratica, prova una delle guide di avvio rapido di Google BigQuery.

Azioni

insert

Inserisci un insieme di record come set di dati direttamente in BigQuery, con le righe da inserire e l'ID set di dati/tabella.

Sintassi

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : dataset-to-insert,
  "table" : table-to-receive-data,
  "rows" : array-of-rows-to-insert
}]]></Input>

Esempio

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "table" : "TestTable",
  "rows" : [
    {"technology":"CRISPR","inventorFirstName":"Jennifer","inventorLastName":"Doudna"},
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}]]></Input>

Parametri di richiesta

Parametro Descrizione Tipo Predefinito Obbligatorio
set di dati ID del set di dati da inserire in BigQuery. Stringa Nessuno. Sì.
righe Righe da inserire nella tabella. Array Nessuno. Sì.
tabella Nome della tabella che riceve i dati. Stringa Nessuno. Sì.

Risposta

Nessuno.

listRows

Elenca le righe della tabella specificate dall'ID tabella e dall'ID set di dati.

Sintassi

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : ID-of-dataset-to-examine,
  "limit" : maximum-rows-to-list,
  "startIndex" : row-index-at-which-to-start-list
  "table" : ID-of-table-to-examine
}]]></Input>

Esempio

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "limit" : 2,
  "startIndex" : 1,
  "table" : "TestTable"
}]]></Input>

Parametri di richiesta

Parametro Descrizione Tipo Predefinito Obbligatorio
set di dati ID del set di dati da cui elencare le righe. Stringa Nessuno. Sì.
limite Numero massimo di righe da elencare. Numero intero Nessuno. No.
startIndex L'indice di riga da cui iniziare l'elenco. Numero intero Nessuno. No.
tabella ID della tabella da cui elencare le righe. Stringa Nessuno. Sì.

Risposta

Un array rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Parametro Descrizione Tipo Predefinito Obbligatorio
righe Array di righe restituite dalla richiesta. Array Nessuno. Sì.

Riferimento alla configurazione

Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per utilizzarla nei proxy API. Per la procedura di configurazione di un'estensione utilizzando la console Apigee, vedi Aggiunta e configurazione di un'estensione.

Proprietà comuni delle estensioni

Per ogni estensione sono presenti le seguenti proprietà.

Proprietà Descrizione Predefinito Obbligatorio
name Il nome che assegni a questa configurazione dell'estensione. Nessuno
packageName Nome del pacchetto dell'estensione fornito da Apigee Edge. Nessuno
version Numero di versione del pacchetto dell'estensione da cui stai configurando un'estensione. Nessuno
configuration Valore di configurazione specifico per l'estensione che stai aggiungendo. Vedi Proprietà per questo pacchetto di estensioni Nessuno

Proprietà per questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche di questa estensione.

Proprietà Descrizione Predefinito Obbligatorio
ID progetto ID del progetto Google Cloud in cui si trovano i dati. Nessuno. Sì.
credenziali Se inserito nella console Apigee Edge, si tratta dei contenuti del file della chiave dell'account di servizio. Se inviato tramite l'API di gestione, è un valore codificato in base64 generato dal file della chiave dell'account di servizio. Nessuno. Sì.