Aller au contenu principal

MyEMS Conception de la base de données

Sommaire​

Architecture des bases​

MyEMS utilise 13 bases MySQL. Les scripts d'installation sont dans database/install. Chaque script crée une base en utf8mb4 / utf8mb4_unicode_ci. Les tables utilisent une clé primaire BIGINT, des colonnes DATETIME en UTC et DECIMAL(21, 6) pour les mesures et les agrégats.

BaseTablesRôle
myems_system_db166Données de référence : espaces, compteurs, points, équipements, centrales, tarifs et associations
myems_historical_db12Valeurs brutes des points et fichiers importés de coût, de compteurs hors ligne, de réparation et de plan
myems_energy_db39Agrégation horaire de l'énergie
myems_billing_db39Agrégation horaire des coûts, même jeu de tables que l'énergie
myems_carbon_db39Agrégation horaire du carbone, même jeu de tables que l'énergie
myems_energy_baseline_db39Référence horaire, même jeu de tables que l'énergie
myems_energy_model_db39Année type de 8 760 heures, mêmes objets que l'énergie
myems_energy_plan_db39Plan horaire, même jeu de tables que l'énergie
myems_energy_prediction_db39Prévision horaire, même jeu de tables que l'énergie
myems_fdd_db9Règles de défaut et messages e-mail, SMS, web et WeChat
myems_user_db10Utilisateurs, privilèges, sessions, clés d'API et journaux d'audit
myems_reporting_db4Définitions de rapports, modèles, fichiers générés et e-mails de rapport
myems_production_db8Produits, équipes, postes et quantités horaires

Principe​

BaseResponsabilitéÉcrivain
myems_system_dbConfiguration et topologieInterface web via myems-api
myems_historical_dbSéries des points et classeurs importésAcquisition et import de fichiers
myems_energy_dbÉnergie horaireNormalisation et agrégation
myems_billing_dbCoût horaireFacturation, à partir de l'énergie et des tarifs
myems_carbon_dbÉmissions horairesCalcul carbone, à partir de l'énergie et des facteurs d'émission
myems_energy_baseline_dbRéférence horaireService de référence
myems_energy_model_dbUne valeur par heure d'une année non bissextileService de modélisation
myems_energy_plan_dbPlan horaireService de planification
myems_energy_prediction_dbPrévision horaireService de prévision
myems_fdd_dbRègles et notifications sortantesService FDD
myems_user_dbIdentité et privilègesAPI
myems_reporting_dbRapports planifiésService de rapports
myems_production_dbQuantités produites pour l'intensité énergétiqueImport et agrégation de production

Les objets de configuration se référencent par id. Les tables d'une autre base stockent le même id et ne déclarent pas de clé étrangère vers une autre base.

Conventions de nommage​

ObjetRègleExemple
Basepréfixe myems_, suffixe _dbmyems_system_db
Tablepréfixe tbl_tbl_meters
Table d'associationtbl_{owner}_{child}tbl_spaces_meters
Table de faits horaire{object}_{measure}_hourlytbl_meter_hourly
Table de faits du modèlemême ensemble d'objets, suffixe _8760tbl_meter_8760
Clé primaireidid BIGINT NOT NULL AUTO_INCREMENT
Clé métieruuid CHAR(36) sur les objets de configurationcompteur, espace, équipement
Temps*_datetime_utc ou utc_date_timestart_datetime_utc
Index{table}_index_{n}tbl_meters_index_1

Description détaillée​

1. Base système (myems_system_db)​

myems_system_db porte les données de référence. Elle compte 166 tables. Les objets de configuration ont en général id, name, uuid et description. Les tables d'association ne stockent que les deux clés étrangères et id. Les tables de composants d'une centrale stockent une ligne par appareil physique et une table *_points associée.

Classification de l'énergie​

TableChamps clésDescription
tbl_energy_categoriesname, uuid, unit_of_measure, kgce, kgco2eCatégorie d'énergie et facteurs de conversion par défaut
tbl_energy_itemsname, uuid, energy_category_idPoste sous une catégorie

kgce et kgco2e sont les facteurs par défaut de la catégorie. Les prix et facteurs d'émission bornés dans le temps sont dans les tables de tarifs et de facteurs.

Compteurs et points​

