Comment écrire un programme de maison de clic
Ce qui suit montrera comment utiliser la bibliothèque client ClickHouse C++ pour se connecter à la base de données ClickHouse et effectuer une opération de requête simple :
#include <iostream>
#include <Poco/SharedPtr.h>
#include <Poco/Net/SocketAddress.h>
#include <Poco/Net/NetException.h>
#include <Poco/Data/Session.h>
#include <Poco/Data/SessionFactory.h>
#include <Poco/Data/MySQL/Connector.h>
#include <Poco/Data/MySQL/MySQLException.h>
using namespace std;
using namespace Poco;
using namespace Poco::Data;
using namespace Poco::Data::MySQL;
int main(int argc, char** argv)
{
// Connect to ClickHouse
Session session(SessionFactory::instance().create(
"MySQL",
"host=localhost;port=9000;db=default;user=default;password="
));
// Execute a simple query
Statement select(session);
select << "SELECT * FROM mytable";
RecordSet rs(select);
// Print the result
for (size_t i = 0; i < rs.rowCount(); i++)
{
const auto& row = rs[i];
cout << row[0].toString() << ", " << row[1].toString() << endl;
}
return 0;
}
Avant d'écrire du code, les bibliothèques client Poco et ClickHouse C++ doivent être installées. Ils peuvent être installés sur Ubuntu avec la commande suivante :
sudo apt-get install libpoco-dev libmysqlclient-dev
sudo apt-get install clickhouse-client clickhouse-server clickhouse-client -y
Une fois l'installation terminée, le code peut être compilé avec la commande suivante :
g++ -o example example.cpp -lPocoDataMySQL -lPocoData -lPocoFoundation -lmysqlclient
Une fois la compilation réussie, vous pouvez exécuter le programme avec la commande suivante :
./example
Cet exemple se connectera à un serveur ClickHouse local et effectuera une opération de requête simple pour récupérer toutes les données d'une table nommée mytable. Enfin, il imprimera les résultats de la requête sur la console.
Fichier d'en-tête du programme et introduction à la classe
1. Poco/SharedPtr.h : ce fichier d'en-tête définit la classe de pointeur partagé dans la bibliothèque Poco. Une classe de pointeur partagé est un pointeur intelligent qui permet à plusieurs objets de partager le même pointeur. Dans cet exemple, des pointeurs partagés sont utilisés pour gérer certains objets de la bibliothèque Poco.
2. Poco/Net/SocketAddress.h : ce fichier d'en-tête définit la classe d'adresse de socket dans la bibliothèque Poco. La classe d'adresses de socket est une classe utilisée pour représenter les adresses réseau, y compris des informations telles que les adresses IP et les numéros de port. Dans cet exemple, la classe d'adresse de socket est utilisée pour spécifier l'adresse et le numéro de port du serveur ClickHouse.
3. Poco/Net/NetException.h : ce fichier d'en-tête définit la classe d'exception réseau dans la bibliothèque Poco. La classe d'exception réseau est utilisée pour représenter les erreurs réseau, y compris les erreurs de connexion, les erreurs de dépassement de délai, etc. Dans cet exemple, la classe d'exception réseau est utilisée pour gérer les erreurs pouvant survenir lors de la connexion au serveur ClickHouse.
4. Poco/Data/Session.h : ce fichier d'en-tête définit la classe de session dans la bibliothèque Poco. La classe de session est utilisée pour représenter une session avec la base de données, y compris la connexion, la transaction, la requête, etc. Dans cet exemple, la classe de session est utilisée pour se connecter à la base de données ClickHouse.
5. Poco/Data/SessionFactory.h : ce fichier d'en-tête définit la classe de fabrique de session dans la bibliothèque Poco. La classe de fabrique de session est une classe utilisée pour créer des objets de session, et différents objets de session peuvent être créés en fonction de différents types de base de données. Dans cet exemple, une classe de fabrique de session est utilisée pour créer des objets de session ClickHouse.
6. Poco/Data/MySQL/Connector.h : ce fichier d'en-tête définit la classe de connecteur MySQL dans la bibliothèque Poco. La classe de connecteur MySQL est une classe utilisée pour se connecter à la base de données MySQL, et différents objets de session MySQL peuvent être créés en fonction de différents paramètres de connexion. Dans cet exemple, la classe de connecteur MySQL est utilisée pour se connecter à la base de données ClickHouse.
7. Poco/Data/MySQL/MySQLException.h : ce fichier d'en-tête définit la classe d'exception MySQL dans la bibliothèque Poco. La classe d'exception MySQL est une classe utilisée pour représenter les erreurs MySQL, y compris les erreurs de connexion, les erreurs de syntaxe, etc. Dans cet exemple, la classe d'exception MySQL est utilisée pour gérer les erreurs pouvant survenir lors de la connexion à la base de données ClickHouse.
8. Utilisation de l'espace de noms : il s'agit d'une instruction d'importation d'espace de noms en C++, qui est utilisée pour spécifier l'utilisation de fonctions ou de classes dans l'espace de noms. Dans cet exemple, l'instruction using namespace est utilisée pour spécifier les fonctions et les classes dans la bibliothèque Poco et la bibliothèque client ClickHouse C++.
9. Session : Cette classe est la classe de base pour représenter les sessions dans la bibliothèque Poco. Différents types de sessions peuvent être créés via différents connecteurs, tels que des sessions MySQL, des sessions PostgreSQL, des sessions ODBC, etc. Dans cet exemple, le connecteur MySQL est utilisé pour créer une session ClickHouse.
10. Instruction : cette classe est la classe qui représente l'instruction de requête dans la bibliothèque Poco. Vous pouvez utiliser l'objet de session pour exécuter l'instruction de requête et renvoyer le jeu de résultats. Dans cet exemple, un SELECT est effectué à l'aide de l'objet de session
Pourquoi utiliser le fichier d'en-tête mysql
Dans l'exemple ClickHouse ci-dessus, le connecteur MySQL et les classes d'exception MySQL sont utilisés pour se connecter à la base de données ClickHouse car la bibliothèque client ClickHouse C++ fournit une interface compatible MySQL. La bibliothèque client ClickHouse C++ est une bibliothèque C++ utilisée pour interagir avec le serveur ClickHouse, fournissant de nombreuses interfaces et outils pour interroger, insérer, mettre à jour et supprimer des données dans la base de données ClickHouse.
L'interface compatible MySQL de la bibliothèque client ClickHouse C++ signifie que cette bibliothèque implémente le protocole client MySQL et fournit une API similaire au client MySQL, et peut accéder à la base de données ClickHouse via le protocole MySQL. L'avantage est que le protocole MySQL est un protocole général et que de nombreux langages et outils prennent en charge le protocole MySQL, de sorte que la base de données ClickHouse est accessible via de nombreux outils différents, pas seulement limités au langage C++ et au client ClickHouse C++. bibliothèque.
Bien sûr, si vous ne souhaitez pas utiliser l'interface compatible MySQL, vous pouvez également utiliser directement l'interface native fournie par la bibliothèque client ClickHouse C++ pour accéder à la base de données ClickHouse. La bibliothèque client ClickHouse C++ fournit une variété de connecteurs, tels que des connecteurs HTTP, des connecteurs natifs, des connecteurs TCP, etc. Vous pouvez choisir différents connecteurs en fonction de vos besoins.