Extension Google BigQuery

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X.
En savoir plus

<ph type="x-smartling-placeholder">

Version 1.0.0

Insérer des lignes dans une table BigQuery Lister les lignes de la table.

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 ExtensionCall, vous devez:

  1. Vérifiez que vous avez activé l'API BigQuery pour votre compte.

  2. Avant de tenter d'insérer des lignes, assurez-vous d'avoir créé un ensemble de données et une table BigQuery (avec un schéma).

  3. Générez une clé pour le compte de service à l'aide de la console GCP.

  4. Utilisez le contenu du fichier JSON de clé obtenu lors de l'ajout et de la configuration de l'extension à l'aide de la documentation de référence de 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 à l'aide du langage SQL qui vous est familier, sans avoir besoin d'un administrateur de base de données.

Pour une introduction pratique, consultez l'un des guides de démarrage rapide de Google BigQuery.

Actions

<ph type="x-smartling-placeholder">

insert

Insérez un ensemble d'enregistrements sous forme d'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 Par défaut Obligatoire
ensemble de données ID de l'ensemble de données à insérer dans BigQuery. Chaîne Aucun Oui.
lignes Lignes à insérer dans le tableau. Tableau Aucun Oui.
table Nom de la table qui recevra les données. Chaîne Aucun Oui.

Réponse

Aucun

listRows

Répertorie les lignes de la table spécifiées par l'ID de la table et l'ID de l'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 Par défaut Obligatoire
ensemble de données ID de l'ensemble de données dont les lignes doivent être répertoriées. Chaîne Aucun Oui.
limite Nombre maximal de lignes à répertorier. Entier Aucun Non.
startIndex Index de ligne à partir duquel commencer la liste. Entier Aucun Non.
table ID de la table dont les lignes doivent être répertoriées. Chaîne Aucun Oui.

Réponse

Un tableau rows.

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

Documentation de référence sur la configuration

Procédez comme suit lorsque vous configurez et déployez cette extension afin de 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 courantes des extensions

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 des valeurs pour les propriétés de configuration suivantes, spécifiques à cette extension.

Propriété Description Par défaut Obligatoire
projectId ID du projet GCP contenant les données. Aucun Oui.
credentials Lorsque vous l'avez saisie 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 de gestion, il s'agit d'une valeur encodée en base64 générée à partir du fichier de clé du compte de service. Aucun Oui.