Estensione di Google BigQuery

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

Versione 1.2.1

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

Prerequisiti

Questi contenuti forniscono riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare l'estensione da un proxy API con le norme relative ai callout estensione, devi:

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

  2. Assicurati di aver creato un set di dati e una tabella BigQuery (con schema) prima di tentare di inserire le righe.

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

  4. Utilizza i contenuti del file JSON della chiave risultante durante l'aggiunta e la configurazione dell'estensione utilizzando il riferimento di configurazione.

Informazioni su Google BigQuery

Google BigQuery è un data warehouse aziendale serverless e scalabile 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 insight significativi utilizzando un ambiente SQL familiare senza bisogno di un amministratore di database.

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

Azioni

insert

Inserisci un set 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 richiesta

Parametro Descrizione Tipo Predefinito Obbligatorie
set di dati ID del set di dati da inserire in BigQuery. Stringa Nessuna. Sì.
righe Righe da inserire nella tabella. Array Nessuna. Sì.
tavolo Nome della tabella per ricevere i dati. Stringa Nessuna. Sì.

Risposta

Nessuna.

listRows

Elenca le righe nella tabella specificata tramite l'ID tabella e l'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 richiesta

Parametro Descrizione Tipo Predefinito Obbligatorie
set di dati ID del set di dati da cui elencare le righe. Stringa Nessuna. Sì.
limite Numero massimo di righe da elencare. Numero intero Nessuna. N.
startIndex Indice della riga da cui iniziare l'elenco. Numero intero Nessuna. N.
tavolo ID della tabella da cui elencare le righe. Stringa Nessuna. 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 Obbligatorie
righe Array di righe restituite dalla richiesta. Array Nessuna. Sì.

Riferimento per la configurazione

Utilizza quanto segue durante la configurazione e il deployment di questa estensione per l'utilizzo nei proxy API. Per i passaggi per configurare un'estensione utilizzando la console Apigee, consulta Aggiungere e configurare un'estensione.

Proprietà delle estensioni comuni

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 Obbligatorie
projectId ID del progetto Google Cloud in cui si trovano i dati. Nessuna. Sì.
credenziali Una volta inseriti nella console Apigee Edge, questi saranno i contenuti del file della chiave dell'account di servizio. Quando viene inviato tramite l'API di gestione, si tratta di un valore con codifica Base64 generato dal file della chiave dell'account di servizio. Nessuna. Sì.