TableChamps clésDescription
tbl_metersenergy_category_id, energy_item_id, cost_center_id, master_meter_id, is_counted, is_enabled, hourly_low_limit, hourly_high_limitCompteur en ligne
tbl_offline_metersmêmes limites et champs de catégorie, sans master_meter_idCompteur saisi à la main
tbl_virtual_metersequation (LONGTEXT), energy_category_id, energy_item_id, is_counted, is_enabledCompteur calculé par une équation
tbl_variablesname, virtual_meter_id, meter_type, meter_idLiaison de variable dans l'équation d'un compteur virtuel
tbl_pointsdata_source_id, object_type, units, high_limit, low_limit, higher_limit, lower_limit, ratio, offset_constant, is_trend, is_virtual, address, faults, definitionsPoint de donnée. address, faults et definitions sont du JSON. Pas de uuid
tbl_points_set_valuespoint_id, utc_date_time, set_value, is_setValeur de consigne d'un point
tbl_meters_pointsmeter_id, point_idLiaison compteur-point
tbl_meters_commandsmeter_id, command_idLiaison compteur-commande

higher_limit, lower_limit et is_in_alarm de tbl_points servent au service FDD. ratio et offset_constant mettent le brut à l'échelle.

Acquisition​

TableChamps clésDescription
tbl_gatewaysname, uuid, token, last_seen_datetime_utcPasserelle d'acquisition
tbl_data_sourcesgateway_id, protocol, connection (LONGTEXT), process_id, last_seen_datetime_utcConnexion sous une passerelle. connection est du JSON
tbl_protocolsname, codeCatalogue de protocoles
tbl_sensorsname, uuidCapteur
tbl_sensors_pointssensor_id, point_idLiaison capteur-point
tbl_iot_sim_cardsiccid, imsi, operator, status, used_traffic, total_trafficInventaire de cartes SIM. Cette table n'a pas de uuid

Espaces et centres de coût​

TableChamps clésDescription
tbl_spacesparent_space_id, area, number_of_occupants, timezone_id, contact_id, cost_center_id, latitude, longitude, is_input_counted, is_output_countedArbre des espaces
tbl_cost_centersname, uuid, external_idCentre de coût
tbl_contactsname, uuid, email, phoneContact
tbl_timezonesname, utc_offsetFuseau horaire
tbl_working_calendarsnameCalendrier de travail
tbl_working_calendars_non_working_daysworking_calendar_id, date_local, descriptionJour non travaillé

Un espace relie ses enfants par des tables d'association, pas par une colonne space_id sur ces objets :

tbl_spaces_meters, tbl_spaces_offline_meters, tbl_spaces_virtual_meters, tbl_spaces_points, tbl_spaces_sensors, tbl_spaces_equipments, tbl_spaces_combined_equipments, tbl_spaces_commands, tbl_spaces_shopfloors, tbl_spaces_stores, tbl_spaces_tenants, tbl_spaces_charging_stations, tbl_spaces_microgrids, tbl_spaces_photovoltaic_power_stations, tbl_spaces_energy_storage_power_stations, tbl_spaces_wind_farms, tbl_spaces_distribution_systems, tbl_spaces_energy_flow_diagrams, tbl_spaces_working_calendars.

Équipements​

TableChamps clésDescription
tbl_equipmentsis_input_counted, is_output_counted, is_enabled, cost_center_id, efficiency_indicator, svg_id, camera_urlÉquipement
tbl_combined_equipmentsmêmes champs que tbl_equipmentsÉquipement combiné
tbl_combined_equipments_equipmentscombined_equipment_id, equipment_idMembres d'un équipement combiné

Les deux types lient compteurs, compteurs hors ligne, compteurs virtuels, paramètres, sources de données et commandes :

  • tbl_equipments_meters, tbl_equipments_offline_meters, tbl_equipments_virtual_meters, tbl_equipments_parameters, tbl_equipments_data_sources, tbl_equipments_commands
  • tbl_combined_equipments_meters, tbl_combined_equipments_offline_meters, tbl_combined_equipments_virtual_meters, tbl_combined_equipments_parameters, tbl_combined_equipments_data_sources, tbl_combined_equipments_commands

Ateliers, magasins et locataires​

