Extension Google BigQuery

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation Apigee X.
info

Version 2.0.1

Insérez des lignes dans une table BigQuery. Lister les lignes du tableau.

Prérequis

Ce contenu fournit des informations de référence pour configurer et utiliser cette extension. Avant d'utiliser l'extension à partir d'un proxy d'API à l'aide de la règle ExtensionCallout, vous devez :

  1. Assurez-vous d'avoir activé l'API BigQuery pour votre compte.

  2. Assurez-vous d'avoir créé un ensemble de données et une table BigQuery (avec le schéma) avant d'essayer d'insérer des lignes.

  3. Utilisez la console GCP pour générer une clé pour le compte de service.

  4. Utilisez le contenu du fichier JSON de clé obtenu lorsque vous ajoutez et configurez l'extension à l'aide de la documentation de référence sur la configuration.

À propos de Google BigQuery

Google BigQuery est un entrepôt de données d'entreprise sans serveur et évolutif qui permet d'effectuer des requêtes SQL ultra-rapides grâce à la puissance de traitement de l'infrastructure de Google. Comme il n'y a pas d'infrastructure à gérer, vous pouvez vous concentrer sur l'analyse des données pour dégager des insights pertinents grâce au langage SQL qui vous est familier, sans avoir besoin d'un administrateur de base de données.

Pour une présentation pratique, suivez l'un des guides de démarrage rapide de Google BigQuery.

Actions

insert

Insérez un ensemble d'enregistrements en tant qu'ensemble de données directement dans BigQuery, avec les lignes à insérer et l'ID de l'ensemble de données/de la table.

Syntaxe

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

Exemple

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

Paramètres de requête

Paramètre Description Type Valeur par défaut Obligatoire
ensemble de données ID de l'ensemble de données à insérer dans BigQuery. Chaîne Aucune. Oui.
lignes Lignes à insérer dans le tableau. Tableau Aucune. Oui.
table Nom de la table qui recevra les données. Chaîne Aucune. Oui.

Réponse

Aucune.

listRows

Liste les lignes de la table spécifiée par l'ID de table et l'ID d'ensemble de données.

Syntaxe

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

Exemple

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

Paramètres de requête

Paramètre Description Type Valeur par défaut Obligatoire
ensemble de données ID de l'ensemble de données à partir duquel lister les lignes. Chaîne Aucune. Oui.
limite Nombre maximal de lignes à lister. Nombre entier Aucune. Non.
startIndex Index de la ligne à partir de laquelle la liste doit commencer. Nombre entier Aucune. Non.
table ID de la table à partir de laquelle lister les lignes. Chaîne Aucune. Oui.

Réponse

Tableau rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Paramètre Description Type Valeur par défaut Obligatoire
lignes Tableau des lignes renvoyées par la requête. Tableau Aucune. Oui.

Documentation de référence sur la configuration

Utilisez les éléments suivants lorsque vous configurez et déployez cette extension pour l'utiliser dans des proxys d'API. Pour savoir comment configurer une extension à l'aide de la console Apigee, consultez Ajouter et configurer une extension.

Propriétés d'extension courantes

Les propriétés suivantes sont présentes pour chaque extension.

Propriété Description Par défaut Obligatoire
name Nom que vous attribuez à cette configuration de l'extension. Aucune Oui
packageName Nom du package d'extension tel qu'indiqué par Apigee Edge. Aucune Oui
version Numéro de version du package d'extension à partir duquel vous configurez une extension. Aucune Oui
configuration Valeur de configuration spécifique à l'extension que vous ajoutez. Consultez Propriétés de ce package d'extension. Aucune Oui

Propriétés de ce package d'extension

Spécifiez les valeurs des propriétés de configuration suivantes, spécifiques à cette extension.

Propriété Description Par défaut Obligatoire
projectId ID du projet GCP dans lequel se trouvent les données. Aucune. Oui.
identifiants Lorsqu'il est saisi dans la console Apigee Edge, il s'agit du contenu de votre fichier de clé de compte de service. Lorsqu'elle est envoyée via l'API Management, il s'agit d'une valeur encodée en base64 générée à partir du fichier de clé du compte de service. Aucune. Oui.