Extensión de Google BigQuery

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Versión 1.2.1

Inserta filas en una tabla de BigQuery. Muestra una lista de filas de la tabla.

Requisitos previos

En este contenido, se proporciona referencia para configurar y usar la extensión. Antes de utilizar la extensión desde un proxy de API con la política ExtensionExtension, debes hacer lo siguiente:

  1. Asegúrate de haber habilitado la API de BigQuery en tu cuenta.

  2. Asegúrate de haber creado un conjunto de datos y una tabla de BigQuery (con esquema) antes de intentar insertar filas.

  3. Usa GCP Console a fin de generar una clave para la cuenta de servicio.

  4. Usa el contenido del archivo JSON de claves resultante cuando agregues y configures la extensión mediante la referencia de configuración.

Acerca de Google BigQuery

Google BigQuery es un almacén de datos empresarial escalable y sin servidores que permite realizar consultas de SQL superrápidas gracias a la potencia de procesamiento de la infraestructura de Google. Debido a que no se debe administrar ninguna infraestructura, puedes enfocarte en analizar datos para encontrar información significativa con el lenguaje SQL que conoces, sin necesidad de un administrador de base de datos.

Para obtener una introducción práctica, prueba una de las guías de inicio rápido de Google BigQuery.

Acciones

insert

Inserta un conjunto de registros como un conjunto de datos directamente en BigQuery, con las filas que se insertarán y el ID del conjunto de datos o de la tabla.

Sintaxis

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

Ejemplo

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

Parámetro Descripción Tipo Predeterminada Obligatorias
conjunto de datos ID del conjunto de datos que se insertará en BigQuery. Cadena Ningún contenido de este tipo Sí.
filas Filas para insertar en la tabla. Array Ningún contenido de este tipo Sí.
mesa Nombre de la tabla para recibir los datos. Cadena Ningún contenido de este tipo Sí.

Respuesta

Ningún contenido de este tipo

listRows

Enumera las filas de la tabla especificadas por el ID de la tabla y el ID del conjunto de datos.

Sintaxis

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

Ejemplo

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

parámetros de solicitud

Parámetro Descripción Tipo Predeterminada Obligatorias
conjunto de datos ID del conjunto de datos del que se enumerarán las filas. Cadena Ningún contenido de este tipo Sí.
límite Cantidad máxima de filas para enumerar. Número entero Ningún contenido de este tipo No.
startIndex Índice de fila en el que se inicia la lista. Número entero Ningún contenido de este tipo No.
mesa ID de la tabla de la que se enumerarán las filas. Cadena Ningún contenido de este tipo Sí.

Respuesta

Un array rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Parámetro Descripción Tipo Predeterminada Obligatorias
filas Arreglo de filas que se muestran en la solicitud. Array Ningún contenido de este tipo Sí.

Referencia de configuración

Usa la siguiente información cuando configures e implementes esta extensión para usarla en proxies de API. Si quieres conocer los pasos para configurar una extensión con la consola de Apigee, consulta Agrega y configura una extensión.

Propiedades comunes de las extensiones

Las siguientes propiedades están presentes para cada extensión.

Propiedad Descripción Predeterminado Obligatorio
name Nombre que asignas a esta configuración de la extensión. Ninguna
packageName Nombre del paquete de extensiones proporcionado por Apigee Edge. Ninguna
version El número de versión del paquete de extensiones desde el que quieres configurar la extensión. Ninguna
configuration Es un valor de configuración específico para la extensión que agregas. Consulta Propiedades para este paquete de extensiones Ninguna

Propiedades de este paquete de extensión

Especifica valores para las siguientes propiedades de configuración específicas de esta extensión.

Propiedad Descripción Predeterminada Obligatorias
projectId ID del proyecto de GCP donde se encuentran los datos. Ningún contenido de este tipo Sí.
credenciales Cuando se ingresa en la consola de Apigee Edge, este es el contenido de tu archivo de claves de la cuenta de servicio. Cuando se envía a través de la API de Management, es un valor codificado en base64 que se genera a partir del archivo de claves de la cuenta de servicio. Ningún contenido de este tipo Sí.