TableChamps clésDescription
tbl_shopfloorsarea, is_input_counted, is_enabled, contact_id, cost_center_idAtelier
tbl_storesaddress, latitude, longitude, area, store_type_id, is_input_counted, is_enabled, contact_id, cost_center_idMagasin
tbl_store_typesname, uuid, simplified_codeType de magasin
tbl_tenantsbuildings, floors, rooms, area, tenant_type_id, is_input_counted, is_enabled, is_key_tenant, lease_number, lease_start_datetime_utc, lease_end_datetime_utc, is_in_lease, contact_id, cost_center_idLocataire
tbl_tenant_typesname, uuid, simplified_codeType de locataire

Chacun de ces trois objets a des tables d'association pour les compteurs, compteurs hors ligne, compteurs virtuels, points, capteurs, commandes et calendriers. Les ateliers ont aussi tbl_shopfloors_equipments.

Centrales photovoltaïques​

tbl_photovoltaic_power_stations stocke station_code, address, latitude, longitude, latitude_point_id, longitude_point_id, rated_capacity, rated_power, contact_id, cost_center_id, cinq emplacements SVG (svg_id à svg5_id), is_cost_data_displayed, phase_of_lifecycle et commissioning_date.

Tables enfants :

TableRôle
tbl_photovoltaic_power_stations_invertors / _invertors_pointsOnduleurs et leurs points
tbl_photovoltaic_power_stations_grids / _grids_pointsRaccordements réseau et leurs points
tbl_photovoltaic_power_stations_loads / _loads_pointsCharges et leurs points
tbl_photovoltaic_power_stations_data_sourcesSources de données
tbl_photovoltaic_power_stations_usersUtilisateurs liés

Stockage d'énergie​

tbl_energy_storage_containers stocke rated_capacity, rated_power, contact_id et cost_center_id. Tables de composants et tables *_points associées lorsqu'elles existent :

Table de composantTable de points
tbl_energy_storage_containers_batteries (soc_point_id, power_point_id, charge_meter_id, discharge_meter_id)—
tbl_energy_storage_containers_power_conversion_systemstbl_energy_storage_containers_pcses_points
—tbl_energy_storage_containers_bmses_points (bms_id, point_id ; pas de table maître BMS)
tbl_energy_storage_containers_dcdcstbl_energy_storage_containers_dcdcs_points
tbl_energy_storage_containers_stsestbl_energy_storage_containers_stses_points
tbl_energy_storage_containers_gridstbl_energy_storage_containers_grids_points
tbl_energy_storage_containers_loadstbl_energy_storage_containers_loads_points
tbl_energy_storage_containers_hvacstbl_energy_storage_containers_hvacs_points
tbl_energy_storage_containers_firecontrolstbl_energy_storage_containers_firecontrols_points

Aussi : tbl_energy_storage_containers_commands, tbl_energy_storage_containers_data_sources, tbl_energy_storage_containers_schedules.

tbl_energy_storage_power_stations reprend les champs de site d'une centrale photovoltaïque (address, coordonnées, capacité et puissance nominales, contact, centre de coût, cinq SVG, cycle de vie). Les conteneurs sont dans tbl_energy_storage_power_stations_containers, les utilisateurs dans tbl_energy_storage_power_stations_users.

Micro-réseaux​

tbl_microgrids ajoute postal_code et serial_number aux champs de site. Tables enfants :

ComposantPoints
tbl_microgrids_batteries—
—tbl_microgrids_bmses_points (bms_id, point_id ; pas de table maître BMS)
tbl_microgrids_power_conversion_systemstbl_microgrids_pcses_points
tbl_microgrids_photovoltaicstbl_microgrids_pvs_points
tbl_microgrids_evchargerstbl_microgrids_evchargers_points
tbl_microgrids_generatorstbl_microgrids_generators_points
tbl_microgrids_gridstbl_microgrids_grids_points
tbl_microgrids_heatpumpstbl_microgrids_heatpumps_points
tbl_microgrids_loadstbl_microgrids_loads_points

Aussi : tbl_microgrids_commands, tbl_microgrids_data_sources, tbl_microgrids_schedules, tbl_microgrids_sensors, tbl_microgrids_users.

Autres centrales et intégrateurs​

