Extensão do Google BigQuery

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

Versão 1.0.0

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

As propriedades a seguir estão presentes para cada extensão.

Propriedade Descrição Padrão Obrigatório
name Nome que será dado a esta configuração da extensão. Nenhum Sim
packageName Nome do pacote de extensão fornecido pelo Apigee Edge. Nenhum Sim
version Número da versão do pacote de extensão a partir do qual você está configurando uma extensão. Nenhum Sim
configuration Valor de configuração específico da extensão que você está adicionando. Consulte Propriedades para este pacote de extensão. Nenhum Sim

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.