Vue d’ensemble des connecteurs

Deux sens du mot « connecteur »

  1. Connecteurs data / API (pipeline) — connexionId + subType, credentials S3/Azure, runtime ConnectorFactory.

  2. Routes HTTP /api/{version}/connectors/* — fichiers, exports DOCX. Voir Routes fichiers et exports.

Architecture

Marketplace → POST /connectors → MongoDB (métadonnées)
           → POST /credentials/file → S3/Azure (secrets)
Pipeline    → ConnectorFactory.get_connector(subType, credentials)
           → extract_data / load_data / get_data

Schéma type / subType

  • type : catégorie (database, api, server, tool)

  • subType : implémentation (snowflake, postgresql, openai, …)

Migration legacy : documents sans subType sont normalisés par l’API (ancien type → subType).

Credentials vs end_scope

Concept

Rôle

credentials

Secrets à l’instanciation ConnectorFactory (host, clés, account…)

end_scope

Cible par opération (table, bucket/key, endpoint REST…)

Schémas Voluptuous : factonics_utils/connect/config/objects/connectors/schema.py.

connexionId et dashboards

Le champ connexion_id des subboxes SQL (text_engine, networkgraph) référence le connexionId Mongo.

Voir aussi