TableChamps clésDescription
tbl_charging_stationsadresse, coordonnées, rated_capacity, rated_power, contact, centre de coût, cinq SVG, cycle de vieStation de recharge
tbl_wind_farmsadresse, coordonnées, rated_power, contact, centre de coût, cinq SVGParc éolien
tbl_virtual_power_plantscost_center_id, balancing_price_point_id, svg_idCentrale virtuelle
tbl_virtual_power_plants_microgridsvirtual_power_plant_id, microgrid_idMicro-réseaux d'une centrale virtuelle
tbl_power_integratorspower_point_id, result_point_id, is_enabledIntègre la puissance en énergie
tbl_fuel_integratorsmodel, power_point_id, result_point_id, is_enabledIntégrateur de combustible
tbl_heat_integratorshigh_temperature_point_id, low_temperature_point_id, flow_point_id, heat_capacity, liquid_density, coefficient, result_point_id, is_enabledIntégrateur de chaleur

Commandes et régulation​

TableChamps clésDescription
tbl_commandstopic, payload (LONGTEXT), set_valueDéfinition de commande
tbl_control_modesname, uuid, is_activeMode de régulation
tbl_control_modes_timescontrol_mode_id, start_time_of_day, end_time_of_day, power_value, power_point_id, power_equationUne période d'un mode de régulation

Tarifs et facteurs d'émission​

TableChamps clésDescription
tbl_tariffsenergy_category_id, tariff_type, unit_of_price, valid_from_datetime_utc, valid_through_datetime_utcTarif. tariff_type vaut timeofuse
tbl_tariffs_timeofusestariff_id, start_time_of_day, end_time_of_day, peak_type, price DECIMAL(23, 8)Prix d'une période de la journée. peak_type vaut toppeak, onpeak, midpeak, offpeak ou deep
tbl_cost_centers_tariffscost_center_id, tariff_idLiaison de tarif
tbl_emission_factorsenergy_category_id, unit_of_factor, valid_from_datetime_utc, valid_through_datetime_utcFacteur d'émission borné dans le temps
tbl_emission_factors_timeofusesemission_factor_id, start_time_of_day, end_time_of_day, factorFacteur d'une période de la journée
tbl_cost_centers_emission_factorscost_center_id, emission_factor_idLiaison de facteur

Schémas, menus, fichiers et ordres de travail​

TableChamps clésDescription
tbl_distribution_systemsname, uuid, svg_idRéseau de distribution
tbl_distribution_circuitsdistribution_system_id, distribution_room, switchgear, peak_load, peak_current, customers, metersCircuit
tbl_distribution_circuits_pointsdistribution_circuit_id, point_idPoints du circuit
tbl_energy_flow_diagramsname, uuidDiagramme de flux d'énergie
tbl_energy_flow_diagrams_nodesenergy_flow_diagram_id, nameNœud
tbl_energy_flow_diagrams_linksenergy_flow_diagram_id, source_node_id, target_node_id, meter_uuidLien
tbl_svgsname, uuid, source_code (LONGTEXT)Graphique SVG
tbl_menusname, route, parent_menu_id, is_hiddenArbre de menus. Pas de uuid
tbl_knowledge_filesfile_name, uuid, upload_datetime_utc, upload_user_uuid, file_object (LONGBLOB)Fichier de base de connaissances
tbl_work_ordersnumber, category, title, priority, status, belong_to_object_type, belong_to_object_id, source_type, source_id, creator_user_id, assignee_user_id, horodatages planifiés et réelsOrdre de travail
tbl_work_order_logswork_order_id, user_id, action, from_status, to_status, comment, created_datetime_utcJournal d'état
tbl_work_order_fileswork_order_id, file_name, file_path, file_size, uploaded_by_user_idChemin de pièce jointe. Les octets sont sur disque
tbl_versionsversion, release_dateVersion du schéma

2. Base historique (myems_historical_db)​

myems_historical_db stocke les valeurs brutes des points et les classeurs importés. Elle compte 12 tables.

Chaque famille de valeurs a une table d'historique et une table de dernière valeur. Les lignes d'historique portent is_bad et is_published. Les dernières valeurs ne gardent que point_id, utc_date_time et actual_value. Les deux sont indexées par (point_id, utc_date_time) et par utc_date_time.

