Extensão do Google BigQuery

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Versão 1.2.1

Insira linhas em uma tabela do BigQuery. Liste as linhas da tabela.

Pré-requisitos

Este conteúdo oferece 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 fazer o seguinte:

  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 com a referência de configuração.

Sobre o Google BigQuery

O Google BigQuery é um data warehouse corporativo escalonável e sem servidor, 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, acesse um dos guias de início rápido do Google BigQuery.

Ações

inserir

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.
mesa Nome da tabela para receber os dados. String Nenhum. Sim.

Resposta

Nenhum.

listRows

Lista as linhas da tabela especificadas 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 as linhas serão listadas. 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 a lista será iniciada. Número inteiro Nenhum. Não.
mesa ID da tabela na qual as linhas 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 código a seguir ao configurar e implantar a extensão para uso em proxies de API. Para saber como 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ão

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

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