Aller au contenu principal

Connexions et entités

Les entités d’un Modèle Sémantique lisent des données via des connexions autorisées. Avant d’importer une entité, vérifiez que vous disposez des permissions sur la connexion et le projet du modèle.

Types de connexion​

Environnement​

Une connexion Environnement est configurée et gérée par l’administrateur. L’éditeur affiche uniquement celles compatibles avec les rôles du modèle et avec l’utilisateur.

Manuel​

Une connexion Manuelle peut être créée dans l’éditeur lorsque l’administrateur a activé cette possibilité.

La gestion permet de :

  • attribuer un nom ;
  • choisir le type de source supporté ;
  • saisir les informations requises dans le formulaire protégé ;
  • vérifier la connexion ;
  • la mettre à jour ;
  • la révoquer ;
  • la supprimer quand elle n’est pas utilisée.

Pour Oracle le formulaire requiert également de choisir si le nom de la base de données est un SID ou un Service name.

Les valeurs réservées ne sont pas affichées après le sauvegarde. Ne les insérez pas dans des noms, des descriptions ou des captures d’écran.

Importer des entités​

  1. Sélectionner Importer des entités.
  2. Choisir le type de connexion.
  3. Sélectionner une connexion autorisée.
  4. Charger le catalogue.
  5. Rechercher par schéma, entité, champ ou type.
  6. Sélectionner une ou plusieurs tables ou vues.
  7. Sélectionner Importer les sélectionnées.

Pour chaque entité Sybot crée les champs initiaux et les affiche dans le panneau Entités et dans le diagramme. Le catalogue affiche tous les schémas qui contiennent des tables ou des vues lisibles, jusqu’à 500 entités par schéma.

Pour SAP HANA le catalogue inclut des tables, des vues et des colonnes accessibles à l’utilisateur de la connexion. Les objets non autorisés ne sont pas affichés ; si une source attendue manque, demander la vérification des permissions au responsable de la connexion.

Propriétés de l’entité​

Sélectionnant une entité il est possible de configurer :

  • nom technique et étiquette ;
  • état actif ;
  • source ;
  • champs ;
  • dimensions calculées ;
  • mesures ;
  • comportement de mise à jour pour les modèles Import ;
  • style de l’en-tête dans le diagramme.

Un champ peut être masqué aux utilisateurs des Vues sans être supprimé du modèle.

Configurer la source​

Le commande Configurer la requête permet de choisir :

  • table ;
  • vue ;
  • Query Builder ;
  • SQL personnalisé en lecture seule.

Le Query Builder supporte objet de départ, joint, conditions organisées en groupes, ordonnements et limite des lignes.

La modalité SQL personnalisée accepte seulement des requêtes en lecture. Utiliser les contrôles de l’éditeur et ne pas insérer des données réservées dans le texte de l’interrogation.

Prévisualisation​

Sont disponibles deux vérifications :

  • Prévisualisation configuration, avant d’appliquer la source à la brouillon ;
  • Prévisualisation entité, sur la définition courante du modèle.

La Prévisualisation montre un échantillon limité et ne publie pas le modèle.

Si ne retourne pas de données, contrôler connexion, objet sélectionné, conditions et autorisations. En présence d’un message avec référence diagnostique, communiquer à l’administrateur sans ajouter des identifiants ou des données source.

Modifications de la source​

Quand on ouvre l’Editor, Sybot contrôle en arrière-plan si les tables et les vues utilisées directement par les entités ont été modifiées. Le contrôle peut détecter :

  • colonnes ajoutées ou supprimées ;
  • modifications du type de données ;
  • tables ou vues supprimées ;
  • configurations du modèle impliquées par le changement.

La vérification ne modifie pas automatiquement le modèle. Si des différences sont trouvées, compare un avertissement avec le bouton Détails.

Dans le détail, les modifications sont regroupées par entité et montrent également les effets prévus sur les relations, les formules, les champs calculés, les mesures, les hiérarchies et l’actualisation incrémentale.

Pour aligner la brouillon :

  1. sélectionner Détails ;
  2. contrôler toutes les modifications et les impacts ;
  3. sélectionner Mettre à jour le modèle ;
  4. vérifier à nouveau Prévisualisation entité et requête sémantique ;
  5. sauvegarder et publier une nouvelle version seulement après le test.

Si une source n’est pas accessible, Sybot ne considère pas supprimées ses entités et empêche l’alignement jusqu’à ce que la vérification soit complète.

Le entités basées sur Query Builder ou SQL personnalisé ne sont pas réalignées automatiquement, car les colonnes renvoyées dépendent de la configuration de la requête. Les tables de calendrier restent gérées par le modèle.