TableType de actual_valueDescription
tbl_analog_value, tbl_analog_value_latestDECIMAL(21, 6)Analogique
tbl_energy_value, tbl_energy_value_latestDECIMAL(21, 6)Énergie cumulée
tbl_digital_value, tbl_digital_value_latestINTNumérique
tbl_text_value, tbl_text_value_latestLONGTEXTTexte

Les fichiers importés partagent file_name, uuid, upload_datetime_utc, status (new, done, error) et file_object (LONGBLOB) :

TableRôle
tbl_cost_filesClasseur de coûts
tbl_offline_meter_filesClasseur de compteurs hors ligne
tbl_data_repair_filesClasseur de réparation
tbl_energy_plan_filesClasseur de plan énergétique

3. Base énergie (myems_energy_db)​

myems_energy_db stocke l'énergie réelle horaire. Elle compte 39 tables, sans tables journalières, mensuelles ni annuelles. Les rapports cumulent les heures dans la requête.

Chaque table a id, l'identifiant de l'objet parent, start_datetime_utc et actual_value DECIMAL(21, 6). Les tables de catégorie ont aussi energy_category_id. Les tables de poste ont aussi energy_item_id. L'index composé est (object_id, [id de catégorie ou de poste], start_datetime_utc).

GroupeTables
Compteurstbl_meter_hourly, tbl_offline_meter_hourly, tbl_virtual_meter_hourly
Équipementtbl_equipment_input_category_hourly, tbl_equipment_input_item_hourly, tbl_equipment_output_category_hourly
Équipement combinétbl_combined_equipment_input_category_hourly, tbl_combined_equipment_input_item_hourly, tbl_combined_equipment_output_category_hourly
Espacetbl_space_input_category_hourly, tbl_space_input_item_hourly, tbl_space_output_category_hourly
Ateliertbl_shopfloor_input_category_hourly, tbl_shopfloor_input_item_hourly
Magasintbl_store_input_category_hourly, tbl_store_input_item_hourly
Locatairetbl_tenant_input_category_hourly, tbl_tenant_input_item_hourly
Conteneur de stockagetbl_energy_storage_container_{charge,discharge,grid_buy,grid_sell,load}_hourly
Centrale de stockagetbl_energy_storage_power_station_{charge,discharge,grid_buy,grid_sell,load}_hourly
Micro-réseautbl_microgrid_{charge,discharge,evcharger,grid_buy,grid_sell,load,photovoltaic}_hourly
Centrale photovoltaïquetbl_photovoltaic_power_station_{generation,grid_buy,grid_sell,load}_hourly

Les tables de compteurs, compteurs hors ligne, compteurs virtuels, stockage, micro-réseau et photovoltaïque n'ont pas de colonne de catégorie d'énergie. La catégorie vient de l'objet parent.

4. Base de facturation (myems_billing_db)​

myems_billing_db a les mêmes 39 tables horaires et les mêmes colonnes que myems_energy_db. actual_value est le coût dans la devise du tarif. La facturation lit l'énergie horaire et le tarif lié au centre de coût.

5. Base carbone (myems_carbon_db)​

myems_carbon_db a les mêmes 39 tables horaires. actual_value est l'émission. Le calcul utilise l'énergie horaire avec tbl_energy_categories.kgco2e ou les lignes horaires de tbl_emission_factors.

6. Base de référence énergétique (myems_energy_baseline_db)​

myems_energy_baseline_db a les mêmes 39 tables horaires. actual_value est la référence de cette heure.

7. Base de modèle énergétique (myems_energy_model_db)​

myems_energy_model_db a les mêmes 39 groupes d'objets. Les noms de tables se terminent par _8760 et non _hourly, et la colonne de temps est hour_of_year (INT) et non start_datetime_utc. Exemple : tbl_meter_8760(meter_id, hour_of_year, actual_value).

8. Base de plan énergétique (myems_energy_plan_db)​

myems_energy_plan_db a les mêmes 39 tables horaires que myems_energy_db. actual_value est la quantité planifiée. Les classeurs de plan arrivent d'abord dans myems_historical_db.tbl_energy_plan_files.

9. Base de prévision énergétique (myems_energy_prediction_db)​

