Extensão do Google BigQuery

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X.
informações

Versão 1.2.1

Inserir linhas em uma tabela do BigQuery. Listar linhas da tabela.

Pré-requisitos

Este conteúdo fornece referência para configurar e usar essa extensão. Antes de usar a extensão de um proxy de API com a política Extension callout, você precisa:

  1. Verifique se você ativou a API BigQuery para sua conta.

  2. Verifique se você criou um conjunto de dados e uma tabela do BigQuery (com esquema) antes de tentar inserir linhas.

  3. Use o Console do GCP para gerar uma chave para a conta de serviço.

  4. Use o conteúdo do arquivo JSON da chave resultante ao adicionar e configurar a extensão usando a referência de configuração.

Sobre o Google BigQuery

O Google BigQuery é um data warehouse corporativo, sem servidor e escalonável, que permite consultas SQL super-rápidas usando a capacidade de processamento da infraestrutura do Google. Como não há infraestrutura para gerenciar, você pode se concentrar na análise de dados para encontrar insights significativos com um SQL conhecido, sem a necessidade de um administrador de banco de dados.

Para uma introdução prática, consulte um dos guias de início rápido do Google BigQuery.

Ações

insert

Insira um conjunto de registros como um conjunto de dados diretamente no BigQuery, com linhas a serem inseridas e ID do conjunto de dados/tabela.

Sintaxe

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

Exemplo

<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>

Parâmetros de solicitação

Parâmetro Descrição Tipo Padrão Obrigatório
conjunto de dados ID do conjunto de dados a ser inserido no BigQuery. String Nenhum. Sim.
linhas Linhas a serem inseridas na tabela. Matriz Nenhum. Sim.
tabela Nome da tabela que receberá os dados. String Nenhum. Sim.

Resposta

Nenhum.

listRows

Lista as linhas na tabela especificada pelos IDs da tabela e do conjunto de dados.

Sintaxe

<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>

Exemplo

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

Parâmetros de solicitação

Parâmetro Descrição Tipo Padrão Obrigatório
conjunto de dados ID do conjunto de dados do qual listar as linhas. String Nenhum. Sim.
limite Número máximo de linhas a serem listadas. Número inteiro Nenhum. Não.
startIndex Índice de linha em que iniciar a lista. Número inteiro Nenhum. Não.
tabela ID da tabela com as linhas que serão listadas. String Nenhum. Sim.

Resposta

Uma matriz rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Parâmetro Descrição Tipo Padrão Obrigatório
linhas Matriz de linhas retornadas da solicitação. Matriz Nenhum. Sim.

Referência de configuração

Use o seguinte ao configurar e implantar esta extensão para uso em proxies de API. Para ver as etapas para configurar uma extensão usando o console da Apigee, consulte Como adicionar e configurar uma extensão.

Propriedades de extensão comuns

The following properties are present for every extension.

Property Description Default Required
name Name you're giving this configuration of the extension. None Yes
packageName Name of the extension package as given by Apigee Edge. None Yes
version Version number for the extension package from which you're configuring an extension. None Yes
configuration Configuration value specific to the extension you're adding. See Properties for this extension package None Yes

Propriedades deste pacote de extensões

Especifique valores para as seguintes propriedades de configuração específicas desta extensão.

Propriedade Descrição Padrão Obrigatório
projectId ID do projeto do GCP em que os dados estão. Nenhum. Sim.
credenciais Quando inserido no console do Apigee Edge, este é o conteúdo do arquivo de chave da conta de serviço. Quando enviado pela API de gerenciamento, é um valor codificado em base64 gerado a partir do arquivo de chave da conta de serviço. Nenhum. Sim.