Présentation de la bibliothèque de sources de données
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La bibliothèque de sources de données de visualisation Google permet de créer facilement une source de données de visualisation. La bibliothèque met en œuvre le protocole de communication et le langage de requête de l'API Google Visualization. Vous n'écrivez que le code nécessaire pour rendre vos données disponibles dans la bibliothèque sous la forme d'une table de données. Une table de données est une table à valeurs bidimensionnelles dont chaque colonne est d'un seul type. L'écriture du code dont vous avez besoin est facilitée par la mise à disposition de classes abstraites et de fonctions d'assistance.
L'implémentation la plus simple de la bibliothèque consiste à hériter d'une classe unique, à mettre en œuvre une fonction de membre et à exécuter la source de données en tant que webhook dans un conteneur de partitionnement. Dans l'implémentation la plus simple, la séquence d'événements suivante se produit lorsqu'une visualisation interroge la source de données:
- Le conteneur de webhook gère la requête et la transmet à la bibliothèque Java de la source de données.
- La bibliothèque analyse la requête.
- Le code de mise en œuvre (le code que vous écrivez) renvoie une table de données à la bibliothèque.
- La bibliothèque exécute la requête sur la table de données.
- La bibliothèque affiche la table de données dans la réponse attendue par la visualisation.
- Le conteneur de webhook renvoie la réponse à la visualisation.
Cela est illustré dans le schéma suivant:

La section Premiers pas avec les sources de données explique comment mettre en œuvre ce type de source de données.
Les données diffusées par une source de données peuvent être spécifiées dans votre code de mise en œuvre, ce qui convient pour de petites quantités de données statiques. Pour les ensembles de données plus volumineux, il est plus probable que vous ayez besoin d'un datastore externe tel qu'un fichier ou une base de données externe. Si une source de données utilise un datastore externe, la séquence d'événements suivante se produit lorsqu'une visualisation interroge la source de données:
- Le conteneur de webhook gère la requête et la transmet à la bibliothèque Java de la source de données.
- La bibliothèque analyse la requête.
- Le code de mise en œuvre (le code que vous écrivez) lit les données conservées dans le datastore et renvoie une table de données à la bibliothèque. Si l'ensemble de données est volumineux et que le magasin de données dispose de fonctionnalités de requête, vous pouvez éventuellement utiliser ces fonctionnalités pour améliorer l'efficacité de votre source de données.
- La bibliothèque exécute la requête sur la table de données.
- La bibliothèque affiche la table de données dans la réponse attendue par la visualisation.
- Le conteneur de webhook renvoie la réponse à la visualisation.
Cela est illustré dans le schéma suivant:

La section Utiliser un datastore externe explique comment mettre en œuvre ce type de source de données.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/07/10 (UTC).
[null,null,["Dernière mise à jour le 2024/07/10 (UTC)."],[[["\u003cp\u003eThe Google Visualization Data Source Library simplifies the creation of visualization data sources by implementing the Google Visualization API wire protocol and query language.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers primarily need to write code to make their data available as a data table, leveraging the library's abstract classes and helper functions.\u003c/p\u003e\n"],["\u003cp\u003eData sources can be implemented as servlets, handling queries from visualizations and returning data tables for rendering.\u003c/p\u003e\n"],["\u003cp\u003eFor larger datasets, the library supports using external data stores like files or databases, enabling efficient querying capabilities.\u003c/p\u003e\n"],["\u003cp\u003eThe library handles query parsing, data table execution, and rendering into the response format expected by the visualization.\u003c/p\u003e\n"]]],[],null,["# Introduction to the Data Source Library\n\n[Visit\nthe library project page!](http://code.google.com/p/google-visualization-java/)\n\nThe Google Visualization Data Source Library makes\nit easy to create a visualization data source. The library implements\nthe Google Visualization API wire\nprotocol and query language. You write only the code that is required to\nmake your data available to the library in the form of a data\ntable. A data table is a two-dimensional table of values where every\ncolumn is of a single type. Writing the code that you need is made easier\nby the provision of abstract classes and helper functions.\n\nThe simplest implementation of the library involves inheriting from\na single class, implementing a member function and running the\ndata source as a servlet within a servlet container. In the simplest\nimplementation, the following sequence of events takes place\nwhen a visualization queries the data source:\n\n1. The servlet container handles the query and passes it to the data source Java library.\n2. The library parses the query.\n3. The implementation code - the code that you write - returns a data table to the library.\n4. The library executes the query on the data table.\n5. The library renders the data table into the response expected by the visualization.\n6. The servlet container returns the response to the visualization.\n\nThis is illustrated in the following diagram:\n\nThe [Getting Started with Data Sources](/chart/interactive/docs/dev/dsl_get_started) section describes\nhow to implement this type of data source.\n\nThe data\nthat is served by a data source can be specified in your implementation\ncode, which is fine for small amounts of static data. For larger\ndata sets it is more likely you will need to use an external data store\nsuch as an external file or database. If a data source uses an external\ndata store, the following sequence of events takes place when a visualization\nqueries the data source:\n\n1. The servlet container handles the query and passes it to the data source Java library.\n2. The library parses the query.\n3. The implementation code - the code you write - reads the data held in the data store and returns a data table to the library. If the data set is large, and the data store has querying [capabilities](/chart/interactive/docs/dev/dsl_key_concepts#capabilities), you can optionally use those capabilities to increase the efficiency of your data source.\n4. The library executes the query on the data table.\n5. The library renders the data table into the response expected by the visualization.\n6. The servlet container returns the response to the visualization.\n\nThis is illustrated in the following diagram:\n\nThe [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv) section describes how to implement this\ntype of data source."]]