myems_energy_prediction_db a les mêmes 39 tables horaires. actual_value est la quantité prévue.

10. Base FDD (myems_fdd_db)​

myems_fdd_db compte 9 tables.

TableChamps clésDescription
tbl_rulesname, uuid, category, fdd_code, priority, channel, expression, message_template, is_enabled, last_run_datetime_utc, next_run_datetime_utc, is_run_immediatelyRègle de défaut. expression est du JSON. message_template est du texte avec substitutions $
tbl_email_servershost, port, requires_authentication, user_name, password, from_addrServeur SMTP
tbl_email_messagesrule_id, recipient_email, subject, message, attachment_file_object, scheduled_datetime_utc, statusE-mail sortant
tbl_text_messages_outboxrule_id, recipient_mobile, message, acknowledge_code, statusSMS sortant
tbl_text_messages_inboxsender_mobile, message, received_datetime_utc, statusSMS entrant
tbl_web_messagesrule_id, user_id, subject, category, priority, message, status, reply, belong_to_object_type, belong_to_object_idMessage web
tbl_wechat_configsapi_server, app_id, app_secret, access_token, expires_datetime_utcApplication WeChat
tbl_wechat_messages_outboxrule_id, recipient_openid, message_template_id, message_data, statusWeChat sortant
tbl_wechat_messages_inboxsender_openid, message, received_datetime_utc, statusWeChat entrant

tbl_rules.category vaut REALTIME, SYSTEM, SPACE, METER, TENANT, STORE, SHOPFLOOR, EQUIPMENT ou COMBINEDEQUIPMENT. priority vaut CRITICAL, HIGH, MEDIUM ou LOW. channel vaut WEB, EMAIL, SMS, WECHAT ou CALL. fdd_code identifie la règle, par exemple REALTIME01 ou SPACE02.

11. Base utilisateurs (myems_user_db)​

myems_user_db compte 10 tables.

TableChamps clésDescription
tbl_usersname, uuid, display_name, email, phone, salt, password, is_admin, is_read_only, privilege_id, account_expiration_datetime_utc, password_expiration_datetime_utc, failed_login_countUtilisateur. password est le hachage salé (VARCHAR(256))
tbl_privilegesname, data (LONGTEXT, JSON)Jeu de privilèges
tbl_sessionsuser_uuid, token, utc_expiresSession de connexion
tbl_logsuser_uuid, request_datetime_utc, request_method, resource_type, resource_id, request_bodyJournal d'audit de l'API. request_body est du JSON
tbl_api_keysname, token, created_datetime_utc, expires_datetime_utcClé d'API. id est INT
tbl_new_usersname, uuid, display_name, email, salt, passwordInscription en attente
tbl_email_messagesrecipient_email, subject, message, scheduled_datetime_utc, statusCourriel utilisateur, par exemple réinitialisation du mot de passe. status vaut new, sent ou timeout
tbl_email_message_sessionsrecipient_email, token, expires_datetime_utcJeton d'une action par courriel
tbl_verification_codesrecipient_email, verification_code, created_datetime_utc, expires_datetime_utcCode de vérification. id est INT
tbl_notificationsuser_id, created_datetime_utc, status, subject, message, urlNotification dans l'application. status vaut unread, read ou archived

12. Base de rapports (myems_reporting_db)​

myems_reporting_db compte 4 tables.

TableChamps clésDescription
tbl_reportsname, uuid, expression, is_enabled, last_run_datetime_utc, next_run_datetime_utc, is_run_immediatelyPlanification de rapport. expression est du JSON
tbl_template_filesuuid, report_id, file_name, file_type, file_objectModèle lié à un rapport
tbl_reports_filesuuid, create_datetime_utc, file_name, file_type, file_objectFichier généré
tbl_email_messagesrecipient_email, subject, message, attachment_file_object, scheduled_datetime_utc, statusCourriel d'envoi du rapport. Cette table n'a pas de rule_id

13. Base de production (myems_production_db)​

myems_production_db compte 8 tables. Les quantités horaires partagent start_datetime_utc, product_id et product_count.

