Extensión de Google BigQuery

Estás viendo la documentación de Apigee Edge.
Ve a la documentación de Apigee X.
info

Versión 2.0.0

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

Requisitos previos

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

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

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

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

  4. Usa el contenido del archivo JSON de clave resultante cuando agregues y configures la extensión con 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 al poder de procesamiento de la infraestructura de Google. Como no se debe administrar ninguna infraestructura, puedes enfocarte en analizar los datos para encontrar estadísticas valiosas con el lenguaje SQL que conoces, sin necesidad de un administrador de bases 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 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 Predeterminado Obligatorio
conjunto de datos Es el ID del conjunto de datos que se insertará en BigQuery. String Ninguno Sí.
filas Son las filas que se insertarán en la tabla. Array Ninguno Sí.
mesa Es el nombre de la tabla que recibirá los datos. String Ninguno Sí.

Respuesta

Ninguno

listRows

Muestra una lista de las filas de la tabla especificada 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 Predeterminado Obligatorio
conjunto de datos Es el ID del conjunto de datos desde el que se enumerarán las filas. String Ninguno Sí.
límite Es la cantidad máxima de filas que se mostrarán. Número entero Ninguno No.
Índice de inicio Es el índice de fila en el que se debe iniciar la lista. Número entero Ninguno No.
mesa Es el ID de la tabla de la que se enumerarán las filas. String Ninguno Sí.

Respuesta

Un array de rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Parámetro Descripción Tipo Predeterminado Obligatorio
filas Es un array de filas que se muestra en la solicitud. Array Ninguno Sí.

Referencia de configuración

Usa lo siguiente cuando configures y, luego, implementes esta extensión para usarla en proxies de API. Si deseas conocer los pasos para configurar una extensión con la consola de Apigee, consulta Cómo agregar y configurar una extensión.

Propiedades comunes de la extensión

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 Obligatorio
ID de proyecto ID del proyecto de GCP en el que se encuentran los datos. Ninguno 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 administración, es un valor codificado en base64 que se genera a partir del archivo de claves de la cuenta de servicio. Ninguno Sí.