Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Version 1.0.0
Insérez des lignes dans une table BigQuery. Lister les lignes de la table
Conditions préalables
Ce contenu fournit une documentation de référence sur la configuration et l'utilisation de cette extension. Avant d'utiliser l'extension à partir d'un proxy d'API avec la règle ExtensionCallout, vous devez:
Assurez-vous d'avoir activé l'API BigQuery pour votre compte.
Assurez-vous d'avoir créé un ensemble de données et une table BigQuery (avec un schéma) avant d'essayer d'insérer des lignes.
Utilisez la console GCP pour générer une clé pour le compte de service.
Utilisez le contenu du fichier JSON de clé obtenu lorsque vous ajoutez et configurez l'extension à l'aide des documents 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 vous n'avez aucune infrastructure à gérer, vous pouvez vous concentrer sur l'analyse des données afin de 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 présentation pratique, consultez 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ètres | Description | Type | 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 la table. | Array | Aucune | Oui. |
table | Nom de la table qui recevra les données. | Chaîne | Aucune | Oui. |
Réponse
Aucune
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ètres | Description | Type | Par défaut | Obligatoire |
---|---|---|---|---|
ensemble de données | ID de l'ensemble de données à partir duquel répertorier les lignes. | Chaîne | Aucune | Oui. |
limite | Nombre maximal de lignes à répertorier. | Entier | Aucune | Non. |
startIndex | Index de ligne auquel la liste doit commencer. | Entier | Aucune | Non. |
table | ID de la table à partir de laquelle répertorier les lignes. | Chaîne | Aucune | Oui. |
Réponse
Un tableau rows
{
"rows": [
{"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
{"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
]
}
Paramètres | Description | Type | Par défaut | Obligatoire |
---|---|---|---|---|
lignes | Tableau de lignes renvoyées par la requête. | Array | Aucune | Oui. |
Documentation de référence sur la configuration
Utilisez le code suivant 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 contenant les données. | Aucune | Oui. |
identifiants | Une fois 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 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. | Aucune | Oui. |