TableChamps clésDescription
tbl_productsname, uuid, unit_of_measure, tag, standard_product_coefficientProduit
tbl_teamsname, uuid, descriptionÉquipe
tbl_shopfloors_productsshopfloor_id, product_idProduits fabriqués dans un atelier
tbl_shopfloors_teamsshopfloor_id, team_idÉquipes d'un atelier
tbl_shiftsshopfloor_id, team_id, product_id, product_count, start_datetime_utc, end_datetime_utc, reference_timestampEnregistrement de poste
tbl_equipment_hourlyequipment_id, start_datetime_utc, product_id, product_countProduction horaire d'un équipement
tbl_shopfloor_hourlyshopfloor_id, start_datetime_utc, product_id, product_countProduction horaire d'un atelier
tbl_space_hourlyspace_id, start_datetime_utc, product_id, product_countProduction horaire agrégée sur un espace

Flux de données​

Ordre de traitement :

  1. Les passerelles écrivent les valeurs de points dans myems_historical_db. Les classeurs importés arrivent dans les tables de fichiers de la même base.
  2. La normalisation transforme les valeurs de points en relevés de compteurs, avec ratio et offset_constant de tbl_points.
  3. L'agrégation écrit des lignes horaires dans myems_energy_db pour les compteurs et pour chaque objet parent (équipement, espace, magasin, locataire, atelier, stockage, micro-réseau, centrale photovoltaïque).
  4. La facturation multiplie ces heures par tbl_tariffs / tbl_tariffs_timeofuses et écrit myems_billing_db.
  5. Le carbone multiplie ces heures par kgco2e ou tbl_emission_factors et écrit myems_carbon_db.
  6. Les services de référence, de modèle, de plan et de prévision écrivent leurs propres bases. La base de modèle stocke hour_of_year au lieu d'un horodatage.
  7. Le FDD évalue tbl_rules.expression face aux limites des points et aux agrégats, puis met en file les messages e-mail, SMS, web ou WeChat.
  8. Les rapports lisent l'énergie, les coûts et le carbone, remplissent tbl_template_files et enregistrent le résultat dans tbl_reports_files.
  9. Les quantités horaires de myems_production_db sont le dénominateur de l'intensité énergétique.

Règles de structure des tables​

Champs communs​

Les tables de configuration de myems_system_db contiennent en général :

ChampTypeDescription
idBIGINT NOT NULL AUTO_INCREMENTClé primaire
nameVARCHAR(128) ou VARCHAR(255)Nom affiché
uuidCHAR(36) NOT NULLClé métier stable
descriptionVARCHAR(255)Description facultative

Les tables de séries et d'association ne suivent pas cet ensemble. Les tables de faits utilisent id, des clés étrangères et actual_value. Beaucoup de tables d'association n'ont que id et deux clés étrangères. tbl_points, tbl_menus et tbl_iot_sim_cards n'ont pas de uuid.

Types de données​

UsageType
Clés primaires et étrangèresBIGINT (INT pour tbl_api_keys et tbl_verification_codes)
Énergie, coût, carbone, limites, surfaceDECIMAL(21, 6)
Prix d'une période tarifaireDECIMAL(23, 8)
LatitudeDECIMAL(12, 10)
LongitudeDECIMAL(13, 10)
HorodatagesDATETIME, stockés en UTC
Dates calendairesDATE
Heure du jourTIME
IndicateursBOOL
Codes courts et étatsVARCHAR
Documents JSON (address, faults, definitions, connection, expression de règle et de rapport, data de privilège, request_body)LONGTEXT
Équations (tbl_virtual_meters.equation, power_equation)LONGTEXT
Valeur de point numériqueINT
FichiersLONGBLOB

Index​

Les index secondaires se nomment {table_name}_index_{n}.

MotifExemple
Recherche par nomtbl_meters_index_1 (name)
Parent plus tempstbl_meter_hourly_index_1 (meter_id, start_datetime_utc)
Catégorie plus tempstbl_space_input_category_hourly_index_1 (space_id, energy_category_id, start_datetime_utc)
Historique de pointtbl_analog_value_index_1 (point_id, utc_date_time), tbl_analog_value_index_2 (utc_date_time)
Validité du tariftbl_tariffs_index_2 (energy_category_id, valid_from_datetime_utc, valid_through_datetime_utc)

Les scripts ne déclarent pas de clés étrangères. L'intégrité référentielle est assurée par l'API.